Create a SAMLP Identity Provider Connection
Obtain IdP Signing Certificates
When you're setting up a SAMLP Connection, Auth0 acts as the service provider. As such, you will need to retrieve and provide to Auth0 an X509 signing certificate from the SAML IDP in PEM or CER format. The methods for retrieving this certificate vary, so please see your identity provider for additonal assistance if necessary.
Convert the Signing Certificate to Base64
Prior to uploading the X509 signing certificate to Auth0, you'll need to convert the file to Base64. You can use a simple online tool like this one, or you can run the following in Bash:
cat signing-cert.crt | base64
Create a Connection Using the Management Dashboard
Scroll down to the row for SAMLP Identity Provider and click Add New (which is represented by the plus symbol). You'll see the Settings page for your new Connection.
Provide the following information for your new Connection:
- Connection Name: The logical identifier for your Connection
- Email Domains (optional): A comma-separated list of domains for use with Lock
- Sign In URL: The SAML single login URL
- X509 Signing Certificate: The signing certificate (encoded in PEM or CER) provided by the identity provider
- Sign Out URL (optional): The SAML single logout URL
- User ID Attribute (optional): The attribute in the SAML token that maps to the Auth0
- Debug Mode: Toggle this to enable/disable verbose logging during the authentication process
- Sign Request: Toggle this to enable/disable signing of the authentication request (be sure to download and provide the accompanying certificate so the identity provider can validate the assertion's signature)
- Sign Request Algorithm: The algorithm you want Auth0 to use to sign the SAML assertions
- Sign Request Digest Algorithm: The algorithm you want to use for the sign request digest
- Protocol Binding: The HTTP binding supported by the identity provider
- Request Template (optional): The template that formats the SAML request
Click Save to persist your changes.
You will then see a pop-up window with the next steps you need to take.
If you do not have the appropriate administrative permissions to complete the integration, you will see a URL to provide to someone who does. If you do, click Continue to see the instructions on how to configure the identity provider you want to use with this integration. You will also be provided the custom parameters needed to integrate your Auth0 tenant with the identity provider.
Create a Connection Using the Management API
Here's how you might include the call within your application's code:
Enable the Connection for Your Auth0 Application
To use your newly-created Connection, you'll need to enable it for your Auth0 Application(s).
- Go to the Applications page of the Management Dashboard.
- Select the Application for which you want to enable the Connection.
- Click the Connections icon for your Application.
- Scroll down to the Enterprise section of the Connections page, and your Connection. Click the slider to enable the Connection. If successful, the slide turns green.