Hub documentation

관리형 SSO

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

관리형 SSO

이 기능은 Enterprise Plus 플랜의 일부입니다.

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

Basic SSO와의 비교를 보려면 SSO 개요를 참조하세요.

작동 방식

Managed SSO는 Hugging Face 로그인을 대체합니다. 관리 대상 사용자의 경우 Hugging Face에서 인증하는 유일한 방법은 IdP입니다. 별도의 Hugging Face 로그인이 없습니다. Basic SSO와 달리, 멤버는 기존 Hugging Face 계정이 필요하지 않습니다. 사용자가 IdP를 통해 처음 인증하면 계정이 자동으로 생성됩니다.

IdP는 Hugging Face 플랫폼의 모든 부분에 상호작용하는 조직의 모든 구성원에게 필수적인 인증 경로입니다. 구성원은 개인 또는 조직 저장소에 액세스할 때뿐만 아니라 모든 Hugging Face 서비스를 사용할 때 IdP를 통해 인증해야 합니다.

사용자가 IdP에서 비활성화되면 Hugging Face 계정 역시 비활성화됩니다. 이를 통해 조직은 신원, 액세스 및 데이터 거버넌스에 대한 완전한 제어권을 가질 수 있습니다.

시작하기

Managed SSO는 자체 설정할 수 없습니다. 조직에 Managed SSO를 활성화하려면 Hugging Face 팀에 문의해 주세요. 설정은 기술 팀과 협력하여 진행되며, 조직의 원활한 전환을 보장합니다.

기존 조직을 전환하는 경우, 먼저 Managed SSO로 마이그레이션을 읽어보세요. 멤버의 기존 개인 계정은 전환되지 않으며, 각 멤버는 프로비저닝되기 전에 업무용 이메일 주소를 해제해야 합니다.

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

사용자 프로비저닝

Managed SSO는 SCIM을 통해 자동화된 사용자 프로비저닝을 도입하여 Hugging Face에서 사용자 수명 주기의 전 과정을 관리합니다. SCIM은 IdP가 사용자 신원 정보를 Hugging Face에 전달할 수 있게 하여, IdP에서 변경 사항이 발생하면 사용자 계정의 자동 생성, 업데이트(예: 이름 변경, 역할 변경), 비활성화를 가능하게 합니다.

SCIM 설정 및 관리 방법에 대한 자세한 내용은 전용 가이드에서 확인하세요.

SSO 기능

Managed SSO는 역할 매핑, 리소스 그룹 매핑, 세션 타임아웃, 외부 협업자를 지원합니다. 이러한 기능은 조직 설정에서 구성할 수 있습니다.

관리 계정 제한

관리 계정 사용 시 중요한 고려 사항

조직의 통제 및 데이터 거버넌스를 보장하기 위해, 관리되는 사용자 계정에는 다음과 같은 특정 제한 사항이 적용됩니다:

  • 개인 콘텐츠 생성 불가: 관리 대상 사용자는 개인 사용자 네임스페이스에서 어떤 콘텐츠(모델, 데이터셋, Spaces)도 생성할 수 없습니다. 모든 콘텐츠는 조직 내에서 생성해야 합니다.
  • 조직 기반 협업: 관리 대상 사용자는 해당 사용자를 관리하는 조직 내에서만 협업할 수 있습니다. 다른 조직에 가입하거나 관리 조직 외부의 저장소에 기여할 수 없습니다.
  • 콘텐츠 가시성: 관리 대상 사용자가 생성한 콘텐츠는 조직 내에 저장됩니다. 관리 대상 사용자는 개인 프로필에 공개 콘텐츠를 생성할 수 없지만, 조직 설정이 허용하는 경우 조직 내에서 공개 콘텐츠를 생성할 수 있습니다.
  • 조직 관리 프로필: 관리 조직은 관리 대상 사용자의 기본 조직으로 자동 설정됩니다. 관리 대상 사용자는 프로필(이름, 아바타, 기본 조직, 홈페이지, 자기소개, 소셜 링크)을 편집하거나 사용자 이름 또는 비밀번호를 변경하거나 조직을 탈퇴하거나 계정을 삭제할 수 없습니다. 이러한 항목은 조직과 해당 ID 제공자가 관리합니다.

이러한 제한 사항은 기업의 보안 경계를 유지합니다. 개인 프로젝트나 조직 외부의 더 넓은 협력이 필요한 경우, 멤버는 별도 관리되지 않는 Hugging Face 계정을 사용해야 합니다.

Update on GitHub