注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

トークンとAPIキーを保護する

Foundry ユーザーは、トークン、APIキー、およびその他の認証に使用する情報を保護することが重要です。トークンが外部に漏洩した(意図せず公開された)場合や、悪意のある攻撃者に侵害された場合、不正な第三者が、侵害されたトークンのユーザーコンテキストで Foundry にアクセスできる可能性があります。

トークン

Foundry では、いくつかの異なる種類のトークンを使用します。

ユーザー生成トークン

ユーザー生成トークン(または個人用アクセストークン)は、プラットフォーム内のすべてのアプリケーションへのユーザーレベルのアクセスを付与するAPIキーです。ユーザーは、トークンの作成時に有効期間(TTL)を指定できます。TTL は、アクセストークンを使用できる最大期間です。TTL が切れると、トークンは取り消されます。

ユーザー生成トークンのセキュリティ特性の1つとして、ほかのユーザー生成トークンを生成できないことが挙げられます。新しいユーザー生成トークンの作成に使用できるのは、セッショントークンのみです。この種類のトークンを生成する方法については、こちらをご覧ください。

セッショントークン

セッショントークンは、ブラウザーに Cookie(PALANTIR_TOKEN)として保存される、有効期間が限られた一時的なトークンです。セッショントークンが生成されると、有効期間(TTL)が自動的に割り当てられます。デフォルトの TTL は16時間です。TTL が切れると、トークンは取り消されます。

データコネクターコーディネータートークン

データコネクターコーディネータートークンは、データコネクターエージェントを Foundry インストールに対して認証するために使用されます。デフォルトでは、このトークンは {BOOTVISOR_DIRECTORY}/var/data/coordinator-token.json に保存されます。データコネクターコーディネータートークンは、エージェント固有のプラットフォームへのアクセスを付与します。

新しいデータコネクターを作成すると、有効期間が限られたトークンがデプロイ用 tarball に動的に挿入されます。この tarball には認証に使用する情報が含まれるため、機密情報として扱ってください。

データコネクターエージェントに、ほかのデータソース(SQL データベースなど)の資格情報が設定されている場合、追加の資格情報がエージェント内でローカルにキャッシュまたは保存されることがあります。

トークンのベストプラクティス

トークンやAPIキーの侵害や悪用を防ぐため、次のベストプラクティスと行動を推奨します。

  1. トークンをほかのユーザーに渡したり、公開したりしないでください。
  2. ローカルでトークンを扱うときは、環境変数を使用することが望ましいです。
  3. トークンの保存にドットファイルを使用する場合は、ドットファイルがバージョン管理の対象から除外されていることを確認してください。
  4. コマンドライン引数にトークンを含めないでください。
  5. スクリプトやソフトウェアにトークンをハードコードしないでください。
  6. 使用していないトークンや不要なトークンは取り消してください。
  7. ユーザー生成トークンには、妥当な有効期間を設定してください。
  8. ほかのデバイスとの間で、ブラウザーベースの Cookie 同期技術を使用しないでください。
  9. 使用するブラウザー拡張機能の数を最小限に抑えてください。

トークンの漏洩

トークンが許可されていないシステム上で公開されたり、アクセス可能になったりした場合、トークンが「漏洩」したとみなされます。たとえば、公開リポジトリに誤って公開した場合が該当します。トークンの漏洩は、いずれも情報セキュリティインシデントとして扱ってください。直ちにトークンを無効化する措置を講じ、その後、情報セキュリティチームに問題を報告してください。種類ごとのトークンの無効化手順は、以下を参照してください。

ユーザー生成トークンを取り消す

Foundry のユーザーインターフェースで、ユーザー生成トークンを取り消すことができます。方法については、ユーザー生成トークンのドキュメントを参照してください。

セッショントークンを取り消す

セッショントークンを取り消すには、Foundry インスタンスからログアウトします。

GitHub トークン取り消しサービス

Palantir の情報セキュリティチームは、GitHub.com ↗ のソース管理に漏洩したトークンの特定と取り消しを試みる自動サービスを運用しています。トークンが GitHub の公開リポジトリに漏洩すると、GitHub トークン取り消しサービスに通知され、このサービスがユーザーに代わって自動的にトークンの取り消しを試みます。

GitHub トークン取り消しサービスは、トークンの取り消しが行われてもユーザーに通知できません。また、お使いの Foundry インストールにこのサービスからネットワーク経由でアクセスできない場合、サービスはトークンを自動的に取り消すことができません。