Hub documentation
Google WorkspaceでSAML SSOを設定する方法
Google WorkspaceでSAML SSOを設定する方法
このガイドでは、SSOプロバイダーとしてGoogle Workspaceを使用し、アイデンティティプロトコルとしてSecurity Assertion Markup Language (SAML)プロトコルを優先的に使用します。
現在、SP開始型認証とIdP開始型認証に対応しています。ユーザープロビジョニングについては、SCIMを参照してください。
この機能は、Team & Enterprise プランの一部です。
ステップ1: Google WorkspaceでSAMLアプリを作成する
- Google Workspaceの管理コンソールで、
Admin>Apps>Web and mobile appsに移動します。 Add appをクリックし、次にAdd custom SAML appをクリックします。- 「App name」フィールドにアプリケーションの名前を入力する必要があります。
Continueをクリックします。
ステップ2: Hugging FaceをGoogleのIdP詳細で設定する
- Google のセットアップの次の画面には、アプリケーションの SSO 情報が含まれています。
- Hugging Face の組織設定で、
SSOタブに移動し、SAMLプロトコルを選択してください。 - GoogleからSSO URLをコピーし、Hugging FaceのSign-on URLフィールドに貼り付けてください。
- Google から 証明書 をコピーして、Hugging Face の対応するフィールドに貼り付けてください。公開証明書は、次の形式である必要があります:
-----BEGIN CERTIFICATE----- {certificate} -----END CERTIFICATE-----
- Google Workspace のセットアップで、
Continueをクリックします。
ステップ 3: Hugging Face の SP 詳細で Google を設定する
- 「Service provider details」画面では、Hugging Face の SSO 設定にある
Assertion Consumer Service URLとSP Entity IDが必要です。これらを Google 側の対応するACS URLとEntity IDフィールドにコピーしてください。 - 以下の設定がされていることを確認してください:
- Signed responseのチェックボックスをオンにします。
- Name ID の形式:
EMAIL - 名前 ID:
Basic Information > Primary email
Continueをクリックします。
ステップ4: 属性のマッピング
- 「Attribute mapping」画面で、
Add mappingをクリックして、送信したい属性を設定します。この手順は任意であり、Hugging Face で Role Mapping または Resource Group Mapping を使用したいかどうかによって異なります。
Finishをクリックします。
ステップ5: SSOのテストと有効化
テストの前に、Google Workspace管理コンソールの該当するアプリケーションの「ユーザーアクセス」設定で、適切なユーザーにアプリケーションへのアクセス権限を付与していることを確認してください。テストを実行する管理者もアクセス権限が必要です。Google Workspace上でユーザーアクセス権限の変更が反映されるまで、数分かかる場合があります。
- 次に、Hugging Face の SSO 設定で、「SAML 設定の更新とテスト」をクリックしてください。
- Googleのログイン画面にリダイレクトされるはずです。ログインが完了すると、組織の設定ページにリダイレクトされます。
- SAMLセレクタの近くに緑色のチェックマークが表示されれば、テストが正常に完了したことを確認できます。
- テストが成功したら、「有効化」ボタンをクリックして、組織でSSOを有効にできます。
- 有効化後、組織のメンバーは仕組みセクションに記載されているSSO認証フローを完了する必要があります。