Clients

An Auth0 client represents your application and allows use of Auth0 for authentication. The term client does not imply any particular implementation characteristics. Your application can be a native app that executes on a mobile device, a single page app that executes on a browser, or a regular web app that executes on a server.

Client Types

Auth0 differentiates between public and private clients, as well as first- vs. third-party clients.

There are four client types in Auth0. Depending on which type you choose, you'll see different settings you can configure.

  • Native: Used for mobile, desktop or hybrid apps, than run natively in a device, like Android, Ionic or iOS. For a complete listing of the SDKs Auth0 offers for mobile apps refer to: Native SDKs.

  • Single Page Web Applications: Used for JavaScript front-end apps that run on a browser, like Angular, jQuery or React. For a complete listing of the SDKs Auth0 offers for SPAs refer to: Single Page App SDKs.

  • Regular Web Applications: Used for traditional web applications that run on a server, like ASP .NET, Java or Node.js. For a complete listing of the SDKs Auth0 offers for Web Apps refer to: Web App SDKs.

  • Non Interactive Clients: Used for server to server applications like CLIs, daemons or services running on your backend. Typically you would use this option if you have a service that requires access to an API.

How to configure a Client

Navigate to the dashboard and click on the Clients menu option on the left. By default, you should have one client named Default App. You can either configure this one or create a new one by clicking the + Create Client button.

The Create Client windows pops open. Set a descriptive name for your client and select the client type. The client type should match your application.

Create Client window

After you set the name and client type, click Create.

A new client will be created and you will be redirected to this client's view that has four tabs:

  • Quick Start: Lists all available Quick Starts, filtered by your client's type.

  • Settings: Lists all the available settings for your client.

    Please see Client Settings for detailed information.

  • Addons: Add-ons are extensions associated with clients. They are typically third-party APIs used by the client(s) for which Auth0 generates access tokens. For more details refer to: Addons.

  • Connections: Connections are sources of users. They are categorized into Database, Social and Enterprise and can be shared among different clients. For more details refer to: Connections. For a detailed list on the supported Identity Providers refer to: Identity Providers Supported by Auth0.

How to Delete a Client

Navigate to the Client Settings and scroll to the end of the page. Under the Danger Zone section you can find the Delete Client button. This operation cannot be undone.

Once you click on the button a pop-up window will ask you to confirm the action. Click Yes, delete client to permanently remove the client.

You can also delete a client using the DELETE /api/v2/clients/{id} endpoint of the Management API.

Client Auditing

Auth0 stores log data of both actions taken in the dashboard by the administrators, as well as authentications made by your users. The logs include many of the actions performed by the user like failing to login to a client or requesting a password change. For more details refer to: Logs.

If you use a third-party application for log management, like Sumo Logic, Splunk or Loggly, you can use Auth0 Extensions to export your logs there. For details on the available extensions and how to configure them refer to: Extensions.

Dynamic Client Registration

You can use the Auth0 to programmatically create clients, as described in the OIDC Dynamic Client Registration 1.0 specification. For more details please refer to Dynamic Client Registration.

Next Steps

Once you have configured your Client, some common next steps to take are:

  • Configure a Connection and enable it for your Client. For details refer to Client Connections. For a list of the supported Identity Providers refer to Identity Providers Supported by Auth0.

  • Configure your app to use your Auth0 Client. For detailed instructions and samples for a variety of technologies, refer to our quickstarts. There you can find information on how to implement login and logout (using Lock or Auth0.js), handle your user sessions, retrieve and display user profile information, add Rules to customize your flow, and more.

    For background theory on client authentication flows, refer to Client Authentication.

  • Use our latest API Authorization features to call an API.

  • Use our APIs.

    • The Authentication API handles all the primary identity related functions (login, logout, get user profile, and so forth). Most users consume this API through our Quickstarts, the Auth0.js library or the Lock widget. However, if you are building all of your authentication UI manually you will have to interact with this API directly.

    • The Management API can be used to automate various tasks in Auth0 such as creating users.