このページはAIにより自動翻訳されており、不正確な内容が含まれている可能性があります。翻訳の誤りを報告するには、ページ右側の目次の下にあるフィードバックをご利用ください。

SCIM API オブジェクトと付録

この記事では、さまざまなSCIM APIオブジェクトと付録について説明します。

legacy scim api
granular scim api

重要

Brazeは、ユーザーアクセスをより柔軟に管理する手段として、きめ細かい権限を導入しています。移行プロセスについてはきめ細かい権限への移行を参照してください。また、きめ細かいSCIM APIオブジェクトと付録についてはきめ細かいSCIM APIタブを参照してください。

権限オブジェクト

権限オブジェクトは、SCIM ID権限を通じてユーザーリソースとやり取りする際に、一部のリクエストとレスポンスに含まれるフィールドです。

注

Brazeではアプリグループはワークスペースに改名されましたが、このページのキーはまだ古い用語を参照しています（例: appGroup、appGroupName）。

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

有効な権限オブジェクトは、以下のキーと値のペアを持つJSONオブジェクトです。

キー	必須	データタイプ	説明
`companyPermissions`	オプション	配列	会社権限文字列テーブルからの会社レベルの権限文字列の配列。文字列が存在する場合、そのユーザーが対応する権限を持っていることを示します。
`roles`	オプション	配列	ロールオブジェクトの配列。
`appGroup`	必須	配列	ワークスペース権限オブジェクトの配列。

ワークスペース権限オブジェクト

有効なアプリグループ権限オブジェクトは、以下のキーと値のペアを持つJSONオブジェクトです。

キー	必須	データタイプ	説明
`appGroupName`	オプション	文字列	ワークスペースの名前。このオブジェクトに含まれる権限がどのワークスペースに対するものかを指定するために使用します。
`appGroupId`	`appGroupName`がない場合は必須	文字列	ワークスペースのID。ワークスペースを指定する代替方法として機能します。
`appGroupPermissionSets`	オプション	配列	単一のワークスペース権限セットオブジェクトを持つ配列。
`appGroupPermissions`	必須	配列	ワークスペース権限文字列テーブルからのワークスペースレベルの権限文字列の配列。文字列が存在する場合、そのユーザーが指定されたワークスペースに対する対応する権限を持っていることを示します。
`team`	オプション	配列	チーム権限オブジェクトの配列。

ワークスペース権限セットオブジェクト

有効なワークスペース権限セットオブジェクトは、以下のキーと値のペアを持つJSONオブジェクトです。

キー	必須	データタイプ	説明
`appGroupPermissionSetName`	オプション	文字列	このワークスペースでユーザーに割り当てられるワークスペース権限セットの名前。
`appGroupPermissionSetID`	`appGroupPermissionSetName`がない場合は必須	文字列	ワークスペースのID。このワークスペースでユーザーに割り当てられたワークスペース権限セットを指定する代替方法として機能します。

チーム権限オブジェクト

有効なチーム権限オブジェクトは、以下のキーと値のペアを持つJSONオブジェクトです。

キー	必須	データタイプ	説明
`teamName`	オプション	文字列	チームの名前。このオブジェクト内の権限がどのチームに対するものかを指定するために使用できます。
`teamId`	`teamName`がない場合は必須	文字列	チームのID。チームを指定する代替方法として機能します。
`teamPermissions`	必須	配列	チーム権限文字列テーブルからのチームレベルの権限文字列の配列。文字列が存在する場合、そのユーザーが指定されたチームに対する対応する権限を持っていることを示します。

ロールオブジェクト

有効なロールオブジェクトは、以下のキーと値のペアを持つJSONオブジェクトです。

キー	必須	データタイプ	説明
`roleName`	オプション	文字列	ユーザーに割り当てられるロールの名前。
`roleId`	`roleName`がない場合は必須	文字列	ロールのID。ロールを指定する代替方法として機能します。

付録

会社権限文字列

UIでの表示	SCIM API文字列
Administrator	`admin`
Can Manage Company Settings	`manage_company_settings`
Can Add/Remove Workspaces	`add_remove_app_groups`

ワークスペース権限文字列

権限名	SCIM API文字列
Admin	`admin`
Access Campaigns, Canvases, Cards, Segments, Media Library	`basic_access`
Approve and Deny Canvases	`approve_deny_campaigns`
Send Campaigns, Canvases	`send_campaigns_canvases`
Publish Cards	`publish_cards`
Edit Segments	`edit_segments`
Export User Data	`export_user_data`
View PII	`view_pii`
View User Profiles PII Compliant	`view_user_profile`
Manage Dashboard Users	`manage_dashboard_users`
Manage Media Library Assets	`manage_media_library`
View Usage Data	`view_usage_data`
Import and Update User Data	`import_update_user_data`
View Billing Details	`view_billing_details`
Access Dev Console	`dev_console`
Launch Content Blocks	`launch_content_blocks`
Manage External Integrations	`manage_external_integrations`
Manage Apps	`manage_apps`
Manage Teams	`manage_teams`
Manage Events, Attributes, Purchases	`manage_events_attributes_purchases`
Manage Tags	`manage_tags`
Manage Email Settings	`manage_email_settings`
Manage Subscription Groups	`manage_subscription_groups`
Manage Approval Settings	`manage_approval_settings`
Manage Catalogs Dashboard Permission	`manage_catalogs_dashboard_permission`

チーム権限文字列

権限名	SCIM API文字列
Admin	`admin`
Access Campaigns, Canvases, Cards, Segments, Media Library	`basic_access`
Approve and Deny Canvases	`approve_deny_campaigns`
Send Campaigns, Canvases	`send_campaigns_canvases`
Publish Cards	`publish_cards`
Edit Segments	`edit_segments`
Export User Data	`export_user_data`
View User Profile	`view_user_profile`
Manage Dashboard Users	`manage_dashboard_users`
Manage Media Library Assets	`manage_media_library`

部門文字列

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の管理者はメールとダッシュボード上のバナーで細粒度権限の移行について通知を受け取ります。

既存のSCIM統合とレガシーSCIM APIオブジェクトは、4月下旬の細粒度権限移行後も引き続き動作します。

すぐに何かアクションを起こす必要はありません。ただし、細粒度化される権限について統合設定を確認することをお勧めします。例えば、現在APIで basic_access を送信している場合、細粒度化後に統合を更新し、特定の権限（例："appGroupPermissions":["view_campaigns","edit_campaigns"]）を含めることをお勧めします。Brazeは、既存の統合が壊れないように、細粒度権限移行後もレガシー文字列（basic_access など）を引き続き受け付けます。