Generic 커넥터와 코드 기반 연결
Generic 커넥터는 임의 외부 시스템의 네트워크 대상, 인증 정보와 내보낼 수 있는 보안 표지를 하나의 소스로 묶습니다. 직접 제공하는 기능은 일반 제공(GA)인 Use in code입니다. 다른 커넥터의 표준 동기화나 내보내기 UI 기능을 자체적으로 제공하지 않습니다.
코드에서는 이 소스를 사용해 배치 수집, 파일 및 테이블 내보내기, 스트리밍 수집과 내보내기, 미디어 수집, 웹훅 등을 구현할 수 있습니다. 소스 소유자는 네트워크와 인증 정보를 함께 관리하여 인증 정보가 지정한 외부 시스템에 사용되도록 하고, 코드 환경에 적용할 내보내기 보안 조건을 설정합니다.
소스 생성 위치
코드 저장소 환경의 측면 패널에서 New connection으로 Generic 커넥터를 만듭니다. Data Connection에서 직접 만드는 흐름을 사용하지 않습니다. 생성한 Generic 소스는 Data Connection에도 다른 소스와 함께 표시됩니다.
네트워크와 실행 환경
코드에서 사용하는 소스이므로 Foundry 워커만 지원합니다. Palantir에서 시작한 연결을 받을 수 있는 대상은 직접 연결 외부 통신 정책으로 구성합니다. 사설망처럼 직접 연결을 받을 수 없는 대상은 에이전트 프록시 정책을 사용합니다.
프록시를 사용하면 에이전트가 목적지 주소에 도달할 수 있어야 하고, 목적지 시스템도 에이전트에서 오는 연결을 허용해야 합니다. 에이전트는 이 경우 연산 실행 호스트가 아니라 네트워크 경로를 제공합니다.
구성 항목
| 항목 | 필수 여부 | 의미 |
|---|---|---|
Networking | 필수 | 코드에서 접근할 목적지 주소와 IP를 정하는 외부 통신 정책 집합입니다. |
Credentials | 선택 | 인증 정보 등의 이름과 값 쌍입니다. 현재 비밀 값만 저장할 수 있으며 암호화하지 않은 일반 값은 지원하지 않습니다. |
Exportable control markings | 선택 | Foundry 데이터 입력과 함께 사용할 때 내보내기를 활성화하고 허용할 보안 표지 집합을 지정합니다. |
네트워크 정책은 도달할 대상을, 인증 정보는 외부 시스템 로그인에 필요한 값을, 내보내기 보안 표지는 그 대상으로 전달할 수 있는 Foundry 데이터의 조건을 정합니다.
사용할 수 있는 코드 환경
| 환경 | 사용 방식 |
|---|---|
| Python 외부 변환 | 소스를 저장소에 가져와 외부 시스템을 호출하고 소스 인증 정보에 접근합니다. |
| Compute modules | 장기간 실행되는 모듈에 소스를 가져옵니다. 스트리밍 수집과 내보내기, 사용자 정의 쓰기 반영 워크플로에 사용할 수 있습니다. |
| TypeScript 함수 | Functions 저장소로 가져와 fetch로 외부 시스템을 호출합니다. 일반 제공됩니다. |
| Python 함수 | Functions 저장소로 가져와 requests로 외부 시스템을 호출합니다. 일반 제공됩니다. |
REST API 소스로 변환
소스에 연결된 외부 통신 정책이 정확히 하나이고, 그 정책이 DNS 주소의 443 포트를 대상으로 하면 REST API 소스로 변환할 수 있습니다.
변환하면 코드에서 사용할 내장 HTTP 클라이언트를 제공받아 해당 외부 시스템과 상호작용할 수 있습니다. 정책이 여러 개이거나 IP 주소 또는 다른 포트를 사용하는 Generic 소스에 같은 변환 조건을 적용하지 않습니다.