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 플랜의 일부입니다.

Hugging Face는 서로 다른 두 가지 SSO 모델을 제공하며, 각각은 다른 조직의 요구 사항에 맞게 설계되었습니다. 이 두 가지 접근 방식의 차이를 이해하는 것이 팀에 적합한 설정을 선택하는 데 핵심입니다.

한눈에 보기

기본 SSO관리형 SSO
계획팀 및 엔터프라이즈Enterprise Plus
범위조직 리소스만Hugging Face 플랫폼 전체
Hugging Face 로그인을 대체합니다아니요 — 사용자는 기존 Hugging Face 자격 증명을 그대로 유지합니다네 — IdP가 유일한 로그인 방법이 됩니다
사용자 계정사용자는 개인 Hugging Face 계정을 유지합니다계정은 조직에 의해 소유 및 관리됩니다
개인 콘텐츠사용자는 개인 네임스페이스에서 콘텐츠를 생성할 수 있습니다사용자는 조직 내에서만 콘텐츠를 생성할 수 있습니다
다중 조직 멤버십사용자는 여러 조직에 속할 수 있습니다사용자는 관리 조직으로 제한됩니다
사용자 프로비저닝수동(SSO 가입 링크) — 또는 Enterprise의 초대 기반 SCIM전체 라이프사이클(SCIM)
설정조직 설정에서 셀프 서비스Hugging Face 팀과의 설정이 필요합니다
외부 협력자예예
프로토콜SAML 2.0 및 OIDCSAML 2.0 및 OIDC
역할 매핑예예
리소스 그룹 매핑예예

기본 SSO

기본 SSO는 표준 Hugging Face 로그인 위에 액세스 제어 계층을 추가합니다. Hugging Face 로그인을 대체하지 않으며, 멤버는 기존 자격 증명을 유지하고 조직의 리소스에 액세스할 때만 SSO 완료를 안내받습니다.

이 기능은 개별 Hugging Face 계정의 유연성을 유지하면서 조직 리소스에 대한 액세스를 안전하게 관리하려는 팀에 적합합니다. 설정은 조직 설정에서 셀프 서비스로 진행할 수 있습니다.

기본 SSO 시작하기 →

관리형 SSO

Managed SSO는 Hugging Face 로그인을 완전히 대체합니다. Identity Provider가 Hugging Face 플랫폼 전체에서 유일한 인증 수단이 됩니다. 조직은 계정 생성부터 비활성화까지 사용자 수명 주기를 전체적으로 관리합니다.

이 기능은 신원, 액세스 및 데이터 거버넌스에 대한 완전한 제어가 필요한 기업을 위해 설계되었습니다. 관리 계정은 특정 제한 사항(개인 콘텐츠 금지, 조직 내 협업만 허용)이 있습니다. 설정을 위해 Hugging Face 팀과의 조율이 필요합니다.

Managed SSO 시작하기 →

사용자 프로비저닝(SCIM)

두 SSO 모델 모두 SCIM(System for Cross-domain Identity Management)을 지원하여 Identity Provider에서 사용자 프로비저닝을 자동화할 수 있습니다. 두 모델은 각각의 철학에 부합하도록 SCIM을 다르게 사용합니다:

  • 기본 SSO(Enterprise 플랜): SCIM을 사용하면 기존 Hugging Face 사용자를 조직에 초대하는 과정을 자동화할 수 있습니다. 사용자는 초대 수락 시에만 조직에 가입할 수 있습니다.
  • Managed SSO(Enterprise Plus 플랜): SCIM은 사용자 전체 라이프사이클을 관리합니다 — 계정 생성, 프로필 업데이트, 비활성화.

User Provisioning (SCIM) 가이드에서 자세히 알아보세요.

어떤 모델을 선택해야 할까요?

팀이 조직 리소스에 대한 액세스를 보호하면서 구성원이 자신의 Hugging Face 계정을 유지하고 더 넓은 커뮤니티에 참여할 수 있도록 하려면 Basic SSO를 선택하세요.

조직에서 모든 사용자 계정에 대한 중앙 집중식 제어, 자동화된 프로비저닝 및 디프로비저닝, 조직 외부에서 콘텐츠가 생성되는 것을 방지하는 엄격한 데이터 거버넌스 정책을 요구한다면 Managed SSO 선택을 선택하세요.

두 모델 모두 SAML 2.0 및 OIDC 프로토콜을 지원하며, Okta, Microsoft Entra ID (Azure AD), Google Workspace와 같은 인기 있는 ID 제공업체와 통합할 수 있습니다.

추가 자료

  • 사용자 관리 — 역할 매핑, 리소스 그룹 매핑, 세션 타임아웃 등
  • 구성 가이드 — Okta, Microsoft Entra ID, Google Workspace의 단계별 설정 지침
Update on GitHub