AWS での OIDC
- はじめに
- 1行でのセットアップ(サイズラベル)
- 移行できるジョブ
- フォールバックとロールバック
- ビルドキャッシュ(Nx / Turborepo)
- AWS での OIDC
- Google Cloud での OIDC
- ご自身のボックスで始める
- GitLab (ベータ版)
- Claude を接続(MCP)
- 課金
- 利用状況の分析とデータ
- コードレビューとインサイトのデータ処理者
- ヘルプ
OIDCを使うと、GitHubにアクセスキーを保存することなく、ジョブが短期間有効なAWS認証情報を取得できます。各実行時にGitHubが署名付きトークンを発行し、AWSがそのトークンを一時的な認証情報と交換します。トークンの仕組みはGitHub Actionsの標準的なものです。そのため、以下のワークフローはcompiler.devのruns-onラベルを使う一般的な構成になります。詳しい手順はGitHub Actions OIDCからAWSへの接続をご覧ください。
1. IAMにGitHubをIDプロバイダーとして追加します。 プロバイダーURLはhttps://token.actions.githubusercontent.com、オーディエンスはsts.amazonaws.comに設定します。
2. 次のトラストポリシーでロールを作成します。 111122223333、ORG、REPOを置き換えてください。他のリポジトリやブランチからのアクセスを防ぐのがsub条件の役割ですので、必ず設定してください。
{
"Version": "2012-10-17",
"Statement": [{
"Effect": "Allow",
"Principal": { "Federated": "arn:aws:iam::111122223333:oidc-provider/token.actions.githubusercontent.com" },
"Action": "sts:AssumeRoleWithWebIdentity",
"Condition": {
"StringEquals": {
"token.actions.githubusercontent.com:aud": "sts.amazonaws.com",
"token.actions.githubusercontent.com:sub": "repo:ORG/REPO:ref:refs/heads/main"
}
}
}]
}
3. ワークフローでロールを使用します。 ジョブにはid-token: writeが必要です。
permissions:
id-token: write
contents: read
jobs:
deploy:
runs-on: compiler-8cpu
steps:
- uses: actions/checkout@v4
- uses: aws-actions/configure-aws-credentials@v4
with:
role-to-assume: arn:aws:iam::111122223333:role/github-deploy
aws-region: eu-west-2
- run: aws sts get-caller-identity
- ロールを引き受けられる実行: 特定のブランチには
repo:ORG/REPO:ref:refs/heads/main、GitHubのenvironmentにはrepo:ORG/REPO:environment:production、リポジトリ全体にはStringLikeとrepo:ORG/REPO:*を使用します。 - フォークからのプルリクエストには、他のランナーと同様にトークンが発行されません。
- ポリシーはお客様が管理します: compiler.devがお客様のAWSロールを参照または変更することはありません。ジョブがロールを引き受けられない場合、エラーはAWSから返されます。まずトラストポリシーを確認してください。