Hub documentation
Okta를 사용하여 OIDC SSO를 구성하는 방법
Okta를 사용하여 OIDC SSO를 구성하는 방법
이 가이드에서는 Okta를 SSO 제공자로, Open ID Connect (OIDC) 프로토콜을 선호하는 ID 프로토콜로 사용합니다.
이 기능은 Team & Enterprise 플랜의 일부입니다.
1단계: Identity Provider에서 새 애플리케이션을 만듭니다
브라우저에서 새 탭/창을 열고 Okta 계정에 로그인하세요.
“Admin/Applications”으로 이동한 후 “Create App Integration” 버튼을 클릭합니다.

이후 “OIDC - OpenID Connect” 애플리케이션을 선택하고, 애플리케이션 유형으로 “Web Application”을 선택한 다음 “Create”를 클릭합니다.

2단계: Okta에서 애플리케이션 구성
브라우저에서 새 탭/창을 열고 조직 설정의 SSO 섹션으로 이동합니다. OIDC 프로토콜을 선택합니다.


Hugging Face의 조직 설정에서 “Redirection URI”를 복사하여 Okta의 “Sign-in redirect URI” 필드에 붙여넣으세요.
URL은 다음과 같은 형태입니다: https://huggingface.co/organizations/[organizationIdentifier]/oidc/consume.
선택 사항인 Sign-out redirect URIs는 비워 둘 수 있습니다.

새로운 애플리케이션을 저장하세요.
3단계: Hugging Face에서 구성 마무리하기
Okta 애플리케이션의 General 섹션에서 다음 필드를 찾습니다:
- 클라이언트 ID
- 클라이언트 시크릿
- Issuer URL Hugging Face에서 SSO 설정을 완료하려면 이 정보가 필요합니다.
Okta Issuer URL은 일반적으로 https://tenantId.okta.com과 같은 URL입니다. 자세한 내용은 해당 가이드를 참고하세요.

Hugging Face의 조직 설정에서 SSO 섹션으로 이동하여 Okta에서 이 값들을 복사하여 붙여넣으세요:
- 클라이언트 ID
- Client Secret

Update and Test OIDC configuration를 클릭하여 설정을 저장할 수 있습니다.
SSO 제공자(IdP) 로그인 프롬프트로 리디렉션됩니다. 로그인하면 조직의 설정 페이지로 리디렉션됩니다.
OIDC 선택기 근처의 녹색 체크 마크는 테스트가 성공적으로 완료되었음을 나타냅니다.

4단계: 조직에서 SSO 활성화
Single Sign-On이 설정되고 테스트된 후, “Enable” 버튼을 클릭하여 조직의 구성원에게 활성화할 수 있습니다.
활성화된 후, 조직의 구성원은 동작 방식 섹션에 설명된 SSO 인증 플로우를 완료해야 합니다.
Update on GitHub