콘텐츠로 이동

자주 묻는 질문


구성 전 준비

회사에서 SAML과 OIDC 중 무엇을 사용해야 할지 확실하지 않습니다. 어떻게 선택하나요?

먼저 회사의 IdP(ID 공급자) 유형을 확인하세요.

  • Azure AD, Okta, OneAuth, Keycloak 등 표준 기업 ID 관리 제품이라면 일반적으로 둘 다 지원하므로, 구성이 더 간단한(메타데이터 XML만 업로드하면 되는) SAML을 우선 권장합니다.

  • 자체 구축 시스템이나 개발자 플랫폼(예: Authing, Auth0)이라면 OIDC만 지원할 수 있으므로 OIDC를 선택하세요.

  • 확실하지 않다면 IT 관리자에게 문의하여 IdP가 지원하는 프로토콜 유형을 확인하세요.


IdP에서 애플리케이션을 만들려면 먼저 SP의 Entity ID와 콜백 URL을 제공해야 하는데, Guance은 먼저 IdP 메타데이터를 업로드하도록 요구합니다. 어떻게 해야 하나요?

임시 주소로 먼저 구성하세요.

  • Entity ID: https://auth.guance.com/saml/metadata.xml

  • Assertion URL(ACS URL): https://auth.guance.com/saml/assertion

IdP에 위 임시 주소를 입력하고 메타데이터 XML을 다운로드한 후 Guance에서 IdP를 생성하세요. 생성이 완료되면 실제 Entity ID와 Assertion URL을 확인하고 IdP로 돌아가 교체하면 됩니다.


구성 중

IdP 메타데이터를 업로드한 후 Guance에서 "파싱 실패" 또는 "형식 오류" 메시지가 표시됩니다.

다음 사항을 확인하세요.

  1. 다운로드한 파일이 SAML 메타데이터 XML인지 확인하세요. 인증서 파일이나 다른 형식이면 안 됩니다.

  2. XML 파일이 완전한지 확인하세요. IdP에서 다운로드한 파일이 브라우저에서 잘려나가는 경우가 있으므로 "다른 이름으로 저장" 방식으로 다운로드하는 것이 좋습니다.

  3. IdP에 Entity ID와 ACS URL이 정상적으로 구성되어 있는지 확인하세요. 비어 있는 구성의 메타데이터는 핵심 필드가 누락될 수 있습니다.

  4. 자체 서명 인증서를 사용하는 경우 인증서가 만료되지 않았는지 확인하세요.


OIDC 구성에서 "IdP URL"에는 무엇을 입력해야 하나요?

IdP의 Issuer URL(서비스 검색 주소)을 입력하세요. 일반적인 형식은 다음과 같습니다.

  • Keycloak: https://keycloak.example.com/realms/<realm-name>

  • Authing: https://<app-id>.authing.cn/oidc

  • Auth0: https://<tenant>.auth0.com/

  • 자체 구축 OIDC: https://auth.example.com

입력하면 Guance이 .well-known/openid-configuration 엔드포인트를 자동으로 검색합니다. "구성을 가져올 수 없음" 메시지가 표시되면 URL이 잘못되었거나 IdP에서 검색 서비스가 활성화되지 않은 것이므로, 비표준 OIDC 구성으로 전환하여 엔드포인트를 직접 입력해야 합니다.


OIDC 매핑 구성에서 "사용자 이름" 필드에는 무엇을 입력하나요?

이는 IdP가 반환하는 사용자 정보 필드 이름에 따라 달라집니다. 일반적인 대응 관계는 다음과 같습니다.

IdP 유형 사용자 이름 필드 이메일 필드 휴대폰 번호 필드
Keycloak preferred_username email phone_number
Authing name 또는 username email phone
Auth0 name email phone_number
자체 구축 시스템 실제 반환 값에 따라 입력 email 실제 반환 값에 따라 입력

확실하지 않다면 IdP에서 사용자 정보 가져오기를 테스트하여 반환되는 JSON 필드 이름을 확인하세요.


역할 매핑을 구성할 때 "속성 필드"와 "속성 값"은 어떻게 입력하나요?

이는 IdP가 사용자 인증 시 반환하는 속성에 따라 달라집니다. 예를 들어:

예시: 부서별 역할 할당

  • IdP가 반환한 사용자 속성: {"department": "技术部", "role": "admin"}

  • Guance 구성:

    • 속성 필드: department

    • 속성 값: 技术部

    • 역할 할당: 표준 멤버

예시: 사용자 그룹별 역할 할당

  • IdP가 반환한 사용자 속성: {"groups": ["admin", "developer"]}

  • Guance 구성:

    • 속성 필드: groups
    • 속성 값: admin(여러 값은 쉼표로 구분할 수 있습니다. 예: admin,developer)
    • 역할 할당: 관리자

속성 필드 이름은 IdP가 반환하는 값과 완전히 일치해야 합니다(대소문자 구분).


로그인 문제

이메일을 입력한 후 사용하려는 IdP를 찾을 수 없으면 어떻게 하나요?

관리자는 다음 순서로 확인하세요.

  1. 입력된 이메일이 완전한 기업 이메일 주소인지 확인하고, 해당 이메일에 기존 SSO 계정이 속한 IdP를 확인하세요.
  2. 해당 IdP 구성이 활성화되어 있고 소속 워크스페이스가 정상인지 확인하세요.
  3. SSO를 처음 사용하여 아직 SSO 계정이 생성되지 않은 경우, 접근 제한에 해당 이메일 또는 이메일 도메인이 포함되어 있는지 확인하세요.

기존 SSO 계정이 있는 경우 계정 ID를 기준으로 IdP를 찾습니다. 자세한 규칙은 사용자 로그인을 참조하세요.


IdP 로그인 페이지로 정상적으로 이동되지만, 로그인 후 Guance으로 돌아오면 "사용자 정보를 가져올 수 없음" 메시지가 표시됩니다(OIDC).

다음 사항을 확인하세요.

  1. 매핑 필드 오류: "이메일" 매핑 필드가 IdP가 실제로 반환하는 필드 이름과 일치하는지 확인하세요(일반적인 오류는 mail을 입력했지만 IdP가 email을 반환하는 경우입니다).

  2. Scope 누락: email이 인증 요청 Scope에 포함되어 있고 IdP가 이메일 정보 반환을 허용하는지 확인하세요.

  3. 사용자 정보 엔드포인트 오류: 비표준 OIDC라면 구성 파일의 userinfo_endpoint가 올바른지 확인하세요.

  4. 토큰 파싱 실패: IdP가 사용하는 서명 알고리즘이 HS256인지 확인하세요. Guance은 현재 RS256을 지원하지 않습니다.


SAML 로그인은 성공했지만 사용자 역할이 올바르지 않습니다.

역할 매핑 구성을 확인하세요.

  1. 역할 매핑 기능이 활성화되어 있는지 확인하세요(스위치 상태).

  2. IdP에서 사용자 속성이 올바르게 반환되는지 확인하세요(브라우저 개발자 도구에서 SAML Assertion을 확인하거나 SAML 디버깅 도구를 사용할 수 있습니다).

  3. "속성 필드"와 "속성 값"이 Assertion의 값과 완전히 일치하는지 확인하세요.

  4. 사용자가 여러 규칙에 매칭되어야 한다면, 의도한 대로 최고 권한 역할이 할당되었는지 확인하세요.


SSO 로그인 후 사용자가 여러 워크스페이스를 볼 수 있는데, 전환할 때 "권한 없음" 메시지가 표시되는 이유는 무엇인가요?

이는 다음과 같은 이유 때문입니다.

  1. 사용자가 IdP A를 통해 워크스페이스 1에 로그인했습니다.

  2. 워크스페이스 2에도 동일한 IdP A가 구성되어 있지만 역할 매핑 규칙이 다릅니다.

  3. 사용자가 워크스페이스 2로 전환하면 Guance이 역할 매핑을 다시 검증하여 사용자가 워크스페이스 2의 규칙과 일치하지 않는 것을 확인합니다.

이 경우 동일한 IdP의 역할 매핑 규칙이 모든 워크스페이스에서 일치하도록 하거나, 워크스페이스 간 사용자를 위해 공통 매핑 규칙(예: 통일된 사용자 그룹 식별자)을 구성하세요.


사용자 관리

직원이 퇴사한 후 해당 직원이 SSO로 Guance에 로그인하는 것을 완전히 차단하려면 어떻게 해야 하나요?

두 곳에서 동시에 삭제해야 합니다.

  1. IdP 측: 해당 직원의 계정을 삭제하거나 비활성화하여 기업 인증을 통과하지 못하게 합니다.

  2. Guance 측: 관리 > 멤버 관리 > SSO 관리로 이동하여 SSO 멤버 수를 클릭한 후 해당 사용자를 찾아 삭제합니다.

Guance 측만 삭제하면 직원이 여전히 SSO로 로그인할 수 있고(계정이 자동으로 다시 생성됨), IdP 측만 삭제하면 직원이 세션 만료 전까지 Guance의 로그인 상태를 유지할 수 있습니다.


SSO 사용자는 Guance에 표시되는 사용자 이름을 어떻게 변경하나요?

SSO 사용자의 사용자 이름은 IdP가 반환하는 매핑 필드에 의해 결정되므로 Guance 측에서 직접 변경할 수 없습니다. 변경하려면 다음을 수행하세요.

  1. IdP에서 사용자의 해당 속성(예: preferred_username 또는 name)을 수정합니다.

  2. 사용자가 Guance에 다시 로그인하면 변경 사항이 동기화됩니다.

Guance에 다른 이름을 표시해야 한다면 IdP 관리자에게 속성 매핑 조정을 요청하거나, Guance에서 역할 매핑을 활성화할 때 표시 이름에 영향을 주지 않는 필드(예: 사용자 그룹)로 권한을 제어하는 것이 좋습니다.


SSO 사용자가 휴대폰 번호를 직접 설정하거나 변경할 수 있나요?

가능합니다. 계정 설정 > 사용자 정보에서 휴대폰 번호를 설정하거나 변경할 수 있으며, IdP에서 작업할 필요가 없습니다.

계정에 이미 휴대폰 번호가 있는 경우 이후 SAML 로그인 시 해당 번호가 유지되며, IdP가 다른 번호를 반환해도 덮어쓰지 않고, IdP가 휴대폰 번호를 반환하지 않아도 지워지지 않습니다. 자세한 규칙은 휴대폰 번호 저장 규칙을 참조하세요.


IdP가 휴대폰 번호를 반환하지 않으면 SAML 로그인이나 음성 알림에 영향을 미치나요?

SAML 로그인에는 영향을 미치지 않습니다. SAML의 필드 매핑에서 사용자 이름과 이메일은 필수이고 휴대폰 번호는 선택 사항입니다.

음성 전화(IVR) 알림은 계정에 저장된 휴대폰 번호를 사용합니다. 계정에 이미 번호가 있으면 해당 번호로 알림을 계속 받을 수 있고, 번호가 없으면 먼저 계정 설정에서 휴대폰 번호를 추가해야 합니다.


일부 직원은 SSO로 로그인하고 일부 직원은 일반 계정 비밀번호로 로그인하도록 할 수 있나요?

가능합니다. Guance은 혼합 로그인 모드를 지원합니다.

  • SSO 관리에서 SSO를 사용하는 직원을 위해 IdP와 접근 제한을 구성합니다.

  • 일반 계정을 사용하는 직원은 Guance 계정 비밀번호 또는 휴대폰 번호 인증 코드 항목으로 로그인합니다.

  • SSO를 사용하는 직원은 SSO 로그인 페이지에서 전체 이메일을 입력하고 계정에 해당하는 IdP를 선택하여 기업 인증을 완료합니다.

IdP 일치 방식은 사용자 로그인을 참조하세요.


다중 IdP 및 워크스페이스 간

회사가 다른 회사를 인수하여 서로 다른 Azure AD 두 개를 보유하게 되었습니다. 두 Azure AD를 모두 동일한 Guance 워크스페이스에 구성할 수 있나요?

가능합니다. Guance 단일 워크스페이스는 최대 10개의 IdP를 지원합니다. 구성 방법:

  1. 두 Azure AD를 각각 별도의 IdP로 추가합니다.

  2. 각각의 이메일 도메인(예: @company-a.com, @company-b.com)을 구성합니다.

  3. 두 IdP에 대해 각각 역할 매핑 규칙을 구성합니다(규칙은 달라도 됩니다).

사용자가 로그인하면 Guance은 완전한 이메일에 해당하는 기존 SSO 계정을 기준으로 IdP를 우선 일치시킵니다. SSO를 처음 사용하여 아직 SSO 계정이 생성되지 않은 경우에는 접근 제한에 따라 이메일 또는 도메인을 일치시킵니다.


"한 번의 로그인으로 여러 워크스페이스에 접근"하는 진정한 SSO를 구현할 수 있나요?

가능하지만 다음 조건을 충족해야 합니다.

  1. 여러 워크스페이스에 동일한 IdP(또는 신뢰하는 여러 IdP)가 구성되어 있어야 합니다.

  2. 사용자의 IdP 세션이 유효한 상태(만료되지 않음)이어야 합니다.

  3. 사용자가 각 워크스페이스에서 유효한 역할을 가지고 있어야 합니다(역할 매핑 또는 기본 역할 할당을 통해).

조건이 충족되면 사용자가 어떤 워크스페이스에 로그인한 후 세션이 유효한 동안 상단의 워크스페이스 전환기를 통해 비밀번호를 다시 입력하지 않고 다른 워크스페이스로 바로 이동할 수 있습니다.


보안 및 규정 준수

SSO 사용자의 로그인 활동을 어떻게 감사하나요?

Guance은 다음 감사 기능을 제공합니다.

  1. SSO 멤버 목록: 각 IdP를 통해 로그인한 멤버 명단과 마지막 로그인 시간을 확인할 수 있습니다.

  2. 작업 감사: 관리 > 감사 이벤트에서 사용자의 작업 기록(로그인, 로그아웃, 주요 작업 포함)을 확인할 수 있습니다.

  3. 알림 메커니즘: SSO 구성이 변경되면 Owner 및 Administrator에게 이메일 알림이 발송됩니다.


문서 평가

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