コンテンツへスキップ

AWS での OIDC

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