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

Bitrise向けOIDC

Open ID Connect (OIDC) 信頼ポリシーを作成し、app.bitrise.ioをオーディエンスとしてOIDCトークンを送信することで、OIDCの認証情報交換を行います。これにより、サードパーティサービスがBitrise workspaceに対して認証を行い、Bitriseリソースにアクセスできるようになります。

OIDCの仕組みについて詳しくは、BitriseへのOIDCを使用した認証をご覧ください。

Bitriseで信頼ポリシーを作成するClick to copy link​

OIDCトークン交換を使用して外部サービスにBitriseリソースへのアクセスを許可するため、OIDC信頼ポリシーを作成します。

  1. BitriseにLog inし、左側のナビゲーションバーにカーソルを合わせます。

  2. Workspaceメニューで、正しいworkspaceが選択されていることを確認します。

  3. Settingsを選択します。

  4. Securityを選択し、OIDC trust policiesタブに移動します。

    2026-03-11-oicd-trust-policies.png

  5. New OIDC policyをクリックします。

  6. policy detailsを入力します。

    • Policy name: ポリシーの識別子です。
    • Issuer (iss): Bitriseが信頼するIDプロバイダーのHTTPS URLです。
    • Session duration: トークンの有効期間です。

    2026-03-11-oicd-new-policy.png

  7. 次のページで、JSON形式でマッチングルールを設定します。

    マッチングルールは、信頼ポリシーに一致させるためにトークン内でBitriseが確認する必要があるクレームを定義します。

    important

    マッチングルールを少なくとも1つ設定する必要があります。subクレームは必須で、トークン交換のトリガーとなったサブジェクトを識別します。

    例えば、リポジトリの特定のブランチに対するマッチングルールを作成し、Workflowを指定できます。

    {
    "sub": "repo:my-org/my-repo:environment:prod",
    "workflow": "CI",
    "ref": "refs/heads/main",
    "repository": "my-account/my-repo"
    }
  8. 次のページで、短命トークン用にworkspaceロールを設定します。

    workspaceロールによってトークンのアクセスレベルが決まります。詳しくは、workspacesのロールと権限をご覧ください。

  9. 次のページで、製品へのアクセスを設定します。すべての製品に対して完全な管理者アクセスを許可するか、Bitrise CIまたはRelease Management、あるいはその両方に対して詳細なアクセスを許可します。

    • Admin accessを選択すると、workspaceが所有するすべてのプロジェクトに対して管理者アクセスを許可します。

    • Bitrise CIを選択し、トークンのプロジェクトまたはRelease Managementアプリとアクセスロールを選択します。プロジェクトごとに異なるアクセスレベルを設定できます。

      詳しくは、Bitrise CIのロールと権限

    • Release Managementを選択し、トークンのRelease Managementアプリとアクセスロールを選択します。Release Managementアプリごとに異なるアクセスレベルを設定できます。

      詳しくは、Release Managementのロールと権限

  10. 準備ができたら、Create policyをクリックします。

トークンリクエストを作成するClick to copy link​

Bitriseで少なくとも1つの信頼ポリシーを作成すると、OIDCトークン交換リクエストを作成してBitriseから短命トークンを受け取れるようになります。

  1. Bitriseへの認証に使用したいサービスからOIDCトークンを取得します。

    トークンの取得方法はサービスによって異なります。例: GitHub Actionsからトークンをリクエストする。

  2. このトークンを使用して、Bitriseへの交換リクエストを行います。

    リクエストにはポリシーIDを含める必要があり、app.bitrise.ioに送信する必要があります。

    curl -i -X POST https://app.bitrise.io/oidc/token \
    -H "Content-Type: application/x-www-form-urlencoded" \
    -d "grant_type=urn:ietf:params:oauth:grant-type:token-exchange" \
    -d "subject_token_type=id_token" \
    -d "policy_id=<POLICY_UUID>" \
    -d "subject_token=<OIDC_TOKEN>"

    リクエストはapplication/jsonとして送信することもできます。

    curl -i -X POST https://app.bitrise.io/oidc/token \
    -H "Content-Type: application/json" \-d
    "{ \"grant_type\": \"urn:ietf:params:oauth:grant-type:token-exchange\",
    \"subject_token_type\": \"id_token\",
    \"subject_token\": <OIDC_TOKEN>,
    \"policy_id\": <POLICY_ID> }"