WebSocket Listener의 인증과 반출 권한

WebSocket 연결은 수신 데이터뿐 아니라 외부로 보내는 응답도 전달합니다. 연결을 허용하는 인증과 Compute Module이 읽어 응답에 포함할 수 있는 데이터의 권한을 함께 설정해야 합니다.

연결 인증

Foundry 인증 WebSocket Listener는 Foundry 토큰을 검증하고, 호출자가 Listener와 기반 Compute Module 양쪽에 필요한 권한을 갖는지 확인합니다.

다른 서비스용 Listener는 각 외부 시스템이 정한 인증 절차를 구현합니다. 필요한 값과 검증 방식은 Listener의 Configure connection > Configure security에서 확인합니다. 프로토콜별 보장이 다르며, Palantir는 외부 프로토콜의 적합성이나 효과를 보증하지 않습니다. 운영자는 해당 방식이 들어오는 연결과 데이터에 대해 어떤 검증을 제공하는지 확인해야 합니다.

반출 가능한 보안 표지

Compute Module이 읽는 데이터에는 Listener의 반출 가능 보안 표지 검사가 적용됩니다. 기본값에서는 보안 표지(Marking)가 없는 데이터만 읽어 모듈 입력에 포함할 수 있습니다.

보안 표지가 있는 데이터를 처리하려면 Listener 설정에서 반출을 허용할 표지를 명시합니다. 해당 보안 표지를 해제할 권한을 가진 사용자만 이 설정에 표지를 추가할 수 있습니다.

Compute Module의 입력과 출력으로 리소스 접근을 설정하는 절차도 필요합니다. 모듈에 리소스 접근을 허용하는 것과 Listener에서 그 데이터의 보안 표지를 반출 가능 목록에 넣는 것은 서로 다른 설정입니다.

도메인 격리와 엔드포인트

외부 서비스용 WebSocket Listener는 전용 하위 도메인으로 인바운드 허용 범위를 분리할 수 있습니다. 연결 승인과 수신 네트워크 정책을 완료한 뒤 Listener를 사용합니다.

Foundry 인증 유형은 기본 플랫폼 도메인을 사용하며 전용 하위 도메인을 요구하지 않습니다. 그러나 Listener를 활성화해야 클라이언트가 연결할 수 있고, 플랫폼의 인바운드 규칙도 계속 적용됩니다.

엔드포인트가 노출된 경우에는 지원되는 엔드포인트 회전 절차로 새 주소를 생성하고 발신자 설정을 전환합니다. 만료일을 지정한 이전 엔드포인트는 그 시각이 지나면 더 이상 이벤트를 처리하지 못합니다.