サービス エージェントの権限をユーザー管理のサービス アカウントに委任することは、ユーザーごとのバケット アクセス制御を必要とする組織向けのオプション構成です。
エージェントレス転送の場合、Storage Transfer Service はデフォルトでサービス エージェントを使用して、転送元と転送先の間でデータを転送します。サービス エージェントに Cloud Storage バケットへのアクセス権を付与します。
同じ Storage Transfer Service サービス エージェントがプロジェクト内のすべての転送で使用されるため、そのプロジェクト内のすべての転送に関係するすべてのバケットに対する権限が必要です。
必要に応じて、複数のユーザー管理サービス アカウントにバケット権限を割り当てることもできます。これらのユーザー管理サービス アカウントには、特定のソースバケットと宛先バケットに対する権限が付与されます。また、特定のユーザー アカウント(転送ジョブを作成またはトリガーするアカウント)に制限されます。
サンプル事例
次のシナリオでは、サービス エージェントとユーザー管理のサービス アカウントを使用したさまざまな権限オプションを示します。
各セクションを開くと詳細が表示されます。
シナリオ 1: サービス エージェントのみ
このシナリオでは、すべての権限がサービス エージェントに付与されます。
- サービス エージェントに、バケット A、B、C、D に対する書き込み権限が付与されます。
転送ジョブを作成するための適切な権限を持つユーザーは、バケット A、B、C、D との間で転送を行うことができます。
これは、Storage Transfer Service ユーザーがすべてのバケットのデータに対して信頼できるユーザーであり、転送ジョブを正しく構成して、間違ったバケットとの間でデータを移動しないようにできる場合に適しています。
シナリオ 2: ユーザー管理のサービス エージェントのみ
このシナリオでは、すべての権限がユーザー管理のサービス アカウントに付与されます。
- ユーザー管理のサービス アカウント 1 には、バケット A と B に対する権限が付与されています。
- ユーザー管理のサービス アカウント #2 には、バケット C と D に対する権限が付与されています。
さらに、次の点にも注意してください。
- ユーザー Alpha にサービス アカウント #1 へのアクセス権が付与されます。
- ユーザー Bravo には、サービス アカウント #2 へのアクセス権が付与されています。
- ユーザー Charlie には、サービス アカウント #1 と #2 へのアクセス権が付与されています。
この例の場合は、次のようになります。
- Alpha はバケット A と B の間でのみ転送できます。
- Bravo はバケット C と D の間でのみ転送できます。
- Charlie は、バケット A と B の間、および C と D の間でのみ転送できます。
- チャーリーは、A と C、A と D、B と C、B と D の間で転送することはできません。
シナリオ 3: 混合権限
このシナリオでは、プロジェクトにサービス エージェントの権限とユーザー管理のサービス アカウントの権限が混在しています。
- サービス エージェントにバケット A とバケット B に対する書き込み権限が付与されます。
- ユーザー管理のサービス アカウント 1 には、バケット C に対する読み取り専用権限と、バケット D に対する書き込み権限が付与されています。
- ユーザー Alpha に、ユーザー管理のサービス アカウント #1 へのアクセス権が付与されます。
この例の場合は、次のようになります。
- 転送ジョブを作成するための適切な権限を持つユーザーは、バケット A と B との間で転送を行うことができます。バケット C または D との間で転送することはできません。
- ユーザー Alpha は、バケット A とバケット B との間で転送を行うことができます。
- アルファは、バケット C からバケット D に転送できます。
- Alpha は、バケット C からバケット A または B に転送することはできません。
実装の概要
実装は次のとおりです。
- ユーザー管理のサービス アカウントを作成するか、既存のサービス アカウントを使用します。
- 権限を付与します。
- ユーザーがユーザー管理のサービス アカウントにアクセスできるようにする。
- サービス エージェントがユーザー管理のサービス アカウントからアクセス トークンを生成するため。
- ユーザー管理のサービス アカウントがバケットにアクセスできるようにするため。
- ユーザーが、ユーザー管理のサービス アカウントを指定する転送ジョブを作成します。
- Storage Transfer Service は、ユーザーにサービス アカウントに対する正しい権限が付与されていることを確認します。正しい権限が付与されていない場合、転送ジョブの作成は失敗します。
- サービス エージェントは、ユーザー管理のサービス アカウントに代わって OAuth トークンを生成します。OAuth トークンを使用すると、Storage Transfer Service は転送に関連するバケットにアクセスできます。
- 転送ジョブが実行されます。
- OAuth トークンは有効期間が短く、期限切れになります。トークンの有効期限が切れたときに転送ジョブが進行中の場合、Storage Transfer Service は新しいトークンを生成して転送を続行します。
権限の委任を設定する
手順に沿って、サービス エージェントのアクセス権をユーザー管理のサービス アカウントに委任します。
要件
- 転送ジョブを作成または管理するには、ユーザー アカウントに Storage Transfer Service のプロジェクト権限が必要です。必要なユーザー権限をご覧ください。
- 新しいユーザー管理のサービス アカウントを作成するには、プロジェクトに対するサービス アカウント作成(
roles/iam.serviceAccountCreator)ロールが必要です。 - ユーザーとサービス エージェントにユーザー管理のサービス アカウントへのアクセス権を付与するには、ユーザー管理のサービス アカウントまたはプロジェクトに対するサービス アカウント管理者(
roles/iam.serviceAccountAdmin)ロールが必要です。
ユーザー管理のサービス アカウントを作成または特定する
新しいユーザー管理のサービス アカウントを作成することも、既存のサービス アカウントを使用することもできます。
ユーザー管理のサービス アカウントを作成するには、サービス アカウントを作成するの手順に沿って操作します。
既存のユーザー管理サービス アカウントを使用するには、次の形式のメールアドレスが必要です。
SERVICE_ACCOUNT_NAME@PROJECT_ID.サービス アカウントの一意の ID(
uniqueId)が必要な場合は、gcloud iam service-accounts describe SERVICE_ACCOUNT_EMAIL --format="value(uniqueId)"を実行するか、Google Cloud コンソールの [サービス アカウント] ページの [一意の ID] 列を表示します。
サービス アカウントが転送ジョブとは異なるプロジェクトにある場合は、プロジェクト間でサービス アカウントの接続を有効にするをご覧ください。
ユーザーにアクセス権を付与する
ユーザー アカウントに新しいユーザー管理のサービス アカウントへのアクセス権を付与し、サービス アカウント ユーザーのロール(roles/iam.serviceAccountUser)を割り当てます。ユーザー アカウントは、転送ジョブの作成または更新に使用されるアカウントです。
Google Cloud コンソール
Google Cloud コンソールで、[サービス アカウント] ページに移動します。
プロジェクトを選択します。
ユーザー管理のサービス アカウントのメールアドレスをクリックします。
[アクセス権を持つプリンシパル] タブを選択します。
[ アクセスを許可] をクリックします。
お客様のメールアドレスを入力します。例:
user1@example.com[ロール] プルダウン リストから [サービス アカウント ユーザー] を選択します。
[保存] をクリックします。プリンシパルにサービス アカウントのロールが付与されます。
gcloud
プリンシパルにロールを付与するには、add-iam-policy-binding コマンドを実行します。
gcloud iam service-accounts add-iam-policy-binding USER_MANAGED_SERVICE_ACCOUNT_EMAIL \ --member=PRINCIPAL --role=roles/iam.serviceAccountUser
次の変数を置き換えます。
- USER_MANAGED_SERVICE_ACCOUNT_EMAIL: ユーザー管理のサービス アカウントのメールアドレス(
SA_NAME@PROJECT_ID.形式)。 - PRINCIPAL: 転送ジョブを実行しているユーザーのメールアドレス(
user:name@example.com形式)。
サービス エージェントへのアクセス権を付与する
サービス エージェントがユーザー管理のサービス アカウントからアクセス トークンを生成できるようにするには、サービス エージェントにユーザー管理のサービス アカウントへのアクセス権を付与し、サービス アカウント トークン作成者のロール(roles/iam.serviceAccountTokenCreator)を割り当てます。
アクセス権を付与するには、サービス エージェントのメールアドレスが必要です。サービス エージェントのメールアドレスを確認するには:
googleServiceAccounts.getリファレンス ページに移動します。[Try this method] というインタラクティブ パネルが開きます。
パネルの [Request parameters] にプロジェクト ID を入力します。ここで指定するプロジェクトは、Storage Transfer Service の管理に使用しているプロジェクトである必要があります。
[実行] をクリックします。
サービス エージェントのメールアドレスが
accountEmailの値として返されます。形式はproject-PROJECT_NUMBER@storage-transfer-service.です。
次に、サービス エージェントにユーザー管理のサービス アカウントへのアクセス権を付与します。
Google Cloud コンソール
Google Cloud コンソールで、[サービス アカウント] ページに移動します。
プロジェクトを選択します。
ユーザー管理のサービス アカウントのメールアドレスをクリックします。
[アクセス権を持つプリンシパル] タブを選択します。
[ アクセスを許可] をクリックします。
サービス エージェントのメールアドレスを入力します。
[ロール] プルダウン リストから、[サービス アカウント トークン作成者] を選択します。
[保存] をクリックします。プリンシパルにサービス アカウントのロールが付与されます。
gcloud
プリンシパルにロールを付与するには、add-iam-policy-binding コマンドを実行します。
gcloud iam service-accounts add-iam-policy-binding USER_MANAGED_SERVICE_ACCOUNT_EMAIL \ --member=serviceAccount:SERVICE_AGENT_EMAIL --role=roles/iam.serviceAccountTokenCreator
次の変数を置き換えます。
- USER_MANAGED_SERVICE_ACCOUNT_EMAIL: ユーザー管理のサービス アカウントのメールアドレス(
SA_NAME@PROJECT_ID.形式)。 - SERVICE_AGENT_EMAIL: サービス エージェントのメールアドレス。
ユーザー管理のサービス アカウントにバケット権限を付与する
サービス エージェントではなく、ユーザー管理のサービス アカウントに、ソースへのアクセスを構成する: Cloud Storage とシンクへのアクセスを構成する: Cloud Storage に記載されている権限を付与します。
ユーザー管理のサービス アカウントを使用して転送ジョブを作成する
適切な権限を付与したら、新しい転送ジョブの作成時にユーザー管理のサービス アカウントを指定できます。
Google Cloud コンソール
手順に沿って転送を作成します。転送ジョブを完了する前に、次のことを行います。
- [設定を選択] ページで、[サービス アカウントの種類] セクションを見つけます。
- [ユーザー管理のサービス アカウント] を選択します。
- ユーザー管理のサービス アカウントのメールアドレスを
SERVICE_ACCOUNT_NAME@PROJECT_ID.の形式で入力します。 - [作成] をクリックして転送を作成します。
REST API
transferJobs.create リクエストの serviceAccount フィールドの値として、ユーザー管理のサービス アカウントを指定します。
サービス アカウントのメールアドレス(SERVICE_ACCOUNT_NAME@PROJECT_ID.)または一意の ID(123456789012345678901)のいずれかが受け入れられます。
次に例を示します。
POST https://storagetransfer.googleapis.com/v1/transferJobs
{
"description": "A transfer using a user-managed service account for bucket permissions",
"status": "ENABLED",
"projectId": "PROJECT_ID",
"serviceAccount": "SERVICE_ACCOUNT_NAME@PROJECT_ID.",
"transferSpec": {
...
}
}
サービス アカウントの一意の ID を取得する
AWS S3 または Microsoft Azure ストレージへの連携アクセスを構成する場合、または REST API リクエストでサービス アカウントを指定する場合は、ユーザー管理のサービス アカウントの一意の ID が必要になることがあります。
uniqueId を取得するには:
Google Cloud コンソール
Google Cloud コンソールの [サービス アカウント] ページに移動します。
サービス アカウントのメールアドレスをクリックします。
[詳細] タブで、[一意の ID] を見つけます。
gcloud CLI
次の Google Cloud CLI コマンドを使用します。
gcloud iam service-accounts describe USER_MANAGED_SERVICE_ACCOUNT_EMAIL \
--format='value(uniqueId)'