콘텐츠로 건너뛰기

자동화된 사용자 프로비저닝

자동화된 사용자 프로비저닝을 사용하면 대시보드에서 수동으로 관리하는 대신 API를 통해 Braze 사용자를 생성하고 관리할 수 있습니다. Braze는 SCIM(System for Cross-domain Identity Management)을 통해 이를 지원합니다. 이 문서에서는 제공해야 하는 정보, SCIM 토큰을 생성하는 방법, SCIM API 엔드포인트를 찾는 위치에 대해 안내합니다.

SCIM 프로비저닝 설정 액세스

  1. Braze 대시보드에서 설정 > 회사 설정 > 관리자 설정 > SCIM 프로비저닝으로 이동한 다음 SCIM 통합 구성을 선택합니다.
  2. Braze 구성 단계에서 프로비저닝 방법을 선택하고 액세스 설정을 입력합니다.

프로비저닝 방법 선택 섹션과 액세스 설정 입력 섹션이 있는 SCIM 통합 설정 페이지.

  1. IdP 구성 단계에서 선택한 프로비저닝 방법에 맞게 해당 플랫폼 내의 단계를 따릅니다.

Okta에서 SAML SSO용 Braze 앱을 설정했다면 Okta - Braze app 옵션을 사용하세요. SSO용 커스텀 앱을 설정했다면 Okta - Custom app integration 탭의 안내를 따르세요.

1단계: SCIM 프로비저닝 설정

1.1단계: SCIM 활성화

  1. Okta에서 Applications > Applications로 이동한 다음 Create App Integration을 선택합니다. 로그인 방법으로 SAML 2.0을 선택합니다.
  2. 다음 세부 정보(Braze의 IdP configuration 단계에서 확인할 수 있음)를 입력하여 커스텀 앱을 만듭니다.
    • 앱 로고
    • SSO URL
    • 오디언스 URL(SP 엔티티 ID)
  3. Finish를 선택합니다.
  4. General 탭을 선택합니다.
  5. App Settings 섹션에서 Edit을 선택합니다.
  6. Provisioning 필드에서 SCIM을 선택합니다.

1.2단계: 애플리케이션 표시 비활성화

  1. Application visibility 필드에서 Do not display application icon to user 체크박스를 선택합니다. 이렇게 하면 사용자가 SCIM 전용으로 사용되는 이 앱을 통해 SSO에 액세스할 수 없습니다.
  2. Save를 선택합니다.

1.3단계: SCIM 통합 설정

  1. Provisioning 탭을 선택합니다.
  2. Settings > Integration > SCIM Connection에서 Edit을 선택하고 Setup SCIM provisioning 페이지의 표에 표시되는 필드 값을 입력합니다.

1.4단계: API 자격 증명 테스트

Test API Credentials를 선택합니다. 통합에 성공하면 확인 메시지가 표시되며 저장할 수 있습니다.

1.5단계: 앱으로의 프로비저닝 활성화

  1. Provisioning > Settings > To App > Provisioning to App에서 Edit을 선택합니다.
  2. 다음 항목을 활성화합니다.
    • Create Users
    • Update Users Attributes
    • Deactivate Users
  3. Setup SCIM provisioning 페이지의 표에 표시되는 매핑으로 Attribute Mapping 섹션을 검토하고 구성합니다.

2단계: 앱에 사용자 할당

  1. Assignment 탭을 선택합니다.
  2. Assign을 선택하고 옵션을 선택합니다.
  3. Braze에 액세스해야 하는 사람들에게 앱을 할당합니다.
  4. 할당을 완료하면 Done을 선택합니다.

SSO용 커스텀 앱을 설정했다면 Okta - Custom app integration 옵션을 사용하세요. Okta에서 SAML SSO용 Braze 앱을 설정했다면 Okta - Braze app 탭의 안내를 따르세요.

1단계: SCIM 프로비저닝 설정

1.1단계: SCIM 활성화

  1. Okta에서 Braze 앱으로 이동합니다.
  2. General 탭을 선택합니다.
  3. App Settings 섹션에서 Edit을 선택합니다.
  4. Provisioning 필드에서 SCIM을 선택합니다.
  5. Save를 선택합니다.

1.2단계: SCIM 통합 설정

  1. Provisioning 탭을 선택합니다.
  2. Settings > Integration > SCIM Connection에서 Edit을 선택하고 Setup SCIM provisioning 페이지의 표에 표시되는 필드 값을 입력합니다.
  3. Test API Credentials를 선택하여 API 자격 증명을 테스트합니다.
  4. Save를 선택합니다.

1.3단계: 앱으로의 프로비저닝 활성화

  1. Provisioning > Settings > To App > Provisioning to App에서 Edit을 선택합니다.
  2. 다음 항목을 활성화합니다.
    • Create Users
    • Update Users Attributes
    • Deactivate Users
  3. Setup SCIM provisioning 페이지의 표에 표시되는 매핑으로 Attribute Mapping 섹션을 검토하고 구성합니다.

2단계: 앱에 사용자 할당

  1. Assignment 탭을 선택합니다.
  2. Assign을 선택하고 옵션을 선택합니다.
  3. Braze에 액세스해야 하는 사람들에게 앱을 할당합니다.
  4. Done을 선택합니다.

1단계: SCIM 프로비저닝 앱 설정

1.1단계: Microsoft Entra 관리 센터에 로그인

Microsoft Entra 관리 센터에 로그인합니다.

1.2단계: SCIM 앱 생성 및 설정

  1. 탐색 메뉴에서 Entra ID > Enterprise apps로 이동합니다.
  2. New application을 선택합니다.
  3. Create your own application을 선택합니다.
  4. 패널에서 앱 이름을 입력합니다.
  5. What are you looking to do with your application? 섹션에서 Integrate application you don’t find in the gallery (Non-gallery)를 선택합니다.
  6. Create를 선택합니다.

1.3단계: SCIM 통합 설정

  1. SCIM 애플리케이션의 Manage > Provisioning 섹션으로 이동합니다.
  2. Connect your application 또는 New configuration을 선택하고 Setup SCIM provisioning 페이지의 표에 표시되는 필드 값을 입력합니다.

1.4단계: 앱으로의 프로비저닝 활성화

  1. SCIM 애플리케이션의 Manage > Attribute mapping (Preview) 섹션으로 이동합니다.
  2. Provision Microsoft Entra ID Users를 선택합니다.
  3. Setup SCIM provisioning 페이지의 표에 표시되는 속성과 일치하도록 Attribute Mapping 섹션을 검토하고 구성합니다.
  4. Attribute Mapping 페이지를 닫습니다.

2단계: 앱에 사용자 할당

  1. Manage > Users and Groups로 이동합니다.
  2. Add user/group을 선택합니다.
  3. None Selected를 선택하여 앱에 사용자를 할당합니다.
  4. Select 버튼을 선택하여 할당을 확인합니다.

1단계: SCIM 설정 구성

  • 기본 워크스페이스: 새 사용자가 기본적으로 추가될 워크스페이스를 선택합니다. SCIM API 요청에서 워크스페이스를 지정하지 않으면 Braze는 사용자를 이 워크스페이스에 할당합니다. 요청에 permissions가 포함되지 않은 경우, Braze는 이 워크스페이스에서 사용자에게 기본 권한 세트를 부여합니다.
  • 서비스 Origin: SCIM 요청의 Origin 도메인을 입력합니다. Braze는 X-Request-Origin 헤더에서 이 값을 사용하여 요청이 어디에서 오는지 확인합니다.
  • IP 허용 목록(선택 사항): SCIM 요청을 특정 IP 주소로 제한할 수 있습니다. 허용할 IP 주소를 쉼표로 구분된 목록 또는 범위로 입력합니다. 각 요청의 X-Request-Origin 헤더를 사용하여 요청 IP 주소를 허용 목록과 대조합니다.

2단계: SCIM 토큰 생성

필수 필드를 모두 입력한 후 SCIM 토큰 생성을 눌러 SCIM 토큰을 생성하고 SCIM API 엔드포인트를 확인합니다. 페이지를 벗어나기 전에 반드시 SCIM 토큰을 복사하세요. 이 토큰은 한 번만 표시됩니다.

마스킹된 값과 복사 버튼이 표시된 SCIM API 엔드포인트 및 SCIM 토큰 필드. 토큰 필드 아래에 “토큰 재설정” 버튼이 있습니다.

Braze는 모든 SCIM 요청에 HTTP Authorization 헤더를 통해 SCIM API bearer 토큰이 첨부되어 있을 것으로 예상합니다.

신규 사용자의 기본 권한

SCIM이 Okta 또는 Entra ID 통합을 통해 권한 목록 없이 사용자를 생성하면, Braze는 해당 사용자에게 기본 워크스페이스에 대한 보기 전용 기본 권한 세트를 부여합니다. permissions를 생략한 커스텀 SCIM API 요청에도 동일하게 적용됩니다.

기본 권한 세트에는 생성, 편집, 보관, 삭제, 내보내기, 전송 권한이 포함되어 있지 않습니다. 사용자에게 더 많은 액세스 권한을 부여하려면 SCIM 그룹 역할 매핑을 사용하거나 Braze에서 사용자를 편집하세요.

제품 영역 권한
메시징 Campaigns 보기, Canvases 보기, Canvas 템플릿 보기, 기능 플래그 보기, 플레이스먼트 보기, 메시지 우선순위 설정 보기, 최대 게재빈도 설정 규칙 보기, 메시징 사용량 제한 보기, 글로벌 컨트롤 그룹 보기, 방해금지 시간 설정 보기, 대시보드 보고서 보기
콘텐츠 Content Blocks 보기, 이메일 템플릿 보기, 이메일 링크 템플릿 보기, 인앱 메시지 템플릿 보기, 웹훅 템플릿 보기, 미디어 라이브러리 에셋 보기, 환경설정 센터 보기, 프로모션 코드 보기, 위치 보기, 현지화 설정 보기
오디언스 및 데이터 Segments 보기, 커스텀 속성 보기, 커스텀 이벤트 보기, 카탈로그 보기, 사용자 병합 기록 보기, 오디언스 동기화 설정 보기
채널 설정 이메일 설정 보기, 푸시 설정 보기, WhatsApp 설정 보기, WhatsApp 카탈로그 보기, WhatsApp 플로우 보기, Meta의 WhatsApp 메시지 템플릿 보기
Decisioning Studio Decisioning Studio 에이전트 보기, Decisioning Studio 오디언스 보기, Decisioning Studio 액션 뱅크 보기, 전환 이벤트 보기, Decisioning Studio 가드레일 보기, Decisioning Studio 타이밍 보기
New Stuff!