콘텐츠로 이동

SAML


이 문서에서는 Guance 워크스페이스에서 SAML 2.0 프로토콜 기반 SSO(Single Sign-On)를 구성하는 방법을 설명합니다.

사전 준비

구성을 시작하기 전에 다음 준비 사항이 갖추어져 있는지 확인하세요.

준비 항목 설명
IdP 관리자 권한 기업 ID 공급자(Azure AD, Okta, OneAuth, Keycloak 등)에 SAML 앱을 생성해야 합니다.
메타데이터 XML 파일 IdP에서 내보낸 SAML 메타데이터 문서로, 로그인 주소, 공개 키 인증서 등의 주요 정보가 포함됩니다.
기업 이메일 도메인 SSO 사용자의 이메일 도메인 접미사를 식별하는 데 사용됩니다(예: example.com).

설정 단계

1단계: 구성 페이지로 이동

  1. 관리 > 멤버 관리 > SSO 관리 > 사용자 SSO로 이동합니다.
  2. SAML 액세스 유형을 선택합니다.
  3. ID 공급자 추가를 클릭합니다.

2단계: 기본 정보 입력

  1. ID 공급자: 사용자 ID와 인증 정보를 관리하는 ID 관리 서비스 플랫폼입니다. 여기에서 이름을 정의합니다(❗️이 사용자 지정 표시 이름은 IdP 별칭으로 로그인 선택 화면에 표시됩니다. 회사 Azure AD처럼 식별하기 쉬운 이름을 입력하는 것을 권장합니다).
  2. 메타데이터 문서: IdP에서 제공하는 XML 형식 메타데이터 파일을 업로드하면 시스템이 로그인 주소, 공개 키 등의 정보를 자동으로 파싱합니다.
  3. 비고: 해당 ID 공급자에 대한 설명을 기록하는 사용자 지정 설명입니다.

3단계: 필드 매핑 구성

IdP에서 반환한 사용자 속성과 Guance 계정 정보 간의 매핑 관계를 구성합니다.

매핑 필드 필수 여부 설명
사용자 이름 필수 사용자 이름을 가져오기 위해 IdP에서 반환하는 사용자 이름 속성 이름을 입력합니다.
이메일 필수 사용자 이메일을 가져오기 위해 IdP에서 반환하는 이메일 속성 이름을 입력합니다.
휴대폰 번호 선택 계정에 휴대폰 번호가 아직 설정되지 않은 경우 번호를 추가하기 위해 IdP에서 반환하는 휴대폰 번호 속성 이름을 입력합니다.

매핑 값은 실제 이름, 이메일 주소 또는 휴대폰 번호가 아니라 IdP에서 반환한 속성 이름을 입력해야 합니다. IdP의 실제 반환 내용에 따라 구성하십시오.

휴대폰 번호 기록 규칙

SAML 로그인 시 계정 휴대폰 번호는 다음 규칙에 따라 처리됩니다.

계정 휴대폰 번호 IdP 반환 여부 처리 방식
설정됨 휴대폰 번호 반환 또는 미반환 계정의 기존 번호를 유지하며 덮어쓰거나 지우지 않습니다.
미설정 휴대폰 번호 매핑으로 번호를 가져온 경우 IdP에서 반환한 번호를 계정에 기록합니다.
미설정 휴대폰 번호 미반환 휴대폰 번호를 기록하지 않으며 로그인에는 영향을 주지 않습니다.

SSO 사용자는 계정 설정에서 휴대폰 번호를 직접 설정하거나 수정할 수도 있습니다. 계정에 번호를 저장한 후에는 이후 SAML 로그인 시 해당 번호를 덮어쓰거나 지우지 않습니다.

음성 전화(IVR) 알림은 계정에 저장된 휴대폰 번호로 전화를 겁니다. IdP가 휴대폰 번호를 반환하지 않고 계정에도 번호가 설정되지 않은 경우 사용자는 정상적으로 로그인할 수 있지만, 음성 알림을 받으려면 먼저 휴대폰 번호를 추가해야 합니다.

4단계: 로그인 제어

  1. 액세스 제한: 기업 이메일 도메인(예: example.com)을 입력하면 시스템이 로그인 이메일의 도메인 접미사 일치 여부를 검증합니다. 최초 로그인한 이메일은 워크스페이스 멤버 계정을 자동으로 생성할 수 있습니다.
  2. 역할 권한 부여: 최초 로그인하는 SSO 사용자에게 기본 역할(관리자/표준 멤버/읽기 전용 멤버)을 할당합니다. 최초 로그인이 아닌 사용자는 영향을 받지 않습니다.

    • 워크스페이스에서 SAML 매핑이 활성화된 경우 시스템은 매핑 규칙에 따라 역할을 우선 할당하며, 여기에서 구성한 기본 역할은 매핑 규칙에 일치하지 않은 사용자에게만 적용됩니다.
  3. 세션 유지: SSO 로그인 세션의 비활동 유지 시간과 최대 유지 시간을 설정합니다.

세션 유지

SSO로 로그인하는 기업 멤버에게 통일된 로그인 유지 시간을 설정합니다.

구성 항목 범위 기본값 설명
비활동 로그인 세션 유지 시간 180~1440분 180분 사용자가 비활동 상태가 된 후 자동으로 로그아웃되는 시간입니다.
로그인 세션 최대 유지 시간 0~7일 7일 작업 여부와 관계없이 해당 시간이 지나면 강제 로그아웃됩니다. 0은 만료되지 않음을 의미합니다.

세션 유지 시간을 변경한 후에는 이미 로그인한 멤버가 기존 설정을 유지하고, 새로 로그인하는 멤버에게 최신 설정이 적용됩니다.

예시

SSO 로그인 유지 시간을 업데이트한 후:

  • 이미 로그인한 멤버: 로그인 세션 만료 시간이 변경되지 않습니다.
  • 새로 로그인한 멤버: 최신 로그인 유지 시간 설정이 적용됩니다.

예:

  • SSO를 처음 구성할 때 비활동 세션 만료 시간이 30분입니다. 이때 멤버 A가 로그인하면 비활동 세션 만료 시간은 30분입니다.
  • 관리자가 이후 비활동 세션 만료 시간을 60분으로 업데이트합니다. 멤버 A의 비활동 세션 만료 시간은 여전히 30분이며, 이후에 로그인한 멤버 B의 비활동 세션 만료 시간은 60분이 됩니다. 이후에도 같은 방식이 적용됩니다.

5단계: SP 구성 정보 가져오기

ID 공급자 추가가 완료되면 편집 페이지에서 서비스 제공자 상세 영역까지 스크롤하여 Guance가 SP(서비스 제공자)로 사용하는 구성 정보를 가져옵니다.

필드 설명
로그인 주소 Guance SSO 로그인 진입점입니다. 각 주소는 하나의 워크스페이스에만 액세스할 수 있습니다. 형식: https://<auth-domain>/saml/login/sso_<id>
Metadata Guance SP 메타데이터 파일입니다. 다운로드하여 IdP로 가져올 수 있습니다.
Entity ID Guance SP 고유 식별자입니다. IdP에서 구성해야 하며 일반적으로 http://<auth-domain>/saml/metadata.xml 형식입니다.
어서션 주소 IdP 로그인 성공 후 Guance에 SAML 어서션을 제출하는 주소(ACS URL)입니다. 형식: https://<auth-domain>/saml/assertion/sso_<id>

6단계: IdP에서 SP 정보 구성

5단계에서 얻은 정보를 바탕으로 IdP에서 다음 구성을 완료합니다.

  1. Entity ID: Guance에서 제공하는 Entity ID를 입력합니다.
  2. ACS URL(어서션 주소): Guance에서 제공하는 어서션 주소를 입력합니다.
  3. Name ID 형식: IdP가 사용자 이메일(EmailAddress 형식)을 반환하도록 합니다.
  4. 서명 인증서: 필요한 경우 Guance 메타데이터에 포함된 인증서를 업로드합니다.

일반적인 IdP 구성 참고

사용자 로그인 검증

  1. SSO 로그인 페이지를 열고 전체 기업 이메일 주소를 입력합니다.
  2. 계정에 해당하는 ID 공급자를 선택하고 기업 인증 페이지의 요구사항에 따라 로그인을 완료합니다.
  3. 인증에 성공하면 워크스페이스 선택 페이지에서 액세스 권한이 있는 워크스페이스로 이동합니다.

기존 SSO 계정은 전체 이메일에 해당하는 SSO ID로 ID 공급자를 조회합니다. SSO ID가 아직 생성되지 않은 경우 액세스 제한에 따라 이메일 또는 도메인을 일치시킵니다. 자세한 규칙은 사용자 로그인에서 확인하세요.

주의사항

  1. 역할 매핑이 활성화된 경우: 사용자가 어떤 역할 매핑 규칙에도 일치하지 않거나 역할 매핑이 비활성화된 경우 로그인 후 '액세스 권한 없음'이 표시됩니다.
  2. ID 공급자를 삭제하면 사용자가 SSO로 로그인할 때 삭제된 IdP에 해당하는 워크스페이스가 표시되지 않습니다.
  3. 다중 IdP 구성: 단일 워크스페이스는 최대 10개의 IdP를 지원합니다. 사용자는 계정에 따라 사용 가능한 ID 공급자를 매칭하며, 기업 인증을 완료한 후 워크스페이스 권한에 따라 액세스합니다.
  4. 계정 바인딩: SSO 최초 로그인 시 이메일이 기존 Guance 계정과 일치하면 자동으로 바인딩되며 기존 데이터가 유지됩니다.

더 읽어보기

다음 내용이 도움이 될 수 있습니다.

문서 평가

이 페이지가 도움이 되었나요?