Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【ITニュース解説】GitHub Actions OIDC AWS: Secure CI/CD Without Access Keys

2026年11月03日に「Dev.to」が公開したITニュース「GitHub Actions OIDC AWS: Secure CI/CD Without Access Keys」について初心者にもわかりやすく解説しています。

作成日: 更新日:

ITニュース概要

GitHub ActionsでAWSにデプロイする際、従来のアクセスキーを使わず、OpenID Connect (OIDC) で一時的な認証情報を取得し、安全なCI/CDを実現する。これにより、長期キー管理の負担や情報漏洩のリスクを減らし、セキュリティを向上させる。

ITニュース解説

システム開発において、GitHub ActionsのようなCI/CD(継続的インテグレーション・継続的デリバリー)ツールは、プログラムの自動テストやデプロイを効率化するために不可欠である。多くのプロジェクトで、このCI/CDプロセスはAWS(Amazon Web Services)などのクラウドサービスと連携し、アプリケーションを本番環境に展開する。

これまで、GitHub ActionsがAWS環境にデプロイする際によく使われていた方法は、AWSの「アクセスキー」(具体的にはAWS_ACCESS_KEY_IDとAWS_SECRET_ACCESS_KEYという二つの認証情報)をGitHub Actionsの「シークレット」という、機密情報を保存する場所に設定するというものだった。この方法は機能するものの、セキュリティ上の大きな課題を抱えている。アクセスキーは、AWSアカウントに対する非常に強力な権限を持つ、有効期限の定められていない「永続的な」認証情報だからである。もしこのアクセスキーが外部に漏洩してしまえば、悪意のある第三者によってAWS内のリソースが不正に操作される深刻なリスクがある。また、セキュリティ基準を満たすためには、定期的にキーを更新(ローテーション)する手間も発生し、その管理は煩雑になりがちである。

このような永続的なアクセスキーの利用に伴うリスクを解消するために登場したのが、OpenID Connect(OIDC)を利用した認証方法だ。OIDCは、GitHub ActionsがAWSと連携する際に、永続的なAWSアクセスキーをGitHub Actions側に保存することなく、必要な時だけ「一時的な」AWS認証情報を安全に取得できるようにする仕組みである。これにより、キーの漏洩リスクや管理の手間を大幅に軽減し、CI/CDパイプラインのセキュリティを向上させることが可能になる。

OIDCによる認証の基本的な流れは以下のようになる。まず、GitHub Actionsでデプロイが実行される際、GitHubのOIDCプロバイダに対して「このワークフローは正当なGitHub Actionsの実行である」ということを証明する「署名付きのトークン」(これをOpenID Connect ID Token、またはJWTと呼ぶ)を要求する。GitHub OIDCプロバイダは、このトークンを発行する。このトークンには、ワークフローが実行されたGitHubリポジトリやブランチなどの情報が含まれており、デジタル署名によってその内容が改ざんされていないことが保証されている。

次に、発行されたOIDCトークンは、GitHub ActionsによってAWSのSTS(Security Token Service)というサービスに渡される。AWS STSは、このトークンを受け取ると、いくつかの重要な検証を行う。一つは、トークンを発行したのが信頼できるGitHub OIDCプロバイダであるかどうかの確認だ。もう一つは、このトークンがAWS向けの認証を意図しているか(オーディエンスが適切か)の確認である。さらに、最も重要な検証として、トークンに含まれるGitHub Actionsの実行元情報(例えば、「特定のリポジトリの特定のブランチでの実行」)が、AWS側で事前に設定されているIAM(Identity and Access Management)ロールの「信頼ポリシー」で許可されているかどうかを確認する。

これらの検証が全て成功した場合、AWS STSは一時的なAWSの認証情報を発行する。この一時的な認証情報は、従来の永続的なアクセスキーとは異なり、有効期限が非常に短く、特定のAWSリソースに対する限定された権限のみを持つように設定できる。GitHub Actionsはこの一時的な認証情報を使って、AWSへのデプロイ作業を行う。デプロイが完了すれば、一時的な認証情報は自動的に失効するため、認証情報が漏洩したとしても、その有効期間は非常に短く、被害を最小限に抑えることができる。AWSでは、この一時的な認証情報を交換するプロセスをAssumeRoleWithWebIdentityと呼んでいる。

OIDC認証を導入するためには、AWSとGitHub Actionsの両方で設定が必要になる。最初のステップは、AWS側でGitHubのOIDCプロバイダを「信頼できる」外部認証元として登録することだ。これは、AWSのIAMコンソールでIAM IDプロバイダを作成し、プロバイダURLとしてhttps://token.actions.githubusercontent.com、オーディエンスとしてsts.amazonaws.comを設定することで行う。これにより、AWSはGitHubから発行されるOIDCトークンを正しく受け入れ、検証できるようになる。

次に、AWSにおけるIAMロールの「信頼ポリシー」の設定が非常に重要になる。この信頼ポリシーは、「どの条件を満たす場合に、このIAMロールを引き受けることを許可するか」を厳密に定義するものだ。OIDCを使用するシナリオでは、このポリシー内で、GitHubから発行されるOIDCトークンの内容を詳細にチェックし、例えばtoken.actions.githubusercontent.com:aud(トークンの対象がsts.amazonaws.comであること)とtoken.actions.githubusercontent.com:sub(トークンが示す実行元のリポジトリやブランチ、例:repo:YOUR_ORG/YOUR_REPO:ref:refs/heads/mainなど)が、事前に定めた値と完全に一致するというような具体的な条件を指定する。広範なワイルドカード(*)を使う設定は、意図しないリポジトリやブランチからのアクセスを許してしまう可能性があるため、極力避けるべきである。さらに、このIAMロール自体に与えるAWS権限も、デプロイ作業に必要な最小限の権限に絞り込む「最小権限の原則」を徹底することが、セキュリティを確保する上で不可欠である。

GitHub Actions側の設定としては、ワークフローのYAMLファイルに、OIDCトークンを要求するための特定の権限を付与する必要がある。具体的には、ワークフローの定義にpermissions: id-token: writeという行を追加する。これは、ワークフローがOIDCトークンを生成して使用することを許可する設定であり、これだけではAWSへのアクセス権限が与えられるわけではない点に注意が必要だ。実際のAWSへのアクセスは、AWS側で設定されたIAMロールの信頼ポリシーと、そのロールにアタッチされた権限によって制御される。ワークフロー内では、aws-actions/configure-aws-credentials@v4といったアクションを利用して、引き受けるIAMロールのARN(role-to-assume)とAWSリージョン(aws-region)を指定することで、一時的なAWS認証情報を取得し、それを用いてAWSリソースにアクセスできるようになる。

OIDC認証の設定は、慣れていないとエラーに遭遇することもある。もし認証失敗(例えばAccessDeniedエラー)が発生した場合は、いくつかのポイントを確認する必要がある。AWSにGitHub OIDCプロバイダが正しく登録されているか、IAMロールの信頼ポリシーで指定されているオーディエンスやサブジェクト(リポジトリ名やブランチ名など)が、実際にワークフローが実行されているコンテキストと一致しているか、GitHub ActionsのワークフローYAMLにid-token: writeの権限が適切に設定されているか、IAMロールのARNが正しいか、などが主なチェックポイントとなる。

プロダクション環境でOIDCを導入する際には、さらなるセキュリティ対策を講じることが非常に重要だ。IAMの信頼ポリシーを厳しく設定し、許可された特定のGitHubリポジトリやブランチからのアクセスのみを認める。GitHubの「保護されたブランチ」や「デプロイメント環境」機能を活用して、重要な環境への変更プロセスを制限する。IAMロールには必要最小限のAWS権限のみを付与し(最小権限の原則)、開発環境と本番環境のIAMロールは明確に分離するべきだ。また、ワークフローで使用するサードパーティ製のGitHub Actionsは、セキュリティレビュー済みで信頼できるものだけを選定する。AWSのCloudTrailなどのサービスを利用して、IAMロールの引き受け(ロールアサンプション)やAWS APIの活動を継続的に監視することで、不審な挙動を早期に検知できるようにすることも、セキュリティ運用の観点から重要だ。取得した一時的な認証情報であっても、それがワークフローのログに不注意に表示されないよう、ログ設定にも注意を払うべきである。

OIDCは、永続的なAWSアクセスキーを保存する必要性をなくすことで、CI/CDパイプラインのセキュリティを大きく向上させる革新的な技術である。しかし、これだけで全てのセキュリティ問題が解決するわけではない。安全なワークフローコードの記述、IAMロールの適切な設計、そして継続的なセキュリティ監視といった基本的な取り組みが、全体としてのシステムセキュリティを保証する。永続的なアクセスキーを一時的な認証情報に置き換えることは、セキュリティを強化する上で非常に効果的な一歩であり、システムエンジニアを目指す上でぜひ理解しておきたい重要な概念の一つだ。

関連コンテンツ

関連IT用語

関連ITニュース