HubSpot private app 연결
HubSpot 소스는 데이터를 가져오고 HubSpot 레코드를 생성, 수정하거나 삭제하는 연결입니다. Data Connection의 +New Source에서 HubSpot 소스를 선택하고 private app 액세스 토큰을 구성합니다.
private app과 범위
HubSpot 계정에서 private app을 만들고 액세스 토큰을 복사합니다. 앱을 생성하려면 HubSpot super admin이어야 합니다. 앱에 부여한 범위(scope)가 탐색하고 동기화할 수 있는 테이블을 결정하므로, Foundry에서 사용할 각 범위에 필요한 읽기 또는 쓰기 접근을 부여합니다.
범위가 부족해도 인증 자체는 성공할 수 있습니다. 이 경우 소스는 연결 오류를 표시하지 않고 토큰으로 접근할 수 없는 테이블을 탐색 결과에서 생략합니다. 테이블이 보이지 않으면 연결 장애뿐 아니라 앱의 범위를 확인해야 합니다.
HubSpot 구독을 하향하면 private app이 일부 범위를 잃을 수 있습니다. 토큰을 Rotate and expire later로 교체하면 이전 토큰은 7일 뒤 만료됩니다. 소스가 계속 이전 토큰을 사용하는지 확인합니다.
네트워크와 연결 속성
api.hubapi.com에 항상 접근할 수 있어야 합니다. Foundry 워커 소스에는 외부 통신 정책을 추가합니다. 다른 네트워크 경유가 필요하면 에이전트 프록시를 우선 사용하고, 에이전트와 원천 양쪽에서 연결을 허용합니다. 에이전트 워커는 권장하지 않는 Legacy 방식입니다.
필수 연결 항목 Private app token에 HubSpot private app에서 발급한 액세스 토큰을 입력합니다. 이 토큰의 권한이 외부 시스템에서 수행 가능한 작업 범위를 정합니다.
기존 API 키에서 전환
HubSpot은 2022년 7월 15일에 새 API 키 생성을 중단했고 2022년 11월 30일에 API 키 인증을 종료했습니다. API 키를 사용하는 기존 소스는 private app 토큰으로 전환해야 합니다.
- 필요한 범위를 가진 private app을 만들고 액세스 토큰을 확보합니다.
- Foundry 소스의 Connection settings, Connection details에서 인증 방식으로 Private app을 선택합니다.
- 액세스 토큰을 입력합니다.
이후 탐색 가능한 테이블과 필요한 작업 범위를 확인합니다. 토큰이 유효하다는 사실만으로 모든 기존 테이블에 접근할 수 있는 것은 아닙니다.