Hub documentation

基本的なSSO

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

基本的なSSO

この機能は、Team & Enterprise プランの一部です。

Basic SSOは、標準的なHugging Faceのログインの上にアクセス制御のレイヤーを追加します。これにより、メンバーが組織のネームスペース配下のリソース(プライベートモデル、データセット、Spacesなど)にアクセスする際に、Identity Provider (IdP) による認証を強制できます。

Managed SSOとの比較については、SSO概要を参照してください。

仕組み

Basic SSOはHugging Faceのログインを置き換えません。 メンバーは、組織のリソースにアクセスするためのSSO認証を完了するよう促される前に、引き続き自分の認証情報(メール/パスワード、Google、またはGitHub)でHugging Faceにサインインする必要があります。これは意図的な設計です。Basic SSOは、ユーザーのHugging Faceアイデンティティを乗っ取ることなく、組織へのアクセスを保護します。

Single Sign-On が有効な場合、組織のメンバーは Identity Provider (IdP) を通じて認証を行います。SSO を強制にするか、任意にするかは選択できます。

  • 強制(デフォルト):メンバーは、組織のネームスペース配下のコンテンツにアクセスする前に、SSO認証を完了する必要があります。
  • オプション: メンバーはページの上部に表示されるバナーを通じて SSO の設定を促されますが、これをスキップして組織にアクセスすることもできます。多くのユーザーを移行する際に、SSO を強制する前にアカウントの整理に時間を与える必要がある場合に便利です。

公開コンテンツは、非メンバーを含むすべてのユーザーが引き続きアクセスできます。

SSOユーザーの識別にはメールアドレスを使用します。ユーザーとして、組織のメールアドレス(例:会社のメールアドレス)がユーザーアカウントに追加されていることを確認してください。

ユーザーがログインすると、次のようなバナーが表示され、Single Sign-On 認証フローの完了を促されます。

Single Sign-Onは、あなたの組織にのみ適用されます。メンバーは、Hugging Face上の他の組織にも所属している場合があります。

はじめる

基本的なSSOは、組織の設定から直接設定できます。Hugging Face Hubは、Okta、OneLogin、Microsoft Entra ID (Azure AD)を含む、OIDC準拠またはSAMLアイデンティティプロバイダーと連携できます。

ステップバイステップのセットアップ手順については、設定ガイドをご覧ください。

ユーザープロビジョニング

組織で SSO が有効になると、直接参加リンクをコピーして新しいメンバーと共有できます。この SSO 参加リンクは、SSO と メンバー の設定タブの両方で利用できます。SSO が有効な組織では従来の招待リンクを使用できないため、SSO 参加リンクはチームメイトを組織に招待するための主な方法です。コピーボタンをクリックしてリンクをクリップボードにコピーし、招待したいメンバーと共有してください。受信者が共有されたリンクをクリックすると、SSO による認証を行い、組織に直接参加できるようになります。

Enterprise プランの組織は、SCIM を使用して、Identity Provider からの招待ベースのプロビジョニングを自動化することもできます。詳細については、SCIM ガイドを参照してください。

SSO機能

Basic SSOは、ロールのマッピング、リソースグループのマッピング、セッションのタイムアウト、メールドメインの一致、外部コラボレーターをサポートしています。これらの機能は、組織の設定から構成できます。

Update on GitHub