SSO 및 SCIM 오류 문제 해결
학습 내용
Klaviyo에서 싱글 사인온(SSO) 및 교차 도메인 ID 관리 시스템(SCIM)의 오류를 해결하는 방법을 알아보세요. 이 문서는 IT 전문가처럼 SSO와 SCIM에 익숙한 분을 대상으로 합니다.
자세한 내용은 단일 로그인(SSO)을 설정하는 방법에 대한 이 문서를 확인해 주세요.
오류 목록과 해결 방법
이 표에서는 일반적인 SSO 및 SCIM 오류를 다뤄요. 정보가 누락되었거나 잘못된 경우 오류가 발생하는 경향이 있어요.
Klaviyo SSO 설정을 찾으려면 설정 > 보안으로 이동해 주세요. Single sign-on(SSO)에서 SSO 설정 또는 설정 편집을 클릭해 연결을 구성하세요. SSO 설정을 사용해 SSO, 신원 제공자(IdP)에서 시작된 로그인 또는 JIT 프로비저닝을 활성화하세요.
오류 | 해결 방법 |
{email}({company_id})에 대한 SSO 구성이 누락되었습니다. | Klaviyo에서 SSO 구성을 완료한 다음 저장을 클릭해 주세요. |
{email}({company_id})에 대해 SSO가 비활성화되었습니다. | Klaviyo에서 SSO 설정 아래의 SSO 사용 설정을 선택해 주세요. |
({company_id})에 대한 SSO 구성이 누락되었습니다. | Klaviyo에서 SSO 구성을 완료한 다음 저장을 클릭해 주세요. |
({company_id})에 대해 SSO가 비활성화됨 | Klaviyo에서 SSO 설정 아래의 SSO 사용 설정을 선택해 주세요. |
계정({company_id})에서 {email}에 대한 새 SSO 사용자를 프로비저닝할 수 없습니다(Just-in-Time 프로비저닝이 활성화되어 있지 않음) | SSO로 처음 로그인할 때 Klaviyo에서 사용자를 생성하도록 하려면, Klaviyo의 SSO 설정에서 적시(JIT) 프로비저닝을 선택해 주세요. |
{email}({company_id})에 대해 IdP(신원 제공자) 시작 SSO가 비활성화되어 있습니다. | 사용자가 신원 제공자에서 로그인을 시작할 수 있도록 하려면 Klaviyo에서 SSO 설정 아래의 신원 제공자 시작 로그인을 선택해 주세요. |
({company_id})에 대한 SSO 구성이 누락되었습니다. | Klaviyo에서 SSO 구성을 완료한 다음 저장을 클릭해 주세요. |
Klaviyo의 이름은 {Klaviyo name}인데, 이는 신원 제공자의 SCIM 메시지인 {IdP name}과(와) 일치하지 않아요 | 여러 Klaviyo 계정에 속한 사용자의 경우, 신원 제공자에서 사용자의 이름과 성을 Klaviyo와 일치하도록 업데이트해 주세요. 또는 사용자에게 Klaviyo에서 이름을 업데이트해 신원 제공자와 일치하도록 요청해 주세요. 그런 다음 SCIM 업데이트를 다시 시도해 주세요. |
SSO 구성 오류
Klaviyo는 서명된 SAML 어설션을 요구해요. 응답에 서명하고 어설션을 암호화하는 것은 선택 사항이에요. 개별 암호화된 속성은 지원되지 않아요.
오류 | 해결 방법 | ||
지원되지 않는 SAML 버전 | 신원 제공자(IdP) SSO 제공자로 이동해 SAML 2.0으로 업데이트하세요. | ||
SAML 응답에 ID 속성이 누락됨 | 신원 제공자에 SAML Response 요소에 대한 ID 속성이 포함되어 있는지 확인해 주세요. 이는 신원 제공자(IdP) 발급자나 사용자의 이메일 주소가 아니라, 응답의 식별자예요. | ||
role 속성이 누락됨 | 신원 제공자에서 SAML 어설션의 AttributeStatement에 역할 속성을 포함해 주세요. 설정 중인 계정 유형에 맞는 역할을 사용해 주세요. 정적 계정 및 포트폴리오 역할 값은 아래에 나열되어 있어요. JIT 프로비저닝으로는 소유자 또는 포트폴리오 소유자를 생성하거나 소유권을 이전할 수 없어요. 기존 소유자의 경우, 신원 제공자가 전송한 역할이 현재 소유자 역할과 일치해야 해요. | ||
|
| ||
SAML 응답에는 어설션 1개가 포함되어야 합니다. | 신원 제공자가 각 SAML 응답에서 정확히 1개의 assertion을 전송하도록 구성해 주세요. | ||
잘못된 SAML 응답. saml-schema-protocol-2.0.xsd와 일치하지 않음 | SAML 응답이 SAML 2.0 스키마를 준수하는지 확인해 주세요. | ||
Assertion에는 Conditions 요소가 포함되어야 해요. | 신원 제공자의 SAML response assertion에 Conditions 요소가 포함되어 있는지 확인해 주세요. | ||
Assertion에 AuthnStatement 요소가 포함되어야 해요. | 신원 제공자의 SAML 응답 어설션에 AuthnStatement 요소가 포함되어 있는지 확인하세요. | ||
Response에 EncryptedAttribute가 있으며 이 SP는 이를 지원하지 않습니다. | Klaviyo는 속성이 암호화된 경우를 지원하지 않아요. 신원 제공자의 설정을 확인하고 암호화된 속성이 없는지 확인하세요. | ||
응답에 Destination 값이 비어 있어요. | 신원 제공자에서 대상(destination)을 Klaviyo의 SSO 설정에 표시된 Klaviyo SSO URL로 설정해 주세요. 필드 이름은 제공업체에 따라 달라요. 일반적인 이름으로는 “Reply URL”, “ACS URL”, “Assertion Consumer Service URL”, “Trusted URL”, “엔드포인트 URL”이 있어요. | ||
%s은(는) 이 응답에 유효한 대상이 아닙니다 | https:// 접두사를 포함해, 신원 제공자(IdP)의 audience Id가 SSO 구성 패널에 제공된 Audience URI(서비스 제공자 엔터티 ID)와 정확히 일치하는지 확인해 주세요. | ||
Assertion/Response에서 발급자(issuer)가 유효하지 않습니다(예상: %(idpEntityId)s, 실제: %(issuer)s) | Klaviyo의 SSO 설정에서 신원 제공자 Issuer가 신원 제공자의 SAML 응답에 있는 발급자(엔터티 ID)와 일치하는지 확인한 다음 저장을 클릭해 주세요. | ||
이 응답의 AttributeStatement에 있는 AttributeStatement의 SessionNotOnOrAfter를 기준으로 특성이 만료되었어요. | 다시 로그인을 시도해 보세요. 그래도 해결되지 않으면 SAML 응답의 만료 기간이 너무 짧을 수 있으므로, 신원 제공자의 SAML 응답 만료 기간을 늘려 보세요. | ||
이 응답에서 유효한 SubjectConfirmation을 찾을 수 없어요. | 어설션에 bearer 메서드 및 SubjectConfirmationData가 포함된 유효한 SubjectConfirmation이 있는지 확인해 주세요. recipient가 Klaviyo SSO URL과 일치하는지, 유효 기간에 현재 시간이 포함되는지, 그리고 InResponseTo 값이 있는 경우 응답과 일치하는지 확인해 주세요. | ||
응답의 Assertion이 서명되지 않았으며 SP에서 이를 요구합니다. | 신원 제공자에서 SAML 어설션 서명을 켜세요. 도움이 필요하면 신원 제공자에게 문의해 주세요. | ||
서명을 찾을 수 없습니다. SAML 응답이 거부되었습니다. | 신원 제공자가 SAML 어설션에 서명하는지 확인해 주세요. 응답에만 서명하는 것은 Klaviyo의 어설션 서명 요구 사항을 충족하지 않습니다. | ||
서명 유효성 검증에 실패했습니다. SAML 응답이 거부되었습니다. | Klaviyo의 SSO 설정에서 신원 제공자 인증서가 신원 제공자가 SAML 어설션에 서명할 때 사용하는 인증서와 일치하는지 확인해 주세요. 변경 사항을 저장한 다음 SSO를 다시 테스트해 주세요. | ||
SAML 응답을 찾을 수 없습니다, HTTP_POST 바인딩만 지원됩니다 | 신원 제공자가 HTTP_POST 요청을 보내고 있는지 확인하세요. | ||
SSO 오류를 수정한 후 Klaviyo의 SSO 설정으로 돌아가 SSO 테스트를 클릭하세요. 연결 설정이 저장되고 로그인이 다시 테스트돼요.
기타 문제 해결 팁
문제를 해결하는 방법을 확인하려면 겪고 있는 문제와 가장 잘 일치하는 드롭다운을 여세요.
Klaviyo에서 사용자의 역할을 편집할 수 없어요
SSO 및 적시(JIT) 프로비저닝이 활성화되어 있거나 SCIM이 활성화되어 있으면 사용자 역할은 신원 제공자를 통해 관리돼요. SSO 예외 목록에 있는 사용자는 Klaviyo에서 역할을 변경할 수 있어요.
신원 제공자에서 사용자의 역할을 업데이트해 주세요. JIT는 사용자가 다음에 SSO로 로그인할 때 역할을 적용해요. SCIM이 꺼져 있고 Klaviyo에서 역할을 직접 변경해야 하는 경우, 다음 단계를 사용해 주세요:
- 설정 > 보안에서 SSO 설정 아래의 적시(JIT) 프로비저닝을 선택 해제한 다음, 확인을 위해 비활성화를 클릭해 주세요.
- Klaviyo에서 사용자의 역할을 업데이트해 주세요. JIT가 다시 켜질 때 변경 사항이 덮어쓰이지 않도록 신원 제공자에서 동일한 역할을 설정해 주세요.
- 다시 켜려면 Just-in-time(JIT) 프로비저닝을(를) 다시 선택해 주세요.
면제 리스트를 볼 수 없어요
면제 목록을 보려면 SSO를 설정해야 해요. 지침은 Klaviyo에서 SSO를 활성화하는 방법에 대한 문서를 참조하세요.
추가 자료
- How to set up single sign-on (SSO)
Learn how to set up single sign-on (SSO) for your Klaviyo account or portfolio. Currently, only identity provided (IdP) single sign-on is supported in Klaviyo.
- How to set up multi-factor authentication (MFA)
Learn how to set up multi-factor authentication (MFA) to help make your Klaviyo account or portfolio more secure. With MFA enabled, you sign in using a username and password, then verify your identity (such as by entering a code).
- How to set up SCIM user provisioning
Learn how to set up a system for cross-domain identity management (SCIM) user provisioning in an account or portfolio.