Azure AD を使用した認証とユーザプロビジョニングについて
Azure Active Directory (Azure AD) は、ユーザアカウントと Web アプリケーションへのアクセスを一元管理できる Microsoft のサービスです。 詳細については、Microsoft Docs の「Azure Active Directory とは」を参照してください。
GitHub Enterprise Server で IAM に IdP を使う場合、リポジトリ、issue、pull request などの Enterprise リソースへのアクセスは、SAML SSO によって制御やセキュリティ保護が行われます。 IdP に変更を加えると、ユーザー アカウントの作成と your GitHub Enterprise Server instance へのアクセスの管理は SCIM によって自動的に行われます。 また、GitHub Enterprise Server 上の team を IdP 上のグループと同期することもできます。 詳細については、次の記事を参照してください。
注: GitHub Enterprise Server の SCIM は現在プライベート ベータ版であり、変更される可能性があります。 ベータ版にアクセスするには、GitHub's Sales team のアカウント マネージャーにお問い合わせください。 GitHub コミュニティ ディスカッションでフィードバックを提供してください。
警告: ベータ版はテストとフィードバック専用であり、サポートは利用できません。 GitHub では、ステージング インスタンスを使用したテストをお勧めします。 詳細については、「ステージング インスタンスのセットアップ」を参照してください。
Azure AD を使って GitHub Enterprise Server に対して SAML SSO と SCIM を有効にした後、Azure AD テナントから以下を実行できます。
- Azure AD の GitHub Enterprise Server アプリケーションをユーザー アカウントに割り当て、GitHub Enterprise Server 上に対応するユーザー アカウントを自動的に作成して、アクセスを許可します。
- Azure AD 上のユーザー アカウントへの GitHub Enterprise Server アプリケーションの割り当てを解除し、GitHub Enterprise Server の対応するユーザー アカウントを非アクティブ化します。
- GitHub Enterprise Server アプリケーションを Azure AD の IdP グループに割り当てて、IdP グループのすべてのメンバーに対する GitHub Enterprise Server 上のユーザー アカウントを自動的に作成して、アクセスを許可します。 さらに、Team とその親 Organization に接続するために、GitHub Enterprise Server で IdP グループを利用できます。
- IdP グループから GitHub Enterprise Server アプリケーションの割り当てを解除すると、その IdP グループを介してのみアクセスしていたすべての IdP ユーザーの GitHub Enterprise Server ユーザー アカウントが非アクティブ化され、親 Organization からユーザーが削除されます。 IdP グループは GitHub Enterprise Server のどの Team からも切断されます
your GitHub Enterprise Server instance での Enterprise の ID とアクセスの管理について詳しくは、「Enterprise の ID とアクセスを管理する」をご覧ください。
前提条件
-
Azure AD を使用して GitHub Enterprise Server の認証とユーザプロビジョニングを設定するには、Azure AD アカウントとテナントが必要です。 詳細については、Azure AD Web サイトおよび Microsoft Docs の「クイックスタート: Azure Active Directory テナントを作成する」を参照してください。
-
your GitHub Enterprise Server instance 用に SAML SSO を構成する必要があります。 詳細については、「エンタープライズ向けの SAML シングル サインオンの構成」を参照してください。
-
IdP で専用のマシン ユーザー アカウントを作成して使用し、GitHub Enterprise Server 上のEnterprise 所有者アカウントに関連付ける必要があります。 このユーザアカウントの認証情報は、パスワードマネージャに安全に保存してください。 詳しくは、「Enterprise 用の SCIM を使用したユーザーのプロビジョニングを構成する」を参照してください。
Azure AD を使用して認証とユーザプロビジョニングを設定する
- your GitHub Enterprise Server instance 用に SAML SSO を構成します。 詳細については、「エンタープライズ向けの SAML シングル サインオンの構成」を参照してください。
- インスタンス用の SCIM を使用したユーザーのプロビジョニングを構成する 詳しくは、「Enterprise 用の SCIM を使用したユーザーのプロビジョニングを構成する」を参照してください。
エンタープライズ所有者の管理
エンタープライズ所有者にユーザーを指定する手順は、SAML だけを使用するか、SCIM も使用するかによって変わります。 Enterprise 所有者の詳細については、「Enterprise におけるロール」を参照してください。
プロビジョニングを構成した場合、GitHub Enterprise Server でユーザーにエンタープライズ所有権を付与するには、Azure AD のユーザーにエンタープライズ所有者ロールを割り当てます。
プロビジョニングを構成しなかった場合は、GitHub Enterprise Server でユーザーにエンタープライズ所有権を付与するには、IdP のユーザー アカウントに対して、SAML アサーションの administrator
属性を、true
の値を指定して含めます。 Azure AD からの SAML 要求に administrator
属性を含める方法の詳細については、Microsoft Docs の「エンタープライズ アプリケーションの SAML トークンで発行された要求のカスタマイズ」を参照してください。