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

権限リファレンス

Data Connection の主要な概念である Agent、ソース、同期はすべて、Foundry でリソースとして管理されます。これにより、プロジェクトやフォルダーにこれらのリソースを柔軟に整理でき、マーキングなどのセキュリティの基本要素を Data Connection リソースに適用できます。

プラットフォームの所有者は、Data Connection リソースを過度に共有しないよう注意してください。ソースや Agent に対する閲覧権限と編集権限を持つユーザーは、信頼できるパイプライン開発者に限定する必要があります。同期によって生成されたデータセットは、必要に応じて下流の Transforms プロジェクトにインポートできます。これにより、Agent やソースへのアクセスを共有せずに、データへのアクセスを付与できます。

このページでは、次のリソースを含む、すべての Data Connection リソースの権限の仕組みを説明します。

リソースの権限

このセクションで説明する権限はデフォルトのものです。一部の環境では、カスタムロールを使用して、権限のデフォルトの動作が変更されている場合があります。

Agent

所有者

Agent の所有者は通常、その作成者であり、次の権限を持ちます。

  • Agent を再ダウンロードする、またはその Agent のトークンを再生成する
  • 編集者の権限を継承する

編集者

Agent の編集者は、次の操作を実行できます。

  • その Agent にソースをデプロイする。
  • Agent Manager を使用して Agent を設定する(プラグインや設定を変更し、Agent を再起動する)。
  • Agent をほかのユーザーと共有する。
  • 閲覧者の権限を継承する。
  • Agent を削除する。

プロジェクト内で Agent を作成するには、そのプロジェクトの編集者である必要がありますが、そのプロジェクト内の Agent を管理するには、プロジェクトの所有者である必要があります。そのため、Agent を作成したユーザーであっても、その Agent のダウンロードリンクの生成やその他の管理タスクを実行できない場合があります。

閲覧者

Agent の閲覧者は、次の操作を実行できます。

  • Agent の設定とステータスを確認する。

ソース

所有者

デフォルトでは、ソースの所有者は編集者の権限を継承します。

ソースの所有者は、次の操作も実行できます。

  • 情報セキュリティ責任者のエンロールメントロールも持っている場合、エクスポートを有効または無効にする。
  • 各マーキングに対するマーキングの適用とマーキングの解除の両方の権限を持っている場合、エクスポート可能なセキュリティマーキングを追加する。
  • 自身の組織以外の各組織に対してアクセスを拡大する権限を持っている場合、エクスポート可能な組織を追加する。自身の組織は、アクセスを拡大する権限がなくても追加できます。
  • ソースをコードリソースにインポートすることを許可する。

エクスポート可能なマーキングや組織を追加する際に、情報セキュリティ責任者ロールは必要ありません。

編集者

ソースの編集者は、次の操作を実行できます。

  • ソースを削除する。
  • ソースに割り当てられた Agent を変更する(追加するすべての Agent に対する編集権限も必要です)。
  • ソースの設定を更新する(ソースに割り当てられた Agent に対する編集権限も必要です)。
  • ソースの名前を変更する。
  • そのソースの同期を作成、編集、削除する。
  • データベースソースに対して SQL クエリを実行する。
  • ソースをほかのユーザーと共有する。
  • JDBC ソースや Directory ソースなど、探索とプレビューに対応したソースを探索、プレビューする。
  • 閲覧者の権限を継承する。
  • ソースをコードリソースにインポートする
資格情報で許可されている場合、ソースの編集者はソースシステムを変更できます

ソースの資格情報で許可されている場合、同期によってソースシステムが変更される可能性があることに注意してください(たとえば、ディレクトリや S3 ソースからファイルを削除したり、任意の SQL を使用してデータベースからデータを削除したりできます)。ソース(またはソースを含むプロジェクト)への編集アクセスは、そのソースがデータへのアクセスに使用するアカウントへのフルアクセスも付与できるユーザーにのみ付与してください。

閲覧者

  • ソースの閲覧者は、割り当てられた Agent を含むソースの設定を閲覧できます。

ソース作成権限

ほとんどの環境では、ネットワークエグレスポリシーを使用して、Foundry から送信されるトラフィックを管理します。エグレスポリシーは、許可される宛先と、それらを利用できるユーザーを制御するため、ユーザーは組織レベルの追加の制限なしでソースやワークフローを作成できます。

ロールベースのソース作成は、組織内でソースを作成できるユーザーを制限するための、任意の追加制御レイヤーです。この設定は、Control Panel: で有効または無効にできます。

  • 有効: ソースを作成するには、Data Connection ソースを作成ワークフローを含む組織ロールをユーザーが持っている必要があります。
  • 無効(デフォルト):ソースを作成するために、組織レベルのソース作成ワークフローをユーザーが持っている必要はありません。

この設定は組織全体に適用されます。どちらの場合も、既存のソースには引き続きプロジェクトの権限が適用されます。この設定はソースの作成を制御するものであり、エグレスポリシーによる管理を置き換えたり、既存のソースの権限を変更したりするものではありません。

この設定を変更するには、該当する組織に対するソース作成の認可方法を管理ワークフローを持っている必要があります。組織管理者ロールには、デフォルトでこのワークフローが含まれています。

ロールベースのソース作成を有効にする場合は、まず、ソースを作成する必要があるユーザーまたはグループに、Data Connection ソースを作成ワークフローを含むロールを付与してください。カスタムロールを含む組織ロールを使用して、このワークフローを付与できます。

同期

同期の権限は、関連するソースと出力データセットの権限に基づきます。

  • 同期の閲覧には、ソースとデータセットに対する閲覧権限が必要です。
  • 同期の編集には、ソースとデータセットに対する編集権限が必要です。
  • 同期の削除には、ソースとデータセットに対する編集権限が必要です。
  • 同期の実行には、データセットに対する編集権限が必要です。

プラグインと JDBC ドライバー

所有者

  • 編集者の権限を継承します。

編集者

  • プラグイン / ドライバーを削除します(削除するには、プラグイン / ドライバーがどの Agent にも割り当てられていない必要があります)。
  • 閲覧者の権限を継承します。

閲覧者

  • プラグイン / ドライバーを閲覧します。
  • プラグイン / ドライバーをダウンロードします。
  • プラグインを Agent に追加します(Agent に対する編集者権限も必要です)。

Webhook

Webhook の権限は、関連付けられたソースからすべて継承されます。

  • Webhook 設定の閲覧には、ソースに対する閲覧権限が必要です。
  • Webhook の作成には、ソースに対する編集権限が必要です。
  • Webhook 設定の編集には、ソースに対する編集権限が必要です。
  • Webhook の削除には、ソースに対する編集権限が必要です。
  • Webhook を使用するアクションの設定には、ソースに対する編集権限が必要です。
  • Webhook の実行には、ソースに対する編集権限が必要です。ただし、アクションを通じて Webhook を実行する場合は例外です。

デフォルトでは、Webhook を実行したユーザーのみが、Data Connection アプリケーションの履歴タブでレスポンスを閲覧できます。webhooks:read-privileged-data 権限をカスタムまたはデフォルトのロールに追加すると、そのロールを持つユーザーは、アクセス可能なすべての Webhook のリクエストとレスポンスの履歴全体を閲覧できます。標準の推奨セットアップは、この権限を持つ「Webhook 特権データ閲覧者」という新しいロールを追加し、Webhook の履歴全体を閲覧する必要があるユーザーが、該当するソースに対してこのロールを持つようにすることです。

コードからの外部接続

外部トランスフォーム、パイプライン、および Compute Modules

ソースをコードリソースにインポートすると、そのリポジトリの編集権限を持つユーザーは、シークレット値へのアクセスを含め、そのソースに設定された接続情報を使用するカスタムコードを記述できます。

このため、コードへのソースのインポート機能と、ソースへの編集者権限の付与は慎重に管理し、信頼できるユーザーにのみソースとリポジトリへのアクセスを付与する必要があります。

  • コードリソース(トランスフォーム、パイプライン、または Compute Module)へのソースのインポートには、ソースに対する編集者権限が必要です。
  • ソースをインポートするビルドのトリガーには、コードリソースに対する編集者権限が必要です(ソース自体に対する権限は不要です)。
  • コードリソースからインポート済みのソースを外すには、ソースまたはコードリソースに対する編集者権限が必要です。

外部関数

関数リポジトリでの Webhook の使用権限についての詳細は、外部関数の権限に関するドキュメントを参照してください。

Code Repositories のカスタム CI ジョブ

コードリポジトリのカスタム CI ジョブは、そのリポジトリにインポートされたソースのエグレスポリシーとシークレットを使用できます。リポジトリを編集できるユーザーは誰でも、任意のブランチでこれらのシークレットとエグレスポリシーを使用するジョブを追加できます。ソースの資格情報を扱うことを信頼できる編集者がいるリポジトリにのみ、ソースをインポートしてください。

マーキングの伝播

前述のとおり、リソースには追加のアクセス制御として組織とマーキングを適用できます。ソースに適用された組織とマーキングは、そのソースの同期によって生成されたデータセットに伝播します。つまり、ユーザーはそのソースに適用されたすべての組織とマーキングへのアクセス権を持たない限り、ソースから生成されたどのデータセットのデータも閲覧できません。

ソースには機密性の異なるデータが含まれている可能性が高いため、そのソースで利用可能なデータに適用されるすべての組織とマーキングをソースにつけてから、トランスフォームで stop_propagating および/または stop_requiring 機能を使用してデータをクレンジングし、マーキングを解除することを推奨します。マーキング解除についての詳細は、マーキングの解除と継承されたマーキングの解除に関するガイドを参照してください。

同期後のデータに組織とマーキングを適用するだけでは十分とはいえません。ソースへのアクセスは実質的にデータへのアクセスを意味するため、ソースには、その中に含まれるすべてのものに適用される組織とマーキングをつける必要があります。

ベストプラクティス

簡単に振り返ると、Data Connection の主要なリソースは Agent とソースです。プラグインとドライバーは Agent にデプロイされ、機能を拡張します。

Agent のベストプラクティス

Agent に推奨される権限設定は2つあります。組織ごとにすべての Agent を1つのプロジェクトに配置する方法と、Agent ごとに個別のプロジェクトに配置する方法です。上の図は前者の方法を示しています。以下では、それぞれの方法を選択する理由を説明します。

方法1:組織ごとにすべての Agent を1つのプロジェクトに配置する。

すべての Agent を1つのプロジェクトに配置するのが最もシンプルな方法です。すべての Agent を1つのユーザーグループが管理している場合に推奨します。この方法では、プロジェクトレベルで Agent へのアクセスを制御し、Agent の下流にあるソースと同期の権限を個別に設定できます。

すべての Agent Manager とすべてのソース編集者が、すべての Agent にアクセスしても問題ない場合にのみ、この方法を選択してください。Agent にソースをデプロイするには、その Agent に対する編集者権限が必要であることに留意してください。

方法2:Agent ごとに個別のプロジェクトに配置する。

この方法では、Agent の権限を細かく設定できます。また、ソース管理が変化していく中でも、構造が「グループ化」からずれることがないように保証できます。たとえば、Agent のグループ全体へのアクセスをユーザーに付与することなく、安全にソースへの Agent の割り当てや割り当て解除ができます。また、将来のグループ権限の変更に対応するために、プロジェクトを再構成する必要もありません。

Agent を管理するグループが複数あり、Agent へのアクセス権限を個別に設定したい場合に、この方法を推奨します。

プロジェクトの編集者は Agent 上でソースと同期を作成できます

Agent を含むプロジェクトの編集者は、その Agent 上で実行される新しいソースと同期を作成できます。この操作を許可すべきでないユーザーには、プロジェクトの編集者ロールを付与しないでください。

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

ソースは、それぞれデータソースレイヤーの個別のプロジェクトに配置する必要があります。ソースに定義された各同期は、ソースと同じプロジェクト内のデータセットに出力する必要があります。ソースに PII などの機密データが含まれている場合は、ソースにマーキングを適用でき、そのマーキングは出力データセットに伝播します。

ソースを含むプロジェクトの編集者は、そのソースの新しい同期の作成と既存の同期の編集に加えて、Webhook を作成し、Foundry のほかの場所で使用するための設定もできます。

ソースの資格情報で許可されている場合、同期はソースシステムを変更できます。たとえば、Directory または S3 ソースからファイルを削除したり、任意の SQL を使用してデータベースからデータを削除したりできます。ソース(またはそのプロジェクト)への編集権限は、そのソースが使用するアカウントへのフルアクセスも付与できるユーザーにのみ付与してください。

プラグインと JDBC ドライバー

プラグインと JDBC ドライバーに推奨される権限設定は2つあります。組織ごとにすべてのリソースを1つのプロジェクトに配置する方法と、各 JDBC/ドライバーを、それを必要とする1個以上の Agent と同じプロジェクトに配置する方法です。

方法1:組織ごとにすべてのプラグインとドライバーを1つのプロジェクトに配置する。

すべての Agent を1つのユーザーグループが管理している場合に、この方法を推奨します。この方法では、Agent Manager がアップロードされたすべてのプラグインとドライバーにアクセスできます。すべての Agent Manager がプラグインとドライバーに等しくアクセスできるべき場合にのみ、この方法を選択してください。

この方法を実施するための推奨手順は次のとおりです。

  1. Agent ごとに1個のフォルダーを作成します。
  2. 現在のプラグインとドライバーを適切な Agent フォルダーに移行します。
  3. プラグインとドライバーごとに、それぞれのアセットの正式なコピーとするものを1個選び、プロジェクトのルートに移動します。
  4. 必要なプラグインとドライバーのルートにあるコピーを使用するように、各 Agent を移行します。
  5. 個別の Agent フォルダーを非推奨にします。

方法2:プラグインとドライバーの種類ごとに個別のプロジェクトに配置する。

この方法では、特定の「機密性の高い」プラグインやドライバーに、ほかとは別の権限を設定できます。この方法を採用する場合は、該当する Agent の所有者が Agent 上でそれらを使用できるように、各プロジェクトに対する十分な権限を付与してください。