Skip to main content
이 문서는 기계 번역되었습니다.

​
개요

이 가이드는 SAML 2.0 ID 공급자를 Legora의 글로벌 인증에 연결하는 IT 관리자를 위한 것입니다. 이후 구성원은 회사 자격 증명으로 Legora에 로그인합니다. Legora에서 SAML, ADFS, PingFederate를 선택할 때도 같은 단계가 적용됩니다. Legora의 글로벌 인증에서 Microsoft Entra ID는 OpenID Connect를 사용합니다. 다음을 참조하세요. 통합 개요 - Entra ID 싱글 사인온.
조직이 Legora의 글로벌 인증을 사용해야 하며, 역할에 Manage authentication security가 포함되어야 합니다. 다음을 참조하세요. 조직의 인증을 어떻게 관리하나요?.조직이 아직 이전하지 않았다면 Legora 지원팀이 싱글 사인온(SSO)을 설정합니다. support@legora.com으로 문의하세요.

​
작동 방식

ID 공급자에서 SAML 애플리케이션을 만들고 Legora 서비스 공급자 세부 정보를 입력합니다. 그런 다음 Legora에 ID 공급자 세부 정보를 입력합니다. 이 교환으로 Legora가 로그인을 신뢰할 수 있습니다.

​
사전 요구 사항

시작하기 전에 다음이 모두 필요합니다.
  • 조직의 SAML 2.0 ID 공급자에 대한 관리자 액세스.
  • Legora 조직의 Manage authentication security.

​
연결 설정

먼저 ID 공급자 단계를 수행한 다음 Legora 단계를 수행하세요. 서비스 공급자 값은 Legora의 글로벌 인증을 사용하는 모든 조직에서 동일합니다.

​
SAML 애플리케이션 만들기

ID 공급자의 관리 콘솔에서 시작합니다.
  1. Legora용 SAML 2.0 애플리케이션을 새로 만듭니다.
  2. 조직에 Legora SAML 앱이 이미 있으면 그 앱은 유지하고 이 앱을 옆에 만드세요. 아래 마이그레이션 섹션에서 해당되는 경우를 설명합니다.

​
Legora 서비스 공급자 세부 정보 입력

이 값을 새 애플리케이션에 복사하세요. 지역에 따라 바뀌지 않습니다.
  • Entity ID, Audience URI, 또는 Identifier: https://sso.legora.com
  • ACS URL, Single Sign-On URL, 또는 Reply URL: https://sso.legora.com/api/oauth/saml
https://sso.legora.com은 웹 사이트가 아니라 로그인 서비스입니다. 이 루트 주소를 열면 설계상 404 Not Found가 표시됩니다. 전체 ACS URL을 사용하세요. 연결을 만든 뒤 연결의 ACS URL에 같은 응답 URL이 표시됩니다. 연결의 Entity ID에는 ID 공급자의 식별자가 표시됩니다. ID 공급자에는 Legora Entity ID로 https://sso.legora.com을 입력하세요. Legora는 email 클레임이 필요합니다. given_name과 family_name은 권장됩니다. ID 공급자 특성을 이 이름에 매핑하세요.

​
Legora에 ID 공급자 추가

Legora가 구성원을 올바른 로그인 페이지로 보내도록 ID 공급자 세부 정보를 입력합니다.
  1. 메뉴에서 본인 이름을 선택한 다음 Settings > People > Authentication을 선택합니다.
  2. SSO에서 Add를 선택한 다음 SAML, ADFS, PingFederate 중 하나를 선택합니다.
  3. Display Name을 입력합니다. 구성원은 로그인 화면에서 이 이름을 봅니다.
  4. ID 공급자 세부 정보를 입력합니다. 다음 중 하나를 사용하세요.
    • Metadata URL: Legora가 이 주소에서 로그인 엔드포인트와 인증서를 가져옵니다. 일반적인 선택입니다.
    • 또는 ID 공급자의 Entity ID, Sign-In Endpoint URL, **Signing Certificate (PEM)**을 입력합니다.
  5. Create connection을 선택합니다. Legora가 새 연결을 엽니다.
SAML 연결에서 Edit는 표시 이름만 변경합니다. 메타데이터를 바꾸려면 새 연결을 만드세요.

​
연결 테스트 및 사용

구성원이 사용하기 전에 연결을 확인합니다.
  1. ID 공급자에서 테스트 사용자를 Legora SAML 애플리케이션에 할당합니다.
  2. Legora에서 연결을 연 다음 Test connection을 선택합니다. 로그인 창이 열립니다.
  3. 테스트 사용자로 로그인합니다. Legora로 돌아와야 합니다.
  4. 구성원이 이 연결로 로그인할 수 있도록 Status를 켭니다.
테스트가 실패하면 ID 공급자의 ACS URL과 Entity ID를 이전 단계의 값과 비교하세요. assertion에 email이 포함되어 있는지도 확인하세요.

​
Legora의 글로벌 인증으로 마이그레이션

조직에 Legora용 SAML 앱이 이미 있고 그 조직을 Legora의 글로벌 인증으로 이전하는 경우에만 이 섹션을 사용하세요. 처음 설정은 Status를 켜면 완료됩니다. SAML 앱은 서비스 공급자 Entity ID에 연결되어 있습니다. 기존 앱을 Legora의 글로벌 인증으로 가리킬 수 없습니다. 위 값으로 새 SAML 앱을 만드세요. 마이그레이션이 끝날 때까지 기존 앱은 그대로 두세요. 마이그레이션 중 테스트하려면 메뉴에서 본인 이름을 선택한 다음 Settings > People > Authentication migration을 선택합니다. 연결 테스트를 실행하고 Passed가 표시되는지 확인하세요. Legora는 같은 Microsoft Entra 테넌트에서 SAML 앱을 두 개 이상 지원하지 않습니다. 해당 연결을 OpenID Connect로 옮기세요. 다음을 참조하세요. 통합 개요 - Entra ID 싱글 사인온. 통합 콜백 URL, 방화벽 규칙, 이전의 나머지 작업은 다음을 참조하세요. IT 관리자 가이드: Legora의 글로벌 인증.

​
문제 해결

assertion과 Legora URL 두 개부터 확인하세요.

​
로그인에 실패하거나 사용자를 찾을 수 없음

Legora는 email 클레임이 필요하며, 이메일을 미확인으로 표시한 assertion은 거부합니다. ID 공급자가 email을 보내는지, given_name과 family_name을 보낼 때 이 이름을 사용하는지 확인하세요. 테스트 사용자가 애플리케이션에 할당되어 있는지도 확인하세요.

​
응답 URL 또는 entity ID가 거부됨

ID 공급자의 ACS URL과 Entity ID는 이 가이드의 값과 정확히 일치해야 합니다. 끝에 슬래시 없이 https://sso.legora.com을 사용하고, 전체 ACS URL https://sso.legora.com/api/oauth/saml을 사용하세요. 이 확인으로 해결되지 않으면 support@legora.com으로 문의하세요.