SCIM 사용자 프로비저닝을 설정하는 방법
예상 3분 읽기
|
업데이트 2026년 3월 24일 AM 12:00 EST
학습 내용
계정 또는 포트폴리오에서 SCIM(교차 도메인 ID 관리) 사용자 프로비저닝을 위한 시스템을 설정하는 방법을 알아보세요.
이 기능을 설정하려면 유료 요금제를 이용 중이어야 하며 관리자 또는 소유자여야 해요.
시작하기 전에 알아야 할 것
SCIM을 설정하기 전에 Klaviyo에서 SSO를 켜 두어야 해요.
SCIM 프로비저닝은 신원 제공자(IdP)에서 애드온인 경우가 많다는 점에 유의하세요. 예를 들어, 신원 제공자(IdP)는 SSO 플랜 외에 별도의 SCIM 플랜을 요구하는 경우가 많아요. IdP에서 다음 단계를 볼 수 없다면 올바른 플랜을 사용 중인지 확인해 주세요.
SCIM 사용자 프로비저닝 켜기
- 왼쪽 아래 모서리에 있는 조직 이름을 클릭합니다.
- 설정 > 보안을 클릭합니다.
- SCIM 프로비저닝 확인란을 선택하세요.
- 접두사
Klaviyo-API-Key를 포함한 액세스 키를 복사하거나 다운로드하세요.
이 키는 한 번만 표시되니, 반드시 액세스할 수 있도록 해 주세요. 복사하는 경우, 즉시 안전한 곳에 붙여 넣어 주세요.
- 완료를 클릭합니다.
- 기본 URL을 복사해 붙여 넣어 주세요. 가능하면 액세스 키를 저장해 둔 위치가 좋아요.
다음으로, 프로세스를 완료하려면 SSO 공급업체로 이동해야 해요. 이 프로세스는 공급업체에 따라 달라요. 아래에는 OKTA, One Login, Azure에 대한 안내가 있지만, 다른 어떤 공급업체를 사용해서도 설정할 수 있어요.
OKTA
- 애플리케이션 > 애플리케이션으로 이동합니다.
- Klaviyo 앱을 선택해 주세요.
- 로그인 탭으로 이동하세요.
- Credential Details에서 다음 사항을 확인해 주세요:
- Application username format이 Email로 설정되어 있어요.
- 에서 애플리케이션 사용자 이름 업데이트 가 생성 및 업데이트로 설정되어 있어요.
- 일반 탭을 클릭하세요.
- 편집을 선택합니다.
- 프로비저닝 아래에서 SCIM을 선택해 주세요.
- 저장을 클릭합니다.
- 프로비저닝 탭을 클릭하세요.
- 편집 을 선택해 SCIM 연결 페이지(아래에 표시됨)를 여세요.
- SCIM connector base URL에 Klaviyo의 기본 URL을 붙여넣으세요.
- 사용자의 고유 식별자 필드에 “userName.”을 입력해 주세요.
- 지원되는 프로비저닝 작업에서 다음 확인란을 선택하세요:
- 새 사용자 가져오기 및 프로필 업데이트
- 새 사용자 푸시
- 프로필 업데이트 푸시
- 인증 모드 옵션을 HTTP 헤더로 변경하세요.
- Authorization 아래에 액세스 키를 붙여넣으세요.
- 커넥터 구성 테스트를 클릭합니다.
- 저장을 클릭합니다.
- App으로 프로비저닝 옆의 편집을 클릭합니다.
- 다음 기능에 대해 사용을 선택하세요:
- 사용자 만들기.
- 사용자 속성 업데이트.
- 사용자 비활성화.
- 저장을 클릭합니다.
- 앱의 속성 매핑 섹션으로 아래로 스크롤해 주세요.
- 프로필 편집기로 이동을 클릭해 주세요.
- 속성 추가를 클릭하세요.
- 표시 이름, 변수 이름, 외부 이름에 “role”을 입력하세요.
- External namespace에 다음을 입력하세요:
urn:ietf:params:scim:schemas:core:2.0:User - 열거된 값 목록 정의의 확인란을 선택해 주세요.
- 역할과 값을 추가하세요. 유효한 역할 값은 다음과 같아요:
- 관리자
- 운영자
- 분석가
- campaign_coordinator
- content_creator
- 지원
- 필수 속성 까지 아래로 스크롤한 다음 예를 선택해 주세요.
- 속성 유형(개인 또는 그룹)을 선택하세요.
- 권장사항: User permission 은 읽기 전용으로 그대로 두세요.
- 저장을 클릭합니다.
- 애플리케이션 > 애플리케이션으로 이동한 다음 앱을 선택하세요.
- 할당을 클릭해 주세요.
- 앱을 개인(즉, 사람)에게 할당할지 또는 그룹에 할당할지 선택해 주세요.
- Klaviyo를 할당할 사람 또는 그룹을 찾은 다음 이름 옆의 할당 을 클릭하세요.
- 아래로 스크롤하여 role 필드로 이동한 다음 올바른 역할을 할당하세요.
- 저장하고 돌아가기를 클릭해 주세요.
원 로그인
- 관리자 포털에서 애플리케이션을 클릭하세요.
- 앱 추가를 클릭하세요.
- “Klaviyo”를 검색해 주세요.
- Klaviyo 를 클릭해 추가하세요.
- 선택 사항: 연결 이름을 바꾸세요.
- 구성을 클릭하세요.
- SCIM Bearer Token 필드에 SCIM 액세스 키를 붙여넣으세요.
- API Connection 아래에서 사용 설정 을 클릭하세요.
- 저장을 클릭합니다.
- 왼쪽 사이드바에서 프로비저닝 으로 이동해 주세요.
- 프로비저닝 활성화 체크박스를 선택해 주세요.
- 사용자 생성, 사용자 삭제 또는 사용자 업데이트 상자의 선택을 해제하지 마세요.
- 권장:OneLogin에서 사용자가 삭제되거나 사용자의 앱 액세스가 제거될 때, 아래 작업 수행 의 드롭다운에서 삭제 를 선택하세요.
- 저장을 클릭합니다.
Microsoft Entra ID(이전 Azure AD)
- Microsoft Entra ID에 로그인하세요.
- Microsoft Entra ID (이전 명칭 “Azure Active Directory”)를 클릭해 주세요
- 왼쪽에서 Enterprise 애플리케이션을 클릭합니다.
- 애플리케이션을 선택합니다.
- 아직 애플리케이션을 만들지 않았다면 SSO 가이드의 단계를 따라 주세요.
- 왼쪽에서 프로비저닝 을 클릭한 다음 시작하기를 선택합니다.
- 프로비저닝 모드라는 필드에서 자동을 선택하세요.
- 관리자 자격 증명으로 이동하세요.
- Klaviyo의 SCIM 기본 URL을 테넌트 URL 필드에 붙여넣으세요.
- SCIM API 키를 Secret Token 필드에 붙여넣으세요. 이 토큰은 어떤 접두사도 없이 그대로 붙여넣어야 합니다(예: "Bearer" 또는 "Klaviyo-API-Key"는 포함하지 마세요).
- 연결을 테스트합니다.
- 연동이 성공하면 왼쪽 상단에서 저장 을 클릭하세요.
- 같은 페이지에서 아래로 스크롤한 다음 매핑 드롭다운을 여세요.
- Azure Active Directory 사용자 프로비저닝을 선택하세요.
- 선택 사항: 지원되지 않는 속성을 삭제하세요. Klaviyo는 SCIM의 customappsso Attribute 열에서 다음 속성만 지원합니다:
- "userName"
- "활성"
- emails[type eq "work"].value'
- "name.givenName"
- "name.familyName"
- emails[primary eq "True"].value'
- roles[primary eq "True"].value'
- SingleAppRoleAssignment([appRoleAssignments])
- appRoleAssignments는 지원되지 않아요.
- SingleAppRoleAssignment을 사용하는 경우 매핑 유형으로 '표현식(Expression)'을 사용하세요.
- 저장을 클릭한 다음 홈을 클릭하세요.
- Microsoft Entra ID > Enterprise applications > Klaviyo > 프로비저닝으로 다시 이동해 주세요.
- 프로비저닝 시작을 선택하세요.
이제 Microsoft Entra ID가 일정에 따라 사용자를 프로비저닝하기 시작해요. 프로비저닝된 사용자가 누구인지 더 자세히 확인하려면 프로비저닝 로그 보기를 선택하세요.
이 도움말 문서가 유용했나요?
이 형식은 도움말 문서 피드백 용도로만 사용하세요. 지원 팀에 문의하는 방법.