Overview of Using SAML as an Authentication Server for Cloudpath

Security Assertion Markup Language (SAML) 2.0 is one of several authentication-server methods that Cloudpath supports.

SAML 2.0 is an XML-based protocol that uses security tokens containing assertions to pass information about an end user between a SAML Identity Provider (IdP) and a SAML Service Provider (SP).

To establish trust between Cloudpath and a SAML IdP, configuration is required on both Cloudpath and the IdP.

Required Parameters

The following are required parameters with any SAML authentication:

  • IdP Metadata URL: URL of the SAML metadata file. IdPs typically publish SAML metadata at a publicly available URL. The Cloudpath system periodically fetches the metadata from this URL to obtain configuration details about the desired SAML communication options the that IdP requires.
  • Entity IDs: An entity ID is a globally unique name for a SAML entity - either an IdP or an SP:
    • IdP Entity ID: The IdP entityID is the identity of the identity provider. Example: https://idp_name.example.edu/idp
    • SP Entity ID: The SP entityID is the identity of the service provider. Example: https://sp_name.example.edu/sp
      Note: The SP Entity ID URI uniquely identifies the Cloudpath SAML authentication server as a Service Provider (SP) to the IdP. This becomes the entityID attribute of the EntityDescriptor element within the SP metadata XML that gets uploaded to the IdP. Changing this value after configuration has been completed requires the service provider metadata to be re-uploaded to the IdP.

Proceeding With One of the Tested SAML Configurations

This document presents four different, tested methods that you can use in which SAML is the authentication server: