Skip to content

Commit f405dbb

Browse files
committed
docs: auth0 migration guid formatting improvements
1 parent ccb0955 commit f405dbb

File tree

1 file changed

+17
-11
lines changed

1 file changed

+17
-11
lines changed

docs/migrate-to-ory/auth0.mdx

Lines changed: 17 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -19,8 +19,8 @@ Before you begin, ensure you have:
1919

2020
- **Auth0 account** with admin access to export user data
2121
- **Ory account** and CLI installed
22-
{/* TODO: change this to refer to new migration guide (docs/migrate-to-ory/migrate/create-project.mdx) */}
23-
- **Ory project** created - See [creating a project](index.mdx) for instructions
22+
{/* TODO: change this to refer to new migration guide (docs/migrate-to-ory/migrate/create-project.mdx) */}
23+
- **Ory project** created - See [creating a project](index.mdx) for instructions
2424
- **Required tools**:
2525
- [jq](https://jqlang.org/) - Command-line JSON processor
2626
- [Gzip](https://www.gnu.org/software/gzip/) - Compression utility
@@ -54,7 +54,9 @@ Follow these steps to get the Management API Access Token and connection ID:
5454
2. Select **Auth0 Management API** and go to the **API Explorer** tab. Copy the displayed token.
5555

5656
:::warning Token expiration
57+
5758
The token is valid for 24 hours by default and is configurable.
59+
5860
:::
5961

6062
3. Go to **Authentication** and navigate to **Database**.
@@ -86,15 +88,18 @@ Follow these steps to export the user data:
8688

8789
### 2. Export password hashes
8890

89-
Exporting password hashes is optional but recommended. Because password hashes are considered sensitive information, Auth0 doesn't export them as part of the general export process. To get the password hashes and other password-related information, you must [create an Auth0 support ticket](#create-auth0-support-ticket).
91+
Exporting password hashes is optional but recommended. Because password hashes are considered sensitive information, Auth0 doesn't
92+
export them as part of the general export process. To get the password hashes and other password-related information, you must
93+
[create an Auth0 support ticket](#create-auth0-support-ticket).
9094

9195
If you get your users' password hashes and import them to Ory, users can log in to their accounts using the same credentials they
9296
used before the migration. If you can't get users' password hashes, you can still import Auth0 user accounts to Ory and migrate
9397
them using a [Password migration hook](../kratos/manage-identities/25_import-user-accounts-identities.mdx).
9498

95-
:::note
96-
Password hash exports are not available for Auth0's Free subscription tier. You'll need a paid Auth0 plan to request this
97-
data.
99+
:::note
100+
101+
Password hash exports are not available for Auth0's Free subscription tier. You'll need a paid Auth0 plan to request this data.
102+
98103
:::
99104

100105
#### Create Auth0 support ticket
@@ -138,15 +143,15 @@ export ORY_WORKSPACE_ID='{your-workspace-id}'
138143
If you don't have these values, you can retrieve them:
139144

140145
- **Using the CLI**: Run `ory list projects` to see all your projects and their IDs
141-
- **Using the Console**: Go to [Ory Console](https://console.ory.sh/), select your project, and find the IDs in the project settings
146+
- **Using the Console**: Go to [Ory Console](https://console.ory.sh/), select your project, and find the IDs in the project
147+
settings
142148

143149
:::
144150

145-
146-
147151
### 2. Configure identity schema
148152

149-
Before importing users, you need to configure your Ory project's identity schema to match your Auth0 setup. Since Auth0 users authenticate with email and password, configure the identity schema to use the email preset.
153+
Before importing users, you need to configure your Ory project's identity schema to match your Auth0 setup. Since Auth0 users
154+
authenticate with email and password, configure the identity schema to use the email preset.
150155

151156
Update your project's identity schema:
152157

@@ -173,7 +178,8 @@ export AUTH0_PWEXPORT="{path-to-the-json-file-with-password-hashes}"
173178
:::info Migration Mode
174179

175180
- Set `RESERVE_ONLY="false"` if you have password hashes
176-
- Set `RESERVE_ONLY="true"` if you don't have password hashes
181+
- Set `RESERVE_ONLY="true"` if you don't have password hashes
182+
177183
:::
178184

179185
### 2. Run import script

0 commit comments

Comments
 (0)