Use the PUT /ccadmin/v1/samlIdentityProviders/default
endpoint to upload the identity provider entity descriptors to Commerce Cloud, and to map assertion attributes to profile properties. This mapping enables automatic creation of shopper profiles in Commerce Cloud.
The request body includes the following properties:
encodedIdpMetadata
-- The Base64-encoded identity provider entity descriptor.loginAttributeName
– The identity provider attribute that stores the shopper’s login name.emailAttributeName
-- The identity provider attribute that stores the shopper’s email address.requiredAttributeToPropertyMap
– A map in which the keys are identify provider attributes and the values are the names of the corresponding required Commerce Cloud profile properties.optionalAttributeToPropertyMap
– A map in which the keys are identify provider attributes and the values are the names of additional (non-required) Commerce Cloud profile properties. (Optional.)
For example:
PUT /ccadmin/v1/samlIdentityProviders/default HTTP/1.1 Authorization: Bearer<access_token>
{ "loginAttributeName": "uid", "emailAttributeName": "email", "encodedIdpMetadata": "
<
identity
provider
e
ntity
d
escriptor>
", "requiredAttributeToPropertyMap": { "uid": "login", "email": "email" }, "optionalAttributeToPropertyMap": { "fName": "firstName", "lName": "lastName" } }