外部サービスとの接続
このセクションでは、GitHub Actionsから、AWSなどの外部サービスと接続する方法について説明します。
1. ベーシック認証

ベーシック認証は、外部サービスが発行する ID やパスワード、あるいはアクセスキーなどの固定された認証情報を直接送信して接続する、最もシンプルな認証方式です。仕組みは非常に直感的で、発行された資格情報をそのまま使って外部サービスにアクセスします。
1.1 ベーシック認証の特徴
まず、ベーシック認証で使用する資格情報には、パスワードやアクセスキーといった種類があります。これらは外部サービスが発行し、認証の際に利用します。
GitHub Actions では、こうした認証情報は Secrets に登録して管理します。Secrets に登録することで、パスワードやアクセスキーを安全に保持でき、ログなどにも値が表示されない仕組みになっています。
一方で、ベーシック認証には流出のリスクがあります。認証文字列が一度でも漏れてしまうと、本人になりすまして外部サービスにそのままアクセスされてしまう危険があります。このため、認証情報の取り扱いには細心の注意が必要です。
1.2 AWSを使ったベーシック認証の例
AWS を例にとると、まず開発者が IAMユーザに対してAWS のアクセスキーを発行します。次に、そのアクセスキーを GitHub の Secrets に登録します。そして、GitHub Actions 内で AWS CLI を使い、登録されたアクセスキーをもとに AWS へアクセスする、という流れになります。
steps:
- name: AWS認証(ベーシック認証)
uses: aws-actions/configure-aws-credentials@v5
with:
aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
aws-region: ap-northeast-1
この例では、Secretsに登録したアクセスキーを使ってAWSに接続しています。
このように、ベーシック認証は仕組みがシンプルな分、扱いやすさとリスクが表裏一体になっています。正しく管理すれば便利に利用できますが、運用には注意が欠かせない認証方式です。
2. OIDCプロバイダ

OIDCプロバイダ(OpenID Connect Provider)を利用すると、GitHub が発行する ID トークンを外部サービス側で検証し、許可されたリポジトリやブランチからのアクセスだけを認証できるようになります。固定された資格情報を使わずに、安全にアクセス権を管理できる仕組みです。
2.1 OIDC認証の流れ
まず、GitHub Actions が外部サービスへ接続する際、GitHub は ID トークンを生成します。このトークンには、実行したアカウント、リポジトリ、ブランチなどの情報が含まれており、署名と発行元によって正当性が保証されています。
外部サービスは、この ID トークンを検証することで、「どのリポジトリから実行されたワークフローなのか」「どのブランチからの実行なのか」といった情報を正しく判断できます。そして、事前に許可しているリポジトリやブランチに一致する場合のみ、アクセスを許可します。これにより、不正なトークンを使ったアクセスや、未許可のブランチからの接続を防ぐことができます。
2.2 OIDCプロバイダの特徴
OIDC を利用する大きな特徴は、固定の資格情報、つまりアクセスキーのような長期間利用される認証情報が不要になることです。ID トークンは短い有効期限を持っており、毎回新しいものが発行されるため、セキュリティリスクが大きく減ります。また、どのリポジトリやブランチから実行されたかを外部サービス側で正確に判断できるため、アクセス制御も柔軟に行えます。
2.3 OIDCプロバイダの注意点
一方で注意点もあります。外部サービス側が OIDC に対応している必要があります。現時点では対応していないサービスも多いため、利用前に確認が必要です。また、GitHub Actions を経由した場合にのみトークンが信頼されるため、ローカル環境などから同じ方法では接続できません。この動作は、不正アクセスを防ぐための仕組みでもあります。
AWSとのOIDC連携の場合、ワークフローでは以下のように記述します。
permissions:
id-token: write
contents: read
steps:
- name: AWS認証(OIDC)
uses: aws-actions/configure-aws-credentials@v5
with:
role-to-assume: arn:aws:iam::123456789012:role/github-actions-role
aws-region: ap-northeast-1
ベーシック認証と異なり、アクセスキーを指定する必要がなく、role-to-assume でAWS側に作成したIAMロールを指定するだけで接続できます。permissions に id-token: write を設定することで、GitHub ActionsがIDトークンを発行できるようになります。
OIDC を利用することで、固定された秘密情報を扱わずに安全に認証でき、より細かいアクセス制御が可能になります。特にクラウドサービスとの連携では、現代的で安全な方法として広く採用されつつある仕組みです。
GitHub ActionsからAWSへOIDCで接続する仕組みは、OIDC federation(AWS公式ドキュメント)でも解説されています。原文(英語表示時)には以下のような記述があります。
OIDC federation is a method for applications to request temporary AWS security credentials dynamically without the need to store long-term AWS credentials.
「アプリケーションがAWSの長期クレデンシャルを保存せずに、一時的なAWSセキュリティクレデンシャルを動的に要求するための仕組みである」と読み取れます。GitHub Actions側の発行・受け渡しの仕様については、GitHub公式ドキュメントのAbout security hardening with OpenID Connectに記載があります。なお、AWSドキュメントは画面右上の言語セレクタから日本語表示に切り替えられます。