Entra ID を使用した認証とプロビジョニングの構成

Microsoft Entra ID (旧称 Azure AD) のテナントを ID プロバイダー (IdP) として使用して、お使いの GitHub Enterprise Server インスタンスの認証とユーザープロビジョニングを一元管理できます。

この機能を使用できるユーザーについて

Site administrators with admin access to the IdP

この記事の内容

Note

現在、GitHub Enterprise Server の SCIM はベータ段階であり、変更される可能性があります。 GitHub では、最初にステージングインスタンスを使用したテストをお勧めします。「ステージングインスタンスのセットアップ」をご覧ください。

Entra ID を使用した認証とユーザープロビジョニングについて

Entra ID は、ユーザアカウントと Web アプリケーションへのアクセスを一元管理できる Microsoft のサービスです。詳細については、Microsoft Docs の「Microsoft Entra ID とは」を参照してください。

GitHub Enterprise Server で IAM に IdP を使う場合、リポジトリ、issue、pull request などのエンタープライズリソースへのアクセスは、SAML SSO によって制御やセキュリティ保護が行われます。 IdP に変更を加えると、ユーザーアカウントの作成とエンタープライズへのアクセスの管理は SCIM によって自動的に行われます。また、GitHub 上のチームを IdP 上のグループと同期することもできます。

詳しくは、「Configuring authentication and provisioning with Entra ID」をご覧ください。

前提条件

GitHub Enterprise Server で SCIM を使用するための一般的な前提条件が適用されます。「Configuring authentication and provisioning with Entra ID」の「前提条件」セクションをご覧ください。

さらに:

SCIM を構成するには、「Configuring authentication and provisioning with Entra ID」のステップ 1 から 4 を完了している必要があります。
- セットアップユーザーが Entra ID からの要求を認証するために作成された personal access token (classic) が必要です。
Entra ID を使用して GitHub Enterprise Server の認証とユーザープロビジョニングを設定するには、Entra ID アカウントとテナントが必要です。詳細については、Entra ID の Web サイトと Microsoft Docs の「クイックスタート: テナントを設定する」を参照してください。

1. SAML を構成する

Note

Entra ID で SAML を以前に構成した場合でも、SCIM プロビジョニングを有効にするには、新しいアプリケーション で SAML と SCIM を構成する必要があります。

このセクションを始める前に、「Configuring authentication and provisioning with Entra ID」のステップ 1 と 2 が済んでいることを確認します。

Entra ID では

Entra ID で "GitHub Enterprise Server" アプリケーションを作成します。手順については、Microsoft のガイド「チュートリアル: Microsoft Entra SSO と GitHub Enterprise サーバーの統合」の「ギャラリーからの GitHub Enterprise Server の追加」セクションを参照してください。

Note

"(Legacy)" というラベルの付いたアプリケーションを 使用しないでください。
"GitHub Enterprise Server" アプリケーション設定で、左側のサイドバーの [シングルサインオン] をクリックし、[SAML] をクリックします。
[基本的な SAML 構成] セクションで、[編集] をクリックし、次の詳細を追加します。
- "識別子": GitHub Enterprise Server ホスト URL (https://HOSTNAME.com)
- "応答 URL": ホスト URL の後に /saml/consume (https://HOSTNAME.com/saml/consume) が続きます
[SAML 認定資格証] セクションで、SAML 認定資格証 (Base64) をダウンロードします。
[GitHub Enterprise Serverの設定] セクションで、ログイン URL と Microsoft Entra 識別子を書き留めます。

GitHub Enterprise Server において

管理コンソールにアクセスできるユーザーとしてお使いの GitHub Enterprise Server インスタンスにサインインします。
収集した情報を使用して SAML を構成します。「Enterprise 向けの SAML シングルサインオンを設定する」をご覧ください。

2. SCIMを構成する

このセクションを始める前に、「Configuring authentication and provisioning with Entra ID」のステップ 1 から 4 が済んでいることを確認します。

Entra ID の "GitHub Enterprise Server" アプリケーションで、左側のサイドバーの [プロビジョニング] をクリックし、 [開始] をクリックします。
[自動] プロビジョニングモードを選択します。
[管理者認証情報] セクションで、次の詳細を追加します。
- "テナント URL": GitHub Enterprise Server ホスト URL の後に、/api/v3/scim/v2 (https://HOSTNAME.com/api/v3/scim/v2) が続きます。
- "シークレットトークン": セットアップユーザー用に作成された personal access token (classic)
[接続テスト] をクリックします。
テストが完了したら、[保存] をクリックします。

SCIM の構成が完了したら、構成プロセスで有効にしたいくつかの SAML 設定を無効にすることができます。「Configuring authentication and provisioning with Entra ID」をご覧ください。