GitHub Enterprise Server を SAML サービスプロバイダーとして構成する

GitHub Enterprise Server のプライベートインスタンスで、SAML2 Web App アドオンを使用して Auth0 を IDプロバイダーとして構成する方法を説明します。

GitHub Enterprise Server (つまり、プライベートな GitHub アプライアンス) 向けの SAML2 Web App アドオンを使用して、Auth0 を IDプロバイダー として構成できます。GitHub Enterprise Cloud (github.com) で Auth0 を IDプロバイダーとして設定する手順をお探しの場合は、代わりに Configure Auth0 as Identity Provider for GitHub Enterprise Cloud を参照してください。

​

Auth0 で SAML SSO を設定する

1. Dashboard > Applications > Applications に移動し、新しいアプリケーションを作成します。GitHub などのわかりやすい名前を付けてください。アプリケーションタイプはどれでも選択できますが、Regular Web App を推奨します。

2. Addons タブに移動し、SAML2 Web App のトグルを有効にします。

3. Settings タブで、Application Callback URL を次の値に設定します。https://github.com/orgs/{yourGitHubOrgName}/saml/consume

   

4. 次のコードを Settings のテキストボックスに貼り付け、Debug をクリックします。

   {
         "audience": "{yourGitHubServerUrl}",
         "mappings": {
       "user_id": "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier",
       "email": "emails",
       "name": "full_name"
         },
         "passthroughClaimsWithNoMapping": false,
         "mapIdentities": false,
         "signatureAlgorithm": "rsa-sha256",
         "digestAlgorithm": "sha256",
         "nameIdentifierProbes": [
       "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier"
         ]
       }
   

   {yourGitHubOrgName} は、GitHub サブスクリプションに対応する GitHub 組織名に置き換えてください。たとえば https://github.yourname.com です。

   1. 上記のマッピングでは、user_id が Name Identifier として GitHub に送信されます。GitHub アプリケーションで複数の接続を有効にする場合は、このオプションを使用してください。これにより一意性が確保されます (すべてのユーザーが異なる ID を持ちます) 。
   2. 単一の接続を使用している場合は、nickname や他の一意の識別子を、よりわかりやすい Name Identifier として使用することもできます。ただし、選択したプロパティが一意であることを確認してください。

5. タブの一番下までスクロールし、Enable をクリックします。

6. Usage タブで Identity Provider Metadata を見つけ、Download をクリックしてメタデータファイルをダウンロードします。Auth0 を IDプロバイダーとして設定する際にこのファイルが必要です。

   

​

GitHub で SAML SSO を設定する

GitHub Enterprise Cloud での設定を完了するには、Using SAML on Enterprise Server- GitHub Help の手順に従ってください。次の情報が必要です。

フィールド	入力内容
Sign On URL	https://{yourDomain}/samlp/{CLIENT_ID} {'{CLIENT_ID}'} は、Auth0 で先ほど作成した GitHub アプリケーションの client_id です。
Issuer	urn:auth0:{yourTenant}
Public Certificate	https://{yourDomain}/pem からダウンロードします。ダウンロードしたファイルをテキストエディターで開き、内容をコピーして GitHub のテキストエリアに貼り付けます。
Signature method	RSA256-SHA256
Digest method	SHA256