Heroku

Heroku easily integrates with Auth0 to enable single sign-on (SSO) to Heroku using the same credentials and login experience as your other SSO-enabled service providers.

Using SSO, an employee logs in to Heroku using your identity provider’s interface instead of the Heroku login page. The employee’s browser is then redirected to Heroku, authenticated and ready to go. When SSO is enabled, Heroku’s own login mechanism is disabled, meaning that authentication security is shifted to Auth0 and coordinated with your other service providers.

The Heroku Single Sign-on (SSO) Integration creates a client application that uses Auth0 for authentication and provides SSO capabilities for Heroku. Your users log in to Heroku with Auth0 identity providers, which means the identity provider performs the identity credentials verification.

Prerequisites

Before you begin:

• Sign up for a Heroku account.
• Set up a connection, which is a source of users. Connections can be databases, social identity providers, or enterprise identity providers, and can be shared among different applications. You may set up more than one connection for use with SSO integrations.

Configure Auth0 SSO Integration

Enter a name for your SSO Integration, configure the following settings, and click Save.

Setting	Description
Callback URL	URL to which the user is redirected after login (https://sso.heroku.com/saml/YOUR-HEROKU-ORG).
Audience	Your Heroku URL (https://sso.heroku.com/saml/YOUR-HEROKU-ORG).
Use Auth0 instead of the IdP to do Single Sign-on (SSO). **Legacy tenants only.**	If enabled, Auth0 will handle SSO instead of Heroku.

Configure integration with Heroku

To configure the integration with Heroku, follow the instructions listed in the Tutorial view (which will appear when you save the initial configuration settings).

Enable connections

Choose the connections to use with your SSO integration. Users in enabled connections will be allowed to log in to Heroku. By default, all configured connections are enabled.

1. Select the Connections view.

2. Toggle the sliders next to connection names to enable or disable them.