Warning
This connector has been updated to meet the requirements of a PowerShell V2 target connector.
The update was dry-coded and could not be tested in a working environment.
We recommend thoroughly testing and validating the connector during implementation, as the code may require adjustments.
Important
This repository contains the connector and configuration code only. The implementer is responsible to acquire the connection details such as username, password, certificate, etc. You might even need to sign a contract or agreement with the supplier before implementing this connector. Please contact the client's application manager to coordinate the connector requirements.
HelloID-Conn-Prov-Target-Salesforce-SCIM is a target connector. Salesforce-SCIM provides a set of REST APIs that allow you to programmatically interact with its data. The SalesForce API is a scim based (http://www.simplecloud.info) API. The code used for this connector is based on the https://github.com/Tools4everBV/HelloID-Conn-Prov-Target-Generic-Scim generic scim connector.
The following features are available:
| Feature | Supported | Actions | Remarks |
|---|---|---|---|
| Account Lifecycle | ✅ | Create, Update, Enable, Disable, Delete | |
| Permissions | ✅ | Retrieve, Grant, Revoke | Static |
| Resources | ❌ | - | |
| Entitlement Import: Accounts | ✅ | - | |
| Entitlement Import: Permissions | ❌ | - | |
| Governance Reconciliation Resolutions | ✅ | - |
URL of the icon used for the HelloID Provisioning target system.
https://raw.githubusercontent.com/Tools4everBV/HelloID-Conn-Prov-Target-Salesforce-SCIM/refs/heads/main/Icon.png
The following settings are required to connect to the API.
| Setting | Description | Mandatory |
|---|---|---|
| ClientID | The ClientID to the Salesforce SCIM API | Yes |
| ClientSecret | The ClientSecret to the Salesforce SCIM API | Yes |
| UserName | The UserName to the Salesforce SCIM API | Yes |
| Password | The Password to the Salesforce SCIM API | Yes |
| BaseUrl | The BaseUrl to the Salesforce environment. e.g. [https://customer.my.salesforce.com] | Yes |
| AuthenticationUri | The URI to retrieve the oAuth token. e.g [https://test.salesforce.com/services/oauth2/token] | Yes |
The correlation configuration is used to specify which properties will be used to match an existing account within Salesforce-SCIM to a person in HelloID.
| Setting | Value |
|---|---|
| Enable correlation | True |
| Person correlation field | PersonContext.Person.ExternalId |
| Account correlation field | employeeNumber |
Tip
For more information on correlation, please refer to our correlation documentation pages.
The field mapping can be imported by using the fieldMapping.json file.
The account reference is populated with the property id property from Salesforce-SCIM
The following endpoints are used by the connector
| Endpoint | HTTP Method | Description |
|---|---|---|
| /Users | GET | Create, update and retrieve user information |
| /Entitlements | GET | Retrieve entitlements |
| /Roles | GET | Retrieve roles |
https://help.salesforce.com/s/articleView?id=xcloud.identity_overview.htm&type=5
Tip
For more information on how to configure a HelloID PowerShell connector, please refer to our documentation pages.
The official HelloID documentation can be found at: https://docs.helloid.com/