Foundry のサードパーティアプリケーションと API に関するガイダンス

Foundry のサードパーティアプリケーション向けの認証・認可機能により、Foundry 以外のアプリケーションやスクリプトは Foundry の API と安全にやり取りできます。これらの機能の中核となるのは、外部アプリケーション向けの OAuth2 サポートです。このドキュメントでは、これらの機能について Palantir が推奨する使用方法と、不適切となる可能性がある使用例を示します。

サードパーティアプリケーションと API を認可することにより、ユーザーは Palantir と顧客との間で書面により相互に合意された適切な使用に関する規約に従うことに同意します。予定している用途についてご質問がある場合、または計画が適切か、安全か、セキュリティが確保されているか不明な場合は、Palantir の担当者にお問い合わせください。

適切な使用方法

サービスユーザーアカウントの置き換え
- OAuth2 認可コードフローにより、外部アプリケーションは個々の Foundry ユーザーに代わって操作できます。これにより、権限が適切であることが保証され、明確な監査証跡が確保されます。また、OAuth2 フローを使用することで、ユーザーが自分に代わって操作を行うためのアプリケーションへのアクセスを明示的に許可したことも保証され、これについても明確な監査証跡が確保されます。
- サービスアカウントを使用して Foundry で操作を行う既存のアプリケーションは、可能な限り OAuth2 認可フローに移行することを強く推奨します。
外部システムとの連携
- 例：顧客の社内システムの変更を監視し、Foundry のオントロジーでアクションを実行するアプリケーション。
特定のユーザーワークフロー向けのカスタムアプリケーション
- 例：Foundry の Ontology API および Actions API とやり取りして、重要なワークフローに効率的な UX を提供するモバイルアプリケーション。
Foundry のパイプラインまたはワークフローの監視や制御
- 例：Foundry の監視 API およびデータ健全性 API に接続して重要なパイプラインの状態を評価し、必要に応じてユーザーがビルドをトリガーできるようにするアプリケーション。

不適切な使用方法

サードパーティアプリケーションの統合と Foundry API の使用にはデータセキュリティ上のリスクが伴うため、技術面および契約面の考慮事項を明確に理解したうえでのみ行う必要があります。ユーザーに代わってデータにアクセスしたり操作を行ったりする開発プロジェクトの範囲を定める際は、システム管理者にお問い合わせください。計画が適切で安全であり、セキュリティが確保され、Foundry の適切な使用に関する規約に準拠しているかを確認する必要があります。

以下の例は、API を不適切に使用してデータにアクセスしたり操作を行ったりすることで、Foundry で管理されるデータの整合性やセキュリティが損なわれる可能性がある代表的なシナリオの概要を示しています。

データ制御の回避
- 例：あるユーザーのトークンでデータを読み取り、別のユーザーのトークンで書き戻すこと。
- Foundry には、高度できめ細かなユーザー認可機能があります。アプリケーション内でユーザーアカウント間でデータを共有すると、これらの制御を回避してしまう可能性があります。
- 個々の Foundry アカウントの使用を完全に分離しておくことが重要です。あるユーザーのトークンでデータにアクセスし、別のユーザーがそのデータを読み取る、発見する、書き込む、あるいは何らかの方法でそのデータを操作できるようにしてはなりません。ユーザー間でデータを共有できるようにしたい場合は、サードパーティアプリケーションではなく、Foundry 内で行う必要があります。
ユーザーの理解と同意を得ずに操作を行うこと。
- アプリケーションはユーザーを欺いてはなりません。Foundry ユーザーのアカウントを使用する際には、どのような操作を行っているかを明確かつ正確に説明する必要があります。
- アプリケーションは、その機能を実行するために必要な最小限のロールと権限のみを要求し、それを超えてはなりません。また、Foundry でいつ操作が行われるのか、およびその操作が何を行うのかをユーザーに明確に示す必要があります。
- 不明確、予期しない、悪意のある、または損害を与えるアプリケーションの動作は禁止されています。
アクセス制御を考慮せずに Foundry 外でデータを取得または保存すること。
- Foundry の顧客は、重要なデータを安全に保存するために Foundry を利用しています。アプリケーションは、このデータの機密性と価値を尊重し、その機能を実行するために必要な最小限のデータのみを取得する必要があります。
- また、可能であれば、Foundry から取得したデータの保存やキャッシュは避けるべきです。オフラインキャッシュは例外となる可能性がありますが、注意を払い、ユーザーから明確な同意を得る必要があります。
- Foundry のデータを別のデータストレージシステムに移動する場合、そのデータには、Foundry 内のデータ保護に関する組織の設定に従ったアクセス制御や監査が適用されなくなることを了承してください。