Skip to main content

Update Source (Full)

This API updates a source in IdentityNow, using a full object representation. In other words, the existing Source configuration is completely replaced.

Some fields are immutable and cannot be changed, such as:

  • id
  • type
  • authoritative
  • connector
  • connectorClass
  • passwordPolicies

Attempts to modify these fields will result in a 400 error.

A token with ORG_ADMIN, SOURCE_ADMIN, or SOURCE_SUBADMIN authority is required to call this API.

Path Parameters
  • id string required

    The Source id

    Example: 2c9180835d191a86015d28455b4a2329
Request Body required
  • description string

    Human-readable description of the source

  • owner object

    Reference to an owning Identity Object

  • type string

    Possible values: [IDENTITY]

    The type of object being referenced

  • id string

    ID of the identity

  • name string

    Human-readable display name of the identity

  • cluster object

    Reference to the associated Cluster

  • type string

    Possible values: [CLUSTER]

    The type of object being referenced

  • id string

    ID of the cluster

  • name string

    Human-readable display name of the cluster

  • accountCorrelationConfig object

    Reference to an Account Correlation Config object

  • type string

    Possible values: [ACCOUNT_CORRELATION_CONFIG]

    The type of object being referenced

  • id string

    ID of the account correlation config

  • name string

    Human-readable display name of the account correlation config

  • accountCorrelationRule object

    Reference to a Rule that can do COMPLEX correlation, should only be used when accountCorrelationConfig can't be used.

  • type string

    Possible values: [RULE]

    The type of object being referenced

  • id string

    ID of the rule

  • name string

    Human-readable display name of the rule

  • managerCorrelationMapping object

    Filter Object used during manager correlation to match incoming manager values to an existing manager's Account/Identity

  • accountAttribute string

    Name of the attribute to use for manager correlation. The value found on the account attribute will be used to lookup the manager's identity.

  • identityAttribute string

    Name of the identity attribute to search when trying to find a manager using the value from the accountAttribute.

  • managerCorrelationRule object

    Reference to the ManagerCorrelationRule, only used when a simple filter isn't sufficient.

  • type string

    Possible values: [RULE]

    The type of object being referenced

  • id string

    ID of the rule

  • name string

    Human-readable display name of the rule

  • beforeProvisioningRule object

    Rule that runs on the CCG and allows for customization of provisioning plans before the connector is called.

  • type string

    Possible values: [RULE]

    The type of object being referenced

  • id string

    ID of the rule

  • name string

    Human-readable display name of the rule

  • schemas object[]

    List of references to Schema objects

  • type string

    Possible values: [CONNECTOR_SCHEMA]

    The type of object being referenced

  • id string

    ID of the schema

  • name string

    Human-readable display name of the schema

  • passwordPolicies object[]

    List of references to the associated PasswordPolicy objects.

  • type string

    Possible values: [PASSWORD_POLICY]

    The type of object being referenced

  • id string

    ID of the policy

  • name string

    Human-readable display name of the policy

  • features string[]

    Possible values: [AUTHENTICATE, COMPOSITE, DIRECT_PERMISSIONS, DISCOVER_SCHEMA, ENABLE, MANAGER_LOOKUP, NO_RANDOM_ACCESS, PROXY, SEARCH, TEMPLATE, UNLOCK, UNSTRUCTURED_TARGETS, SHAREPOINT_TARGET, PROVISIONING, GROUP_PROVISIONING, SYNC_PROVISIONING, PASSWORD, CURRENT_PASSWORD, ACCOUNT_ONLY_REQUEST, ADDITIONAL_ACCOUNT_REQUEST, NO_AGGREGATION, GROUPS_HAVE_MEMBERS, NO_PERMISSIONS_PROVISIONING, NO_GROUP_PERMISSIONS_PROVISIONING, NO_UNSTRUCTURED_TARGETS_PROVISIONING, NO_DIRECT_PERMISSIONS_PROVISIONING]

    Optional features that can be supported by a source.

  • type string

    Specifies the type of system being managed e.g. Active Directory, Workday, etc..

  • connector string

    Connector script name.

  • connectorClass string

    The fully qualified name of the Java class that implements the connector interface.

  • connectorAttributes object

    Connector specific configuration; will differ from type to type.

  • deleteThreshold int32

    Number from 0 to 100 that specifies when to skip the delete phase.

  • authoritative boolean

    When true indicates the source is referenced by an IdentityProfile.

  • managementWorkgroup object

    Reference to Management Workgroup for this Source

  • type string

    Possible values: [GOVERNANCE_GROUP]

    The type of object being referenced

  • id string

    ID of the management workgroup

  • name string

    Human-readable display name of the management workgroup

  • healthy boolean

    When true indicates a healthy source

  • status string

    A status identifier, giving specific information on why a source is healthy or not

  • since string

    Timestamp showing when a source health check was last performed

  • connectorId string

    The id of connector

  • connectorName string

    The name of the connector that was chosen on source creation

  • connectionType string

    The type of connection (direct or file)

  • connectorImplementstionId string

    The connector implementstion id

Responses

Updated Source object. Any passwords will only show the the encrypted cipher-text, as they are not decrypt-able in IdentityNow cloud-based services, per IdentityNow security design.


Schema
  • id string

    the id of the Source

  • description string

    Human-readable description of the source

  • owner object

    Reference to an owning Identity Object

  • type string

    Possible values: [IDENTITY]

    The type of object being referenced

  • id string

    ID of the identity

  • name string

    Human-readable display name of the identity

  • cluster object

    Reference to the associated Cluster

  • type string

    Possible values: [CLUSTER]

    The type of object being referenced

  • id string

    ID of the cluster

  • name string

    Human-readable display name of the cluster

  • accountCorrelationConfig object

    Reference to an Account Correlation Config object

  • type string

    Possible values: [ACCOUNT_CORRELATION_CONFIG]

    The type of object being referenced

  • id string

    ID of the account correlation config

  • name string

    Human-readable display name of the account correlation config

  • accountCorrelationRule object

    Reference to a Rule that can do COMPLEX correlation, should only be used when accountCorrelationConfig can't be used.

  • type string

    Possible values: [RULE]

    The type of object being referenced

  • id string

    ID of the rule

  • name string

    Human-readable display name of the rule

  • managerCorrelationMapping object

    Filter Object used during manager correlation to match incoming manager values to an existing manager's Account/Identity

  • accountAttribute string

    Name of the attribute to use for manager correlation. The value found on the account attribute will be used to lookup the manager's identity.

  • identityAttribute string

    Name of the identity attribute to search when trying to find a manager using the value from the accountAttribute.

  • managerCorrelationRule object

    Reference to the ManagerCorrelationRule, only used when a simple filter isn't sufficient.

  • type string

    Possible values: [RULE]

    The type of object being referenced

  • id string

    ID of the rule

  • name string

    Human-readable display name of the rule

  • beforeProvisioningRule object

    Rule that runs on the CCG and allows for customization of provisioning plans before the connector is called.

  • type string

    Possible values: [RULE]

    The type of object being referenced

  • id string

    ID of the rule

  • name string

    Human-readable display name of the rule

  • schemas object[]

    List of references to Schema objects

  • type string

    Possible values: [CONNECTOR_SCHEMA]

    The type of object being referenced

  • id string

    ID of the schema

  • name string

    Human-readable display name of the schema

  • passwordPolicies object[]

    List of references to the associated PasswordPolicy objects.

  • type string

    Possible values: [PASSWORD_POLICY]

    The type of object being referenced

  • id string

    ID of the policy

  • name string

    Human-readable display name of the policy

  • features string[]

    Possible values: [AUTHENTICATE, COMPOSITE, DIRECT_PERMISSIONS, DISCOVER_SCHEMA, ENABLE, MANAGER_LOOKUP, NO_RANDOM_ACCESS, PROXY, SEARCH, TEMPLATE, UNLOCK, UNSTRUCTURED_TARGETS, SHAREPOINT_TARGET, PROVISIONING, GROUP_PROVISIONING, SYNC_PROVISIONING, PASSWORD, CURRENT_PASSWORD, ACCOUNT_ONLY_REQUEST, ADDITIONAL_ACCOUNT_REQUEST, NO_AGGREGATION, GROUPS_HAVE_MEMBERS, NO_PERMISSIONS_PROVISIONING, NO_GROUP_PERMISSIONS_PROVISIONING, NO_UNSTRUCTURED_TARGETS_PROVISIONING, NO_DIRECT_PERMISSIONS_PROVISIONING]

    Optional features that can be supported by a source.

  • type string

    Specifies the type of system being managed e.g. Active Directory, Workday, etc..

  • connector string

    Connector script name.

  • connectorClass string

    The fully qualified name of the Java class that implements the connector interface.

  • connectorAttributes object

    Connector specific configuration; will differ from type to type.

  • deleteThreshold int32

    Number from 0 to 100 that specifies when to skip the delete phase.

  • authoritative boolean

    When true indicates the source is referenced by an IdentityProfile.

  • managementWorkgroup object

    Reference to Management Workgroup for this Source

  • type string

    Possible values: [GOVERNANCE_GROUP]

    The type of object being referenced

  • id string

    ID of the management workgroup

  • name string

    Human-readable display name of the management workgroup

  • healthy boolean

    When true indicates a healthy source

  • status string

    A status identifier, giving specific information on why a source is healthy or not

  • since string

    Timestamp showing when a source health check was last performed

  • connectorId string

    The id of connector

  • connectorName string

    The name of the connector that was chosen on source creation

  • connectionType string

    The type of connection (direct or file)

  • connectorImplementstionId string

    The connector implementstion id

Loading...