Configuring your enterprise IdP to work with CDP as a service provider

CDP provides a service provider SAML metadata file that describes the information that CDP requires to enable users to log in to CDP through your enterprise IdP.

You can get the CDP SAML metadata XML from the Identity Providers page in CDP web interface by navigating to the details of your identity provider configuration.

The CDP SAML metadata file includes the following information:


Information	Attribute	Description
Name ID formats that CDP supports	NameIDFormat	The metadata includes multiple name ID formats. Use one of the formats in the list for the user ID. CDP supports any type of name ID format other than transient. Cloudera requires that you use name ID formats that are globally unique within your identity provider. The name ID format should also be stable over time. Cloudera does not recommend using email addresses because, although they can be unique, they are typically not stable over time. If your NameID is an opaque ID (such as a UUID), you can Generate workload usernames based on email. The value of NameID is case-sensitive.
CDP SSO URL	Location	It should be the same as the "Location" value of the "<AssertionConsumerService>" in the CDP SAML Service Provider metadata. It has a fixed format. For CDP Control Plane region us-west-1:`https://consoleauth.altus.cloudera.com/saml?samlProviderId=CDP-assigned-ID` For any other CDP Control Plane region: `https://consoleauth.<CONTROL_PLANE_REGION>.cdp.cloudera.com/consoleauth/saml?samlProviderId=CDP-assigned-ID` For more information about the ID that CDP generates and assigns to the CDP identity provider, see Setting Up the Identity Provider in CDP. This attribute is required.
Endpoint for binding	Binding	Use the following URN as the endpoint that your enterprise IdP must bind to: `urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST` This attribute is required.
User email address	`RequestedAttribute: mail`	Set the email address attribute to the following URN: `urn:oid:0.9.2342.19200300.100.1.3` CDP also accepts: `mail` This attribute is required. Although CDP requires the user email address, it is used for display purposes only.
(Optional) List of groups that the user is a member of	`RequestedAttribute: groups`	Set the group list attribute to the following URN: `https://cdp.cloudera.com/SAML/Attributes/groups` This attribute is optional. For more information about the group list and how CDP synchronizes group membership, see Synchronizing Group Membership.
(Optional) User first name	`RequestedAttribute: firstName`	Set the user first name attribute to the following URN: `https://cdp.cloudera.com/SAML/Attributes/firstName` This attribute is optional; used for display purposes only.
(Optional) User last name	`RequestedAttribute: lastName`	Set the user last name attribute to the following URN: `https://cdp.cloudera.com/SAML/Attributes/lastName` This attribute is optional; used for display purposes only.

If your enterprise IdP allows it, you can upload the CDP SAML metadata file to your enterprise IdP. Otherwise, use your enterprise IdP user interface to set up CDP as a service provider.