HTTPS Listener의 인증과 데이터 보호

HTTPS Listener는 외부 서비스가 정한 요청 형식을 받으므로 일반 Foundry API의 인증 및 인가 방식을 그대로 사용하지 않습니다. 각 Listener가 해당 서비스의 메시지 서명, 비밀 정보 또는 다른 검증 절차를 구현합니다.

요청 인증의 범위

설정 마법사의 Configuration에서 해당 Listener의 검증 프로토콜과 필요한 인증 정보를 확인합니다. 같은 HTTPS 연결이라도 서비스별 프로토콜이 제공하는 보장은 다릅니다. Palantir는 외부 서비스 프로토콜의 적합성이나 효과를 보증하지 않으므로, 운영자는 해당 검증이 발신자와 수신 데이터에 대해 무엇을 확인하는지 파악해야 합니다.

예를 들어 Slack Listener의 Signing Secret은 Slack 요청 서명을 확인하는 데 사용됩니다. 이를 Slack API로 응답을 보내는 Bearer 토큰과 혼동하지 않습니다. 네트워크 허용 목록 역시 메시지 서명이나 애플리케이션 인증을 대신하지 않습니다.

Listener와 출력 스트림의 접근 권한

수신 데이터에서 일부 민감한 값을 가리는 처리가 수행될 수 있지만, 이는 최선 노력 방식입니다. 요청 본문에 포함된 토큰이나 다른 민감한 데이터가 모두 제거된다고 가정해서는 안 됩니다.

Listener와 출력 스트림을 모두 접근이 제한된 프로젝트에 배치합니다. 필요한 보안 표지(Marking)는 Listener에 적용하고, 출력 스트림에 접근할 수 있는 사용자와 후속 처리 경로도 확인합니다. Listener 설정 화면만 제한하고 원본 요청이 저장된 스트림을 넓게 공유하면 수신 데이터가 노출될 수 있습니다.

수신 도메인과 주소 교체

전용 하위 도메인을 사용하면 기본 플랫폼 도메인과 별도로 인바운드 허용 범위를 관리할 수 있습니다. 외부 서비스용 주소를 플랫폼 전체의 수신 정책과 분리하고, 승인된 범위의 요청만 허용합니다.

엔드포인트가 노출되면 Rotate endpoints로 새 주소를 생성합니다. 기존 주소에 만료일을 설정하여 발신자 설정을 바꾸는 동안 두 주소를 사용할 수 있으며, 이관 후 기존 주소를 삭제합니다. 이미 만료된 주소의 만료일은 연장할 수 없습니다.