Okta와 SAML SSO 구성 방법

이 가이드에서는 Okta를 SSO 제공자로, Security Assertion Markup Language (SAML) 프로토콜을 선호하는 ID 프로토콜로 사용합니다.

현재 SP-initiated 및 IdP-initiated 인증을 지원합니다. 사용자 프로비저닝에 대해서는 SCIM을 참조하세요.

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

1단계: Identity Provider에서 새 애플리케이션을 만듭니다

브라우저에서 새 탭/창을 열고 Okta 계정에 로그인하세요.

“Admin/Applications”으로 이동한 후 “Create App Integration” 버튼을 클릭합니다.

이후 “SAML 2.0” 애플리케이션을 선택하고 “Create”를 클릭합니다.

2단계: Okta에서 애플리케이션 구성

브라우저에서 새 탭/창을 열고 조직 설정의 SSO 섹션으로 이동합니다. SAML 프로토콜을 선택합니다.

Hugging Face의 조직 설정에서 “Assertion Consumer Service URL”을 복사하여 Okta의 “Single sign-on URL” 필드에 붙여넣으세요. URL은 다음과 같은 형태입니다: https://huggingface.co/organizations/[organizationIdentifier]/saml/consume.

Okta에서 다음 설정을 구성합니다:

• Hugging Face의 “SP Entity ID” 값과 일치하도록 Audience URI(SP Entity Id)를 설정하세요.
• Name ID 형식을 Unspecified(지정되지 않음)으로 설정합니다.
• Application username을 Custom(으)로 설정하고, 식은 user.getInternalProperty("id")을 사용합니다.
• “Attribute Statements” 아래에 http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress를 값 user.email과 함께 추가합니다.
• “Show Advanced Settings”에서 Response와 Assertion Signature가 Signed로 설정되어 있는지 확인하세요.

새로운 애플리케이션을 저장하세요.

3단계: Hugging Face에서 구성 마무리하기

Okta 애플리케이션에서 “Sign On/Settings/More details” 아래에서 다음 필드를 찾습니다:

• 로그인 URL
• 공개 인증서
• SP Entity ID Hugging Face에서 SSO 설정을 완료하려면 이 값이 필요합니다.

조직 설정의 SSO 섹션에서 Okta의 다음 값을 복사하여 붙여넣습니다:

• 로그인 URL
• SP 엔티티 ID
• 공개 인증서

공개 인증서는 다음 형식을 가져야 합니다:

-----BEGIN CERTIFICATE-----
{certificate}
-----END CERTIFICATE-----

Update and Test SAML configuration을 클릭하여 설정을 저장할 수 있습니다.

SSO 제공자(IdP) 로그인 프롬프트로 리디렉션됩니다. 로그인하면 조직의 설정 페이지로 리디렉션됩니다.

SAML 선택기 근처의 녹색 체크 마크는 테스트가 성공적으로 완료되었음을 나타냅니다.

4단계: 조직에서 SSO 활성화

Single Sign-On이 설정되고 테스트된 후, “Enable” 버튼을 클릭하여 조직의 구성원에게 활성화할 수 있습니다.

활성화된 후, 조직의 구성원은 동작 방식 섹션에 설명된 SSO 인증 플로우를 완료해야 합니다.