Secret ManagerとCloud RunでAPIキーやパスワードを安全に管理する

インフラ・運用2026年11月19日公開読了目安 約8分

目次
  1. 秘密情報をコードや環境変数に直書きしない理由
  2. 基本の流れ
  3. 環境変数とファイルの使い分け
  4. 運用で気を付けたいポイント
  5. まとめ

Webアプリを動かすには、データベースのパスワードや外部APIのキーなど、公開してはいけない値(秘密情報)が必要になります。
手軽さから、ソースコードやリポジトリ内の設定ファイル、デプロイ設定の環境変数に直接書いてしまうことがあります。
しかし、この方法では、リポジトリを閲覧できる人や、設定画面を開ける人に値が見えてしまい、漏えい時の差し替えも大変です。
この記事では、Google CloudのSecret Managerに秘密情報を置き、Cloud Runから安全に受け取る方法を整理します。

秘密情報をコードや環境変数に直書きしない理由

直書きには、次のような問題があります。

  • Gitの履歴に残り、あとから消しても過去のコミットから読める。
  • サービスの設定を見られる人全員に、値が見える。
  • 値を変えるたびに、コードや設定の変更とデプロイが必要になる。
  • 開発・検証・本番で、同じ値を使い回しがちになる。

Secret Managerは、秘密情報を保管するためのGoogle Cloudのサービスです。
値そのものに加えて、版(バージョン)の管理、IAM(アクセス権限の管理)による利用者の制限、アクセスの記録(監査ログ)を使えます。
コードやリポジトリには「どのシークレットを使うか」という名前だけを置き、値は置きません。
Cloud Runの環境変数に値を直接書くのではなく、シークレットへの参照を書く点が、直書きとの違いです。

基本の流れ

構成は、次の3ステップです。

  1. Secret Managerにシークレット(入れ物)を作り、値をバージョンとして登録する。
  2. Cloud Runサービスが使うサービスアカウントに、そのシークレットを読む権限を付ける。
  3. Cloud Runサービスに、シークレットを環境変数またはファイルとして渡す設定をする。

1. シークレットの作成

次のコマンドは、db-password というシークレットを作る例です。
値は read -rs で画面に表示せずに入力し、標準入力から渡します。
こうすると、シェルの履歴やファイルに値が残りません。
コマンドはbashを前提としています。
登録後は変数を消します。

read -rs DB_PASSWORD
gcloud secrets create db-password --replication-policy=automatic
printf '%s' "$DB_PASSWORD" | gcloud secrets versions add db-password --data-file=-
unset DB_PASSWORD

登録するたびに、バージョン番号(1、2、3…)が増えていきます。

2. 読み取り権限の付与

Cloud Runのサービスが使うサービスアカウントに、Secret Manager Secret Accessor(roles/secretmanager.secretAccessor)を付けます。

gcloud secrets add-iam-policy-binding db-password \
  --member="serviceAccount:APP_SA@PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/secretmanager.secretAccessor"

ここでは、プロジェクト全体ではなく、シークレット単位で付けています(理由は後述)。
なお、デプロイを行う側には、Cloud Runサービスに対するCloud Run管理者(roles/run.admin)と、サービスアカウントに対するサービスアカウントユーザー(roles/iam.serviceAccountUser)のロールが必要です。

3. Cloud Runへの設定

環境変数として渡す場合は、--update-secrets に「環境変数名=シークレット名:バージョン」を指定します。

gcloud run deploy my-app \
  --image IMAGE \
  --service-account APP_SA@PROJECT_ID.iam.gserviceaccount.com \
  --update-secrets=DB_PASSWORD=db-password:3

ファイルとして渡す場合は、パスを / から始めて指定します。

gcloud run services update my-app \
  --update-secrets=/etc/secrets/db/password=db-password:3

アプリ側は、普段の環境変数やファイルと同じように読むだけです。
Pythonなら、環境変数は os.environ["DB_PASSWORD"]、ファイルは Path("/etc/secrets/db/password").read_text() で取得できます。
Cloud Runはデプロイの時点で、サービスアカウントが参照先のシークレットにアクセスできるかを確認します。

環境変数とファイルの使い分け

観点 環境変数 ファイル(ボリュームのマウント)
値を読むタイミング インスタンスの起動時に解決される ファイルを読むときに、Secret Managerから取得される
取得に失敗したとき インスタンスが起動しない 起動はするが、読み込み時に失敗する
新しいバージョンの反映 新しいインスタンスから latest なら、再デプロイなしで反映される
向いている用途 パスワード、APIキーなど短い値 証明書、設定ファイルなど

環境変数は、実装が簡単で、既存のアプリも変えずに使えます。
一方で、値の入れ替えを実行中のインスタンスに反映したい場合は、ファイルとして渡す方法が向いています。
ファイルとして渡すときは、既存のディレクトリに重ねず(中身が見えなくなるため)、新しいサブディレクトリを使います。
/dev、/proc、/sys とその配下にはマウントできません。

運用で気を付けたいポイント

バージョンの固定

latest を指定すると、常に最新のバージョンが使われます。
便利ですが、誤った値を登録したときに、そのまま本番へ影響する可能性があります。
Google Cloudのドキュメントでも、環境変数として使う場合は、latest ではなく特定のバージョンを指定することが勧められています。
バージョンを固定しておけば、値の切り替えを通常のリリースと同じ手順で確認し、戻すことができます。
ファイルとして latest を使う場合は、反映が即時になる代わりに、誤った値もそのまま届きます。
登録前の確認と、誤った値を登録したときに、正しい値を新しいバージョンとして登録し直す手順を決めておきます。

シークレット単位の権限設定

1つのプロジェクトで多数のサービスを動かしていると、プロジェクト全体にSecret Accessorを付けたくなります。
その場合、あるサービスが侵害されると、ほかのサービスの秘密情報まで漏れます。
サービスごとに専用のサービスアカウントを用意し、シークレット単位の権限で自分の分だけを読めるようにします。
本番と検証で、プロジェクトを分ける方法も有効です。

ローテーションと旧バージョンの扱い

秘密情報は、定期的に更新(ローテーション)します。
漏えいしたときの被害を限定でき、不要になった人からのアクセスを断てるためです。
更新の流れは、次の順番が安全です。

  1. 新しい値をバージョンとして登録する。
  2. Cloud Runの設定を新しいバージョンに切り替えて、デプロイする。
  3. 動作を確認する。
  4. 旧バージョンを無効化(disable)する。
  5. 問題がないまま一定期間が過ぎたら、破棄(destroy)する。

無効化は、あとで有効に戻せます。
いきなり破棄せず、一度無効化して様子を見ると、その値を使い続けているサービスが残っていても気付けます。

ログや画面への値の出力の防止

アプリのデバッグ出力やエラーメッセージに、環境変数の中身をそのまま出さないようにします。
Cloud Loggingに残った値は、ログを閲覧できる人に見えてしまうためです。

アクセスの記録

シークレットの値の取得(AccessSecretVersion)は、監査ログのうち、データアクセス監査ログの「データ読み取り」(DATA_READ)に分類されます。
監査ログの設定で、Secret Manager APIのデータ読み取りのログを有効にすると、値の取得をログエクスプローラで確認できます。
漏えいが疑われるときの調査に役立ちます。

まとめ

秘密情報は、コードや設定に書かず、Secret Managerに置いて、Cloud Runが実行時に受け取る形にします。
押さえておきたい点は、次の4つです。

  • サービスごとにサービスアカウントを分け、必要なシークレットだけにSecret Accessorを付ける。
  • 環境変数で渡すときは、バージョンを固定する。
  • ローテーションは、新バージョンの登録、切り替え、旧バージョンの無効化、破棄の順に行う。
  • 値をログに出さず、アクセスの記録を残す。

最初に権限とバージョンの扱いを決めておけば、ローテーションも決まった手順で進められ、漏えい時の影響を小さくできます。
仕様は変わることがあるため、導入時には最新のドキュメントを確認してください。

情報は2026年11月15日時点のものです。

参考資料・出典

コラム一覧を見る »