注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
リスナー
リスナーを使用すると、OAuth 2.0 認証を直接サポートしていないシステムや、標準の Foundry API エンドポイントに対応する設定可能なペイロードを提供できないシステムから、Palantir プラットフォームがイベントを受信できます。
これらのシステムからの受信接続を受け付けるため、Data Connection のリスナーは URL エンドポイントをプロビジョニングし、外部システム固有のメッセージ署名やその他の検証方式を実装します。また、データフィードを Foundry に受信するためのシンプルで低遅延な仕組みを提供します。
リスナーの種類
Foundry は3種類のリスナーをサポートしており、それぞれ異なる統合シナリオや処理方法に合わせて設計されています。
| リスナーの種類 | ステータス | 接続の種類 | 出力先 |
|---|---|---|---|
| HTTPS リスナー | GA | リクエスト・レスポンス | ストリーム |
| WebSocket リスナー | ベータ版 | 永続的な双方向接続 | Compute Module |
| メールリスナー | GA | 受信メール | メディアセット |
HTTPS リスナー
HTTPS リスナーは、HTTPS エンドポイントを通じて外部システムから Webhook リクエストを受信します。イベントはストリームに書き込まれ、Automate、ストリーミングパイプライン、またはストリームの元データセットを使用したバッチ処理で処理できます。
WebSocket リスナー [ベータ版]
WebSocket リスナーは開発のベータ版段階にあり、お使いのエンロールメントでは利用できない場合があります。開発が進行している間は機能が変更される可能性があります。WebSocket リスナーの利用をご希望の場合は、Palantir サポートにお問い合わせください。
WebSocket リスナーは主にリアルタイムの音声および電話通信のワークフロー向けに設計されており、Foundry と Twilio、Genesys、Azure Communication Services などの外部サービスとの間で双方向通信を可能にします。受信 WebSocket 接続は、カスタム WebSocket サーバーをホストできる Compute Module によって直接処理されます。
メールリスナー
メールリスナーは、すべてのエンロールメントで利用可能なわけではありません。お使いのエンロールメントでの提供状況の詳細については、Palantir サポートにお問い合わせください。
メールリスナーを使用すると、Foundry は専用のメールアドレスでメールを受信し、下流で処理できます。各リスナーにはエンロールメントをスコープとする一意のメールアドレスがあり、コンテンツを転送する前に、送信者の許可リスト登録、メール認証、添付ファイルの検証を適用します。
リスナーを使用する場面
リスナーは、Palantir プラットフォームにデータを取り込むための数ある選択肢の1つです。リスナーを設定する前に、ユースケースが、受信接続またはカスタマイズできない外部システムに関する以下の基準を満たしているかを評価します。
受信接続の場合
リスナーは、外部システムが Foundry への接続を確立する受信接続でのみ使用できます。Foundry から外部システムにリクエストを送信するには、ソースを使用します。同期や送信 Webhookなどのノーコード機能も利用可能です。また、外部トランスフォーム、関数、Compute Moduleなどを使用して、カスタムコードによるデータ接続も利用できます。
外部システムをカスタマイズできない場合
リスナーは、Foundry に接続するように外部システムをカスタマイズできない場合にのみ使用してください。たとえば、多くの Webhook および WebSocket プロバイダーは独自のペイロード形式を持ち、Foundry で適切に認証できないため、代わりにほかの認証および検証プロトコルに依存しています。
カスタムの統合コードを記述できるシステムなど、外部システムをカスタマイズできる場合は、代わりに公開 API を使用します。公開 API を使用すると、ストリームへのプッシュ、データセットへのアップロード、またはオントロジーとの直接的なやり取りができます。
記載されているすべての製品名、ロゴ、ブランドは、それぞれの所有者の商標です。このドキュメントで使用されているすべての会社名、製品名、サービス名は、識別のみを目的としています。