2.3.2 Advanced Settings Parameters

These are the configuration-related entries that the connector uses during reconciliation and provisioning operations.

Table 2-2 Advanced Settings Parameters

Parameter Mandatory? Description

Bundle Name

Yes

This parameter holds the name of the connector class.

Default value: org.identityconnectors.generiscim

Bundle Version

Yes

This parameter holds the version of the connector bundle class.

Default value: 12.3.0

Connector Name

Yes

This parameter holds the name of the connector bundle package.

Default value: org.identityconnectors.gener icscim.genericscimConnector

defaultBatchSize

No

This entry holds the value of the number of records that can be retrieved from the target system in one go.

Default value: 200

customPayload

No

This entry holds the payloads for all operations that are not in the standard format.

Enter a comma-separated list of request payload formats for target system attributes that do not adhere to the standard JSON format.

Format: OBJ_CLASS.ATTRNAME.OP=PAYLOAD_FORMAT

If you must pass the unique ID or Name attribute of the user as part of a custom payload, then represent it as $(__UID__)$ or $(__NAME__)$ respectively

Sample value: "__ACCOUNT__.__GROUP__.UPDATEOP={ \"user\": { \"id\": \"$(__UID__)$\"}, \"group\": { \"id\": \"$(id)$\" } }"

nameAttributes

No

This is the __NAME__ attribute mapping of Oracle Identity Governance to the relevant attribute on target system

Sample value:"Users=userName","Groups=displayName"  

Note: All values in this parameter must be comma separated.

attrToOClassMapping

No

This is Attribute names to Other Object Class mapping.

Sample value: "__ACCOUNT__.groups=Groups"

jsonResourcesTag

Yes, if you are implementing custom parsers

Enter the JSON tag value that is used for parsing a response payload. The connector will consider the value that you enter in this parameter as an unwanted outer tag while parsing responses. You can skip entering a value for this parameter if there is no unwanted outer tag in your response payload.

Enter a value for this parameter in the following format:

OBJ_CLASS=OUTER_ATTR_NAME

In this format, OBJ_CLASS is the name of the object class for which a response payload is being parsed. OUTER_ATTR_NAME is the name of the outer tag in the response payload.

For example, consider the following JSON value for a User object:

“Resources”:”{     
          “user”:”{value1}”,      
          “user2”:”{value2}”        }

Because the name of the object class for a User object is __ACCOUNT__, for the given example, the value of the jsonResourcesTag parameter is __ACCOUNT__=Resources.

Note: You must enter a value for this parameter only if the data from your target system is in JSON format. For more than one JSON tag, the values must be comma separated.

scimVersion

No

This entry specifies the SCIM version.

Sample value: 1

statusAttributes

No

This entry lists the name of the target system attribute that holds the status of an account.

Sample value: "Users=active"

uidAttributes

Yes

This is the __UID__ attribute mapping of Oracle Identity Governance to the GUID attribute on target system.

Sample value: "Users=id","Groups=id"

Note: All values in this parameter must be comma separated.

passwordAttributes

No

Enter the name of the target system attribute that is mapped to the __PASSWORD__ attribute of the connector in OIM.

Default value: "Users=password"

schemaBuildingOption

No

This property determines the type of schema that will be built for the connector operations.

Default value: blank

Sample Values:

  • static

    Indicates that the schema will be built by default for the following SCIM object types:

    • User Core: urn:ietf:params:scim:schemas:core:2.0:User
    • User Enterprise: urn:ietf:params:scim:schemas:extension:enterprise:2.0:User
    • Group Core: urn:ietf:params:scim:schemas:core:2.0:Group

    If the user wants to build the schema for additional user or group schema IDs, those IDs must be specified in the extensionSchemaIds attribute.

  • dynamic

    Indicates that the schema will be built for the object classes specified in the managedObjectClasses attribute.

    For example, if the value of managedObjectClasses is users, the schema will be built for the User object class.

  • default/blank

    Indicates that if the attribute is not specified or its value is blank, the schema will be built for all object classes available at the target. In other words, the entire target schema will be built, irrespective of the object classes required by the user.

managedObjectClasses

No

This value indicates which object types the connector supports.

Sample value:  "Users",”Groups"

extensionSchemaIds

No

This entry holds extension schema tags.

Sample value:"urn:ietf:params:scim:schemas:extension:Fieldglass:2.0:User","urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"

checkAliveUri

No

This entry holds URL for test connection functionality

Sample value: /Users?count=1

extensionSchemaTag

No

This entry holds extension schema tags.

Sample value:

"urn:ietf:params:scim:schemas:extension:Fieldglass:2.0:User","urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"