Hub

API docs

Join the Hugging Face community

and get access to the augmented documentation experience

Collaborate on models, datasets and Spaces

Faster examples with accelerated inference

Switch between documentation themes

to get started

기본 SSO

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

기본 SSO는 표준 Hugging Face 로그인 위에 액세스 제어 계층을 추가합니다. 이를 통해 조직의 네임스페이스 아래에 있는 리소스(예: 비공개 모델, 데이터셋, Spaces)에 멤버가 액세스할 때 Identity Provider(IdP)를 통한 인증을 강제할 수 있습니다.

Managed SSO와의 비교에 대해서는 SSO 개요를 참조하세요.

작동 방식

기본 SSO는 Hugging Face 로그인을 대체하지 않습니다. 조직의 리소스에 접근하기 위해 SSO 인증을 완료하도록 프롬프트되기 전에, 멤버들은 여전히 자신의 자격 증명(이메일/비밀번호, Google 또는 GitHub)을 사용하여 Hugging Face에 로그인해야 합니다. 이는 의도된 동작입니다. 기본 SSO는 사용자의 Hugging Face 신원을 인수하지 않으면서도 조직에 대한 접근을 보호합니다.

Single Sign-On이 활성화되면 조직 구성원은 Identity Provider(IdP)를 통해 인증합니다. SSO를 강제할지 선택적으로 할지 선택합니다:

Enforced(기본값): 구성원은 조직의 네임스페이스 아래에 있는 항목에 액세스하기 전에 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 Identity Provider와 함께 작동할 수 있습니다.

단계별 설정 지침은 Configuration Guides를 참조하세요.

사용자 프로비저닝

조직에서 SSO가 활성화되면, 직접 가입 링크를 복사하여 새 멤버와 공유할 수 있습니다. 이 SSO 가입 링크는 SSO 및 Members 설정 탭에서 모두 사용할 수 있습니다. SSO가 활성화된 조직은 기존 초대 링크를 사용할 수 없으므로, SSO 가입 링크는 팀원을 조직에 초대하는 주요 방법입니다. 복사 버튼을 클릭하여 링크를 클립보드에 복사한 후, 초대하려는 멤버와 공유하십시오. 수신자가 공유된 링크를 클릭하면 SSO를 통해 인증하고 조직에 직접 가입할 수 있습니다.

Enterprise 플랜의 조직은 SCIM을 사용하여 Identity Provider에서 초대 기반 프로비저닝을 자동화할 수도 있습니다. 자세한 내용은 SCIM 가이드를 참조하세요.

액세스 토큰 및 SSH 키

SSO를 강제하는 조직에서 User Access Token 또는 SSH key를 사용하려면, 먼저 해당 조직에 대해 이를 승인해야 합니다. 승인 전까지, 해당 토큰 또는 키를 사용하여 조직의 리소스에 보낸 요청은 모두 거부되며, Git over SSH도 포함됩니다. 다른 리소스에 대한 접근에는 영향을 미치지 않습니다.

토큰 또는 SSH 키를 승인하려면:

Go to Access Tokens or SSH and GPG Keys in your settings.
토큰 또는 키 옆의 메뉴를 열고 SSO 구성을 클릭하세요.
조직 옆의 Authorize를 클릭합니다. Identity Provider로 리디렉션되어 로그인합니다.

SSO로 조직에 로그인한 상태에서 생성한 토큰은 자동으로 해당 조직에 대해 인증됩니다.

인가는 동일한 메뉴에서 인가를 해제하거나 조직을 떠날 때까지 유지됩니다. 다시 가입하는 경우 토큰과 키를 다시 인가해야 합니다. 외부 협업자는 자격 증명을 인가할 필요가 없습니다.

조직 관리자는 감사 로그에서 승인 및 승인 취소 내역을 확인할 수 있습니다.

SSO 기능

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

Update on GitHub

←단일 로그인(SSO) 관리형 SSO→