次の方法で共有

Microsoft Entra ID でシングル サインオン用に GitHub Enterprise Server を構成する

この記事では、GitHub Enterprise Server と Microsoft Entra ID を統合する方法について説明します。 GitHub Enterprise Server と Microsoft Entra ID を統合すると、次のことができます。

  • GitHub Enterprise Server にアクセスできる Microsoft Entra ID を制御します。
  • ユーザーが自分の Microsoft Entra アカウントを使用して GitHub Enterprise Server に自動的にサインインできるようにします。
  • 1 つの中央の場所でアカウントを管理します。

[前提条件]

開始するには、次のものが必要です。

  • Microsoft Entra サブスクリプション。 サブスクリプションがない場合は、無料アカウントを取得できます。
  • 初期化の準備ができている GitHub Enterprise Server。
  • クラウド アプリケーション管理者と共に、アプリケーション管理者も、Microsoft Entra ID でアプリケーションを追加または管理することができます。 詳細については、Azure の組み込みロールに関するページを参照してください。

シナリオの説明

この記事では、テスト環境で Microsoft Entra SSO を構成してテストします。

Microsoft Entra ID への GitHub Enterprise Server の統合を構成するには、ギャラリーから管理対象 SaaS アプリの一覧に GitHub Enterprise Server を追加する必要があります。

  1. クラウド アプリケーション管理者以上として Microsoft Entra 管理センターにサインインします。
  2. Entra ID>のEnterprise apps>に移動し、新しいアプリケーションを選択します。
  3. [ギャラリーからの追加] セクションで、検索ボックスに「GitHub Enterprise Server」と入力します。
  4. 結果パネルから GitHub Enterprise Server を 選択し、アプリを追加します。 お使いのテナントにアプリが追加されるのを数秒待機します。

または、 エンタープライズ アプリ構成ウィザードを使用することもできます。 このウィザードでは、テナントにアプリケーションを追加したり、ユーザー/グループをアプリに追加したり、ロールを割り当てたり、SSO 構成を確認したりできます。 Microsoft 365 ウィザードの詳細を確認します。

GitHub Enterprise Server の Microsoft Entra SSO の構成とテスト

B.Simon というテスト ユーザーを使用して、GitHub Enterprise Server に対する Microsoft Entra SSO を構成してテストします。 SSO を機能させるには、Microsoft Entra ユーザーと GitHub Enterprise Server の関連ユーザーとの間にリンク関係を確立する必要があります。

GitHub Enterprise Server に対して Microsoft Entra SSO を構成してテストするには、次の手順に従います。

  1. Microsoft Entra SSO を構成する - ユーザーがこの機能を使用できるようにします。
    1. Microsoft Entra テスト ユーザーの作成 - B.Simon で Microsoft Entra のシングル サインオンをテストします。
    2. Microsoft Entra テスト ユーザーを割り当てる - B.Simon が Microsoft Entra シングル サインオンを使用できるようにします。
  2. GitHub Enterprise Server の SSO を構成 する - アプリケーション側でシングル サインオン設定を構成します。
    1. GitHub Enterprise Server のテスト ユーザーの作成 - GitHub Enterprise Server で B.Simon に対応するユーザーを作成し、Microsoft Entra の B.Simon にリンクさせます。
  3. SSO のテスト - 構成が機能するかどうかを確認します。

Microsoft Entra SSO の構成

Microsoft Entra SSO を有効にするには、次の手順に従います。

  1. クラウド アプリケーション管理者以上として Microsoft Entra 管理センターにサインインします。

  2. Entra ID>Enterprise アプリ>GitHub Enterprise Server>Single サインオンに移動します。

  3. [シングル サインオン方式の選択] ページで、 [SAML] を選択します。

  4. [ SAML でのシングル サインオンの設定 ] ページで、[ 基本的な SAML 構成 ] の鉛筆アイコンを選択して設定を編集します。

    [基本的な SAML 構成] を編集する方法を示すスクリーンショット。

  5. [ 基本的な SAML 構成] セクションで、 IDP 開始モードでアプリケーションを構成する場合は、次の手順を実行します。

    a. [ 識別子 (エンティティ ID)] テキスト ボックスに、次のパターンを使用して URL を入力します。 https://<YOUR-GITHUB-ENTERPRISE-SERVER-HOSTNAME>

    b。 [ 応答 URL ] テキスト ボックスに、次のパターンを使用して URL を入力します。 https://<YOUR-GITHUB-ENTERPRISE-SERVER-HOSTNAME>/saml/consume

  6. SP 開始モードでアプリケーションを構成する場合は、[追加の URL の設定] を選択し、次の手順を実行します。

    [ サインオン URL ] テキスト ボックスに、次のパターンを使用して URL を入力します。 https://<YOUR-GITHUB-ENTERPRISE-SERVER-HOSTNAME>/sso

    注

    これらの値は実際の値ではありません。 実際の識別子、応答 URL、サインオン URL でこれらの値を更新します。 これらの値を取得するには 、GitHub Enterprise Server クライアント サポート チーム に問い合わせてください。 「 基本的な SAML 構成 」セクションに示されているパターンを参照することもできます。

  7. GitHub Enterprise Server アプリケーションでは、特定の形式の SAML アサーションを使用するため、カスタム属性マッピングを SAML トークン属性の構成に追加する必要があります。 次のスクリーンショットは、既定の属性の一覧を示しています。

    Enterprise Server アプリケーションの画像を示すスクリーンショット。

  8. ユーザー属性と要求を編集します。

  9. [ 新しい要求の追加] を選択し、テキスト ボックスに administrator として名前を入力します ( administrator の値では大文字と小文字が区別されます)。

  10. [要求条件] を展開し、[ユーザーの種類] から [メンバー] を選択します。

  11. [ グループの選択] を選択 し、この要求を含める グループ を検索します。このグループのメンバーは GHES の管理者である必要があります。

  12. [ソース] の [属性] を選択し、[値] に「true (引用符なし)」と入力します。

  13. 保存 を選択します。

    属性の要求を管理するスクリーンショット。

  14. [ SAML でのシングル サインオンの設定 ] ページの [ SAML 署名証明書 ] セクションで、 証明書 (Base64) を探し、[ ダウンロード ] を選択して証明書をダウンロードし、コンピューターに保存します。

    [証明書のダウンロード] リンクを示すスクリーンショット。

  15. [ GitHub Enterprise Server のセットアップ ] セクションで、要件に基づいて適切な URL をコピーします。

    適切な構成 U R L をコピーするスクリーンショット。

Microsoft Entra テスト ユーザーの作成と割り当て

ユーザー アカウントの作成と割り当ての クイックスタートのガイドラインに従って、B.Simon というテスト ユーザー アカウントを作成します。

GitHub Enterprise Server SSO の構成

GitHub Enterprise Server 側で SSO を構成するには、 ここで説明する手順に従う必要があります。

GitHub Enterprise Server のテスト ユーザーの作成

このセクションでは、B.Simon というユーザーを GitHub Enterprise Server に作成します。 GitHub Enterprise Server では、Just-In-Time ユーザー プロビジョニングがサポートされています。この設定は既定で有効になっています。 このセクションにはアクション項目はありません。 GitHub Enterprise Server にユーザーがまだ存在していない場合は、認証後に新しく作成されます。

GitHub Enterprise Server では、自動ユーザー プロビジョニングもサポートされています。 自動ユーザー プロビジョニングを構成する方法の詳細 については、こちらをご覧ください 。

SSO のテスト

このセクションでは、次のオプションを使用して Microsoft Entra のシングル サインオン構成をテストします。

SP Initiated:

  • [ このアプリケーションをテストする] を選択すると、このオプションはログイン フローを開始できる GitHub Enterprise Server のサインオン URL にリダイレクトされます。

  • GitHub Enterprise Server のサインオン URL に直接移動し、そこからログイン フローを開始します。

IDP Initiated:

  • [ このアプリケーションをテストする] を選択すると、SSO を設定した GitHub Enterprise Server に自動的にサインインします。

Microsoft マイ アプリを使用して、任意のモードでアプリケーションをテストすることもできます。 マイ アプリで [GitHub Enterprise Server] タイルを選択すると、SP モードで構成されている場合は、ログイン フローを開始するためのアプリケーション サインオン ページにリダイレクトされます。IDP モードで構成されている場合は、SSO を設定した GitHub Enterprise Server に自動的にサインインされます。 詳細については、「 Microsoft Entra My Apps」を参照してください。

関連コンテンツ

  • Last updated on