PingDirectory

Postal address SCIM 2.0 attribute mappings

Postal address System for Cross-domain Identity Management (SCIM) 2.0 attribute mappings can be used for cases in which an attribute represents a postal address in a multi-line format.

In this case, the SCIM 2.0 representation of the address will use the newline character (\n) to separate lines, but the Lightweight Directory Access Protocol (LDAP) representation uses the dollar sign character ($) to separate lines. The values will be transformed as appropriate when converting between the LDAP and SCIM 2.0 representations.

Additional configuration properties that are available for postal address SCIM 2.0 attribute mappings include:

ldap-attribute-name

The name of the LDAP attribute (in the mapped representation of the source entry generated by the sync class) whose values will be used as the values of the SCIM 2.0 attribute. This is required.

single-valued

Indicates whether the SCIM 2.0 attribute is single-valued or multivalued. If this is true, then the SCIM 2.0 representation of the attribute value will be as a JavaScript Object Notation (JSON) string. If this is false, then the SCIM 2.0 representation of the attribute value will be as a JSON array of strings.

You can use the following example configuration change to create a postal address SCIM 2.0 attribute mapping:

dsconfig create-scim2-attribute-mapping \
     --mapping-name "Postal Address" \
     --type postal-address \
     --set scim-attribute-name:formatted \
     --set ldap-attribute-name:postalAddress \
     --set attribute-usage:fetch \
     --set attribute-usage:create-during-realtime-sync \
     --set attribute-usage:create-during-resync \
     --set attribute-usage:update-during-realtime-sync \
     --set attribute-usage:update-during-resync \
     --set single-valued:true