Skip to content

Commit 6c83bb6

Browse files
update Auth0 docs for compatibility with SSH (#2005)
update Auth0 docs for compatibility with SSH (#2003) Update screenshots and instructions to mention the 'Device Code' grant type for native SSH access. Remove the note about the JWT Signature Algorithm setting as this does not appear to be configurable. Co-authored-by: Kenneth Jenkins <51246568+kenjenkins@users.noreply.github.com>
1 parent 8131ea1 commit 6c83bb6

File tree

4 files changed

+14
-12
lines changed

4 files changed

+14
-12
lines changed

content/docs/integrations/user-identity/auth0.mdx

Lines changed: 14 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -9,38 +9,40 @@ pagination_next: null
99
import Tabs from '@theme/Tabs';
1010
import TabItem from '@theme/TabItem';
1111

12-
This page documents configuring an [Auth0] Web Application and Machine to Machine Application for Pomerium to read user data. It assumes you have already [installed Pomerium](/docs/get-started/quickstart).
12+
This page documents how to configure an [Auth0] application for use with Pomerium. It assumes you have already [installed Pomerium](/docs/get-started/quickstart).
1313

1414
:::caution
1515

1616
While we do our best to keep our documentation up to date, changes to third-party systems are outside our control. Refer to [Applications in Auth0](https://auth0.com/docs/applications) from Auth0's docs as needed, or [let us know](https://github.com/pomerium/documentation/issues/new?assignees=&labels=&template=doc-error.md) if we need to re-visit this page.
1717

1818
:::
1919

20-
[Log in to your Auth0 account](https://manage.auth0.com/) and head to your dashboard. Select **Applications → Applications** on the left menu. On the Applications page, click the **Create Application** button to create a new app.
20+
## Create an Auth0 Application
2121

22-
![Auth0 Applications Dashboard](./img/auth0/dashboard.png)
22+
1. [Log in to your Auth0 account](https://manage.auth0.com/) and head to your dashboard. Select **Applications → Applications** on the left menu. On the Applications page, click the **Create Application** button.
2323

24-
## Create Regular Web Application
24+
![Auth0 Applications Dashboard](./img/auth0/dashboard.png)
2525

26-
1. On the **Create New Application** page, name your application and select the **Regular Web Application** for your application. This is the application that your users will login to.
26+
1. On the **Create New Application** page, name your application and select the type **Native**, then click **Create**. This is the application that your users will log in to.
2727

2828
![Auth0 Create Application Select Platform](./img/auth0/create.png)
2929

30-
1. Under the **Settings** tab, note the **Domain**, **Client ID**, and **Client Secret** values. We'll provide these to Pomerium at the end of the process.
30+
1. Switch to the **Settings** tab, and note the **Domain**, **Client ID**, and **Client Secret** values. We'll need these later to configure Pomerium.
3131

3232
1. Provide the following information for your application settings:
3333

3434
| Field | Description |
3535
| --- | --- |
3636
| Name | The name of your application. |
37-
| Application Login URI | [Authenticate Service URL] (e.g. `https://${authenticate_service_url}`) |
38-
| Allowed Callback URLs | Redirect URL (e.g. `https://${authenticate_service_url}/oauth2/callback`). |
39-
| Allowed Logout URLs | Sign Out URL (e.g. `https://${authenticate_service_url}/.pomerium/signed_out`). |
37+
| Application Login URI | [Authenticate Service URL] (e.g. `https://auth.example.com`) |
38+
| Allowed Callback URLs | Redirect URL (e.g. `https://auth.example.com/oauth2/callback`). |
39+
| Allowed Logout URLs | Sign Out URL (e.g. `https://auth.example.com/.pomerium/signed_out`). |
4040

41-
1. Under **Advanced Settings****OAuth**, confirm that **JSON Web Token (JWT) Signature Algorithm** is set to "RS256".
41+
1. If you want to use Pomerium's [**native SSH access**](/docs/capabilities/native-ssh-access): scroll down to **Advanced Settings** near the bottom of the page, then select the **Grant Types** tab. Make sure the **Device Code** box is checked:
4242

43-
1. Click **Save Changes** at the bottom of the page when you're done.
43+
![Auth0 Applications Dashboard](./img/auth0/device-code.png)
44+
45+
1. Click **Save** at the bottom of the page when you're done.
4446

4547
## Configure Pomerium
4648

@@ -71,7 +73,7 @@ IDP_CLIENT_SECRET="REPLACE_ME" # from the web application
7173

7274
:::tip
7375

74-
Remember to prepend the provider URL from Auth0 with `https://`.
76+
Remember to prepend the Auth0 **Domain** with `https://` to get the provider URL.
7577

7678
:::
7779

-59.4 KB
Loading
18 KB
Loading
48.5 KB
Loading

0 commit comments

Comments
 (0)