Listener로 외부 이벤트 받기
Listener는 외부 시스템이 Foundry로 연결을 시작할 때 사용할 수 있는 수신 지점입니다. 외부 서비스가 Foundry의 OAuth 2.0 인증을 지원하지 않거나, 이벤트 본문을 Foundry API가 요구하는 형태로 바꿀 수 없을 때 해당 서비스의 서명 검증과 메시지 형식을 처리합니다. Data Connection의 Listeners 탭에서 생성하고 관리합니다.
연결 방식과 처리 목적지
| 유형 | 연결과 출력 | 제공 상태 |
|---|---|---|
| HTTPS Listener | 웹훅 요청을 받아 스트림에 이벤트를 기록합니다. | 정식 제공(GA) |
| WebSocket Listener | 연결을 유지하며 양방향으로 메시지를 주고받습니다. 자동 생성된 Compute Module의 사용자 지정 서버가 처리합니다. | Beta. 플랫폼 인스턴스에 따라 사용 가능 여부가 다르며 기능이 변경될 수 있습니다. |
| Email Listener | 전용 이메일 주소로 받은 메시지를 검증하고 내용을 미디어 집합으로 전달합니다. | 정식 제공(GA). 모든 플랫폼 인스턴스에서 사용할 수 있는 것은 아닙니다. |
HTTPS Listener의 출력 스트림은 Automate, 스트리밍 파이프라인, 아카이브 데이터셋을 사용하는 배치 파이프라인에서 처리할 수 있습니다. 선택 기준은 이벤트 처리 방식에서 설명합니다. WebSocket은 음성 통화처럼 수신 중에도 응답을 보내야 하는 연결에 적합합니다. 이메일은 발신자 허용 목록과 이메일 인증, 첨부 파일 검사를 통과해야 수신됩니다.
Listener와 다른 연결 기능의 선택
외부 데이터를 Foundry가 요청해서 가져오거나, Foundry에서 외부 시스템으로 요청을 보내려면 소스를 구성합니다. 소스에는 배치 및 스트리밍 동기화, 외부 웹훅, 코드에서의 API 호출 같은 연결 기능을 사용할 수 있습니다. 외부 이벤트를 받는 Listener와 외부로 요청을 보내는 웹훅은 방향이 다릅니다.
외부 시스템에 통합 코드를 작성할 수 있고 목적이 데이터 쓰기라면 Foundry 공개 API를 우선 검토합니다. API를 통해 스트림에 레코드를 보내거나 데이터셋에 파일을 업로드하고 온톨로지와 상호작용할 수 있습니다. 공급자가 정한 웹훅 본문과 인증 방식을 바꿀 수 없을 때 HTTPS Listener를 선택합니다. 사용자 지정 WebSocket 서버에 Foundry 토큰으로 접속하는 클라이언트는 Foundry 인증 WebSocket Listener를 사용할 수 있습니다.
네트워크와 보안 준비
HTTPS 및 외부 서비스용 WebSocket Listener는 전용 하위 도메인에 연결하여 기본 플랫폼 도메인과 다른 인바운드 허용 범위를 적용할 수 있습니다. 하위 도메인 생성과 Listener 연결에는 각각 승인 절차가 있습니다. Foundry 인증 WebSocket Listener는 기본 플랫폼 도메인을 사용합니다.
수신 인증과 저장된 데이터의 접근 권한을 함께 설정합니다. HTTPS 수신 설정에서는 공급자별 인증 방식과 출력 스트림의 권한을, WebSocket 수신 설정에서는 Compute Module의 리소스 접근 및 반출 가능한 보안 표지를, 이메일 수신 설정에서는 발신자 허용 목록과 메시지 검사를 확인합니다.