この記事では、CloudBees CI と Microsoft Entra ID を統合する方法について説明します。 Jenkins ベースの安全でスケーラブルかつ柔軟な CI ソリューションである CloudBees CI で、管理を一元化し、コンプライアンスを確保し、大規模な自動化を実現します。 CloudBees CI を Microsoft Entra ID と統合すると、次のことが可能になります。
- CloudBees CI にアクセスできるユーザーを Microsoft Entra ID で制御する。
- ユーザーが Microsoft Entra アカウントで CloudBees CI に自動的にサインインできるようにする。
- 1 つの中央の場所でアカウントを管理します。
CloudBees CI に対する Microsoft Entra シングル サインオンをテスト環境で構成・テストする。 CloudBees CI は SP 開始のシングル サインオンのみをサポートしています。
[前提条件]
Microsoft Entra ID を CloudBees CI と統合するには、以下が必要です。
- Microsoft Entra ユーザー アカウント。 まだアカウントがない場合は、無料でアカウントを作成することができます。
- 次のいずれかのロール: アプリケーション管理者、クラウドアプリケーション管理者、または アプリケーション所有者。
- Microsoft Entra サブスクリプション。 サブスクリプションがない場合は、無料アカウントを取得できます。
- CloudBees CI でのシングル サインオン (SSO) が有効なサブスクリプション。
アプリケーションを追加してテスト ユーザーを割り当てる
シングル サインオンの構成プロセスを開始する前に、Microsoft Entra ギャラリーから CloudBees CI アプリケーションを追加する必要があります。 アプリケーションに割り当ててシングル サインオン構成をテストするには、テスト ユーザー アカウントが必要です。
Microsoft Entra ギャラリーから CloudBees CI を追加する
Microsoft Entra アプリケーション ギャラリーから CloudBees CI を追加して、CloudBees CI に対するシングル サインオンを構成します。 ギャラリーからアプリケーションを追加する方法の詳細については、「 クイック スタート: ギャラリーからアプリケーションを追加する」を参照してください。
Microsoft Entra テスト ユーザーの作成と割り当て
作成とユーザー アカウントの割り当てに関する記事のガイドラインに従って、B.Simon というテスト ユーザー アカウントを作成します。
または、 エンタープライズ アプリ構成ウィザードを使用することもできます。 このウィザードでは、テナントにアプリケーションを追加し、ユーザー/グループをアプリに追加し、ロールを割り当てることができます。 このウィザードでは、シングル サインオン構成ウィンドウへのリンクも提供されます。 Microsoft 365 ウィザードの詳細を確認してください。.
Microsoft Entra SSO の構成
Microsoft Entra のシングル サインオンを有効にするには、次の手順を実行します。
クラウド アプリケーション管理者以上として Microsoft Entra 管理センターにサインインします。
Entra ID>エンタープライズ アプリ>CloudBees CI>シングルサインオンに移動します。
[シングル サインオン方式の選択] ページで、 [SAML] を選択します。
[ SAML でのシングル サインオンの設定 ] ページで、[ 基本的な SAML 構成 ] の鉛筆アイコンを選択して設定を編集します。
[基本的な SAML 構成] セクションで、次の手順を実行します。
a. [識別子] ボックスに、
<Customer_EntityID>
の形式で値を入力します。b。 [ 応答 URL ] ボックスに、次のいずれかのパターンを使用して URL を入力します。
応答 URL https://<CustomerDomain>/cjoc/securityRealm/finishLogin
https://<CustomerDomain>/<Environment>/securityRealm/finishLogin
https://cjoc.<CustomerDomain>/securityRealm/finishLogin
https://<Environment>.<CustomerDomain>/securityRealm/finishLogin
c. [サインオン URL] ボックスに、次のいずれかのパターンを使用して URL を入力します。
サインオン URL https://<CustomerDomain>/cjoc
https://<CustomerDomain>/<Environment>
https://cjoc.<CustomerDomain>
https://<Environment>.<CustomerDomain>
注
これらの値は実際の値ではありません。 実際の識別子、応答 URL、サインオン URL でこれらの値を更新します。 これらの値を取得するには、CloudBees CI サポート チームにお問い合わせください。 [基本的な SAML 構成] セクションに示されているパターンを参照することもできます。
CloudBees CI アプリケーションでは、特定の形式の SAML アサーションを使用するため、カスタム属性マッピングを SAML トークン属性の構成に追加する必要があります。 次のスクリーンショットは、既定の属性の一覧を示しています。
その他に、CloudBees CI アプリケーションでは、いくつかの属性が SAML 応答で返されることが想定されています。それらの属性を次に示します。 これらの属性も事前に設定されていますが、要件に従って確認できます。
名前 ソース属性 Eメール ユーザーのメールアドレス ユーザー名 user.userprincipalname displayName User.givenname groups ユーザー.グループ [ SAML でのシングル サインオンのセットアップ ] ページの [ SAML 署名証明書 ] セクションで、 フェデレーション メタデータ XML を探し、[ ダウンロード ] を選択して証明書をダウンロードし、コンピューターに保存します。
[CloudBees CI のセットアップ] セクションで、要件に基づいて適切な URL をコピーします。
CloudBees CI SSO を構成する
CloudBees CI でシングル サインオンを構成するには、「フェデレーション メタデータ XML とコピーした URL を使用して Azure を構成する」に従ってください。
SSO のテスト
このセクションでは、次のオプションを使用して Microsoft Entra のシングル サインオン構成をテストします。
[ このアプリケーションをテストする] を選択すると、このオプションはログイン フローを開始できる CloudBees CI サインオン URL にリダイレクトされます。
CloudBees CI のサインオン URL に直接移動し、そこからログイン フローを開始します。
Microsoft マイ アプリを使用できます。 マイ アプリで CloudBees CI タイルを選択すると、このオプションは CloudBees CI のサインオン URL にリダイレクトされます。 詳細については、「 Microsoft Entra My Apps」を参照してください。
その他のリソース
関連コンテンツ
CloudBees CI を構成したら、組織の機密データを流出と侵入からリアルタイムで保護するセッション制御を適用することができます。 セッション制御は条件付きアクセスから拡張されます。 Microsoft Cloud App Security でセッション制御を適用する方法について説明します。