Starling Connect Identity Manager Integrated - Administration Guide

GoToMeeting

GoToMeeting is an online tool for meeting planning. The connector integrates with multiple other products and plug-ins, allowing users to easily connect to create, organize, and host meetings across a common platform.

For more information on generating a private key for a service account, see Generating a private key in GoToMeeting.

Supervisor Configuration Parameters

To configure the connector, following parameters are required:

  • Connector name

  • Username

  • Password
  • Client Id

  • Client Secret

  • Account key
  • Target URL (Cloud application's instance URL used as target URI in payload - Example: https://api.getgo.com/admin/rest/v1/)

Supported Objects and Operations

Users
Table 131: Supported operations for Users

Operation

VERB

Create User

POST

Update User

PUT

Delete User

DELETE

Get User

GET

Get Users

GET

Get All Users with Pagination

GET

Groups
Table 132: Supported operations for Groups

Operation

VERB

Create Group

POST

Update Group

PUT

Delete Group

DELETE

Get Group

GET

Get Groups

GET

Get All Groups with Pagination

GET

Mandatory Fields

Users
  • Email

  • givenName

  • familyName

Groups

displayName

User and Group Mapping

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

Table 133: User Mapping
SCIM Parameter GoToMeeting Parameter
Id key
UserName email
Name.givenName firstName
Name.familyName lastName
Name.formatted firstName+""+lastName
DisplayName firstName+""+lastName

emails[0].value

email

locale

locale

Timezone

timeZone

Groups[].Value

groupKey

Groups[].display

groupName

Groups
Table 134: Group Mapping
SCIM Parameter GoToMeeting Parameter
Id key
DisplayName name
members[].value userKeys[]

Connector Limitations

  • For Users and Groups objects, the Created and Last Modified date are not displayed.

  • When trying to create a duplicate entry of the user who already exists, the connector returns status code 201.

  • Group membership operation is not supported.

  • When trying to retrieve a user by their ID using invalid alphanumeric IDs, the connector returns status code 502 instead of 404.
  • When trying to create a new user with the same email ID of a deleted user, the connector activates the deleted user instead of creating a new user.

 

Coupa

A Coupa connector allows users to move data in and out of Coupa. It lets you manage spend more efficiently by being able to integrate and access spend management and data for expenses, and integrate with other cloud applications.

Supervisor Configuration Parameters

To configure the connector, the following parameters are required:

  • Connector name

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

Supported Objects and Operations

Users
Table 135: Supported operations for Users

Operation

VERB

Create User

POST

Update User

PUT

Get User by id

GET

Get All Users

GET

Get All Users with Pagination

GET

Update Role Membership

PUT

Update Group Membership

PUT

NOTE: The membership operations are user based operations according to target system behavior from Coupa.

Groups
Table 136: Supported operations for Groups

Operation

VERB

Get Group by id

GET

Get All Groups

GET

Get All Groups with Pagination

GET

Roles
Table 137: Supported operations for Roles

Operation

VERB

Get Roles by id

GET

Get All Roles

GET

Get All Roles with Pagination

GET

Mandatory Fields

Users
  • Username

  • Email
  • FirstName

  • LastName

Groups

NA

User and Group Mapping

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

Table 138: User Mapping
SCIM Parameter Coupa Parameter
Id id
UserName login
Name.GivenName firstname
Name.FamilyName lastame
Name.Formatted fullname
DisplayName fullname
Emails[0].value email
Photos avatar-thumb-url
Addresses.StreetAddress default-address[0].street1
Addresses.Locality default-address[0].city
Addresses.Region default-address[0].state

Addresses.PostalCode

default-address[0].postal-code

Addresses.Country

default-address[0].country[0].name

Groups.value

user-groups[X].id

Groups.display

user-groups[X].name

Roles.value

roles.id

Roles.display

roles.name

Active

active

Locale

default-locale

PreferredLanguage

default-locale

Extension.Manager.value

manager.id

Extension.EmployeeNumber

employee-number

Extension.CostCenter

custom-fields.default-user-cost-center

Extension.AuthenticationMethod

authentication-method

Extension.SsoIdentifier

sso-identifier

Extension.PurchasingUser

purchasing-user

Extension.ExpenseUser

expense-user

Extension.SourcingUser

sourcing-user

Extension.InventotyUser

inventoty-user

Extension.ContractsUser

contracts-user

Extension.AnalyticsUser

analytics-user

Extension.UserGroups

User-groups

Extension.ApprovalGroups

Approval-groups

Extension.invoiceApprovalLimit

invoice-approval-limit

Extension.invoiceSelfApprovalLimit

invoice-self-approval-limit

Extension.requisitionApprovalLimit

Requisition-approval-limit

Extension.requisitionSelfApprovalLimit

Requisition-self-approval-limit

Extension.contractApprovalLimit

Contract-approval-limit

Extension.contractSelfApprovalLimit

Contract-self-approval-limit

Extension.workConfirmationApprovalLimit

work-confirmation-approval-

limit

Extension.defaultChartOfAccountsName

default-account.name

Extension.defaultAccountCode

default-account.code

Extension.defaultAccountCodeSegment1

default-account.segment1

Extension.defaultAccountCodeSegment2

default-account.segment2

Extension.defaultCurrency

default-currency

Extension.defaultAddressLocationCode

default-address.location-code

Extension.accountSecurityType

account-security-type

Extension.businessGroupSecurityType

business-group-security-type

Extension.mentionName

mention-name

Extension.newUser

new-user

Extension.deliveryInfo

delivery-info-on-user-record

Created

created-at

LastModified

updated-at

Groups
Table 139: Group Mapping
SCIM Parameter Coupa Parameter
Id id
DisplayName name
Created created-at

LastModified

updated-at

Roles
Table 140: Roles Mapping
SCIM Parameter Coupa Parameter
Id id
DisplayName name
Created created-at

LastModified

updated-at

Connector Limitations

  • Total results are not supported due to cloud application limitations.

  • The target application supports soft delete of users. The deleted users are returned in GET and GET All. The users can also be deleted repeatedly.

  • Account-Groups will not work as of now. It will work when the Coupa team shares the source of information.

  • Approval-Groups will not work as of now. It will work when the new endpoint is implemented.

  • User-Groups will not work as of now. It will work when the new endpoint is implemented.

 

AWS Cognito

AWS Cognito is a connector from Amazon Web Services that helps developers build web and mobile apps that are more secure. It helps to better authenticate users. It also handles user data, including passwords, token-based authentication, scalability, permissions, and so on.

Supervisor Configuration Parameters

To configure the connector, following parameters are required:

  • Connector name

  • AccessKey Id

  • Access Secret

  • Region

  • User Pool Id

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

Supported Objects and Operations

Users
Table 141: Supported operations for Users

Operation

VERB

Create User

POST

Update User

PUT

Delete User

DELETE

Get User

GET

Get All Users

GET

Get All Users with Pagination

GET

Groups
Table 142: Supported operations for Groups

Operation

VERB

Create Group

POST

Update Group

PUT

Delete Group

DELETE

Get Group

GET

Get All Groups

GET

Get All Users with Pagination

GET

Update Membership

PUT

Mandatory Fields

Users
  • Username

  • Email
Groups

DisplayName

User and Group Mapping

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

Table 143: User Mapping
SCIM Parameter Cognito Parameter
Id Username
userName Username
Name.Formatted Username
DisplayName Username
Emails[0].value UserAttributes.email
Active UserStatus.CONFIRMED
PhoneNumbers[0].Value phone_number
Password Password
Extension.IsPasswordPermanent Permanent
Extension.DesiredDeliveryMediums DesiredDeliveryMediums
Extension.email_verified UserAttributes.email_verified
Extension.phone_number_verified UserAttributes.phone_number_verified
Created_at UserCreateDate
lastModified_at UserLastModifiedDate
Groups
Table 144: Group Mapping
SCIM Parameter Cognito Parameter
Id GroupName
displayName GroupName
members[].value Users[].Username

members[].display

Users[].Username

Extension.Precedence

Precedence

Extension.RoleArn

RoleArn

Created_at

CreationDate

lastModified_at

LastModifiedDate

Connector Limitations

  • Creating or updating the User or a Group executes in multiple steps. Failure in any step is reported as a complete failure of operation. However, the record is persisted until succeeded steps.

  • Noncompliance to password policy returns an error. However, an User is created.

  • DesiredDeliveredMedium is write only property. By default, SMS is the default option and it is not returned in Get specific user response.

  • A User can be a member of a maximum of 25 groups.

Appendix

The following chapter has additional information and procedures about the connectors.

 

Documentos relacionados