SAML 2.0으로 SSO 설정하기

SAML 2.0을 사용하여 Clevera를 ID 공급자(IdP)에 연결하면 팀원들이 회사 계정으로 로그인할 수 있습니다. 이 문서에서는 Clevera 설정 대화 상자의 모든 필드, IdP에 필요한 정확한 값, 그리고 테스트 및 활성화 방법을 설명합니다.

SSO가 멤버에게 어떤 변화를 주는지 알아보려면 먼저 싱글 사인온(SSO) 이해하기를 읽어보세요. 단계별 IdP 화면 설정은 Okta, Microsoft Entra ID, Google Workspace 가이드를 참조하세요.

시작하기 전에#

• 사용자 지정 플랜을 사용하는 워크스페이스의 소유자여야 합니다.
• IdP에서 SAML 앱을 직접 생성할 수 있거나, 생성할 수 있는 담당자와 협업 중이어야 합니다.
• 팀에서 사용하는 모든 이메일 도메인(예: acme.example 및 eu.acme.example)을 알고 있어야 합니다.

IdP에 제공할 값#

Clevera는 설정 대화 상자의 "ID 공급자를 설정하는 담당자를 위한 정보" 섹션에 이 값들을 표시하며, 각 값 옆에는 복사 버튼이 있습니다. 여기서 값을 복사하세요. 엔터티 ID에는 워크스페이스 고유 ID가 포함되어 있습니다.

IdP에서 앱을 다음과 같이 설정하세요:

Clevera가 읽는 속성#

이메일은 Name ID에서 가져옵니다. Name ID가 이메일 주소가 아닌 경우, Clevera는 다음 속성 중 첫 번째로 발견되는 것을 찾습니다:

이름은 Clevera가 새 계정을 생성할 때만 사용됩니다. 이름 속성이 전혀 없는 경우, 계정 이름은 이메일의 @ 앞부분을 따릅니다. Clevera는 그룹이나 역할 속성을 읽지 않습니다. SSO로 생성된 모든 멤버는 아래에서 선택한 기본 역할을 부여받습니다.

Clevera에 IdP 연결하기#

1. 보안 탭 열기#

   사이드바 상단의 워크스페이스 메뉴를 열고 팀 설정을 선택한 다음 보안을 클릭하세요. 싱글 사인온 아래에서 SSO 설정을 클릭하면 싱글 사인온 구성 대화 상자가 열립니다.

2. 공급자#

   ID 공급자(Okta, Microsoft Entra ID(Azure AD), OneLogin, Google Workspace, JumpCloud 또는 사용자 지정 SAML/OIDC 공급자)를 선택하고 프로토콜을 SAML 2.0으로 설정하세요. 회색 상자에 있는 값을 IdP에 복사한 후 계속을 클릭하세요.

   공급자 이름은 멤버가 로그인 버튼에서 보는 이름입니다(예: Okta로 계속). 사용자 지정 SAML/OIDC 공급자의 경우 버튼에 SSO로 계속이라고 표시됩니다.

3. ID 공급자#

   IdP의 SAML 설정 페이지에서 값을 붙여넣으세요. 필드 참조를 확인하세요. 계속을 클릭하세요.

4. 도메인 및 역할#

   허용된 이메일 도메인 아래에 각 이메일 도메인을 입력하고 추가를 클릭하세요(또는 Enter 키를 누르세요). 그런 다음 첫 로그인 시 계정 생성 여부를 선택하고 새 SSO 멤버의 기본 역할을 지정하세요. 도메인 및 역할을 참조하세요.

5. 검토#

   요약 내용을 확인하고 구성 저장을 클릭하세요. "SSO 구성이 저장되었습니다. 테스트를 실행한 후 활성화하세요."라는 메시지가 표시됩니다. 저장만으로는 SSO가 활성화되지 않습니다.

ID 공급자 필드#

인증서#

• 인증서 전체를 붙여넣으세요. -----BEGIN CERTIFICATE----- 및 -----END CERTIFICATE----- 줄은 선택 사항이며, 공백과 줄 바꿈은 무시됩니다.
• 바이너리 .cer 파일이 아닌 Base64(PEM) 텍스트를 사용하세요. 파일을 다운로드했다면 텍스트 편집기로 열어 내용을 복사하세요.
• Clevera는 인증서를 암호화하여 저장하며 다시 표시하지 않습니다. 나중에 연결을 편집할 때 필드에는 "인증서가 저장되어 있습니다. 유지하려면 비워 두세요."라고 표시됩니다.
• 테스트 실행을 통해 인증서를 읽을 수 없는지 또는 만료되었는지 확인할 수 있습니다.

도메인 및 역할#

도메인 정보:

• 도메인은 정확히 일치해야 합니다. acme.example은 eu.acme.example을 포함하지 않으므로 각각 추가하세요.
• 이메일이 아닌 도메인만 입력하세요(acme.example). 앞의 @은 제거됩니다.
• 도메인은 하나의 Clevera 워크스페이스에만 속할 수 있습니다. 다른 워크스페이스에서 이미 사용 중인 경우 저장 시 "도메인 acme.example은 이미 다른 팀에 할당되었습니다."라는 메시지가 표시됩니다. 본인의 도메인이라면 고객 지원팀에 문의하세요.

콘텐츠 제작자는 제작자 시트를 사용하지만, 편집자는 사용하지 않습니다. 기본 역할이 콘텐츠 제작자인데 모든 제작자 시트가 사용 중이라면, SSO로 참여하는 멤버는 대신 편집자가 되어 시트 수를 초과하지 않게 됩니다. 준비가 되면 시트를 추가하고 팀 설정 → 멤버에서 역할을 변경하세요. 워크스페이스, 역할 및 제작자 시트 이해하기를 참조하세요.

연결 테스트#

1. 확인 실행#

   보안 탭에서 연결 테스트 옆의 테스트 실행을 클릭하세요. 저장된 설정(엔터티 ID, 로그인 URL, 인증서 존재 여부, URL 유효성, 인증서 읽기 가능 여부 및 만료 여부)을 확인합니다.

   "SSO 구성이 유효하며 사용할 준비가 되었습니다." 또는 해결해야 할 문제 목록과 함께 "SSO 구성에 해결해야 할 문제가 있습니다."라는 메시지가 표시됩니다. SSO 로그인 문제 해결하기를 참조하세요.

   

2. SSO 켜기#

   SSO 활성화를 켭니다. "SSO가 켜졌습니다."라는 메시지가 표시됩니다. 상태 배지가 끄기에서 활성으로 변경됩니다.

3. 테스트 멤버로 로그인#

   개인 브라우저 창을 열고 Clevera 로그인 페이지로 이동한 다음, 멤버의 이메일(첫 로그인 시 계정이 생성되는 경우 새로운 사람의 이메일)을 입력하세요. Continue with를 클릭하고 IdP에서 로그인하세요. 워크스페이스 내 해당 사용자의 Clevera 홈 페이지로 이동해야 합니다.

   본인의 세션은 영향을 받지 않으며, 소유자는 언제든지 비밀번호로 로그인할 수 있습니다.

Run test는 IdP에 연결하지 않으므로 3단계의 실제 로그인이 유일한 전체 테스트입니다. Clevera 로그인 페이지에서 시작하세요. IdP 대시보드에서 시작한 테스트는 거부됩니다.

SSO 필수 설정#

모든 사람이 로그인할 수 있게 되면 Require SSO("Matching members must sign in with SSO.")를 켜세요. "SSO is now required."라는 메시지가 표시되고 배지에 Active · enforced가 나타납니다.

그 이후부터는 도메인에 속한 멤버가 비밀번호나 Google을 사용할 수 없으며, 도메인에 새로 추가된 사용자는 비밀번호로 Clevera 계정을 만들 수 없습니다. SSO로 로그인해야 계정을 얻을 수 있습니다. 이 설정은 Enable SSO가 켜져 있을 때만 켤 수 있으며, Enable SSO를 끄면 이 설정도 함께 꺼집니다.

단일 로그아웃#

Logout URL을 입력하면 Clevera 메타데이터에도 로그아웃 주소가 나열됩니다: https://app.clevera.ai/sso/saml/slo (HTTP Redirect 바인딩). IdP가 해당 주소로 로그아웃 요청을 보내면 Clevera는 사용자를 로그아웃시키고 IdP로 다시 보냅니다.

Clevera에서 로그아웃한다고 해서 IdP에서 로그아웃되지는 않습니다.

연결 변경 또는 제거#

• 변경: Provider 옆의 편집을 클릭하세요. 저장된 값이 포함된 대화 상자가 열립니다. 인증서를 유지하려면 비워 두세요.
• 일시적으로 끄기: Enable SSO를 끄세요. 설정은 그대로 저장됩니다.
• 제거: 상태 배지 옆의 메뉴를 열고 Remove SSO configuration을 선택한 다음 Remove SSO를 클릭하세요. "SSO로 로그인하는 멤버는 계속 로그인하려면 비밀번호를 재설정해야 합니다."

Provider 행에는 프로토콜과 보유한 도메인 수가 표시됩니다. 사용자가 SSO를 사용하기 시작하면 섹션 하단에 "12 SSO sign-ins · last Oct 12"와 같은 줄이 나타납니다.

관련 항목#