2
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Cloud Runで403が出たら、誰の権限を確認する? 3つの立場で学ぶGoogle Cloud IAM

2
Posted at

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 で短期間有効な認証情報を利用できます。

参考資料

2
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
2
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?