Okta SSO 예시¶
Okta는 ID 및 액세스 관리(IAM) 솔루션 공급업체입니다.
작업 절차¶
1. Okta 애플리케이션 생성¶
참고: 애플리케이션을 생성하기 전에 먼저 Okta 웹사이트에서 계정을 등록하고 조직을 생성해야 합니다.
- Okta 웹사이트를 열고 로그인한 다음, 오른쪽 상단의 사용자를 클릭하고 드롭다운 목록에서 Your Org를 선택합니다.
- Okta 조직 페이지에서 오른쪽 메뉴의 Application을 클릭하고, 열린 페이지에서 Create App Integration을 클릭합니다.
- SAML 2.0을 선택하여 새 애플리케이션을 생성합니다.
2. Okta 애플리케이션에 SAML 구성¶
참고: 이 단계에서는 Okta 애플리케이션 속성을 Guance의 속성에 매핑하여 Okta와 Guance 간에 신뢰 관계를 설정합니다.
- 새로 생성한 애플리케이션의 General Settings에서 애플리케이션 이름(예: "okta")을 입력하고 다음을 클릭합니다.
-
Configure SAML의 SAML Settings 섹션에서 Assertion URL과 Entity ID를 입력합니다.
-
Single sign on URL: Assertion URL, 예시: https://auth.guance.com/saml/assertion
- Audience URI(SP Entity ID): Entity ID, 예시: https://auth.guance.com/saml/metadata.xml
참고: 이번 구성은 다음 단계에서 사용할 메타데이터 문서를 얻기 위한 것입니다. Guance에서 SSO를 활성화한 후 올바른 Entity ID와 Assertion URL을 가져와 다시 교체해야 합니다.
-
Configure SAML의 Attribute Statements(optional) 섹션에서 Name과 Value를 입력합니다.
-
Name: 이 예시에서는 Email을 입력하며, 사용자 이메일을 전달하는 데 사용합니다.
- Value: ID 공급자의 실제 이메일 형식에 맞게 입력합니다. Okta에서는 user.email을 입력할 수 있습니다.
참고: Guance의 SAML 필드 매핑에서 이메일 매핑에 여기서 반환된 속성 이름(이 예시에서는 Email)을 입력합니다. 동시에 필수 항목인 사용자 이름 매핑을 구성하고, 휴대폰 번호 매핑은 필요에 따라 입력할 수 있습니다.
- Feedback에서 다음 옵션을 선택하고 Finish를 클릭하여 SAML 구성을 완료합니다.
3. Okta 메타데이터 문서 가져오기¶
참고: 이 단계에서는 Guance에 ID 공급자를 생성할 때 사용할 메타데이터 문서를 가져올 수 있습니다.
- Sign On에서 Identity Provider metadata를 클릭하여 ID 공급자 메타데이터를 확인합니다.
- 확인 페이지에서 마우스 오른쪽 버튼을 클릭하여 로컬에 저장합니다.
참고: 메타데이터 문서는 xml 파일(예: "metadata.xml")입니다.
4. Guance에서 SSO 활성화¶
- SSO를 활성화합니다. Guance 워크스페이스의 관리 > 구성원 관리 > SSO 관리에서 활성화를 클릭하면 됩니다.
참고 문서: SSO 생성
참고: 계정 보안을 위해 Guance은 워크스페이스당 하나의 SSO만 구성할 수 있습니다. 이전에 SAML 2.0을 이미 구성한 경우, 기본적으로 마지막으로 업데이트한 SAML 2.0 구성이 최종 SSO 로그인 검증 진입점으로 간주됩니다.
- 3단계에서 다운로드한 메타데이터 문서를 업로드하고, 도메인(이메일 접미사 도메인)을 구성한 다음 역할을 선택하면 해당 ID 공급자의 Entity ID와 Assertion URL을 확인할 수 있습니다. 로그인 주소를 복사하여 바로 로그인할 수 있습니다.
참고: 도메인은 Guance와 ID 공급자가 이메일 도메인을 매핑하여 SSO 로그인을 구현하는 데 사용됩니다. 즉, 사용자 이메일의 접미사 도메인은 Guance에 추가된 도메인과 일치해야 합니다.
5. Okta에서 SAML Assertion URL 교체¶
- Okta로 돌아가 2단계의 Entity ID와 Assertion URL을 교체합니다.
참고: Guance에서 SSO를 구성할 때 ID 공급자 SAML에 구성된 Assertion URL은 Guance의 값과 일치해야 SSO 로그인이 가능합니다.
6. Okta 사용자 구성¶
참고: 이 단계에서는 Guance에 ID 공급자를 생성할 때 사용할 권한 있는 사용자 이메일 계정을 구성합니다. 구성된 Okta 사용자 이메일 계정으로 Guance 플랫폼에 SSO 로그인할 수 있습니다.
- Assignments > Assign에서 Assign to People을 선택합니다.
- Guance에 SSO 로그인할 사용자(예: "jd@qq.com")를 선택하고 Assign을 클릭합니다.
- Save and Go Back을 클릭하여 사용자 구성을 완료합니다.
- Assignments로 돌아가면 권한이 구성된 Okta 사용자를 확인할 수 있습니다.
7. Okta 계정으로 Guance에 SSO 로그인¶
- SSO 구성을 완료한 후 Guance 공식 사이트 또는 Guance 콘솔에서 로그인하고, 로그인 페이지에서 SSO를 선택합니다.
- SSO 생성 시 사용한 이메일 주소를 입력하고 로그인 주소 가져오기를 클릭합니다.
- 링크를 클릭하면 기업 계정 로그인 페이지가 열립니다.
- 기업 공용 이메일과 비밀번호를 입력합니다.
- Guance의 해당 워크스페이스로 로그인됩니다.
참고: 여러 워크스페이스에 동일한 ID 공급자의 SSO 로그인이 동시에 구성된 경우, 사용자가 SSO로 워크스페이스에 로그인한 후 Guance 왼쪽 상단의 워크스페이스 옵션을 클릭하여 다른 워크스페이스로 전환하고 데이터를 확인할 수 있습니다.



















