Cloud Run に社内向けの report-api を作るとします。別の社内サービスが API を呼び出すと、report-api が Cloud Storage の reports-prod バケットから CSV を読み取り、集計結果を返す構成です。
この構成で 403 が返ったとき、どのアカウントの権限を確認すればよいのでしょうか。API を呼び出すサービスと、CSV を読み取るアプリでは、Google Cloud が確認するアカウントが異なります。
IAM は「誰が、何に、何をするか」で考える
Google Cloud IAM では、操作する主体をプリンシパルと呼びます。Google アカウントや、アプリが使うサービスアカウントがその例です。認証は主体の身元を確認すること、認可はその主体に操作を許可するか判断することです。
IAM の許可ポリシーは、あるリソースに対して、どのプリンシパルにどのロールを付与するかを定めます。ロールは、読み取りや呼び出しといった個別の権限をまとめたものです。
1. デプロイする担当者は、実行用アカウントを関連付ける
report-api に実行用サービスアカウント report-runtime を関連付けるとき、デプロイ担当者には Cloud Run のデプロイ権限に加えて、report-runtime に対する iam.serviceAccounts.actAs 権限が必要です。
この権限を含む roles/iam.serviceAccountUser は、report-runtime の IAM ポリシーでデプロイ担当者に付与します。CI がデプロイするなら、CI が Google Cloud への認証に使う主体にこのロールを付与します。
2. 呼び出し元のサービスは、API にリクエストを送る
認証が必要な report-api を別のサービスから呼び出すときは、report-api の IAM ポリシーで、呼び出し元のサービスアカウントに roles/run.invoker を付与します。
呼び出し側は、report-api のサービス URL を宛先にした ID トークンをリクエストに添えます。Cloud Run はそのトークンで呼び出し元を確認し、API の呼び出しを許可するか判断します。
3. Cloud Run 上のアプリは、CSV を読み取る
CSV を読むのは report-api のアプリです。ここでは、Cloud Run に関連付けた report-runtime が読み取りの主体になります。Cloud Storage の reports-prod バケットの IAM ポリシーで、このアカウントに roles/storage.objectViewer を付与します。
Google Cloud のクライアントライブラリは、標準的な構成では Application Default Credentials(ADC)を通じて、関連付けられたサービスアカウントの認証情報を取得します。
読み取り先が reports-prod だけなら、ロールの付与範囲もそのバケットに絞れます。プロジェクト単位で付与した場合は、配下のバケットにも権限が継承されます。
403 が出たら、失敗した操作をログで特定する
たとえば、リクエストはアプリまで届いていて、アプリのログに storage.objects.get の権限エラーが出ているとします。このエラーは、アプリからバケットへのアクセス時に発生しています。まず、アプリが実際に使ったアカウントと、対象バケットに適用されるポリシーを確認します。
ローカル開発や CI/CD で使う認証情報
ローカル開発では gcloud auth application-default login でアプリが使う認証情報を用意できます。GitHub Actions などの外部 CI/CD では、Workload Identity Federation で短期間有効な認証情報を利用できます。