Using Multiple Group Entitlements

For pre-existing Atlassian Suite Cloud sources, complete the following steps to start using the Multiple Group Entitlements feature with your current source.

1. Use the createSchema API to create new group schema for your source. Here is an example for API body content for adding Project Roles to an existing source.

   {
   "nativeObjectType": "ProjectRole",
   "identityAttribute": "projectRoleId",
   "displayAttribute": "displayName",
   "hierarchyAttribute": null,
   "includePermissions": false,
   "features": [],
   "configuration": {},
   "attributes": [
   {
   "name": "name",
   "type": "STRING",
   "schema": null,
   "description": "Name of the Project Role",
   "isMulti": false,
   "isEntitlement": false,
   "isGroup": false
   },
   {
   "name": "displayName",
   "type": "STRING",
   "schema": null,
   "description": "Display name of the Project Role",
   "isMulti": false,
   "isEntitlement": false,
   "isGroup": false
   },
   {
   "name": "projectRoleId",
   "type": "STRING",
   "schema": null,
   "description": "An unique identifier for the project specific roles",
   "isMulti": false,
   "isEntitlement": false,
   "isGroup": false
   },
   {
   "name": "id",
   "type": "STRING",
   "schema": null,
   "description": "An unique identifier for the project role",
   "isMulti": false,
   "isEntitlement": false,
   "isGroup": false
   },
   {
   "name": "description",
   "type": "STRING",
   "schema": null,
   "description": "The description of the Project Role",
   "isMulti": false,
   "isEntitlement": false,
   "isGroup": false
   }
   ],
   "name": "ProjectRole"
   }
   

2. Update Account Schema using the following steps:

   1. Get account schema using the getSchema API.
   2. Copy the schema to a file and search for the attribute corresponding to the group schema that was added in step 1.

   3. Add/Update these properties for the attribute found in previous step (2.b.):

      "isGroup": true, 
      "schema": {"type": "CONNECTOR_SCHEMA",
      "id": "<Schema_ID_From_Step1>",
      "name": "<Name_Of_Schema_Created_In_Step1>"}
      

   4. Add the schema modified in step 2.c. to the payload to update account schema in source using the replaceSchema API.

Documentation Feedback

Feedback is provided as an informational resource only and does not form part of SailPoint’s official product documentation. SailPoint does not warrant or make any guarantees about the feedback (including without limitation as to its accuracy, relevance, or reliability). All feedback is subject to the terms set forth at https://developer.sailpoint.com/discuss/tos.