Application Settings

Application Settings

On the Applications page of the Dashboard, locate your application in the list, and click its name to view the available settings.

Dashboard Applications List

Basic settings

When you edit an existing application's settings or create a new application, you enter information about the application in the Settings view.

Basic Information

Dashboard Applications Application Settings Tab Basic Information
  • Name: The name of your application. Editable, and will be seen in the portal, emails, logs, and so on.

  • Domain: Your Auth0 tenant name. You choose this when you create a new Auth0 tenant, and it cannot be changed. If you need a different domain, you must register for a new tenant by selecting + Create Tenant in the top-right menu.

  • Client ID: The unique identifier for your application. You will use this when configuring authentication with Auth0. Generated by the system when you create a new application and cannot be modified.

  • Client Secret: A string used to sign and validate ID Tokens for authentication flows and to gain access to select Auth0 API endpoints. By default, the value is hidden, so check the Reveal Client Secret box to see it. While the Client ID is considered public information, the Client Secret must be kept confidential. If anyone can access your Client Secret, they can issue tokens and access resources they shouldn't be able to access.

  • Description: A free-text description of the Application's purpose. Maximum of 140 characters.

Application Properties

Dashboard Applications Application Settings Tab Application Properties

  • Application Logo: The URL of a logo (recommended size: 150x150 pixels) to display for the application. Appears in several areas, including the list of applications in the Dashboard and customized consent forms. If none is set the default badge for this type of application will be shown.

  • Application Type: The Auth0 application type determines which settings you can configure using the Dashboard. (Not editable for M2M apps. Sometimes disabled for other Auth0 application types if the selected grant types are only allowed for the currently selected application type.) Use the drop-down to select from the following types:

    • Machine to Machine: Non-interactive applications, such as command-line tools, daemons, IoT devices, or services running on your backend. Typically, you use this option if you have a service that requires access to an API.

    • Native App: Mobile or Desktop applications that run natively in a device (such as iOS or Android).

    • Regular Web App: Traditional web apps that perform most of their application logic on the server (such as Express.js or ASP.NET).

    • Single Page App: JavaScript apps that perform most of their user interface logic in a web browser, communicating with a web server primarily using APIs (such as AngularJS + Node.js or React). 

  • Token Endpoint Authentication Method: Defines the requested authentication method for the /oauth/token endpoint. Choose one of these values:

    • Post, for a confidential application using request body parameters to send a client secret.

    • Basic, for a confidential application using the HTTP BASIC authentication scheme.

Application URIs

Dashboard Applications Application Settings Application URIs

  • Application Login URI: In some scenarios, Auth0 will need your application to redirect to your application's login page. This URI needs to point to a route in your application that redirects to your tenant's /authorize endpoint. It would usually take the form of https://myapp.org/login. To learn more, read Configure Default Login Routes.

  • Allowed Callback URLs: Set of URLs to which Auth0 is allowed to redirect users after they authenticate. You can specify multiple valid URLs by comma-separating them (typically, to handle different environments like QA or testing). For production environments, verify that the URLs do not point to localhost. You can use the star symbol as a wildcard placeholder for subdomains (*.google.com). If you are using the Organizations feature, for production applications, you can use {organization_name} as a placeholder to dynamically specify a registered organization’s name in a URL (https://{organization_name}.exampleco.com). URLs with the {organization_name} placeholder should only be used on domains that you fully control (for example, https://{organization_name}.exampleco.com where you control the exampleco.com domain).

    Do not use wildcard placeholders or localhost URLs in your application callbacks or allowed origins fields. Using redirect URLs with wildcard placeholders can make your application vulnerable to attacks. To learn more, read Unvalidated Redirects and Forwards Cheat Sheet on owasp.org. Instead, URLs with the {organization_name} placeholder should be preferred, where relevant. To learn more, read Subdomain URL Placeholders.

  • Allowed Logout URLs: After a user logs out from Auth0 you can redirect them with the returnTo query parameter. The URL that you use in returnTo must be listed here. You can specify multiple valid URLs by comma-separating them. For production environments, verify that the URLs do not point to localhost. You can use the star symbol as a wildcard placeholder for subdomains (*.google.com). Notice that query strings and hash information are not taken into account when validating these URLs. See Logout. You can provide up to 100 URLs in the Allowed Logout URLs field.

  • Allowed Web Origins: List of URLs from where an authorization request using Cross-Origin Authentication, Device Flow, and web_message as the response mode can originate from. You can specify multiple valid URLs by comma-separating them. For production environments, verify that the URLs do not point to localhost. You can use the star symbol as a wildcard placeholder for subdomains (*.google.com). Paths, query strings, and hash information are not taken into account when validating these URLs (and may, in fact, cause the match to fail). You can provide up to 100 URLs in the Allowed Web Origins field.

  • Allowed Origins (CORS): Set of URLs that will be allowed to make requests from JavaScript to Auth0 API (typically used with CORS). This prevents same-origin policy errors when using Auth0 from within a web browser. By default, all your callback URLs will be allowed. This field allows you to enter other origins if you need to. You can specify multiple valid URLs by comma-separating them. For production environments, verify that the URLs do not point to localhost. You can use the star symbol as a wildcard placeholder for subdomains (*.google.com). If you are using the Organizations feature, you can use {organization_name} as a placeholder to dynamically specify a registered organization’s name in a URL (https://{organization_name}.exampleco.com). Notice that paths, query strings, and hash information are not taken into account when validating these URLs (and may, in fact, cause the match to fail). You can provide up to 100 URLs in the Allowed Origins (CORS) field.

ID Token

In the ID Token section, enter the ID Token Expiration (in seconds) which is the amount of time before the Auth0 id_token expires. The default value is 36000 seconds which is 10 hours.

Dashboard Applications Applications Settings Tab ID Token

Refresh Token Rotation

In the Refresh Token Rotation section, enable or disable rotation. When enabled, as a result of exchanging a refresh token, a new refresh token will be issued and the existing token will be invalidated. This allows for automatic detection of token reuse if the token is leaked. In addition, enter the Reuse Interval (in seconds). This interval is the allowable leeway time that the same refresh_token can be used to request an access_token without triggering automatic reuse detection. To learn more, read Refresh Token Rotation.

Dashboard Applications Applications Settings Tab Refresh Token Rotation

Refresh Token Expiration

In the Refresh Token Expiration section, enable or disable absolute and inactivity expiration and set the lifetimes (in seconds) for each. To learn more, read Configure Refresh Token Expiration.

Dashboard Applications Applications Settings Tab Refresh Token Expiration

Advanced settings

The Advanced Settings section allows you to:

  • Manage or add application metadata, device, OAuth, and WS-Federation settings

  • Obtain certificates and Token endpoint information

  • Set the grant type(s) for the application

Application Metadata

Application metadata are custom string keys and values (each of which has a character maximum of 255), set on a per-application basis. Metadata is exposed in the application object as client_metadata, and in rules as context.clientMetadata. You can create up to 10 sets of metadata.

Dashboard Applications Applications Settings Tab Advanced Settings Application Metadata Tab

Device Settings

If you're developing a mobile application, enter the necessary iOS/Android parameters.

Dashboard Applications Application Settings Tab Advanced Settings Device Settings Tab

OAuth

Dashboard Applications Application Settings Tab Advanced Settings OAuth Tab
  • By default, all apps/APIs can make a delegation request, but if you want to explicitly grant permissions to selected apps/APIs, you can do so in Allowed Apps/APIs.

  • Set the algorithm used (HS256 or RS256) for signing your JSON web tokens. To learn more, read JSON Web Token Signing Algorithms. When selecting RS256 (recommended), the token will be signed with your tenant's private key.

  • Toggle the Trust Token Endpoint IP Header setting; if this is enabled, the auth0-forwarded-for is set as trusted and used as a source of end user IP information for protection against brute-force attacks on the Token endpoint. This setting is only available for Regular Web Apps and M2M Apps.

  • Toggle the switch to indicate if your application is OIDC Conformant or not. Applications flagged as OIDC Conformant will strictly follow the OIDC specification.

  • Set the location URL for Cross-Origin Verification Fallback. This is the location of the page that will be rendered inside an iframe to perform the token verification when third-party cookies are not enabled in the browser. Must be in the same domain where the embedded login form is hosted and must have an https scheme.

For troubleshooting help, read Troubleshoot Invalid Token Errors.

Grant Types

Select grant types to enable or disable for your application. Available grant types are based on the application type.

Dashboard Applications Application Settings Tab Advanced Settings Grant Types tab

WS-Federation

Manage or add WS-Federation settings.

Dashboard Applications Application Settings Tab Advanced WS-Federation tab

Certificates

Manage or add the signing certificate, and its fingerprint and thumbprint.

Dashboard Applications Advanced Settings Certificates tab

Endpoints

View endpoint information for OAuth, SAML, and WS-Fed.

Dashboard Applications Application Settings Tabs Advanced Endpoints tab

Learn more