Chat now with support
Chat with Support

Starling Connect Hosted - One Identity Manager Administration Guide

About this guide One Identity Starling Connect overview One Identity Starling Supported cloud applications Working with connectors Connector versions Salesforce Facebook Workplace SAP Cloud Platform JIRA Server RSA Archer SuccessFactors AWS IAM ServiceNow Dropbox Crowd Atlassian JIRA Confluence Trello Box Pipedrive SuccessFactors HR NutShell Insightly Egnyte SugarCRM Oracle IDCS Statuspage Zendesk Sell Workbooks DocuSign Citrix ShareFile Zendesk Azure AD Google Workspace Concur Tableau GoToMeeting Coupa AWS Cognito Okta DataDog Hideez Opsgenie Informatica Cloud Services AppDynamics Marketo Workday HR OneLogin PingOne Aha! SAP Litmos HackerRank Slack ActiveCampaign Webex Apigee Databricks Hive PagerDuty Dayforce Smartsheet Pingboard SAP Cloud for Customer Azure Infrastructure Oracle Fusion Cloud Majesco LuccaHR OpenText JFrog Artifactory xMatters Discourse Testrail ChipSoft PingOne Platform Azure DevOps UKG PRO Atlassian Cloud Appendix: Creating a service account in Google Workspace Appendix: Setting a trial account on Salesforce Registering the application, providing necessary permissions, retrieving Client Id and Client Secret from the Azure AD tenant Generating a private key for service account in GoToMeeting Configuring AWS IAM connector to support entitlements for User and Group Configuring Box connector to support additional email IDs for users One Identity Manager E2E integration needs for Hideez connector Configuring custom attributes for ServiceNow v.1.0 Configuring custom attributes for Coupa v.1.0 Configuring custom attributes in connectors Disabling attributes Configuring a connector that uses the consent feature Synchronization and integration of Roles object type with One Identity Manager Synchronization and integration of Workspaces object type with One Identity Manager Synchronization and integration of Products object type with One Identity Manager User centric membership Creating multi-valued custom fields in One Identity Manager Synchronization and assignment of PermissionSets to Users with One Identity Manager Connectors that support password attribute in User object Connectors that do not support special characters in the object ID Creating an app for using SCIM on Slack Enterprise Grid Organization Creating a Webex integration application, providing necessary scopes, retrieving Client Id and Client Secret Retrieving the API key from Facebook Workplace Outbound IP addresses Values for customer-specific configuration parameters in Workday HR connector Initiate an OAuth connection to SuccessFactors Creating custom editable/upsertable attributes in Successfactors employee central Custom Foundation Objects in Successfactors HR connector Configuring additional datetime offset in connectors How to Create custom attribute for Users in SuccessFactors portal SAP Cloud for Customer - Steps to add custom fields at One Identity Manager attributes Creating a Service Principal for the Azure Infrastructure Connector Workday permissions needed to integrate via the Starling Connector Configuring integration application in DocuSign Creating integration Connect Client in Coupa Retrieving Azure DevOps Personal Access Token (PAT) Setup integration system and field override service in Workday Retrieving Atlassian Cloud API Key and Directory ID

Connector limitations

The Apigee connector allows you to connect Apigee with One Identity Starling enabling you to take advantage of the features and products available with Starling Connect that complement and enhance Apigee's platform that allows you to design, secure, analyze, scale, publish, monitor, and manage the APIs.

Supervisor configuration parameters

To configure the connector, following parameters are required:

  • Connector name

  • UserName

  • Password

  • Organization

  • Target URL (Cloud application's instance URL used as target URI in payload)

Supported objects and operations

Users

Table 316: Supported operations for Users
Operation VERB
Create User POST
Update User PUT
Delete User DELETE
Get User by ID GET
Get All Users GET

Roles

Table 317: Supported operations for Roles
Operation Operation
Get Role by id GET
Get All Roles GET

Mandatory fields

This section lists the mandatory fields required to create a User or Group:

Users

  • Name.GivenName

  • Name.FamilyName

  • Emails.Value

  • Password

User and Group mapping

The user and group mappings are listed in the tables below.

Table 318: User mapping
SCIM Parameter Apigee parameter
id emailId
userName emailId
DisplayName firstName+lastName
Name.GivenName firstName
Name.FamilyName lastName
Emails.Value emailId
Roles[].value (userRolesResponse)role[].name
Password Password

Role

Table 319: Role mapping
SCIM Parameter Apigee parameter
id name
name name
  • At least one role must be assigned to the created user. If the role is not assigned to the user, the particular user is not visible on the User management dashboard of the target instance due to the limitation of the target system.

  • Get All Users does not return the displayName as it is not available in the target system. However, Get User by ID returns the display name with the other available attributes of the User.

  • Create User operation fails intermittently and an Internal Server Error 500 is displayed due to the Target system API behavior.
  • The Get All and Create User operations may occasionally take more time to respond for requests.

  • Apigee Connector does not support pagination for Users and Roles object types due to API limitation in the target system.
  • The connector does not support special characters in the object ID. For more information, see Connectors that do not support special characters in the object ID.

Synchronization and integration of Roles object type with One Identity Manager

For more information, see Synchronization and integration of Roles object type with One Identity Manager.

Databricks

The Databricks connector allows you to connect Databricks with One Identity Starling enabling you to take advantage of the features and products available with Starling Connect that complement and enhance Databricks' unified platform for data and Artificial Intelligence (AI). Databricks provides services that allow you to migrate complex and expensive on-premises data systems to cloud data platforms.

Supervisor configuration parameters

To configure the connector, following parameters are required:

  • Connector name

  • Access Token

  • Target URL (Format:- https://databricks_instance/api/2.0/preview/scim/v2)

Supported objects and operations

Users

Table 320: Supported operations for Users
Operation VERB
Create User POST
Get User GET
List Users GET
Update User PUT
Delete User DELETE

Groups

Table 321: Supported operations for Groups
Operation Operation
Create Group POST
Get Group GET

List Groups

GET

Update Group

PUT

Delete Group

DELETE

Mandatory fields

This section lists the mandatory fields required to create a User or Group:

Users

  • userName

Groups

  • displayName

User and Group mapping

The user and group mappings are listed in the tables below.

Table 322: User mapping
SCIM Parameter Databricks parameter
id id
userName userName
name.familyName name.familyName
name.givenName name.givenName
displayName displayName
emails[0].value emails[0].value
emails[0].type emails[0].type
emails[0].primary emails[0].primary

active

active

groups[].value

groups[].value

groups[].display

groups[].display

entitlements[].value

entitlements[].value

Group

Table 323: Group mapping
SCIM Parameter Databricks parameter
id id
displayName displayName

members[].value

members[].value

members[].display

members[].display

extension.parentGroups[].value

groups[].value

extension.parentGroups[].display

groups[].display

extension.entitlements[].value

entitlements[].value

Connector limitations

  • If User's displayName attribute is present in the request, then the name attributes are not considered. If displayName is not provided, the values from the name attributes would be considered.

  • The connector doesn't implement roles for Users. Roles endpoints are not supported at target system and the user can not be assigned with random text to the roles.

  • The connector does not implement modifying the entitlements for Users or Groups. Entitlements endpoints are not supported at target system. The User or Group can not be assigned with random text to the entitlements.

  • Create User operation can create only Active users in the target application. However, Update User operation can be used to make the user InActive.

  • When a user create operation is tried with userName of a deleted user, the target system re-activates the deleted user and returns the details of that deleted user (with any updated values for attributes from the create request) instead of creating a new user with new user id.

  • The Databricks REST API supports a maximum of 30 requests per second per workspace. A 429 response status code is displayed if the requests exceed the rate limit.

  • A Databricks admin user whose Personal Access Token is used to authorize the target endpoints and who is managed by the Identity Provider (IdP) can be deprovisioned using the IdP, which may cause the SCIM provisioning integration to be disabled.

  • No meta information is retrieved for users and groups.

  • Target system follows soft delete of resources. Inactivating a user by updating 'active' to 'false' soft-deletes the user and that user cannot be retrieved.

  • Group's members will not contain 'type' attribute with values 'User' / 'Group' as the target system does not return the type of the members. Groups in target system can have users and groups as members.

  • Delete group request with invalid id returns 204 because of the target API behavior. The target API returns success when a deleted group is tried deleting again.

  • List users and list groups APIs are relatively slow. Hence used very minimal set of attributes in the query attributes on these endpoint.

Supervisor configuration parameters

The Databricks connector allows you to connect Databricks with One Identity Starling enabling you to take advantage of the features and products available with Starling Connect that complement and enhance Databricks' unified platform for data and Artificial Intelligence (AI). Databricks provides services that allow you to migrate complex and expensive on-premises data systems to cloud data platforms.

To configure the connector, following parameters are required:

  • Connector name

  • Access Token

  • Target URL (Format:- https://databricks_instance/api/2.0/preview/scim/v2)

Supported objects and operations

Users

Table 320: Supported operations for Users
Operation VERB
Create User POST
Get User GET
List Users GET
Update User PUT
Delete User DELETE

Groups

Table 321: Supported operations for Groups
Operation Operation
Create Group POST
Get Group GET

List Groups

GET

Update Group

PUT

Delete Group

DELETE

Mandatory fields

This section lists the mandatory fields required to create a User or Group:

Users

  • userName

Groups

  • displayName

User and Group mapping

The user and group mappings are listed in the tables below.

Table 322: User mapping
SCIM Parameter Databricks parameter
id id
userName userName
name.familyName name.familyName
name.givenName name.givenName
displayName displayName
emails[0].value emails[0].value
emails[0].type emails[0].type
emails[0].primary emails[0].primary

active

active

groups[].value

groups[].value

groups[].display

groups[].display

entitlements[].value

entitlements[].value

Group

Table 323: Group mapping
SCIM Parameter Databricks parameter
id id
displayName displayName

members[].value

members[].value

members[].display

members[].display

extension.parentGroups[].value

groups[].value

extension.parentGroups[].display

groups[].display

extension.entitlements[].value

entitlements[].value

Connector limitations

  • If User's displayName attribute is present in the request, then the name attributes are not considered. If displayName is not provided, the values from the name attributes would be considered.

  • The connector doesn't implement roles for Users. Roles endpoints are not supported at target system and the user can not be assigned with random text to the roles.

  • The connector does not implement modifying the entitlements for Users or Groups. Entitlements endpoints are not supported at target system. The User or Group can not be assigned with random text to the entitlements.

  • Create User operation can create only Active users in the target application. However, Update User operation can be used to make the user InActive.

  • When a user create operation is tried with userName of a deleted user, the target system re-activates the deleted user and returns the details of that deleted user (with any updated values for attributes from the create request) instead of creating a new user with new user id.

  • The Databricks REST API supports a maximum of 30 requests per second per workspace. A 429 response status code is displayed if the requests exceed the rate limit.

  • A Databricks admin user whose Personal Access Token is used to authorize the target endpoints and who is managed by the Identity Provider (IdP) can be deprovisioned using the IdP, which may cause the SCIM provisioning integration to be disabled.

  • No meta information is retrieved for users and groups.

  • Target system follows soft delete of resources. Inactivating a user by updating 'active' to 'false' soft-deletes the user and that user cannot be retrieved.

  • Group's members will not contain 'type' attribute with values 'User' / 'Group' as the target system does not return the type of the members. Groups in target system can have users and groups as members.

  • Delete group request with invalid id returns 204 because of the target API behavior. The target API returns success when a deleted group is tried deleting again.

  • List users and list groups APIs are relatively slow. Hence used very minimal set of attributes in the query attributes on these endpoint.

Supported objects and operations

The Databricks connector allows you to connect Databricks with One Identity Starling enabling you to take advantage of the features and products available with Starling Connect that complement and enhance Databricks' unified platform for data and Artificial Intelligence (AI). Databricks provides services that allow you to migrate complex and expensive on-premises data systems to cloud data platforms.

Supervisor configuration parameters

To configure the connector, following parameters are required:

  • Connector name

  • Access Token

  • Target URL (Format:- https://databricks_instance/api/2.0/preview/scim/v2)

Users

Table 320: Supported operations for Users
Operation VERB
Create User POST
Get User GET
List Users GET
Update User PUT
Delete User DELETE

Groups

Table 321: Supported operations for Groups
Operation Operation
Create Group POST
Get Group GET

List Groups

GET

Update Group

PUT

Delete Group

DELETE

Mandatory fields

This section lists the mandatory fields required to create a User or Group:

Users

  • userName

Groups

  • displayName

User and Group mapping

The user and group mappings are listed in the tables below.

Table 322: User mapping
SCIM Parameter Databricks parameter
id id
userName userName
name.familyName name.familyName
name.givenName name.givenName
displayName displayName
emails[0].value emails[0].value
emails[0].type emails[0].type
emails[0].primary emails[0].primary

active

active

groups[].value

groups[].value

groups[].display

groups[].display

entitlements[].value

entitlements[].value

Group

Table 323: Group mapping
SCIM Parameter Databricks parameter
id id
displayName displayName

members[].value

members[].value

members[].display

members[].display

extension.parentGroups[].value

groups[].value

extension.parentGroups[].display

groups[].display

extension.entitlements[].value

entitlements[].value

Connector limitations

  • If User's displayName attribute is present in the request, then the name attributes are not considered. If displayName is not provided, the values from the name attributes would be considered.

  • The connector doesn't implement roles for Users. Roles endpoints are not supported at target system and the user can not be assigned with random text to the roles.

  • The connector does not implement modifying the entitlements for Users or Groups. Entitlements endpoints are not supported at target system. The User or Group can not be assigned with random text to the entitlements.

  • Create User operation can create only Active users in the target application. However, Update User operation can be used to make the user InActive.

  • When a user create operation is tried with userName of a deleted user, the target system re-activates the deleted user and returns the details of that deleted user (with any updated values for attributes from the create request) instead of creating a new user with new user id.

  • The Databricks REST API supports a maximum of 30 requests per second per workspace. A 429 response status code is displayed if the requests exceed the rate limit.

  • A Databricks admin user whose Personal Access Token is used to authorize the target endpoints and who is managed by the Identity Provider (IdP) can be deprovisioned using the IdP, which may cause the SCIM provisioning integration to be disabled.

  • No meta information is retrieved for users and groups.

  • Target system follows soft delete of resources. Inactivating a user by updating 'active' to 'false' soft-deletes the user and that user cannot be retrieved.

  • Group's members will not contain 'type' attribute with values 'User' / 'Group' as the target system does not return the type of the members. Groups in target system can have users and groups as members.

  • Delete group request with invalid id returns 204 because of the target API behavior. The target API returns success when a deleted group is tried deleting again.

  • List users and list groups APIs are relatively slow. Hence used very minimal set of attributes in the query attributes on these endpoint.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating