Listener 하위 도메인과 엔드포인트 교체
HTTPS와 WebSocket Listener를 전용 하위 도메인에 연결하면 해당 Listener의 모든 요청은 그 하위 도메인을 통해 들어와야 합니다. 기본 플랫폼 도메인과 수신 정책을 분리하여, 외부 서비스가 사용하는 IP 범위를 플랫폼 전체에 허용하지 않고 Listener에만 허용할 수 있습니다.
Listener 하나에는 하위 도메인 하나만 연결할 수 있습니다. 하위 도메인 하나를 여러 Listener가 공유하는 것은 가능합니다. Foundry 인증 WebSocket Listener는 기본 플랫폼 도메인을 사용하므로 이 전용 하위 도메인이 필요하지 않습니다. FedRAMP 및 온프레미스 플랫폼 인스턴스에서는 셀프서비스 제공 여부를 Palantir 지원팀에 확인해야 합니다.
하위 도메인 생성과 인바운드 정책
Control Panel > Domains & certificates에서 부모 도메인을 찾습니다.Request a listener subdomain을 선택하여 새 하위 도메인을 요청합니다.- 플랫폼 인스턴스의
Information Security Officer역할을 가진 사용자가 요청을 승인합니다.
플랫폼 인스턴스당 Listener 하위 도메인은 최대 3개입니다. 더 필요하면 Palantir 지원팀에 요청합니다.
하위 도메인을 만들 때 인바운드 정책을 선택합니다.
| 정책 | 동작과 선택 조건 |
|---|---|
| Custom ingress | 부모 도메인과 독립된 허용 목록을 사용합니다. 생성 후 Control Panel > Network ingress에서 관리합니다. |
| Inherited ingress | 부모 도메인의 허용 목록을 상속합니다. 부모 정책의 변경도 자동 반영됩니다. 생성한 뒤 Custom ingress로 바꿀 수 없습니다. |
예를 들어 플랫폼 전체는 회사 IP만 허용하되, Listener에는 외부 공급자가 운영되는 국가를 허용할 수 있습니다. 공급자가 고정 IP 목록을 제공하지 않거나 목록이 자주 바뀌는 경우에 검토하는 구성입니다. 반대로 기본 인증이나 헤더 비밀 정보만 확인하는 Listener에는 기본 도메인보다 작은 IP 범위만 허용할 수 있습니다. 실제 인증 방식과 발신자의 네트워크 범위에 맞춰 허용 목록을 정합니다.
Listener에 연결하기
- Data Connection의
Listeners탭에서 대상 Listener를 엽니다. - 설정 마법사의
Configure connection에서 하위 도메인을 선택합니다. - 생성된 Approvals 요청을 관리자가 승인합니다.
- Listener를 시작합니다. 이미 실행 중인 Listener는 연결 승인이 완료되면 새 엔드포인트에서 요청을 처리할 수 있습니다.
하위 도메인 자체를 생성하는 승인과 특정 Listener를 그 도메인에 연결하는 승인은 별개입니다.
하위 도메인 변경과 기존 Listener 이관
실행 중인 Listener의 Configure connection에서 다른 하위 도메인을 선택하면 기존 하위 도메인의 요청 처리가 즉시 중단됩니다. 새 연결 승인이 완료될 때까지 요청을 처리할 수 없으므로 서비스 중단이 발생합니다. 승인 후에는 외부 시스템에 등록된 기존 엔드포인트도 새 하위 도메인의 엔드포인트로 변경해야 합니다.
하위 도메인 기능이 제공되기 전에 만든 Listener에는 별도의 무중단 이관 절차가 있습니다. 하위 도메인을 먼저 생성한 뒤 Configure connection에서 표시되는 이관 절차를 사용합니다. 일반적인 하위 도메인 변경의 즉시 중단 동작과 구분해야 합니다.
엔드포인트 회전
엔드포인트가 노출되었거나 새 주소로 교체해야 할 때 Configuration의 Rotate endpoints를 사용합니다. 엔드포인트는 동시에 최대 2개, 만료일이 없는 활성 엔드포인트는 최대 1개만 둘 수 있습니다. 만료일이 설정된 이전 엔드포인트도 만료 전까지는 요청을 처리하므로 두 주소를 겹쳐 운영할 수 있습니다.
- 새 엔드포인트를 생성하고 기존 엔드포인트에 만료일을 지정합니다.
- 외부 시스템에서 사용하는 주소를 새 엔드포인트로 변경합니다.
- 이관이 끝나면 기존 엔드포인트를 삭제합니다.
회전 시 기존 엔드포인트를 즉시 삭제할 수도 있습니다. 이 경우 이전 주소를 계속 사용하는 발신자의 요청은 처리되지 않습니다. 무중단 전환에는 만료일까지 두 주소를 사용할 수 있는 방식을 선택합니다.
만료 전에 시간이 더 필요하면 기존 엔드포인트의 만료일을 연장할 수 있습니다. 이미 만료된 엔드포인트는 만료일을 수정할 수 없습니다. 만료된 항목을 삭제하고 다시 회전하여 새 엔드포인트를 생성해야 합니다.