지금 지원 담당자와 채팅
지원 담당자와 채팅

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 Amazon S3 AWS 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 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 Amazon S3 AWS 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 Service Principal to authenticate the Azure resource management REST APIs for Azure Infrastructure connector

Marketo

The Marketo connector allows you to connect Marketo with One Identity Starling enabling you to take advantage of the features and products available with Starling Connect that complement and enhance the services provided by Marketo.

Marketo provides marketing automation software for all types of digital marketing. It provides services to capture the interaction with each customer, enabling users to identify the most profitable channels and campaigns.

Supervisor configuration parameters

To configure the connector, following parameters are required:

Supported objects and operations

Users

Table 242: Supported operations for Users
Operation VERB

Create(Invite) User

POST

Update User PUT
Delete User DELETE
Get User GET
Get All Users GET
Add RoleAndWorkspace to User PUT

Remove RoleAndWorkspace from User

PUT

Roles

Table 243: Supported operations for Roles

Operation

VERB

Get all Roles GET

Workspaces

Table 244: Supported operations for Workspaces

Operation

VERB

Get all Workspaces GET

Mandatory fields

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

Users

  • FirstName

  • LastName

  • EmailAddress

  • accessRoleId

  • WorkspaceId

Mappings

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

Table 245: User mapping
SCIM Parameter Marketo parameter
Id userid
UserName userid
DisplayName firstName + lastName
name.GivenName firstName
name.FamilyName lastName
emails[].value emailAddress
Active isLocked == false
Extension.rolesAndWorkspaces[].accessRoleId userRoleWorkspaces[].accessRoleId
Extension.rolesAndWorkspaces[].accessRoleName userRoleWorkspaces[].accessRoleName
Extension.rolesAndWorkspaces[].workspaceId userRoleWorkspaces[].workspaceId
Extension.rolesAndWorkspaces[].workspaceName userRoleWorkspaces[].workspaceName

Roles

Table 246: Roles mapping
SCIM parameter Marketo parameter
id id
name name
description description
Type type

Meta.Created

createdAt

Meta.LastModified

updatedAt

Workspaces

Table 247: Workspaces mapping
SCIM parameter Marketo parameter
id id
name name
description description
Status Status

Meta.Created

createdAt

Meta.LastModified

updatedAt

Connector limitations

  1. Create User is a multiple steps operation.
    1. Once the Create User request is successfully submitted to One Identity Manager, the user will receive an email on the email ID mentioned in the request.
    2. User must click on the link provided in the email and set a password.
    3. User is now activated and will be available at the target instance.
  2. To Create a User, at least one pair of accessRoleId and WorkspaceId must be provided.
  3. One Identity Manager must have multi-value arrays of string type to hold the values of the User properties: accessRoleId, accessRoleName, WorkspaceId and WorkspaceName.
  4. Update User is a multiple steps operation.
    1. Only confirmed Users can be updated.
    2. One round of full synchronization is required before submitting the UPDATE request on a newly created User. This must be done to synchronize the User details after activation. This applies to newly created Users only, however existing User UPDATE will work as usual.

  5. Roles and Workspaces endpoints are used only to retrieve data from target and store it in One Identity Manager and can not to be used to assign or unassign Roles and Workspaces to a User.
  6. Connector supports cursor pagination and hence TotalResults are not returned.
  7. Duplicate User CREATE request will return Internal Server Error: 500 with the message System Error: This userid is in use. Choose another email for already existing activated User. However, error 409 is returned if the User is not activated.
  8. The pagination scenarios are not tested for Marketo Connector due to unavailability of adequate target system instance.

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.

Synchronization and integration of Workspaces object type with One Identity Manager

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

Add Roles ID and Workspaces ID to create and update users for Marketo connector

To create a user successfully using Marketo connector, you must provide valid values for mandatory properties such as Roles ID and Workspaces ID in the request. Roles ID and Workspaces ID are the sub-attributes of the main attribute RolesAndWorkspaces, which is a complex multi-valued string attribute defined under User extensions in the connector schema.

One Identity Manager must have fields where you can enter complex multi-value array values but it does not display such fields by default. However, it is possible to create custom multi-value array fields. For more information, see Creating multi-valued custom fields in One Identity Manager.

NOTE: The above example of creating multi-valued custom fields is one of the various ways to achieve the configuration required for adding Roles ID and Workspaces ID to create and update Users. There may be other ways to achieve this integration based on the customization options that One Identity Manager provides.

Supervisor configuration parameters

The Marketo connector allows you to connect Marketo with One Identity Starling enabling you to take advantage of the features and products available with Starling Connect that complement and enhance the services provided by Marketo.

Marketo provides marketing automation software for all types of digital marketing. It provides services to capture the interaction with each customer, enabling users to identify the most profitable channels and campaigns.

To configure the connector, following parameters are required:

Supported objects and operations

Users

Table 242: Supported operations for Users
Operation VERB

Create(Invite) User

POST

Update User PUT
Delete User DELETE
Get User GET
Get All Users GET
Add RoleAndWorkspace to User PUT

Remove RoleAndWorkspace from User

PUT

Roles

Table 243: Supported operations for Roles

Operation

VERB

Get all Roles GET

Workspaces

Table 244: Supported operations for Workspaces

Operation

VERB

Get all Workspaces GET

Mandatory fields

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

Users

  • FirstName

  • LastName

  • EmailAddress

  • accessRoleId

  • WorkspaceId

Mappings

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

Table 245: User mapping
SCIM Parameter Marketo parameter
Id userid
UserName userid
DisplayName firstName + lastName
name.GivenName firstName
name.FamilyName lastName
emails[].value emailAddress
Active isLocked == false
Extension.rolesAndWorkspaces[].accessRoleId userRoleWorkspaces[].accessRoleId
Extension.rolesAndWorkspaces[].accessRoleName userRoleWorkspaces[].accessRoleName
Extension.rolesAndWorkspaces[].workspaceId userRoleWorkspaces[].workspaceId
Extension.rolesAndWorkspaces[].workspaceName userRoleWorkspaces[].workspaceName

Roles

Table 246: Roles mapping
SCIM parameter Marketo parameter
id id
name name
description description
Type type

Meta.Created

createdAt

Meta.LastModified

updatedAt

Workspaces

Table 247: Workspaces mapping
SCIM parameter Marketo parameter
id id
name name
description description
Status Status

Meta.Created

createdAt

Meta.LastModified

updatedAt

Connector limitations

  1. Create User is a multiple steps operation.
    1. Once the Create User request is successfully submitted to One Identity Manager, the user will receive an email on the email ID mentioned in the request.
    2. User must click on the link provided in the email and set a password.
    3. User is now activated and will be available at the target instance.
  2. To Create a User, at least one pair of accessRoleId and WorkspaceId must be provided.
  3. One Identity Manager must have multi-value arrays of string type to hold the values of the User properties: accessRoleId, accessRoleName, WorkspaceId and WorkspaceName.
  4. Update User is a multiple steps operation.
    1. Only confirmed Users can be updated.
    2. One round of full synchronization is required before submitting the UPDATE request on a newly created User. This must be done to synchronize the User details after activation. This applies to newly created Users only, however existing User UPDATE will work as usual.

  5. Roles and Workspaces endpoints are used only to retrieve data from target and store it in One Identity Manager and can not to be used to assign or unassign Roles and Workspaces to a User.
  6. Connector supports cursor pagination and hence TotalResults are not returned.
  7. Duplicate User CREATE request will return Internal Server Error: 500 with the message System Error: This userid is in use. Choose another email for already existing activated User. However, error 409 is returned if the User is not activated.
  8. The pagination scenarios are not tested for Marketo Connector due to unavailability of adequate target system instance.

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.

Synchronization and integration of Workspaces object type with One Identity Manager

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

Add Roles ID and Workspaces ID to create and update users for Marketo connector

To create a user successfully using Marketo connector, you must provide valid values for mandatory properties such as Roles ID and Workspaces ID in the request. Roles ID and Workspaces ID are the sub-attributes of the main attribute RolesAndWorkspaces, which is a complex multi-valued string attribute defined under User extensions in the connector schema.

One Identity Manager must have fields where you can enter complex multi-value array values but it does not display such fields by default. However, it is possible to create custom multi-value array fields. For more information, see Creating multi-valued custom fields in One Identity Manager.

NOTE: The above example of creating multi-valued custom fields is one of the various ways to achieve the configuration required for adding Roles ID and Workspaces ID to create and update Users. There may be other ways to achieve this integration based on the customization options that One Identity Manager provides.

Supported objects and operations

The Marketo connector allows you to connect Marketo with One Identity Starling enabling you to take advantage of the features and products available with Starling Connect that complement and enhance the services provided by Marketo.

Marketo provides marketing automation software for all types of digital marketing. It provides services to capture the interaction with each customer, enabling users to identify the most profitable channels and campaigns.

Supervisor configuration parameters

To configure the connector, following parameters are required:

Users

Table 242: Supported operations for Users
Operation VERB

Create(Invite) User

POST

Update User PUT
Delete User DELETE
Get User GET
Get All Users GET
Add RoleAndWorkspace to User PUT

Remove RoleAndWorkspace from User

PUT

Roles

Table 243: Supported operations for Roles

Operation

VERB

Get all Roles GET

Workspaces

Table 244: Supported operations for Workspaces

Operation

VERB

Get all Workspaces GET

Mandatory fields

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

Users

  • FirstName

  • LastName

  • EmailAddress

  • accessRoleId

  • WorkspaceId

Mappings

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

Table 245: User mapping
SCIM Parameter Marketo parameter
Id userid
UserName userid
DisplayName firstName + lastName
name.GivenName firstName
name.FamilyName lastName
emails[].value emailAddress
Active isLocked == false
Extension.rolesAndWorkspaces[].accessRoleId userRoleWorkspaces[].accessRoleId
Extension.rolesAndWorkspaces[].accessRoleName userRoleWorkspaces[].accessRoleName
Extension.rolesAndWorkspaces[].workspaceId userRoleWorkspaces[].workspaceId
Extension.rolesAndWorkspaces[].workspaceName userRoleWorkspaces[].workspaceName

Roles

Table 246: Roles mapping
SCIM parameter Marketo parameter
id id
name name
description description
Type type

Meta.Created

createdAt

Meta.LastModified

updatedAt

Workspaces

Table 247: Workspaces mapping
SCIM parameter Marketo parameter
id id
name name
description description
Status Status

Meta.Created

createdAt

Meta.LastModified

updatedAt

Connector limitations

  1. Create User is a multiple steps operation.
    1. Once the Create User request is successfully submitted to One Identity Manager, the user will receive an email on the email ID mentioned in the request.
    2. User must click on the link provided in the email and set a password.
    3. User is now activated and will be available at the target instance.
  2. To Create a User, at least one pair of accessRoleId and WorkspaceId must be provided.
  3. One Identity Manager must have multi-value arrays of string type to hold the values of the User properties: accessRoleId, accessRoleName, WorkspaceId and WorkspaceName.
  4. Update User is a multiple steps operation.
    1. Only confirmed Users can be updated.
    2. One round of full synchronization is required before submitting the UPDATE request on a newly created User. This must be done to synchronize the User details after activation. This applies to newly created Users only, however existing User UPDATE will work as usual.

  5. Roles and Workspaces endpoints are used only to retrieve data from target and store it in One Identity Manager and can not to be used to assign or unassign Roles and Workspaces to a User.
  6. Connector supports cursor pagination and hence TotalResults are not returned.
  7. Duplicate User CREATE request will return Internal Server Error: 500 with the message System Error: This userid is in use. Choose another email for already existing activated User. However, error 409 is returned if the User is not activated.
  8. The pagination scenarios are not tested for Marketo Connector due to unavailability of adequate target system instance.

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.

Synchronization and integration of Workspaces object type with One Identity Manager

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

Add Roles ID and Workspaces ID to create and update users for Marketo connector

To create a user successfully using Marketo connector, you must provide valid values for mandatory properties such as Roles ID and Workspaces ID in the request. Roles ID and Workspaces ID are the sub-attributes of the main attribute RolesAndWorkspaces, which is a complex multi-valued string attribute defined under User extensions in the connector schema.

One Identity Manager must have fields where you can enter complex multi-value array values but it does not display such fields by default. However, it is possible to create custom multi-value array fields. For more information, see Creating multi-valued custom fields in One Identity Manager.

NOTE: The above example of creating multi-valued custom fields is one of the various ways to achieve the configuration required for adding Roles ID and Workspaces ID to create and update Users. There may be other ways to achieve this integration based on the customization options that One Identity Manager provides.

Mandatory fields

The Marketo connector allows you to connect Marketo with One Identity Starling enabling you to take advantage of the features and products available with Starling Connect that complement and enhance the services provided by Marketo.

Marketo provides marketing automation software for all types of digital marketing. It provides services to capture the interaction with each customer, enabling users to identify the most profitable channels and campaigns.

Supervisor configuration parameters

To configure the connector, following parameters are required:

Supported objects and operations

Users

Table 242: Supported operations for Users
Operation VERB

Create(Invite) User

POST

Update User PUT
Delete User DELETE
Get User GET
Get All Users GET
Add RoleAndWorkspace to User PUT

Remove RoleAndWorkspace from User

PUT

Roles

Table 243: Supported operations for Roles

Operation

VERB

Get all Roles GET

Workspaces

Table 244: Supported operations for Workspaces

Operation

VERB

Get all Workspaces GET

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

Users

  • FirstName

  • LastName

  • EmailAddress

  • accessRoleId

  • WorkspaceId

Mappings

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

Table 245: User mapping
SCIM Parameter Marketo parameter
Id userid
UserName userid
DisplayName firstName + lastName
name.GivenName firstName
name.FamilyName lastName
emails[].value emailAddress
Active isLocked == false
Extension.rolesAndWorkspaces[].accessRoleId userRoleWorkspaces[].accessRoleId
Extension.rolesAndWorkspaces[].accessRoleName userRoleWorkspaces[].accessRoleName
Extension.rolesAndWorkspaces[].workspaceId userRoleWorkspaces[].workspaceId
Extension.rolesAndWorkspaces[].workspaceName userRoleWorkspaces[].workspaceName

Roles

Table 246: Roles mapping
SCIM parameter Marketo parameter
id id
name name
description description
Type type

Meta.Created

createdAt

Meta.LastModified

updatedAt

Workspaces

Table 247: Workspaces mapping
SCIM parameter Marketo parameter
id id
name name
description description
Status Status

Meta.Created

createdAt

Meta.LastModified

updatedAt

Connector limitations

  1. Create User is a multiple steps operation.
    1. Once the Create User request is successfully submitted to One Identity Manager, the user will receive an email on the email ID mentioned in the request.
    2. User must click on the link provided in the email and set a password.
    3. User is now activated and will be available at the target instance.
  2. To Create a User, at least one pair of accessRoleId and WorkspaceId must be provided.
  3. One Identity Manager must have multi-value arrays of string type to hold the values of the User properties: accessRoleId, accessRoleName, WorkspaceId and WorkspaceName.
  4. Update User is a multiple steps operation.
    1. Only confirmed Users can be updated.
    2. One round of full synchronization is required before submitting the UPDATE request on a newly created User. This must be done to synchronize the User details after activation. This applies to newly created Users only, however existing User UPDATE will work as usual.

  5. Roles and Workspaces endpoints are used only to retrieve data from target and store it in One Identity Manager and can not to be used to assign or unassign Roles and Workspaces to a User.
  6. Connector supports cursor pagination and hence TotalResults are not returned.
  7. Duplicate User CREATE request will return Internal Server Error: 500 with the message System Error: This userid is in use. Choose another email for already existing activated User. However, error 409 is returned if the User is not activated.
  8. The pagination scenarios are not tested for Marketo Connector due to unavailability of adequate target system instance.

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.

Synchronization and integration of Workspaces object type with One Identity Manager

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

Add Roles ID and Workspaces ID to create and update users for Marketo connector

To create a user successfully using Marketo connector, you must provide valid values for mandatory properties such as Roles ID and Workspaces ID in the request. Roles ID and Workspaces ID are the sub-attributes of the main attribute RolesAndWorkspaces, which is a complex multi-valued string attribute defined under User extensions in the connector schema.

One Identity Manager must have fields where you can enter complex multi-value array values but it does not display such fields by default. However, it is possible to create custom multi-value array fields. For more information, see Creating multi-valued custom fields in One Identity Manager.

NOTE: The above example of creating multi-valued custom fields is one of the various ways to achieve the configuration required for adding Roles ID and Workspaces ID to create and update Users. There may be other ways to achieve this integration based on the customization options that One Identity Manager provides.

관련 문서

The document was helpful.

평가 결과 선택

I easily found the information I needed.

평가 결과 선택