Okta로 SSO 설정하기

Okta와 Clevera 간에 싱글 사인온을 설정하여 팀원들이 Okta 계정으로 로그인할 수 있도록 하세요. SAML 2.0 또는 OpenID Connect(OIDC)를 통해 연결할 수 있으며, 이 가이드에서는 Okta 측 설정과 Clevera의 해당 필드 입력 방법을 모두 설명합니다.

Okta 관리자 콘솔은 주기적으로 변경됩니다. 아래 레이블이 실제 화면과 일치하지 않는 경우, 동일한 의미의 설정을 찾아보세요. 전체 값 목록은 일반 가이드를 참조하세요: SAML, OIDC.

시작하기 전에#

• 사용자 지정 플랜을 사용하는 Clevera 워크스페이스의 소유자여야 합니다.
• 앱 통합을 생성하고 할당할 수 있는 Okta 관리자여야 합니다.
• 팀원이 Okta에서 사용하는 이메일 도메인(예: acme.example)을 알고 있어야 합니다.

먼저 Clevera 설정 대화 상자를 열어 값을 복사할 수 있도록 준비하세요. 사이드바 상단의 워크스페이스 메뉴를 열고 팀 설정, 보안을 차례로 선택한 다음 SSO 설정을 클릭합니다. ID 공급자로 Okta를 선택하세요.

SAML 2.0으로 연결#

1. Okta에서 앱 생성#

   Okta 관리자 콘솔에서 Applications → Applications로 이동한 후 Create App Integration을 클릭합니다. SAML 2.0을 선택하고 다음을 클릭하세요. 이름을 Clevera으로 지정하고 다음을 클릭합니다.

2. Clevera 값 입력#

   SAML Settings에서 다음을 입력하세요:

   Okta 필드	Clevera에서 가져온 값
   Single sign-on URL	ACS URL (Reply URL): https://app.clevera.ai/sso/saml/callback. Use this for Recipient URL and Destination URL이 체크되어 있는지 확인하세요.
   Audience URI (SP Entity ID)	Entity ID / Audience URI (Clevera 대화 상자에서 복사하세요. 워크스페이스 ID로 끝납니다)
   Default RelayState	비워 두세요
   Name ID format	EmailAddress
   Application username	Email

3. 서명 확인#

   Show Advanced Settings를 클릭하고 Response와 Assertion Signature가 모두 Signed로 설정되어 있는지, Signature Algorithm이 RSA-SHA256인지, Assertion Encryption이 Unencrypted인지 확인하세요. Clevera는 응답과 어설션 모두에 서명이 필요합니다.

4. 이름 속성 추가#

   Attribute Statements에서 firstName(값: user.firstName)과 lastName(값: user.lastName)를 추가하세요. Clevera는 이를 사용하여 새 계정의 이름을 지정합니다. 다음을 클릭하고 Okta의 피드백 질문에 내부 앱이라고 답한 뒤 마침을 클릭합니다.

5. Okta 값을 Clevera에 복사#

   앱의 Sign On 탭에서 SAML 설정 세부 정보(View SAML setup instructions 또는 최신 콘솔의 More details)를 엽니다. Clevera에서 Protocol을 SAML 2.0으로 설정하고 계속을 클릭한 뒤 다음을 붙여넣으세요:

   Okta 값	Clevera 필드
   Identity Provider Issuer (또는 Issuer)	IdP Entity ID
   Identity Provider Single Sign-On URL (또는 Sign on URL)	SSO sign-in URL
   X.509 Certificate (또는 Signing Certificate)	X.509 certificate

   Okta 싱글 로그아웃을 사용하지 않는 한 Logout URL은 비워 두세요.

   

6. 사용자 할당#

   앱의 Assignments 탭에서 Assign을 클릭하고 Clevera를 사용할 사람이나 그룹을 추가하세요. 할당되지 않은 사용자는 Okta를 통해 로그인할 수 없습니다.

그런 다음 Clevera에서 마무리하세요: 도메인 및 역할.

OpenID Connect로 연결#

1. Okta에서 앱 생성#

   Applications → Applications → Create App Integration으로 이동합니다. OIDC - OpenID Connect, Web Application을 차례로 선택하고 다음을 클릭하세요.

2. 리디렉션 URI 설정#

   Clevera 설정 대화 상자에서 Protocol을 OpenID Connect로 설정하고 회색 상자에서 **Redirect URI (callback URL)**를 복사하세요. 그런 다음 Okta에 입력하세요:

   Okta 필드	값
   App integration name	Clevera
   Grant type	Authorization Code
   Sign-in redirect URIs	Redirect URI (callback URL): https://app.clevera.ai/sso/oidc/callback
   Sign-out redirect URIs	예시를 제거하고 비워 두세요
   Controlled access	앱을 사용할 수 있는 대상을 선택하거나 Skip group assignment for now를 선택하고 나중에 할당하세요

   저장을 클릭하세요.

3. 자격 증명 복사#

   앱의 General 탭, Client Credentials 아래에서 Client ID와 Client secret을 복사하세요. Client authentication은 Client secret으로 유지하세요.

4. Clevera에 입력#

   Clevera에서 계속을 클릭하고 다음을 입력하세요:

   Clevera 필드	값
   Client ID	Okta의 Client ID
   Client secret	Okta의 Client secret
   Discovery URL	https:// Okta 도메인 /.well-known/openid-configuration (예: https://acme.okta.com/.well-known/openid-configuration)

   사용자 지정 인증 서버를 사용하는 경우 해당 서버의 Discovery URL(예: https://acme.okta.com/oauth2/default/.well-known/openid-configuration)을 대신 사용하세요.

   

5. 사용자 할당#

   Assignments 탭에서 Clevera를 사용할 사람이나 그룹을 할당하세요.

Clevera에서 마무리#

1. 도메인 및 역할에서 Okta 사용자가 사용하는 모든 이메일 도메인을 추가하고, 첫 로그인 시 계정 생성 및 새 SSO 멤버의 기본 역할을 선택하세요.
2. 검토에서 구성 저장을 클릭하세요.
3. 테스트 실행을 클릭하고 SSO 활성화를 켠 다음, Clevera 로그인 페이지에서 할당된 테스트 사용자로 비공개 창에서 로그인해 보세요.
4. 모든 것이 정상적으로 작동하면, SSO를 유일한 로그인 방법으로 사용하려면 SSO 필수를 켜세요.

이제 멤버들은 Clevera 로그인 페이지에서 회사 이메일을 입력하고 Okta로 계속하기를 클릭하면 됩니다.

문제 해결#

추가 메시지: SSO 로그인 문제 해결.

관련 항목#