メインコンテンツまでスキップ

AWS向けOIDC

OpenID Connect(OIDC)を使用すると、Bitrise は有効期間の長いアクセスキーなしで、誰がリクエストを行っているかを AWS に証明できます。Bitrise はビルドまたはセッションを記述する ID トークンを発行し、AWS はそれを、AWS スコープの権限を持つ AWS Identity and Access Management(IAM)ロールの一時的な認証情報と交換します。

OIDC トークンは、次の 2 か所で AWS に使用できます。

OIDC トークンを AWS に使用するには、次の作業が必要です。

  • AWS アカウントで IAM OIDC プロバイダーを作成します。
  • カスタム信頼ポリシーを追加します: ID トークンのルールを記述します。

IAM OIDC プロバイダーは、ビルドとセッションで共通です。サブジェクトが異なるため、信頼ポリシーは異なります。

IAMにOIDC IDプロバイダーを追加するClick to copy link​

AWSアカウントにIAM OIDCプロバイダーをセットアップします。

AWS ユーザーガイド

IAM OIDCプロバイダーの詳細については、公式AWSユーザーガイドをご覧ください。

  1. AWSアカウントにLog inします。

  2. IAMに移動します。

  3. 左側でAccess Managementを見つけ、Identity providersを選択します。

  4. Add Providerをクリックします。

  5. OpenID Connectを選択します。

  6. Provider URLフィールドにhttps://token.builds.bitrise.io.を設定します。

  7. Audienceフィールドにsts.amazonaws.comを設定します。

  8. Add providerをクリックします。

    2025-11-11-aws-iam-provider.png

  9. Identity providersページで、新しく作成したIDプロバイダーを選択し、ARNをコピーします。

    ARNは次のようになります:arn:aws:iam::ACCOUNT_NUMBER:oidc-provider/token.builds.bitrise.io。

カスタム信頼ポリシーの追加Click to copy link​

AWS IAM でカスタム信頼ポリシーを追加して、Bitrise ID トークンのルールを記述します。

AWS ドキュメント

このガイドは、Bitrise ビルド用の AWS ポリシーの設定に役立ちます。信頼ポリシーの詳細については、AWS のドキュメント Create a role using custom trust policies を参照してください。

  1. AWS アカウントにログインします。

  2. IAM に移動します。

  3. 左側で Access Management を見つけ、Roles を選択します。

  4. Create role をクリックします。

    2025-11-11-aws-roles.png

  5. Custom trust policy を選択します。

    2025-11-11-custom-trust-policy.png

  6. カスタム信頼ポリシーエディターでステートメントを作成して、OIDC トークンのルールを設定します。

    ポリシーの作成

    ポリシーの作成方法の詳細については、AWS のドキュメント Creating IAM policies を参照してください。

    • Principal を追加します: タイプはフェデレーションユーザーセッションとし、先ほど作成した ARN を指定します。次の例の Federated を参照してください。

    • sts:AssumeRoleWithWebIdentity 値を持つ Action を追加します。

    • Conditions で、ID トークン内のクレームと照合します。

      制限事項

      Bitrise は汎用の ID プロバイダーと見なされるため、AWS はトークンから aud と sub の 2 つのクレームのみを保持します。ポリシーで使用できるのは、この 2 つだけです。

      クレームフィールドの詳細については、AWS のドキュメントを参照してください。

      次の例では、オーディエンス、Bitrise project スラッグ、および Workflow 名を確認します。

    {
    "Version": "2012-10-17",
    "Statement": [
    {
    "Effect": "Allow",
    "Principal": {
    "Federated": "arn:aws:iam::ACCOUNT_NUMBER:oidc-provider/token.builds.bitrise.io"
    },
    "Action": "sts:AssumeRoleWithWebIdentity",
    "Condition": {
    "StringEquals": {
    "token.builds.bitrise.io:aud": "sts.amazonaws.com",
    "token.builds.bitrise.io:sub": "app:APP_SLUG:workflow:run-tests"
    }
    }
    }
    ]
    }

    StringEquals の代わりに StringLike 演算でワイルドカードを使用することもできます: Wildcard matching。

    Remote Dev Environment セッション

    Remote Dev Environment セッションからリクエストされたトークンは、rde: で始まる別のサブジェクトを使用するため、専用の信頼ポリシーが必要です。OIDC でのクラウド認証を参照してください。

  7. 完了したら、Next をクリックします。

  8. ロールに必要な権限を選択します。

    必要な権限は、AWS でアクセスしようとしているサービスによって異なります。たとえば、ビルド中に S3 バケットにファイルをアップロードするには、AmazonS3FullAccess を選択します。

    カスタムアクセスポリシー

    AWS で独自のカスタムポリシーを作成して、必要な権限を正確に設定することもできます。

  9. 完了したら、Next をクリックします。

  10. ロールに名前を付け、必要に応じて説明を追加します。

  11. 完了したら、Create a role をクリックします。

トークンの取得と交換Click to copy link​

AWSでOIDC IDプロバイダーとカスタム信頼ポリシーの設定が完了すると、Bitriseビルドは選択したサービスとトークンを交換できるようになります。次の方法があります:

  • Authenticate with AWS Stepを使用して、プロセス全体を処理します。
  • Get OIDC Identity Token Stepでトークンを取得し、スクリプトで認証情報の交換を行います。
OIDCトークンの情報

BitriseはOIDCトークンに次のクレームを含めます:OIDCトークンの情報。

Authenticate with AWS Stepを使用するClick to copy link​

Authenticate with AWS StepはOIDCトークンをリクエストし、AWSとの認証情報の交換を行います。つまり、認証を行うための独自のスクリプトを作成する必要はなく、Stepが代わりに処理します。

  1. BitriseでWorkflow Editorを開きます。

  2. Authenticate with AWS StepをWorkflowに追加します。

  3. Token audience入力をsts.amazonaws.comに設定します。

  4. AWS Role ARNに、先ほど作成したIAMロールARNの値を設定します。

    Docker ログイン

    Stepのもう一つの便利な機能として、DockerをEC2 Container Registryに自動的にログインさせることができます。Stepの設定でDocker入力グループを見つけ、trueに設定します。

    これはLinux stacksでのみサポートされています。

Get OIDC Identity Token Stepを使用するClick to copy link​

  1. BitriseでWorkflow Editorを開きます。

  2. Get OIDC Identity Token StepをWorkflowに追加します。

  3. Token audience入力をsts.amazonaws.comに設定します。

  4. BITRISE_IDENTITY_TOKEN環境変数を使用します。これは任意のCLIツールやAPIエンドポイントに渡すことができます。

    トークンの交換を行い、レスポンスから認証情報を抽出するスクリプトを、Script Step内に作成できます。認証情報として3つの環境変数が必要です:

    • AWS_ACCESS_KEY_ID
    • AWS_SECRET_ACCESS_KEY
    • AWS_SESSION_TOKEN

    これらがエクスポートされると、AWS CLIが自動的にそれらを取得して使用します。CLIを介したあらゆる操作が問題なく動作します。

    たとえば、AWS CLIを使用して短期認証情報を取得し、現在認証されているセッションの詳細を出力する場合は、次のようになります:

    # Perform the token exchange and save the response
    AWS_RESPONSE=$(aws sts assume-role-with-web-identity \
    --role-arn "arn:aws:iam::065600603509:role/OIDC-TEST" \
    --role-session-name "bitrise-${BITRISE_BUILD_NUMBER}" \
    --web-identity-token "$BITRISE_IDENTITY_TOKEN" \
    --output json)

    # Extract the credentials from the reponse
    export AWS_ACCESS_KEY_ID=$(echo "$AWS_RESPONSE" | jq -r '.Credentials.AccessKeyId')
    export AWS_SECRET_ACCESS_KEY=$(echo "$AWS_RESPONSE" | jq -r '.Credentials.SecretAccessKey')
    export AWS_SESSION_TOKEN=$(echo "$AWS_RESPONSE" | jq -r '.Credentials.SessionToken')

    # The AWS cli will automatically pick up the env vars from the section above
    aws sts get-caller-identity