Google Workspace에서 SAML SSO를 구성하는 방법

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

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

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

1단계: Google Workspace에서 SAML 앱 만들기

• Google Workspace 관리자 콘솔에서 Admin > Apps > Web and mobile apps으로 이동하세요.
• Add app를 클릭한 다음 Add custom SAML app을 클릭합니다.
• “App name” 필드에 애플리케이션 이름을 입력해야 합니다.
• Continue를 클릭합니다.

2단계: Google의 IdP 세부 정보로 Hugging Face 구성

• Google 설정의 다음 화면에는 애플리케이션의 SSO 정보가 포함되어 있습니다.
• Hugging Face 조직 설정에서 SSO 탭으로 이동하여 SAML 프로토콜을 선택하세요.
• Google에서 SSO URL을 복사하여 Hugging Face의 Sign-on URL 필드에 붙여넣으세요.
• Google에서 Certificate 를 복사하여 Hugging Face의 해당 필드에 붙여넣으세요. 공개 인증서는 다음 형식을 가져야 합니다:
  복사됨

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

• Google Workspace 설정에서 Continue를 클릭합니다.

3단계: Hugging Face의 SP 세부 정보로 Google 구성

• “Service provider details” 화면에서는 Hugging Face SSO 설정의 Assertion Consumer Service URL과 SP Entity ID가 필요합니다. 이들을 Google의 해당 ACS URL 및 Entity ID 필드에 복사해 넣으세요.
• 다음 항목이 설정되어 있는지 확인하세요:
  • Signed response 상자를 선택합니다.
  • Name ID 형식: EMAIL
  • 이름 ID: Basic Information > Primary email

• Continue를 클릭합니다.

4단계: 속성 매핑

• “Attribute mapping” 화면에서 Add mapping를 클릭하고 전송하려는 속성을 구성합니다. 이 단계는 선택 사항이며, Hugging Face에서 Role Mapping 또는 Resource Group Mapping을 사용할지 여부에 따라 달라집니다.

• Finish를 클릭합니다.

5단계: SSO 테스트 및 활성화

테스트를 수행하기 전에, Google Workspace 관리 콘솔에서 해당 애플리케이션의 User access 설정을 통해 적절한 사용자에게 애플리케이션 접근 권한을 부여했는지 확인하세요. 테스트를 수행하는 관리자에게도 접근 권한이 있어야 합니다. Google Workspace에서 사용자 접근 권한 변경 사항이 적용되는 데 몇 분 정도 걸릴 수 있습니다.

• 이제 Hugging Face SSO 설정에서 “SAML 구성 업데이트 및 테스트”를 클릭하세요.
• Google 로그인 프롬프트로 리디렉션됩니다. 로그인하면 조직의 설정 페이지로 리디렉션됩니다.
• SAML 선택기 근처의 녹색 체크 마크는 테스트가 성공적으로 완료되었음을 확인해 줍니다.
• 테스트가 성공적으로 완료되면 Enable 버튼을 클릭하여 조직에 SSO를 활성화할 수 있습니다.
• 활성화된 후, 조직의 구성원은 동작 방식 섹션에 설명된 SSO 인증 플로우를 완료해야 합니다.

Update on GitHub