Take the following steps to create a new application for NGINX Plus.
Note:
This section contains images that reflect the state of the Auth0 web interface at the time of publication. The actual Auth0 GUI may differ from the examples shown here. Use this guide as a reference and adapt the instructions to suit the current Auth0 GUI as necessary.
-
Log in to your Auth0 Dashboard at manage.auth0.com.
-
Select Applications > Applications from the sidebar menu.
-
On the Applications page, select the Create Application button.
-
In the Create application window, provide the information listed below and then select Create.
In this section, you wll set up a web application that follows the Auth0 Authorization Code Flow.
-
On the Application page in the Auth0 dashboard, select your web application.
-
Select the Settings tab for your application.
-
Make note of the Client ID and Client Secret displayed in the Basic Information section.
-
In the Application Properties section, choose one of options from the combo box in the Token Endpoint Authentication Method field.
-
In the Application URIs section, provide the URI of the NGINX Plus instance in the fields of Allowed Callback URLs and Allowed Logout URLs.
-
Allowed Callback URLs: The URL must include the port number and end in /_codexch. In our example, we used the URL
http://nginx.auth0.test:443/_codexch
. -
Allowed Logout URLs: The URL must include the port number and end in /_codexch. In our example, we used the URL
http://nginx.auth0.test:443/_logout
.
Note:
- The port is always required, even if you use the default port for HTTP (80) or HTTPS (443).
- The use of SSL/TLS (443) is strongly recommended for production environments.
- You don't need to include the port number if it is either 80 or 443 if you use NGINX-ACM > 1.1.1.
-
-
In the Advanced Settings section, select the OAuth tab.
-
In the Advanced Settings section, select the Grant Types tab.
-
In the Advanced Settings section, select the Endpoints tab.
-
Select Save Changes.
Note: For the purposes of this guide, we will add a new Auth0 user database and user account to use for testing.
You can set up authentication using any of the available Auth0 identity providers.
To set up a new user database and add a user account to it, take the steps below.
-
Log in to the Auth0 dashboard and select Authentication > Database from the sidebar menu.
-
Select the Create DB Connection button.
-
Provide a Name for the database connection, then select Create.
-
On the Database page, select the Applications tab. Then, select the toggle button next to the application you created earlier.
-
In the sidebar menu, select User Management > Users.
-
On the Users page, select the Create User button.
-
In the Create user window, provide the following information, then select Create.
- Email: user’s email
- Password: a password for the user account
- Connection: select your database from the list.
The user should receive an email to the email address provided. Once the user verifies their account by clicking on the link in the email, the account creation process is complete.