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

OIDC認証の概要

OpenID Connect(OIDC)は、OAuth 2.0 フレームワークの上に構築された ID 認証レイヤーです。サードパーティのアプリケーションがエンドユーザーの ID を検証できるようにし、アプリケーション間での Single Sign-On の利用も可能にします。

OIDC は、認証操作の結果とユーザーの ID に関する情報を提供する ID トークン(通常は JSON Web Token または JWT)を発行することで機能します。認証結果に関するデータとユーザー情報は、クレームと呼ばれます。

トークンを受け取るサービスは、そのトークンのクレームを自身の OIDC ポリシーと照合して評価します。トークンのクレームがポリシーに一致する場合はリクエストが許可され、一致しない場合は拒否されます。

Bitrise は、次の 2 つの方法で OIDC トークンの利用をサポートしています。

  • Bitrise ビルドと Remote Dev Environment セッションが、AWS、GCP、Azure、コンテナレジストリ、シークレット管理、アーティファクトストアなどの外部システムに対して認証できるようにします。
  • 外部の OIDC トークンを使用して Bitrise に対して認証し、有効期間の短い Bitrise トークンを受け取ります。

OIDCを使った外部サービスへの認証Click to copy link​

OIDCを使用すると、Workflowsに長期間有効な認証情報を埋め込むことなく、ビルドがAWS、GCP、Azure、コンテナレジストリ、シークレット管理、アーティファクトストアなどの外部システムに対して認証できます。Bitriseは、ビルド番号、コミットハッシュ、リポジトリスラッグ、アプリスラッグ、Workflow名などのクレームを含む、特定のビルドに紐づいた1つ以上のIDトークンを発行できます。

これらのトークンには、次の特徴があります。

  • 特定のビルドのやり取りに対して発行されるため、サードパーティのサービスはその実行のみに限定したアクセス権を付与できます。
  • 有効期間が短いため、万が一漏えいした場合の影響を最小限に抑えられます。
  • OIDCを受け入れるフェデレーションサービスで利用できます。たとえば、BitriseのOIDCトークンを一時的なクラウド認証情報と交換できます。

ビルド用のIDトークンをリクエストするClick to copy link​

BitriseのビルドからOIDCトークンを使ってサービスに対して認証を行うには、トークンを取得したうえで、そのサービスとの認証情報交換を実行する必要があります。Bitriseでは、この処理の一部を担うStepsを提供しています。

Get OIDC Identity Token StepClick to copy link​

ビルド内で任意のサービスに対してOIDCトークンを使用するには、Get OIDC Identity Token Stepを使用します。このStepにより、WorkflowsやPipelinesは、リポジトリやビルド設定にシークレットを保存することなく、実行時にクラウドリソースや外部サービスへの一時的で監査可能なアクセスをリクエストできます。

Token audienceインプットを設定して、Stepを構成します。これは、トークンでアクセスしたいサービスのURLか、そのサービスが提供する特定の識別子です。

2025-11-12-get-oidc-token-step.png

Stepは、トークンの関連情報を含む環境変数を、キーBITRISE_IDENTITY_TOKENでエクスポートします。アクセスしたいサービスとの認証情報交換にはこれを使用してください。

特定のサービス向けの専用StepsClick to copy link​

Get OIDC Identity Token Stepを使用すると、任意のサービス向けにOIDCトークンを取得できますが、認証情報の交換までは行いません。一部のサービスについては、この処理全体を担うStepsを用意しています。

  • Authenticate with Google Cloud Platform (GCP):サービスアカウントキーを使用してGoogle認証トークンを生成し、GCPに対して認証を行います。
  • Authenticate with Amazon Web Services (AWS):AWS IAM IDプロバイダーに基づいてIDトークンを生成します。詳細ガイドはこちら:OIDC(AWS向け)をご覧ください。

OIDCトークンに含まれる情報Click to copy link​

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

制限事項

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

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

NameDescription
audカスタマイズ可能なオーディエンスフィールド
subIDトークンの作成をトリガーしたサブジェクト。app:APP_SLUG:workflow:WORKFLOW形式になります。
expトークンの有効期限
iatトークンの生成日時
issトークンの発行者
jtiトークンの一意の識別子
nbf現在時刻
shaGitのコミットハッシュ
repository_urlアプリに関連付けられたGitリポジトリのURL
repository_ownerGitリポジトリの所有者
repository_slugGitリポジトリのスラッグ
app_slugアプリのスラッグ
workspace_slugWorkspaceのスラッグ
trigger_byビルドをトリガーしたエンティティ
branchビルド対象のブランチ
branch_destPRのターゲットブランチ
tagビルドをトリガーしたタグ
build_numberビルド番号
workflowトリガーされたWorkflow名

Remote Dev Environment の ID トークンClick to copy link​

Remote Dev Environment セッションは、ビルドと同じ方法で ID トークンをリクエストできます。トークンは同じ発行者から同じ署名鍵で発行されるため、ビルドですでに Bitrise を信頼しているクラウドプロバイダーは、セッションでも信頼します。サブジェクトは、ビルドではなくセッションを表します。

rde:workspace:WORKSPACE_ID:template:TEMPLATE_ID:session-owner:OWNER_TYPE:OWNER_ID

サブジェクトは rde: で始まるため、ビルド用に記述した信頼ポリシーはセッションには一致せず、その逆も同様です。クレームの完全な一覧とセッションからトークンをリクエストする方法については、OIDC でのクラウド認証を参照してください。

OIDCを使ったBitriseへの認証Click to copy link​

Bitriseでは、外部のOIDCトークンを使用してBitriseに対して認証を行い、短期間有効なBitriseのworkspaceアクセストークンを受け取ることができます。発行されたトークンは、Bitriseの信頼ポリシーと照合されます。

Bitriseトークンを受け取ったサービスは、実質的にworkspaceの一時的なメンバーとなり、信頼ポリシーで定義された特定の操作を実行できるようになります。たとえば、特定のリポジトリの特定のブランチでトリガーされたビルドからデータを受け取ることができます。

信頼ポリシーClick to copy link​

OIDCの信頼ポリシーでは、誰を信頼するか、どのような条件で信頼するか、OIDCトークンをどのように検証するかを定義します。Bitriseの信頼ポリシーでは、次の項目を定義します。

  • Bitriseが信頼するOIDCの発行者。信頼ポリシーで発行者として登録されていないOIDCプロバイダーからのクレームは自動的に拒否されます。
  • 短期間有効なトークンの有効期間:どのくらいの期間有効かを定義します。
  • アクセスレベル:workspacesやプロジェクトで付与されるロールと権限を定義します。
  • トークンのマッチングルール:一致させる必要があるクレームを定義します。たとえば、クレームにはリポジトリ、リポジトリのブランチ、トリガーされるべきWorkflowなどを含めることができます。マッチングルールはJSON形式で記述します。

OIDCトークンのリクエストClick to copy link​

ポリシーの作成に成功すると、Bitriseは一意のポリシーIDを自動的に生成します。このポリシーIDは、すべてのトークンリクエストに含める必要があります。

サービスが短期間有効なBitrise workspaceアクセストークンをリクエストするためにOIDCトークンを送信すると、Bitriseはリクエスト内のポリシーIDを対応する信頼ポリシーと照合し、その信頼ポリシーのマッチングルールを確認します。ルールがOIDCトークンのクレームと一致する場合、短期間有効なトークンが発行されます。