Chat now with support
Chat with Support

Starling Connect Identity Manager Integrated - Administration Guide

About this guide One Identity Starling Connect overview One Identity Starling Supported cloud applications Configuring 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 GSuite Concur Tableau GoToMeeting Coupa AWS Cognito Okta Creating a service account in GSuite Setting a trial account on Salesforce Working with Azure AD Generating a private key for service account in GoToMeeting OneIM limitations Configuring Amazon S3 AWS connector to support entitlements for User and Group Outbound IP addresses

SuccessFactors HR

SuccessFactors HR is an integrated human-resources platform. It offers users tools for onboarding, social business, and collaboration along with tools for learning management, performance management, recruiting, applicant tracking, succession planning, talent management, and HR analytics. It is also cloud-based.

Supervisor configuration parameters

To configure the connector, following parameters are required:

Table 68: Minimal set of attributes for the objects

SuccessFactors HR

Attributes

BusinessUnit

externalCode, name, description, status, startDate, createdOn, lastModifiedOn

Company

externalCode, name, description, status, createdOn, lastModifiedOn

CostCenter

name, description, externalCode, status, startDate, createdOn, lastModifiedOn

Division

externalCode, name, description, status, startDate, createdOn, lastModifiedOn

Department name, description, externalCode, status, startDate, createdOn, lastModifiedOn

EmpEmployment

userID, startDate, createdOn, lastModifiedOn

Employee

EmpJob attributes: userId, businessUnit, company, costCenter, createdOn, division, event, eventReason, jobTitle, location, managerId, emplStatus, startDate, jobCode, position

User attributes: userId, username, defaultFullName, hireDate, lastModified, status, department, location, firstName, lastName, mi, suffix, email, addressLine1, state, city, zipCode, country, businessPhone, cellPhone

EventReason

externalCode, name, status, event, createdOn, lastModifiedOn

JobCode

externalCode, name, description, status, createdOn, lastModifiedOn

Location externalCode, name, description, status, geozoneFlx, createdOn, lastModifiedOn

PerPersonal

personIdExternal, firstName, lastName, preferredName, createdOn, lastModifiedOn

PerPhone

personIdExternal, phoneNumber, phoneType, createdOn, lastModifiedOn

PicklistLabel

id,externalCode, status

PicklistOption

id,externalCode, status

Position code, description, jobTitle, effectiveStatus, jobCode, businessUnit, company, department, externalName_defaultValue, createdDate, lastModifiedDate

NOTE: For consuming Starling Connect HR connectors (for example, SuccessFactors HR) into the One Identity Manager Synchronization Client, the One Identity Manager CHS module has to be installed and configured. You can download the appropriate CHS module from the One Identity Manager Support site.

Supported objects and operations

Employees
Table 69: Supported operations for Employees

Operation

VERB

Get Employee

GET

Get All Employees with Pagination

GET

Update Employees

PUT

Companies
Table 70: Supported operations for Companies

Operation

VERB

Get Company GET

Get All Company With Pagination

GET

BusinessUnits
Table 71: Supported operations for BusinessUnits

Operation

VERB

Get BusinessUnit GET

Get All Business Units with Pagination

GET

Departments
Table 72: Supported operations for Departments

Operation

VERB

Get Department GET

Get All Departments with Pagination

GET

Locations
Table 73: Supported operations for Locations

Operation

VERB

Get Location GET

Get All Locations with Pagination

GET

Divisions
Table 74: Supported operations for Divisions

Operation

VERB

Get Division GET

Get All Division With Pagination

GET

CostCenters
Table 75: Supported operations for CostCenters

Operation

VERB

Get CostCenter GET

Get All CostCenter with Pagination

GET

JobCodes
Table 76: Supported operations for JobCodes

Operation

VERB

Get JobCode GET
Get All JobCodeWith Pagination GET
Positions
Table 77: Supported operations for Positions

Operation

VERB

Get Position GET
Get All Position With Pagination GET
EmpEmployments
Table 78: Supported operations for EmpEmployments

Operation

VERB

Get EmpEmployment GET
Get All EmpEmployment With Pagination GET
PerPersonals
Table 79: Supported operations for PerPersonals

Operation

VERB

Get PerPersonal GET
Get All PerPersonal With Pagination GET

PerPhones

Table 80: Supported operations for PerPhones

Operation

VERB

Get PerPhone GET
Get All PerPhone With Pagination GET

EventReasons

Table 81: Supported operations for EventReasons

Operation

VERB

Get EventReason GET
Get All EventReason With Pagination GET

PicklistLabels

Table 82: Supported operations for PicklistLabels

Operation

VERB

Get PicklistLabel GET
Get All PicklistLabel With Pagination GET

PicklistOptions

Table 83: Supported operations for PicklistOptions

Operation

VERB

Get PicklistOption GET
Get All PicklistOption With Pagination GET

Mappings

Endpoints mapping

Table 84: Target system objects mapping
Target system objects SCIM endpoints
Employees EmpJob
BusinessUnits FOBusinessUnit
Departments FODepartment
CostCenters FOCostCenter
Locations FOLocation

Divisions

Divisions

Companies

FOCompany

JobCodes

FOJobCode

Positions

Position

EmpEmployments

EmpEmployment

PerPersonals

PerPersonal

PerPhones

PerPhone

PicklistLabels

PicklistLabel

PicklistOptions

PicklistOption

EventReasons

EventReason

Attributes mapping

Different mappings associated with this connector are listed in the tables below.

Table 85: Employee mapping
SCIM parameter SuccessFactors HR parameter
Id id
UserName userNav /username
Name.GivenName userNav/firstName
Name.Familyname userNav/lastName
Name.MiddleName userNav/mi
Name.HonorificSuffix userNav/suffix
Name.Formatted userNav/defaultFullName
DisplayName userNav/defaultFullName
Emails[0].Value userNav/email
Addresses.StreetAddress userNav/addressLine1
Addresses.Locality userNav/state
Addresses.Region userNav/city
Addresses.PostalCode userNav/zipCode
Addresses.Country userNav/country
PhoneNumbers.businessPhone userNav/businessPhone
PhoneNumbers.cellPhone userNav/cellPhone
Meta.LastModified userNav/lastModified

Meta.Created

createdOn

userId userId
department department
businessUnit businessUnit
division division

location

location

costCenter

costCenter

startDate

startDate

seqNumber

seqNumber

workingTimeDirective

workingTimeDirective

endDate

endDate

timeTypeProfileCode

timeTypeProfileCode

timeRecordingVariant

timeRecordingVariant

employmentType

employmentType

workscheduleCode

workscheduleCode

regularTemp

regularTemp

payScaleGroup

payScaleGroup

probationPeriodEndDate

probationPeriodEndDate

payScaleType

payScaleType

createdBy

createdBy

managerId

managerId

jobCode

jobCode

retired

retired

employeeClass

employeeClass

familyRelationshipWithEmployer

familyRelationshipWithEmployer

isCompetitionClauseActive

isCompetitionClauseActive

jobTitle

jobTitle

standardHours

standardHours

countryOfCompany

countryOfCompany

hazard

hazard

travelDistance

travelDistance

isSideLineJobAllowed

isSideLineJobAllowed

payScaleArea

payScaleArea

holidayCalendarCode

holidayCalendarCode

timezone

timezone

contractType

contractType

payGrade

payGrade

workLocation

workLocation

workingDaysPerWeek

workingDaysPerWeek

empRelationship

empRelationship

company

company

isFulltimeEmployee

isFulltimeEmployee

laborProtection

laborProtection

payScaleLevel

payScaleLevel

workerCategory

workerCategory

position

position

event_

event_

eventReason

eventReason

emplStatus

emplStatus

status

status

 

Table 86: Departments mapping
SCIM parameter SuccessFactors HR parameter
Id externalCode
name name
description description
createdBy createdBy
externalCode externalCode
costCenter costCenter
headOfUnit headOfUnit

status

status

startDate

startDate

endDate

endDate

lastModifiedDateTime

lastModifiedDateTime

parent

parent

lastModifiedOn

lastModifiedOn

createdOn

createdOn

lastModifiedBy

lastModifiedBy

Meta.LastModified lastModifiedOn

Meta.Created

createdOn

 

Table 87: Locations mapping
SCIM parameter SuccessFactors HR parameter
Id externalCode
name name
description description
timezone timezone
externalCode externalCode
geozoneFlx geozoneFlx
locationGroup locationGroup
locationGroupFlx locationGroupFlx

createdBy

createdBy

status

status

startDate

startDate

endDate

endDate

lastModifiedOn

lastModifiedOn

lastModifiedDateTime

lastModifiedDateTime

lastModifiedBy

lastModifiedBy

createdDateTime

createdDateTime

standardHours

standardHours

Meta.LastModified lastModifiedOn

Meta.Created

createdOn

 

Table 88: BusinessUnits mapping
SCIM parameter SuccessFactors HR parameter
Id externalCode
name name
description description
createdBy createdBy
externalCode externalCode
status status
startDate startDate

endDate

endDate

headOfUnit

headOfUnit

description_de_DE

description_de_DE

name_de_DE

name_de_DE

lastModifiedOn

lastModifiedOn

lastModifiedBy

lastModifiedBy

createdOn

createdOn

Meta.LastModified lastModifiedOn

Meta.Created

createdOn

 

Table 89: Divisions mapping
SCIM parameter SuccessFactors HR parameter
Id externalCode
name name
description description
createdBy createdBy
externalCode externalCode
startDate startDate

endDate

endDate

status status
lastModifiedDateTime lastModifiedDateTime
parent parent
lastModifiedOn lastModifiedOn
createdOn createdOn

lastModifiedBy

lastModifiedBy

createdDateTime

createdDateTime

headOfUnit

headOfUnit

Meta.LastModified lastModifiedOn

Meta.Created

createdOn

 

Table 90: CostCenters mapping
SCIM parameter SuccessFactors HR parameter
Id externalCode
name name
description description
createdBy createdBy
externalCode externalCode

costcenterManager

costcenterManager

status status
startDate startDate

endDate

endDate

parent parent
lastModifiedOn lastModifiedOn
createdOn createdOn

lastModifiedBy

lastModifiedBy

Meta.LastModified

lastModifiedOn

Meta.Created

createdOn

 

Table 91: Companies mapping
SCIM parameter SuccessFactors HR parameter
Id externalCode
name name
description description
externalCode externalCode
status status
startDate startDate

endDate

endDate

defaultLocation defaultLocation
country country
standardHours standardHours
defaultPayGroup defaultPayGroup
Meta.LastModified lastModifiedOn

Meta.Created

createdOn

 

Table 92: JobCodes mapping
SCIM parameter SuccessFactors HR parameter
Id externalCode
name name
description description
externalCode externalCode
status status
startDate startDate

endDate

endDate

lastModifiedOn lastModifiedOn
lastModifiedBy lastModifiedBy
createdBy createdBy
createdOn createdOn

parentJobCode

parentJobCode

supervisorLevel

supervisorLevel

defaultSupervisorLevel

defaultSupervisorLevel

standardHours

standardHours

workerCompCode

workerCompCode

grade

grade

isFulltimeEmployee

isFulltimeEmployee

jobFunction

jobFunction

regularTemporary

regularTemporary

employeeClass

employeeClass

defaultJobLevel

defaultJobLevel

isRegular

isRegular

jobLevel

jobLevel

defaultEmployeeClass

defaultEmployeeClass

Meta.LastModified lastModifiedOn

Meta.Created

createdOn

 

Table 93: Positions mapping
SCIM parameter SuccessFactors HR parameter
Id code
code code
description description
effectiveStartDate effectiveStartDate
effectiveEndDate effectiveEndDate
effectiveStatus effectiveStatus
standardHours standardHours
department department
businessUnit businessUnit
division division
location location
costCenter costCenter
createdBy createdBy
jobTitle jobTitle
employeeClass employeeClass
jobCode jobCode
company company
payGrade payGrade
comment comment
createdDate createdDate
jobLevel jobLevel
lastModifiedBy lastModifiedBy
lastModifiedDate lastModifiedDate
positionTitle positionTitle
vacant vacant
regularTemporary regularTemporary

payRange

payRange

Meta.LastModified lastModifiedDate

Meta.Created

createdDate

 

Table 94: EmpEmployments mapping
SCIM parameter SuccessFactors HR parameter
Id userId
userId userId
personIdExternal personIdExternal
startDate startDate
createdBy createdBy
createdOn createdOn
firstDateWorked firstDateWorked
lastDateWorked lastDateWorked
lastModifiedBy lastModifiedBy
Meta.LastModified lastModifiedOn

Meta.Created

createdOn

 

Table 95: PerPersonals mapping
SCIM parameter SuccessFactors HR parameter
Id personIdExternal
personIdExternal personIdExternal
startDate startDate
createdBy createdBy
createdOn createdOn
firstName firstName
lastName lastName
gender gender

preferredName

preferredName

lastModifiedBy

lastModifiedBy

Meta.LastModified lastModifiedOn

Meta.Created

createdOn

 

Table 96: PerPhones mapping
SCIM parameter SuccessFactors HR parameter
Id personIdExternal
personIdExternal personIdExternal
phoneType phoneType
areaCode areaCode
phoneNumber phoneNumber
countryCode countryCode
isPrimary isPrimary
createdBy createdBy
createdOn createdOn
lastModifiedOn lastModifiedOn

lastModifiedBy

lastModifiedBy

Meta.LastModified lastModifiedOn

Meta.Created

createdOn

 

Table 97: EventReasons mapping
SCIM parameter SuccessFactors HR parameter
Id externalCode
externalCode externalCode
name name
status status
event_ event_
emplStatus emplStatus
description description
startDate startDate
createdOn createdOn
createdBy createdBy
lastModifiedOn lastModifiedOn

lastModifiedBy

lastModifiedBy

Meta.LastModified

lastModifiedOn

Meta.Created

createdOn

 

Table 98: PicklistOptions mapping
SCIM parameter SuccessFactors HR parameter
Id id
externalCode externalCode
status status

 

Table 99: PicklistLabels mapping
SCIM parameter SuccessFactors HR parameter
Id optionId
id_ id
optionId optionId

locale

locale

label

label

 

Connector limitations

  • Create and Delete operations are not supported for any object.

  • Currently, the Update functionality is functional only for the following attributes of the Employee object:

    • cellPhone
    • businessPhone
    • email

NutShell

NutShell is a customer relationship management (CRM) service. It can be integrated with other SaaS services for small businesses, including Google Apps.

Supervisor configuration parameters

To configure the connector, following parameters are required:

  • Connector name

  • Username for the cloud account

  • Password - API Key

  • Target URL of the cloud account

Supported objects and operations

Users
Table 100: Supported operations for Users

Operation

VERB

Create

POST

Update

PUT

Delete

DELETE

Get user by Id

GET

Get all users

GET

Get all users with pagination

GET

Groups
Table 101: Supported operations for Groups

Operation

VERB

Create POST
Update

PUT

Delete DELETE
Get group by Id GET
Get all groups GET

Get all groups with pagination

GET

Mandatory fields

Users
  • emails.value

Groups
  • displayName

User and Group mapping

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

Table 102: User mapping
SCIM parameter NutShell parameter
id id
userName email

name.familyName

lastName
name.givenName firstName
displayName name
emails[0].value email
active isEnabled
groups teams
meta.created createdTime
meta.lastModified modifiedTime

 

Table 103: Group mapping
SCIM parameter NutShell parameter
id id
displayName name
enterpriseExtension.division division
meta.created createdTime

meta.lastModified

modifiedTime

Connector limitations

  • Error messages and status codes are not customized. The following status codes are returned:

    • 200
    • 201
    • 204
    • 400
    • 401
    • 404
  • Members cannot be added or retrieved from teams (groups) via the team endpoints. This can be achieved using the user endpoints and, updating the individual users. However, considering the large number of users in live production environments, membership management is not supported by the connector, as performance issues may arise.
  • The delete operation is soft delete. Hence, it is possible to delete, or retrieve the deleted user or group multiple number of times. However, a deleted group will not be retrieved as part of the list groups response.
  • Multiple email addresses can be associated to a user. Hence, the first email Id from the Nutshell user response is considered as the email id for the SCIM user.
  • The NutShell API does not provide information on retrieval of all resources through paginated requests. Hence, the connector provides a nextCursor value, when the total resource count is divisible by requested count.

Insightly

Insightly provides customer relationship management software for small and midsize businesses. It can be integrated with other applications such as Box, Dropbox, Gmail, Outlook, and QuickBooks. Its dashboard lets users create custom reports and track projects.

Supervisor configuration parameters

To configure the connector, following parameters are required:

  • Connector name

  • API Key

  • SCIM URL (Cloud application's instance URL, used as the target URL in payload)

Supported objects and operations

Users
Table 104: Supported operations for Users

Operation

VERB

Get user by Id

GET

Get all users

GET

Groups
Table 105: Supported operations for Groups

Operation

VERB

Create POST
Update

PUT

Delete DELETE
Get group by Id GET
Get all groups GET

Mandatory fields

Users
  • Creation of users is not supported.

Groups
  • DisplayName

User and Group mapping

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

Table 106: User Mapping
SCIM Parameter Insightly Parameter
Id USER_ID
emails[0].value EMAIL_ADDRESS

DisplayName

FIRST_NAME + LAST_NAME
name.FirstName FIRST_NAME
name.LastName LAST_NAME
name.Formatted FIRST_NAME + LAST_NAME
active ACTIVE

timezone

TIMEZONE_ID

meta.created DATE_CREATED_UTC
userName EMAIL_ADDRESS
meta.lastModified DATE_UPDATED_UTC

 

Table 107: Group mapping
SCIM parameter Insightly parameter
id TEAM_ID
displayName TEAM_NAME
created DATE_CREATED_UTC
lastModified DATE_UPDATED_UTC

members[].value

TEAMMEMBERS[].MEMBER_USER_ID

Connector limitations

  • Create, Update, and Delete operation (for Users) are not supported.
  • During the process of creating or updating a group, if the member data is incorrect, the operation fails with Bad request status code.

  • It is possible to create multiple groups with the same name in Insightly cloud application.

NOTE:If the version of One Identity Manager is 8.0.2 , an error is returned, if the Group objects are more than four. If the version of One Identity Manager is 7.1.4, the display names of few groups would be missing in the Manager console of One Identity Manager, if the Group objects are more than twenty. The cause for the above mentioned irregularities is that, the Insightly cloud application can handle only five requests per second, if the account is a trial version.

Egnyte

Egnyte lets users store files on either a company’s existing data center infrastructure or in the cloud. It can be integrated with the cloud, storage, devices, and business applications to let you control data with your current hardware.

Supervisor configuration parameters

To configure the connector, following parameters are required:

  • Connector name

  • Client_Id (API Key provided for the application)

  • Username

  • Password

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

To get the Client_id

  1. Login to the Egnyte cloud application.
  2. Register an application under My API Keys menu. Registered Application will have an API key that can be used as Client_Id.

Supported objects and operations

Users
Table 108: Supported operations for Users

Operation

VERB

Create

POST

Update

PUT

Delete

DELETE

Get user by Id

GET

Get all users

GET

Get all users with pagination

GET

Groups
Table 109: Supported operations for Groups

Operation

VERB

Create POST
Update

PUT

Delete DELETE
Get all groups GET

Get all groups with pagination

GET

Mandatory fields

Users
  • userName

  • emails.value
  • name.givenName

  • name.familyName

  • EnterpriseExtension.authType

  • userType

  • active
Groups
  • displayName

User and Group mapping

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

Table 110: User mapping
SCIM parameter Egnyte parameter
Id Id
externalId externalId

userName

userName

Name.FamilyName

name.FamilyName
Name.givenName name.givenName
Name.Formatted name.Formatted
DisplayName name.Formatted
email.value email
Active active
userType userType
EnterpriseExtension.authType authType

Groups.DisplayName

groups.DisplayName

Groups.Value

groups.Value

Created

createdDate

LastModified

lastModificationDate

 

Table 111: Group mapping
SCIM parameter Egnyte parameter
Id id
displayName displayName
members.value members.value
members.display members.display

Connector limitations

  • The Role object type is not supported by cloud application for trial account. Hence, the connector does not support the role endpoint.
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating