SSO 관리¶
Guance는 SAML 2.0 및 OIDC/OAuth 2.0 프로토콜 기반의 싱글 사인온(SSO)을 지원합니다. 기업은 로컬 ID 공급자(IdP)에서 직원 계정을 통합 관리할 수 있으며, Guance와 IdP 간에 사용자 정보를 동기화할 필요가 없습니다. 직원은 회사 이메일만으로 Guance에 로그인할 수 있으며, 사전 설정된 권한에 따라 시스템에 액세스할 수 있습니다.
개념¶
| 용어 | 설명 |
|---|---|
| IdP(ID 공급자) | 기업 내부의 통합 인증 시스템(예: Azure AD, Okta, OneAuth, Keycloak, DingTalk, WeCom, 자체 구축 LDAP 등) |
| SP(서비스 제공자) | 서비스 수신자로서의 Guance 플랫폼 |
| 역할 매핑 | IdP가 반환한 사용자 속성(예: 부서, 직책, 사용자 그룹)을 기반으로 Guance의 역할 권한 자동 할당 |
| Entity ID | SAML 프로토콜에서 Guance가 SP로서 가지는 고유 식별자 |
| ACS URL | Assertion Consumer Service URL로, SAML 로그인 성공 후 IdP가 Guance에 어서션을 제출하는 주소 |
기능 특성¶
- IdP 지원: 단일 워크스페이스에 최대 10개의 ID 공급자를 구성할 수 있으며, 기업 내부의 다양한 인증 체계와 호환됩니다.
- 워크스페이스 간 재로그인 불필요: 동일한 ID 공급자에서 인증받은 사용자는 로그인 세션 유효 기간 내에 다른 인증된 워크스페이스로 이동할 수 있으며, 재인증이 필요하지 않습니다.
- 동적 권한: 역할 매핑을 통해 사용자 속성 기반의 세분화된 권한 제어를 구현합니다.
- 자동 계정 연동: SSO 첫 로그인 시 이메일이 기존 Guance 계정과 일치하면 자동으로 연동되고 기존 데이터가 유지됩니다.
빠른 시작¶
설정 진입¶
관리 > 멤버 관리 > SSO 관리 > 사용자 SSO로 이동합니다.
프로토콜 유형 선택¶
| 프로토콜 | 사용 사례 | 구성 |
|---|---|---|
| SAML 2.0 | 기업에 Azure AD, ADFS, Okta, OneAuth, Keycloak 등 표준 SAML 서비스가 이미 구축된 경우 | SAML 구성 가이드 보기 |
| OIDC/OAuth 2.0 | 기업이 자체 구축 인증 시스템 또는 최신 클라우드 IdP를 사용하는 경우 | OIDC 구성 가이드 보기 |
사용자 로그인¶
ID 공급자를 구성하고 활성화한 후, 직원은 회사 이메일을 사용하여 SSO 로그인 페이지에서 SSO 로그인을 시작할 수 있습니다.
- 전체 회사 이메일 주소를 입력하여 사용 가능한 ID 공급자를 조회합니다.
- 사용할 ID 공급자를 선택하여 기업 인증 페이지로 이동합니다.
- 기업 인증 페이지의 요구 사항에 따라 로그인을 완료합니다.
- 인증 완료 후 워크스페이스 선택 페이지에서 액세스 권한이 있는 워크스페이스를 선택합니다.
ID 공급자는 다음 규칙에 따라 매칭됩니다.
- 기존 SSO 계정: 전체 이메일 주소에 해당하는 SSO ID를 기준으로, 해당 ID와 연결된 유효한 ID 공급자 구성을 표시합니다. 동일한 이메일 도메인의 서로 다른 직원도 각자 자신의 ID 공급자를 사용할 수 있습니다.
- SSO 첫 사용: 계정에 SSO ID가 아직 생성되지 않은 경우, ID 공급자의 액세스 제한에 따라 전체 이메일 주소 또는 이메일 도메인을 매칭합니다.
ID 공급자에 이미 연결된 계정은 연결된 구성이 비활성화되거나 삭제되거나 소속 워크스페이스가 더 이상 유효하지 않게 된 경우, 관리자에게 문의하여 구성을 확인하시기 바랍니다. 로그인 후의 워크스페이스 액세스 및 역할 권한은 여전히 해당 워크스페이스의 멤버 권한 부여 및 역할 매핑에 따라 결정됩니다.
역할 매핑¶
사용자 속성 기반의 동적 권한 할당을 구현합니다.
SSO 설정 관리¶
목록 작업¶
ID 공급자를 추가한 후 다음 작업을 통해 SSO 구성을 관리할 수 있습니다.
| 작업 | 설명 | 위험 안내 |
|---|---|---|
| 편집 | 구성 정보 및 활성화/비활성화 상태 수정 | 기존 SSO 멤버의 로그인 환경에 영향을 줄 수 있으므로 업무 시간 외에 작업할 것을 권장 |
| 삭제 | 해당 ID 공급자 제거 | 관련 멤버는 이 방식으로 로그인할 수 없게 되므로, 사전에 공지하고 다른 로그인 수단이 있는지 확인 |
| 내보내기 | JSON 파일로 내보내기 | 파일 이름은 현재 워크스페이스의 다른 IdP와 중복될 수 없으며, 다른 워크스페이스로 빠르게 복사할 때 유용 |
| 가져오기 | JSON 파일에서 빠르게 생성 | 형식 규격에 부합해야 하며, 먼저 하나를 내보내 템플릿으로 사용할 것을 권장 |
SSO 멤버 보기¶
- 멤버 수: SSO로 로그인한 모든 멤버의 총 수를 표시합니다.
- 멤버 명단: 멤버 수를 클릭하면 권한이 부여된 SSO 멤버 명단을 확인할 수 있습니다.
알림 메커니즘¶
다음 작업은 워크스페이스의 Owner와 Administrator에게 이메일 알림을 전송합니다.
- SSO 구성 추가/활성화
- 주요 구성 수정(도메인, 역할 매핑 규칙)
- SSO 구성 삭제