이 페이지는 AI로 자동 번역되었으며 부정확한 내용이 포함될 수 있습니다. 번역 오류를 신고하려면 페이지 오른쪽 목차 아래에 있는 피드백 기능을 사용하세요.

SCIM API 오브젝트 및 부록

이 문서에서는 다양한 SCIM API 오브젝트와 부록에 대해 설명합니다.

granular scim api
legacy scim api

세분화된 권한 마이그레이션

기존 SCIM 통합과 레거시 SCIM API 오브젝트는 세분화된 권한으로 마이그레이션한 후에도 계속 작동합니다. 다만 Braze는 2026년 12월부터 레거시 SCIM API 값을 더 이상 수락하지 않습니다.

지금 바로 조치를 취할 필요는 없습니다. 하지만 세분화된 권한으로 전환되는 권한이 있는지 통합을 검토해 보세요. 예를 들어 현재 API에서 basic_access를 전송하고 있다면, 세분화된 권한으로 마이그레이션한 후 구체적인 권한을 포함하도록 통합을 업데이트하세요(예: "appGroupPermissions":["view_campaigns","edit_campaigns"]). 기존 통합이 중단되지 않도록 Braze는 세분화된 권한 마이그레이션 이후에도 basic_access와 같은 레거시 문자열을 계속 수락합니다.

권한 오브젝트

권한 오브젝트는 SCIM ID 권한을 통해 사용자 리소스와 상호 작용할 때 일부 요청 및 응답에 포함되는 필드입니다.

참고

Braze에서 앱 그룹의 이름이 워크스페이스로 변경되었지만, 이 페이지의 키는 여전히 이전 용어를 사용합니다(예: appGroup, appGroupName).

중요

appGroupId, teamId, roleId, appGroupPermissionSetId 필드는 리소스의 API 식별자, 즉 1f16c016-8e44-48f3-9fd7-2b8d5d70d9bd와 같은 UUID를 가리킵니다. 이는 리소스의 내부 데이터베이스 ID와는 다릅니다. 이러한 식별자를 찾으려면 GET: 기존 대시보드 사용자 계정 조회를 사용하세요. 반환된 permissions 객체에 해당 사용자의 appGroupId, teamId, roleId, appGroupPermissionSetId 값이 포함되어 있습니다.

{
  "permissions": {
    "companyPermissions": (required, array),
    "appGroup": (required, array)
  }
}

유효한 권한 오브젝트는 다음 키-값 페어를 가진 JSON 오브젝트입니다.

키	필수	데이터 유형	설명
`companyPermissions`	선택 사항	배열	회사 수준 권한 문자열의 배열로, 문자열이 있으면 사용자에게 해당 권한이 있음을 의미합니다.
`roles`	선택 사항	배열	역할 오브젝트의 배열입니다.
`appGroup`	필수	배열	워크스페이스 권한 오브젝트의 배열입니다.

워크스페이스 권한 오브젝트

유효한 워크스페이스 권한 오브젝트는 다음 키-값 페어를 가진 JSON 오브젝트입니다.

키	필수	데이터 유형	설명
`appGroupName`	선택 사항	문자열	워크스페이스의 이름입니다. 이 오브젝트에 포함된 권한이 어떤 워크스페이스에 적용되는지 지정하는 데 사용됩니다.
`appGroupId`	`appGroupName`이 없는 경우 필수	문자열	워크스페이스의 API 식별자(UUID)로, 워크스페이스를 지정하는 또 다른 방법입니다.
`appGroupPermissionSets`	선택 사항	배열	하나 이상의 워크스페이스 권한 세트 오브젝트로 구성된 배열입니다. 사용자는 이 워크스페이스에서 나열된 권한 세트에 포함된 모든 권한을 부여받습니다. 배열은 비워 둘 수 없습니다. 워크스페이스 항목마다 `appGroupPermissions` 또는 `appGroupPermissionSets` 중 하나만 제공하고, 둘 다 제공하지는 마세요.
`appGroupPermissions`	조건부 필수	배열	워크스페이스 권한 문자열 표에 있는 워크스페이스 수준 권한 문자열의 배열입니다. `appGroupPermissionSets`를 제공하지 않는 경우 필수입니다.
`team`	선택 사항	배열	팀 권한 오브젝트의 배열입니다.

워크스페이스 권한 세트 오브젝트

유효한 워크스페이스 권한 세트 오브젝트는 다음 키-값 페어를 가진 JSON 오브젝트입니다.

키	필수	데이터 유형	설명
`appGroupPermissionSetName`	선택 사항	문자열	이 워크스페이스에서 사용자에게 할당하는 워크스페이스 권한 세트의 이름입니다.
`appGroupPermissionSetId`	`appGroupPermissionSetName`이 없는 경우 필수	문자열	권한 세트의 API 식별자(UUID)로, 이 워크스페이스에서 사용자에게 할당된 워크스페이스 권한 세트를 지정하는 또 다른 방법입니다.

팀 권한 오브젝트

유효한 팀 권한 오브젝트는 다음 키-값 페어를 가진 JSON 오브젝트입니다.

키	필수	데이터 유형	설명
`teamName`	선택 사항	문자열	팀의 이름으로, 이 오브젝트의 권한이 어떤 팀에 적용되는지 지정하는 데 사용할 수 있습니다.
`teamId`	`teamName`이 없는 경우 필수	문자열	팀의 API 식별자(UUID)로, 팀을 지정하는 또 다른 방법입니다.
`teamPermissions`	필수	배열	팀 권한 문자열 표에 있는 팀 수준 권한 문자열의 배열로, 문자열이 있으면 사용자에게 지정된 팀에 대한 해당 권한이 있음을 의미합니다.

역할 오브젝트

유효한 역할 오브젝트는 다음 키-값 페어를 가진 JSON 오브젝트입니다.

키	필수	데이터 유형	설명
`roleName`	선택 사항	문자열	사용자에게 할당하는 역할의 이름입니다.
`roleId`	`roleName`이 없는 경우 필수	문자열	역할의 API 식별자(UUID)로, 역할을 지정하는 또 다른 방법입니다.

부록

회사 권한 문자열

UI에 표시되는 이름	SCIM API 문자열
Administrator	`admin`
Manage Company Settings	`manage_company_settings`
Create and delete workspaces	`add_remove_app_groups`
View Domain Settings	`view_domain_settings`
Edit Domain Settings	`edit_domain_settings`
Delete Dashboard Users	`delete_dashboard_users`

워크스페이스 권한 문자열

권한 이름	SCIM API 문자열
View Campaigns	`view_campaigns`
Edit Campaigns	`edit_campaigns`
Archive Campaigns	`archive_campaigns`
View Canvases	`view_canvases`
Edit Canvases	`edit_canvases`
Archive Canvases	`archive_canvases`
View Frequency Capping Rules	`view_frequency_caps`
Edit Frequency Capping Rules	`edit_frequency_caps`
View Message Prioritization Settings	`view_message_prioritization`
Edit Message Prioritization Settings	`edit_message_prioritization`
Delete Message Prioritization Settings	`delete_message_prioritization`
View Content Blocks	`view_content_blocks`
Edit Content Blocks	`edit_content_blocks`
Archive Content Blocks	`archive_content_blocks`
View Feature Flags	`view_feature_flags`
Edit Feature Flags	`edit_feature_flags`
Archive Feature Flags	`archive_feature_flags`
View Segments	`view_segments`
View Audience Population	`view_audience_population`
Edit Segments	`edit_segments`
Archive Segments	`archive_segments`
View Global Control Group	`view_global_control_group`
Edit Global Control Group	`edit_global_control_group`
View IAM Templates	`view_iam_templates`
Edit IAM Templates	`edit_iam_templates`
Archive IAM Templates	`archive_iam_templates`
View Email Templates	`view_email_templates`
Edit Email Templates	`edit_email_templates`
Archive Email Templates	`archive_email_templates`
View Webhook Templates	`view_webhook_templates`
Edit Webhook Templates	`edit_webhook_templates`
Archive Webhook Templates	`archive_webhook_templates`
View Email Link Templates	`view_link_templates`
Edit Email Link Templates	`edit_link_templates`
View Media Library Assets	`view_media_library_assets`
View Locations	`view_locations`
Edit Locations	`edit_locations`
Archive Locations	`archive_locations`
View Promotion Codes	`view_promotion_codes`
Edit Promotion Codes	`edit_promotion_codes`
Export Promotion Codes	`export_promotion_codes`
View Preference Centers	`view_preference_centers`
Edit Preference Centers	`edit_preference_centers`
Edit Reports	`edit_reports`
View Placements	`view_placements`
Edit Placements	`edit_placements`
Archive Placements	`archive_placements`
View Banner Templates	`view_banner_templates`
View Multi Language Settings	`view_multi_language_settings`
Use BrazeAI Operator^TM	`use_operator`
View Decisioning Studio Agents	`view_decisioning_studio_agents`
View Decisioning Studio Audience	`view_decisioning_studio_audience`
View Decisioning Studio Conversion Event	`view_decisioning_studio_conversion_event`
View Decisioning Studio Guardrails	`view_decisioning_studio_guardrails`
Launch Campaigns	`launch_campaigns`
Launch Canvases	`launch_canvases`
Approve Campaigns	`approve_deny_campaigns`
Approve Canvases	`approve_deny_canvases`
Send Campaigns, Canvases	`send_campaigns_canvases`
Publish Cards	`publish_cards`
Export User Data	`export_user_data`
View PII	`view_pii`
View User Profiles (PII Redacted)	`view_user_profile`
Edit Dashboard Users	`edit_dashboard_users`
Edit Media Library Assets	`edit_media_library_assets`
Delete Media Library Assets	`delete_media_library_assets`
View Import Users	`view_import_users`
Import Users	`import_users`
Edit User Data	`edit_user_data`
View User Merge Records	`view_user_merge_records`
Merge Duplicate Users	`merge_duplicate_users`
View API Keys	`view_api_keys`
Edit API Keys	`edit_api_keys`
View Internal Groups	`view_internal_user_groups`
Edit Internal Groups	`edit_internal_user_groups`
Delete Internal Groups	`delete_internal_user_groups`
View Message Activity Log	`view_message_activity_log`
View Event User Log	`view_event_user_log`
View API Identifiers	`view_api_identifiers`
View API Usage Dashboard	`view_api_usage_dashboard`
View API Limits	`view_api_limits`
View API Usage Alerts	`view_api_usage_alerts`
Edit API Usage Alerts	`edit_api_usage_alerts`
View SDK Debugger	`view_sdk_debugger`
Edit SDK Debugger	`edit_sdk_debugger`
Launch Content Blocks	`launch_content_blocks`
Edit Cloud Data Ingestion	`edit_cloud_data_ingestion`
View App Settings	`view_app_settings`
Edit App Settings	`edit_app_settings`
View Push Settings	`view_push_settings`
Edit Push Settings	`edit_push_settings`
View Teams	`view_teams`
Edit Teams	`edit_teams`
Archive Teams	`archive_teams`
View Custom Attributes	`view_custom_attributes`
Edit Custom Attributes	`edit_custom_attributes`
Blocklist Custom Attributes	`blocklist_custom_attributes`
Delete Custom Attributes	`delete_custom_attributes`
Export Custom Attributes	`export_custom_attributes`
View Custom Events	`view_custom_events`
Edit Custom Events	`edit_custom_events`
Blocklist Custom Events	`blocklist_custom_events`
Delete Custom Events	`delete_custom_events`
Export Custom Events	`export_custom_events`
Edit Custom Event Property Segmentation	`edit_custom_event_property_segmentation`
View Products	`view_products`
Edit Products	`edit_products`
Blocklist Products	`blocklist_products`
Edit Purchase Property Segmentation	`edit_purchase_property_segmentation`
View Tags	`view_tags`
Edit Tags	`edit_tags`
Delete Tags	`delete_tags`
View Email Settings	`view_email_settings`
Edit Email Settings	`edit_email_settings`
View Catalogs	`view_catalogs`
Edit Catalogs	`edit_catalogs`
Export Catalogs	`export_catalogs`
Delete Catalogs	`delete_catalogs`
View Whatsapp Settings	`view_whatsapp_settings`
Edit Technology Partners	`edit_technology_partners`

팀 권한 문자열

권한 이름	SCIM API 문자열
View Campaigns	`view_campaigns`
Edit Campaigns	`edit_campaigns`
Archive Campaigns	`archive_campaigns`
Launch Campaigns	`launch_campaigns`
Approve Campaigns	`approve_deny_campaigns`
View Canvases	`view_canvases`
Edit Canvases	`edit_canvases`
Archive Canvases	`archive_canvases`
Launch Canvases	`launch_canvases`
Approve Canvases	`approve_deny_canvases`
View Canvas Templates	`view_canvas_templates`
Edit Canvas Templates	`create_and_edit_canvas_templates`
Archive Canvas Templates	`archive_canvas_templates`
View Content Blocks	`view_content_blocks`
Edit Content Blocks	`edit_content_blocks`
Archive Content Blocks	`archive_content_blocks`
Launch Content Blocks	`launch_content_blocks`
View Segments	`view_segments`
View Audience Population	`view_audience_population`
Edit Segments	`edit_segments`
Archive Segments	`archive_segments`
View IAM Templates	`view_iam_templates`
Edit IAM Templates	`edit_iam_templates`
Archive IAM Templates	`archive_iam_templates`
View Email Templates	`view_email_templates`
Edit Email Templates	`edit_email_templates`
Archive Email Templates	`archive_email_templates`
View Webhook Templates	`view_webhook_templates`
Edit Webhook Templates	`edit_webhook_templates`
Archive Webhook Templates	`archive_webhook_templates`
View Email Link Templates	`view_link_templates`
Edit Email Link Templates	`edit_link_templates`
View Banner Templates	`view_banner_templates`
Edit Banner Templates	`edit_banner_templates`
Archive Banner Templates	`archive_banner_templates`
View Landing Page Templates	`view_landing_page_templates`
Edit Landing Page Templates	`edit_landing_page_templates`
Archive Landing Page Templates	`archive_landing_page_templates`
View Media Library Assets	`view_media_library_assets`
Edit Media Library Assets	`edit_media_library_assets`
Delete Media Library Assets	`delete_media_library_assets`
Replace Media Library Assets	`replace_media_library_assets`
View Dashboard Reports	`view_reporting`
Edit Dashboard Reports	`edit_reporting`
Delete Dashboard Reports	`delete_reporting`
Export User Data	`export_user_data`
View User Profiles (PII Redacted)	`view_user_profile`
Edit Dashboard Users	`edit_dashboard_users`
Admin	`admin`

부서 문자열

UI에 표시되는 이름	SCIM API 문자열
Agency / Third Party	`agency`
BI / Analytics	`bi`
C-Suite	`c_suite`
Engineering	`engineering`
Finance	`finance`
Marketing / Editorial	`marketing`
Product Management	`pm`

중요

이제 Braze는 사용자 액세스를 더 유연하게 관리할 수 있는 세분화된 권한을 제공합니다. 자세한 내용은 세분화된 권한으로 마이그레이션을 참조하고, Granular SCIM API 탭에서 세분화된 SCIM API 오브젝트와 부록을 확인하세요. Braze는 2026년 12월부터 레거시 SCIM API 값을 더 이상 수락하지 않습니다.