Testing a partner connection

Testing a connection in Auth0 is very easy:

  1. Click on the Try button on each connection.
  2. Login with the identity provider.
  3. Wait for the It Works! page that displays the result.

Auth0 simulates the authentication flow as if it was an application, displaying the User Profile resulting from a successful authentication.

There's a caveat though: for this to work you have to be logged-in in the dashboard.

This is often not possible if you are testing a connection that belongs to someone else, and you don't have test credentials with them. This is common when connecting to Enterprise connections such as SAML IdPs or Active Directory.

Having your partners test the new connection is very easy nevertheless:

1. Create a Test app

Register a new application on Auth0: Dashboard > Apps/APIs > Create. You can give it any name: Test App

In the settings of the newly created app, configure Allowed Callback Urls to http://jwt.io.

Click on SAVE CHANGES.

https://YOUR_AUTH0_DOMAIN/authorize?response_type=token&scope=openid%20profile&client_id={THE_APP_CLIENT_ID}&redirect_uri=http://jwt.io&connection={THE_CONNECTION_YOU_WANT_TO_TEST}

Make sure you replace these two parameters:

  • client_id: the app client_id created in Step 1.
  • connection: the name of the connection you want to test.

scope=openid profile will instruct Auth0 to return the full profile. If it is too large, you will see an error. You can trim it by specifying only a few properties: scope=openid name email. See scopes for more details.

3. Test it!

When your partner follows the link above, she will be redirected to their configured Identity Provider (the connection). After successful authentication, she will be sent back to http://jwt.io where all user properties will be decoded from the token.

Notice that the test app is not a real app. jwt.io is just a testing website that is able to decode tokens sent on a URL fragment.