Propagation Stores
Identity propagation store entities represent a connection to an identity store owned by a customer. Store instances may be associated with multiple rule entities, and must not be deleted when referred to by a rule instance.
|
Note: To reflect the propagation stores API changes in the PingOne Admin Console, you must create a new propagation revision. |
The examples that follow show common actions to find and manage identity propagation store resources. You need the Environment Admin role to perform operations on identity propagation store entities.
Propagation stores are directional relative to Ping Identity.
-
For Outbound provisioning, a store in Ping Identity is the source and an outside identity store is the target. You must create an identity propagation store of type directory as the source store. Changes to users propagate near real-time - when there is a change to a user in PingOne, the target identity store is updated immediately.
-
For Inbound provisioning, a store in Ping Identity is the target and an outside identity store is the source. You must create an identity propagation store of type PingOne as the target store. Changes to users are retrieved from the source identity store by polling the remote store every 4 hours. The polling interval is not configurable. You can also use inbound SCIM for inbound user provisioning. For more information, see SCIM.
Every propagation store is either a target store or a source store. When you create the propagation rule, you designate, by its identifier, which identity store is the source store and which identity store is the target store. For information on inbound and outbound capabilities for each connection type, see Inbound and outbound provisioning.
Propagation store data models by store type
| Propagation store type | Propagation store data models |
|---|---|
Propagation store base data model (common to all propagation store types) |
|
Aquera |
|
Azure Active Directory SAML V2.0 |
Propagation store Azure Active Directory SAML V2.0 configuration data model |
directory |
|
GitHubEMU |
|
GoogleApps |
|
LDAP Gateway |
|
PingOne |
|
Salesforce |
|
SalesforceContacts |
Propagation store SalesforceContacts configuration data model |
SCIM |
|
ServiceNow |
|
Slack |
|
Workday |
|
Zoom |
Propagation store base data model
These properties are common to all propagation store types.
| Property | Type | Required? | Mutable? | Description |
|---|---|---|---|---|
|
Object |
Required |
Mutable |
Configuration properties specific to each identity propagation store as described in subsequent tables. |
|
String |
Optional |
Mutable |
A description for the identity propagation store. |
|
String |
N/A |
Read-only |
Unique identifier (UUID) of the PingOne environment associated with the propagation store. |
|
String |
N/A |
Read-only |
Unique identifier (UUID) of the propagation store. |
|
String |
Optional |
Mutable |
The URL for the identity store resource image file. |
|
String |
Optional |
Mutable |
The image ID for the identity store resource. |
|
Boolean |
Optional |
Mutable |
Indicates whether or not to enable deprovisioning of users for a store when it is deleted. The deprovisioning occurs when a new revision is created (POST {{apiPath}}/environments/{{envID}}/propagation/revisions). |
|
String |
Required |
Mutable |
The name of the identity store. |
|
String[] |
Optional |
Mutable |
Deprecated, use |
|
String |
Optional |
Mutable |
The status of the identity store. The default value is |
|
String |
N/A |
Read-only |
Details of any synchronization errors. |
|
Integer |
N/A |
Read-only |
A count of failed synchronization events since the last revision. |
|
Integer |
N/A |
Read-only |
A count of failed deprovisioning synchronization events since the last revision. |
|
DateTime |
N/A |
Read-only |
The last synchronization in |
|
Integer |
N/A |
Read-only |
A count of successful synchronization events since the last revision. |
|
String |
N/A |
Read-only |
The current state of synchronization with a propagation store or stores. Options are either |
|
Integer |
N/A |
Read-only |
A count of users that will synchronize to the target store based on the Rule’s filter. |
|
Object |
N/A |
Read-only |
Deprecated, use |
|
String |
Required |
Immutable |
The type of the identity store and determines the required and acceptable configuration properties. It also determines the acceptable target attribute mappings. Options are |
Propagation store Aquera configuration data model
| Property | Type | Required? | Mutable? | Description |
|---|---|---|---|---|
|
String |
Optional |
Mutable |
A string specifying the access token for account authentication. |
|
String |
Required |
Mutable |
The account authentication method. For example, |
|
String |
Required |
Mutable |
The password for account authentication. |
|
String |
Required |
Mutable |
The user name for account authentication. |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be created. |
|
Boolean |
Optional |
Mutable |
Deprecated, use |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be disabled. |
|
Boolean |
Optional |
Mutable |
Deprecated, use |
|
String |
Optional |
Mutable |
The source to use for the group name. Options are either |
|
String |
Optional |
Mutable |
The action to take when deprovisioning (removing) a user. Options are either |
|
String |
Required |
Mutable |
The SCIM URL. |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be updated. |
|
Boolean |
Optional |
Mutable |
Deprecated, use |
Propagation store Azure Active Directory SAML V2.0 configuration data model
| Property | Type | Required? | Mutable? | Description |
|---|---|---|---|---|
|
String |
Required |
Mutable |
The Azure Active Directory client ID. |
|
String |
Required |
Mutable |
The Azure Active Directory client secret. |
|
Boolean |
Optional |
Mutable |
Deprecated, use |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be created. |
|
Boolean |
Optional |
Mutable |
Deprecated, use |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be deprovisioned (removed) following action specified in |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be disabled. |
|
Boolean |
Optional |
Mutable |
Whether or not disabled users can be provisioned. Defaults to |
|
String |
Optional |
Mutable |
The action to take when deprovisioning (removing) a user. Can be |
|
Boolean |
Optional |
Mutable |
Deprecated, use |
|
Boolean |
Required |
Mutable |
Whether or not remove licenses from user when skuId is empty. |
|
String |
Required |
Mutable |
The account’s Azure Active Directory domain. |
|
Boolean |
Optional |
Mutable |
Deprecated, use |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be updated. |
|
Note: Two properties appear in the response to Identity Propagation Store Metadata (AzureActiveDirectorySAML2) that are not listed in this data model. The required property, |
Propagation store directory configuration data model
An identity propagation store of type directory has no configuration data model.
Propagation store GitHubEMU configuration data model
| Property | Type | Required? | Mutable? | Description |
|---|---|---|---|---|
|
String |
Required |
Mutable |
Base URL of the target propagation store. |
|
Boolean |
Optional |
Mutable |
Deprecated, use |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be created. |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be deprovisioned (removed) following action specified in |
|
String |
Optional |
Mutable |
Defines how memberships in a group is handled when there is an existing group with the same name. Can be |
|
String |
Required |
Mutable |
OAuth 2 access token. |
|
String |
Optional |
Mutable |
The action to take when deprovisioning (removing) a user. Can be |
|
Boolean |
Optional |
Mutable |
Deprecated, use |
|
Boolean |
Optional |
Mutable |
Deprecated, use |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be updated. |
Propagation store GoogleApps configuration data model
| Property | Type | Required? | Mutable? | Description |
|---|---|---|---|---|
|
String |
Required |
Mutable |
Name of the application using the store. |
|
Boolean |
Optional |
Mutable |
Deprecated, use |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be created. |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be deprovisioned (removed) following action specified in |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be disabled. |
|
String |
Required |
Mutable |
The account’s domain name. |
|
String |
Required |
Mutable |
OAuth 2 access token. |
|
String |
Required |
Mutable |
GoogleApps identifier of the client associated with the propagation store. |
|
String |
Required |
Mutable |
GoogleApps secret of the client associated with the propagation store. |
|
String |
Required |
Mutable |
OAuth 2 refresh token. |
|
Boolean |
Optional |
Mutable |
Whether or not disabled users can be provisioned. Defaults to |
|
String |
Optional |
Mutable |
The action to take when deprovisioning (removing) a user. Can be |
|
Boolean |
Optional |
Mutable |
Deprecated, use |
|
Boolean |
Optional |
Mutable |
Deprecated, use |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be updated. |
Propagation store LDAP Gateway configuration data model
| Property | Type | Required? | Mutable? | Description |
|---|---|---|---|---|
|
String |
Optional |
Mutable |
User-defined attribute metadata. |
|
String |
Required |
Mutable |
Identifier of the client for authentication. |
|
String |
Required |
Mutable |
Secret of the client for authentication. |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be created. |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be deleted. |
|
String |
Required |
Immutable |
Identifier, a UUID, of the environment the connector services. |
|
String |
Required |
Mutable |
Base URL of the gateway. |
|
String |
Required |
Mutable |
Identifier of the gateway to which the connector connects. |
|
String |
Required |
Immutable |
Type of LDAP gateway; can be |
|
String |
Required |
Mutable |
URL to which OAUTH requests are sent. |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be updated. |
Propagation store PingOne configuration data model
| Property | Type | Required? | Mutable? | Description |
|---|---|---|---|---|
|
String |
Optional |
Mutable |
Unique identifier (UUID) of the PingOne client associated with the propagation store. |
|
String |
Optional |
Mutable |
The PingOne client secret. |
|
Boolean |
Optional |
Mutable |
Deprecated, use |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be created. |
|
String |
Optional |
Mutable |
The default authentication method. Options are |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be disabled. |
|
Sring |
Required |
Mutable |
Unique identifier (UUID) of the PingOne environment associated with the propagation store. |
|
String |
Optional |
Mutable |
How to manage MFA user devices when synchronizing. Options are either |
|
Boolean |
Optional |
Mutable |
Whether or not disabled users can be provisioned. |
|
String |
Required |
Mutable |
A supported region. Options are "NA", "CA", "EU", or "AP". |
|
String |
Optional |
Mutable |
The action to take when deprovisioning (removing) a user. Options are either |
|
Boolean |
Optional |
Mutable |
Deprecated, use |
|
Boolean |
Optional |
Mutable |
Deprecated, use |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be updated. |
Propagation store Salesforce configuration data model
| Property | Type | Required? | Mutable? | Description |
|---|---|---|---|---|
|
String |
Optional |
Mutable |
The Salesforce account ID. |
|
String |
Required |
Mutable |
The Salesforce client ID. |
|
String |
Required |
Mutable |
The Salesforce client secret. |
|
Boolean |
Optional |
Mutable |
Deprecated, use |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be created. |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be disabled. |
|
Boolean |
Required |
Mutable |
Whether or not to enable Salesforce communities. |
|
Boolean |
Required |
Mutable |
Whether the user account is frozen. |
|
String |
Required |
Mutable |
OAuth access token for account authentication. |
|
String |
Required |
Mutable |
OAuth refresh token for account authentication. |
|
String |
Required |
Mutable |
The permission sets to be merged with Salesforce. |
|
String |
Optional |
Mutable |
The Salesforce profile ID. |
|
Boolean |
Optional |
Mutable |
Whether or not disabled users can be provisioned. |
|
String |
Required |
Mutable |
The account’s salesforce.com domain. |
|
Boolean |
Optional |
Mutable |
Deprecated, use |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be updated. |
Propagation store SalesforceContacts configuration data model
| Property | Type | Required? | Mutable? | Description |
|---|---|---|---|---|
|
String |
Optional |
Mutable |
The Salesforce account ID. |
|
String |
Required |
Mutable |
Unique identifier (UUID) of the Salesforce client associated with the propagation store. |
|
String |
Required |
Mutable |
The Salesforce client secret. |
|
Boolean |
Optional |
Mutable |
Deprecated, use |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be created. |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be disabled. |
|
Boolean |
Optional |
Mutable |
Whether or not to enable Salesforce communities. |
|
Boolean |
Optional |
Mutable |
Whether the user account is frozen. |
|
String |
Required |
Mutable |
OAuth access token for account authentication. |
|
String |
Required |
Mutable |
OAuth refresh token for account authentication. |
|
String |
Optional |
Mutable |
The permission sets to be merged with Salesforce. |
|
String |
Optional |
Mutable |
The Salesforce profile ID. |
|
Boolean |
Optional |
Mutable |
Whether or not disabled users can be provisioned. |
|
String |
Required |
Mutable |
The type of Salesforce record. Options are either |
|
String |
Required |
Mutable |
The account’s salesforce.com domain. |
|
Boolean |
Optional |
Mutable |
Deprecated, use |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be updated. |
Propagation store SCIM configuration data model
| Property | Type | Required? | Mutable? | Description |
|---|---|---|---|---|
|
String |
Required |
Mutable |
The account authentication method. Can be |
|
String |
Required |
Mutable |
The authorization header type. |
|
String |
Required/Optional |
Mutable |
The password for account authentication. Required when |
|
String |
Required/Optional |
Mutable |
The user name for account authentication. Required when |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be created. |
|
Boolean |
Optional |
Mutable |
Deprecated, use |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be disabled. |
|
Boolean |
Optional |
Mutable |
Deprecated, use |
|
String |
Optional |
Mutable |
Defines how memberships in a group is handled when there is an existing group with the same name. Can be |
|
String |
Optional |
Mutable |
The source to use for the group name. Options are either |
|
String |
Optional |
Mutable |
API endpoint path to the |
|
String |
Required/Optional |
Mutable |
OAuth access token for account authentication. Required when |
|
String |
Required/Optional |
Mutable |
OAuth client ID. Required when |
|
String |
Required/Optional |
Mutable |
OAuth client secret. Required when |
|
String |
Required/Optional |
Mutable |
OAuth token request endpoint. Required when |
|
String |
Optional |
Mutable |
The action to take when deprovisioning (removing) a user. Options are either |
|
String |
Optional |
Mutable |
A comma-delimited list of schema URNS in which to look for custom attributes. |
|
String |
Required |
Mutable |
The SCIM URL. |
|
String |
Required |
Mutable |
The SCIM version. |
|
String |
Required |
Mutable |
Specifies the unique user identifier to use. Options are either |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be updated. |
|
Boolean |
Optional |
Mutable |
Deprecated, use |
|
String |
Required |
Mutable |
A string that specifies a SCIM filter expression. |
|
String |
Required |
Mutable |
API endpoint path to the |
Propagation store ServiceNow configuration data model
| Property | Type | Required? | Mutable? | Description |
|---|---|---|---|---|
|
String |
Required |
Mutable |
Password for the administrator. |
|
String |
Required |
Mutable |
Username for the administrator. |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be created. |
|
Boolean |
Optional |
Mutable |
Deprecated, use |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be deprovisioned (removed) following action specified in |
|
Boolean |
Optional |
Mutable |
Whether or not new users are allowed to be disabled. |
|
Boolean |
Optional |
Mutable |
Deprecated, use |
|
String |
Optional |
Mutable |
The action to take when deprovisioning (removing) a user. Must be set to |
|
String |
Optional |
Mutable |
Deprecated, use |
|
String |
Required |
Mutable |
The URL for the ServiceNow account. |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be updated. |
|
Boolean |
Optional |
Mutable |
Deprecated, use |
Propagation store Slack configuration data model
| Property | Type | Required? | Mutable? | Description |
|---|---|---|---|---|
|
Boolean |
Optional |
Mutable |
Deprecated, use |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be created. |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be deprovisioned (removed) following action specified in |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be disabled. Must be set to |
|
String |
Optional |
Mutable |
Defines how memberships in a group is handled when there is an existing group with the same name. Can be |
|
String |
Required |
Mutable |
OAuth 2 access token. |
|
String |
Optional |
Mutable |
The action to take when deprovisioning (removing) a user. Must be set to |
|
Boolean |
Optional |
Mutable |
Deprecated, use |
|
String |
Required |
Mutable |
The unique user identifier, must be either |
|
Boolean |
Optional |
Mutable |
Deprecated, use |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be updated. |
Propagation store Workday configuration data model
| Property | Type | Required? | Mutable? | Description |
|---|---|---|---|---|
|
Boolean |
Optional |
Mutable |
Whether or not contingent workers are excluded. |
|
Boolean |
Optional |
Mutable |
Whether or not employees are excluded. |
|
Boolean |
Optional |
Mutable |
Whether or not inactive workers are excluded. |
|
String |
Optional |
Mutable |
The Workday API host. |
|
String |
Optional |
Mutable |
A comma-delimited list of one or more System IDs of Workday integration systems that contain field overrides (custom attributes that exist on customers' Workday tenant). |
|
String |
Required |
Mutable |
The password for account authentication. |
|
String |
Required |
Mutable |
The Workday tenant ID. |
|
String |
Required |
Mutable |
The user name for account authentication. |
Propagation store Zoom configuration data model
| Property | Type | Required? | Mutable? | Description |
|---|---|---|---|---|
|
String |
Required/Optional |
Mutable |
Deprecated, use |
|
String |
Required/Optional |
Mutable |
Deprecated, use |
|
String |
Optional |
Mutable |
Account authentication method. Case sensitive. Can be |
|
Boolean |
Optional |
Mutable |
Deprecated, use |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be created. |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be removed (deprovisioned) following the action configured in |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be disabled. |
|
String |
Required/Optional |
Mutable |
OAuth account identifier. Required when |
|
String |
Required/Optional |
Mutable |
OAuth client identifier. Required when |
|
String |
Required/Optional |
Mutable |
OAuth client secret. Required when |
|
String |
Required/Optional |
Mutable |
OAuth token request endpoint. Required when |
|
String |
Optional |
Mutable |
The action to take when removing (deprovisioning) a user. Options are either |
|
Boolean |
Optional |
Mutable |
Deprecated, use |
|
String |
Required |
Mutable |
The SCIM URL. |
|
Boolean |
Optional |
Mutable |
Deprecated, use |
|
Boolean |
Optional |
Mutable |
Whether or not users are allowed to be updated. |