A Ping One Customer Sync Destination defines the destination of a Sync Pipe that is an Environment in PingOne for Customers.
A Ping One Customer Sync Destination provides a method for synchronizing users from directories and data sources to the PingOne for Customers cloud directory. PingOne for Customers has a strict user schema which may require custom attribute mapping. An example dsconfig script file is provided in the resource directory. Consult the PingOne for Customers documentation for further details.
Ping One Customer Sync Destination does support pre-encoded user password synchronization. Consult the PingOne for Customers documentation for a list of the supported pre-encoding formats.
↓Parent Component
↓Properties
↓dsconfig Usage
The Ping One Customer Sync Destination component inherits from the Sync Destination
The properties supported by this managed object are as follows:
| Basic Properties: | Advanced Properties: |
|---|---|
| ↓ description | None |
| ↓ ping-one-api-url | |
| ↓ ping-one-environment-id | |
| ↓ ping-one-default-population-id | |
| ↓ ping-one-auth-url | |
| ↓ ping-one-oauth-client-id | |
| ↓ ping-one-oauth-client-secret |
| Description | A description for this Sync Destination |
| Default Value | None |
| Allowed Values | A string |
| Multi-Valued | No |
| Required | No |
| Admin Action Required | None. Modification requires no further action |
| Description | Specifies the API endpoint for the PingOne for Customers web service. |
| Default Value | None |
| Allowed Values | A string |
| Multi-Valued | No |
| Required | Yes |
| Admin Action Required | None. Modification requires no further action |
| Description | Specifies the PingOne for Customers Environment that will be associated with this Ping One Customer Sync Destination. Using a browser console watch the network traffic while accessing the PingOne for Customers' UI. Look for calls to /environments; the response will contain environment IDs. |
| Default Value | None |
| Allowed Values | Environment ID must be in the format of a UUID v4. |
| Multi-Valued | No |
| Required | Yes |
| Admin Action Required | None. Modification requires no further action |
ping-one-default-population-id
| Description | Specifies a default PingOne for Customers Population ID that will be used when synchronizing new users into PingOne for Customers. If an attribute mapping exists that maps to "population", it will take precedent over this default. Using a browser console watch the network traffic while accessing the PingOne for Customers' UI. Look for calls to /populations; the response will contain population IDs. |
| Default Value | None |
| Allowed Values | Population ID must be in the format of a UUID v4. |
| Multi-Valued | No |
| Required | No |
| Admin Action Required | None. Modification requires no further action |
| Description | Specifies the API endpoint for the PingOne for Customers authentication service. |
| Default Value | None |
| Allowed Values | A string |
| Multi-Valued | No |
| Required | Yes |
| Admin Action Required | None. Modification requires no further action |
| Description | Specifies the OAuth client ID used to authenticate connections to PingOne for Customers. This can be found under the Connections Tab in the PingOne for Customers Admin UI. |
| Default Value | None |
| Allowed Values | A string |
| Multi-Valued | No |
| Required | Yes |
| Admin Action Required | None. Modification requires no further action |
| Description | Specifies the OAuth client secret used to authenticate connections to PingOne for Customers. This can be found under the Connections Tab in the PingOne for Customers Admin UI. |
| Default Value | None |
| Allowed Values | A string |
| Multi-Valued | No |
| Required | Yes |
| Admin Action Required | None. Modification requires no further action |
To list the configured Sync Destinations:
dsconfig list-sync-destinations
[--property {propertyName}] ...
To view the configuration for an existing Sync Destination:
dsconfig get-sync-destination-prop
--destination-name {name}
[--tab-delimited]
[--script-friendly]
[--property {propertyName}] ...
To update the configuration for an existing Sync Destination:
dsconfig set-sync-destination-prop
--destination-name {name}
(--set|--add|--remove) {propertyName}:{propertyValue}
[(--set|--add|--remove) {propertyName}:{propertyValue}] ...
To create a new Ping One Customer Sync Destination:
dsconfig create-sync-destination
--destination-name {name}
--type ping-one-customer
--set ping-one-api-url:{propertyValue}
--set ping-one-environment-id:{propertyValue}
--set ping-one-auth-url:{propertyValue}
--set ping-one-oauth-client-id:{propertyValue}
--set ping-one-oauth-client-secret:{propertyValue}
[--set {propertyName}:{propertyValue}] ...
To delete an existing Sync Destination:
dsconfig delete-sync-destination
--destination-name {name}