Microsoft Entra ID(Azure AD)에서 SAML SSO를 구성하는 방법

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

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

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

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

브라우저에서 새 탭/창을 열고 조직의 Azure 포털에 로그인하세요.

“Enterprise applications”으로 이동한 후 “New application” 버튼을 클릭합니다.

이 페이지로 리디렉션되며, “Create your own application”을 클릭하고 애플리케이션 이름을 입력한 후 “Create”를 클릭하여 애플리케이션을 생성합니다.

이후 “Single Sign-On”을 선택하고 SAML을 선택합니다

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

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

Hugging Face의 조직 설정에서 “SP Entity Id”를 복사하여 Azure의 “Identifier (Entity Id)” 필드에 붙여넣으세요 (1).

Hugging Face의 조직 설정에서 “Assertion Consumer Service URL”을 복사하여 Azure의 “Reply URL” 필드(2)에 붙여넣습니다.

URL은 다음과 같은 형태입니다: https://huggingface.co/organizations/[organizationIdentifier]/saml/consume.

그 다음 “SAML Certificates”에서 “Signin Option”이 “Sign SAML response and assertion”(으로 설정되어 있는지 확인합니다.

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

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

Azure 애플리케이션에서 설정 아래에 다음 필드를 찾습니다:

• 로그인 URL

그리고 “SAML Certificates” 아래:

• “Certificate (base64)”를 다운로드합니다

Hugging Face에서 SSO 설정을 완료하려면 이 값이 필요합니다.

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

• 로그인 URL -> 로그인 URL
• Certificate -> 공개 인증서

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

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

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

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

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

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

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

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