The Hugging Face Hub gives you the ability to implement mandatory Single Sign-On (SSO) for your organization.
We support both SAML 2.0 and OpenID Connect (OIDC) protocols.
When Single Sign-On is enabled, the members of your organization must authenticate through your Identity Provider (IdP) to access any content under the organization’s namespace. Public content will still be available to users who are not members of the organization.
We use email addresses to identify SSO users. Make sure that your organizational email address (e.g. your company email) has been added to your user account.
When users log in, they will be prompted to complete the Single Sign-On authentication flow with a banner similar to the following:
Single Sign-On only applies to your organization. Members may belong to other organizations on Hugging Face.
You can easily integrate Hugging Face Hub with a variety of Identity Providers, such as Okta, OneLogin or Azure Active Directory (Azure AD). Hugging Face Hub can work with any OIDC-compliant or SAML Identity Provider.
We have some guides available to help with configuring based on your chosen SSO provider, or to take inspiration from:
This value sets the duration of the session for members of your organization.
After this time, members will be prompted to re-authenticate with your Identity Provider to access the organization’s resources.
The default value is 7 days.
When enabled, Role Mapping allows you to dynamically assign roles to organization members based on data provided by your Identity Provider.
This section allows you to define a mapping from your IdP’s user profile data from your IdP to the assigned role in Hugging Face.
IdP Role Attribute Mapping
A JSON path to an attribute in your user’s IdP profile data.
A mapping from the IdP attribute value to the assigned role in the Hugging Face organization.
You must map at least one admin role.
If there is no match, a user will be assigned the default role for your organization. The default role can be customized in the
Members section of the organization’s settings.
Role synchronization is performed on login.