SAML(Security Assertion Markup Language)2.0 標準を使用すると、多くのクラウドアプリにシングル サインオン(SSO)を設定できます。SSO を設定すると、ユーザーは Google Workspace の認証情報で SSO を使用してアプリにログインできます。
SAML を使用して GitHub Enterprise の SSO を設定する
手順 1: Google を SAML ID プロバイダとして設定する
-
Google 管理コンソールで、メニュー アイコン
[アプリ]
[ウェブアプリとモバイルアプリ] に移動します。
この操作を実施するには、特権管理者としてログインする必要があります。
-
[**アプリを追加**]
[**アプリを検索**] をクリックします。
- [**アプリ名を入力**] に「**GitHub Business** 」と入力します。
- 検索結果で [GitHub Business] にカーソルを合わせ、[選択] をクリックします。
-
In the [Google Identity Provider details] window, for [Option 2: Copy the SSO URL, entity ID, and certificate]:
- [SSO の URL] の横にあるコピーアイコン
をクリックし、URL を保存します。
- [**エンティティ ID**] の横にあるコピーアイコン
をクリックし、URL を保存します。
- [証明書] の横にあるダウンロード アイコン
をクリックして証明書をダウンロードします。
GitHub Enterprise の設定を完了するには、この情報が必要です。
- [SSO の URL] の横にあるコピーアイコン
- [続行] をクリックします。
- [**サービス プロバイダの詳細**] ページで、[**ACS の URL**] と [**エンティティ ID**] の [**{組織名}**] を GitHub Enterprise の組織名に置き換えます。
- [続行] をクリックします。
- [属性のマッピング] ウィンドウで [フィールドを選択] をクリックし、次の Google Directory の属性を対応する GitHub Enterprise の属性にマッピングします。firstName、lastName の属性は必須です。
Google ディレクトリの属性 アプリの属性 [Basic Information] > [First name] firstName* Basic Information > Last Name lastName* - (省略可)マッピングを追加するには、[マッピングを追加] をクリックして、マッピングする必要があるフィールドを選択します。
-
(省略可)このアプリに関連するグループの名前を入力するには:
- [グループ メンバーシップ(省略可)] で [グループを検索] をクリックし、グループ名の文字を 1 つ以上入力して、グループ名を選択します。
- 必要に応じてグループを追加します(最大 75 個のグループ)。
- [**アプリの属性**] に、サービス プロバイダの対応するグループ属性名を入力します。
入力したグループ名の数に関係なく、SAML レスポンスには、ユーザーが(直接的または間接的に)メンバーになっているグループのみが含まれます。詳しくは、グループ メンバーシップのマッピングの概要をご覧ください。
- [完了] をクリックします。
手順 2: GitHub Enterprise を SAML 2.0 サービス プロバイダとして設定する
- シークレット ブラウザ ウィンドウを開き、GitHub Enterprise のログインページ に移動して、GitHub Enterprise 管理者アカウントでログインします。
- ユーザー名
[Settings] をクリックします。
- 組織の名前
[Security] をクリックします。
- SAML シングル サインオン の場合:
- [ログイン URL] に、先ほどコピーした SSO の URL を貼り付けます。
- [発行者] に、先ほどコピーしたエンティティ ID を貼り付けます。
- [一般公開証明書] で、先ほどダウンロードした証明書をコピーします。
- [Test SAML configuration] をクリックして設定を確認します。
- [SAML 認証を有効にする] チェックボックスをオンにします。
- [保存] をクリックします。
手順 3: ユーザーに対してアプリをオンにする
-
Google 管理コンソールで、メニュー アイコン
[アプリ]
[ウェブアプリとモバイルアプリ] に移動します。
この操作を実施するには、特権管理者としてログインする必要があります。
- [GitHub Business] をクリックします。
- [ユーザー アクセス] をクリックします。
-
組織内のすべてのユーザーに対してサービスを有効または無効にするには、[オン(すべてのユーザー)] または [オフ(すべてのユーザー)] をクリックし、[保存] をクリックします。
-
(省略可)特定の組織部門に対してサービスを有効または無効にするには:
- 左側で組織部門を選択します。
- サービスのステータスを変更するには、[オン] または [オフ] を選択します。
- 次のどちらかの操作を行います。
- [サービスのステータス] が [継承] になっており、親組織の設定が変更されても現在の設定を維持したい場合は、[オーバーライド] をクリックします。
- [サービスのステータス] が [**オーバーライド**] になっている場合は、[**継承**] をクリックして親と同じ設定に戻すか、[**保存**] をクリックして新しい設定を維持します(親組織の設定が変更された場合でも、現在の設定を維持します)。
詳しくは、組織部門についてのページをご覧ください。
- (任意)組織部門全体または組織部門内の一部のユーザーに対してサービスを有効にするには、アクセス グループを使用します。詳しくは、アクセス グループを使用してサービスへのアクセスをカスタマイズするをご覧ください。
- GitHub Enterprise のユーザー アカウントのメールドメインが、組織の管理対象の Google アカウントのプライマリ ドメインと一致していることを確認します。
手順 4: SSO が機能していることを確認する
GitHub Enterprise は、ID プロバイダを起点とする SSO と、サービス プロバイダを起点とする SSO の両方をサポートしています。
ID プロバイダを起点とする SSO を確認する
-
Google 管理コンソールで、メニュー アイコン
[アプリ]
[ウェブアプリとモバイルアプリ] に移動します。
この操作を実施するには、特権管理者としてログインする必要があります。
- [GitHub Business] をクリックします。
- [GitHub Business] セクションで、[SAML ログインをテスト] をクリックします。
アプリが別のタブで開きます。開かない場合は、エラー メッセージのトラブルシューティングを行ってから、もう一度お試しください。 トラブルシューティングについて詳しくは、SAML アプリのエラー メッセージをご覧ください。
サービス プロバイダを起点とする SSO を確認する
- ブラウザ ウィンドウをすべて閉じます。
- https://github.com/orgs/{組織名}/sso を開いてログインします。Google ログインページに自動的にリダイレクトされます。
- ログイン認証情報を入力します。
ログイン認証情報が認証されると、GitHub Enterprise に自動的にリダイレクトされます。
- 個人用 GitHub アカウントの認証情報でログインします。
Google、Google Workspace、および関連するマークとロゴは、Google LLC の商標です。その他すべての企業名および商品名は関連各社の商標です。