Skip to content

Commit 00b5f55

Browse files
MikeSagnelliclaude
andcommitted
docs(kratos): address PR review feedback on password migration guide
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 7a16c20 commit 00b5f55

1 file changed

Lines changed: 24 additions & 15 deletions

File tree

docs/kratos/manage-identities/25_import-user-accounts-identities.mdx

Lines changed: 24 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -566,19 +566,23 @@ The following steps are necessary to set up password migration using a web hook:
566566
<TabItem value="console">
567567
```
568568
569-
To configure the password migration hook using the Ory Console:
569+
a. Go to your project in the [Ory Console](https://console.ory.sh).
570570
571-
1. Go to your project in the [Ory Console](https://console.ory.sh).
572-
2. Click **Authentication** in the top navigation bar.
573-
3. Click **Actions & Webhooks** in the left sidebar.
574-
4. Click **Create new Action**.
571+
b. Click **Authentication** in the top navigation bar.
575572
576-
In the **Action Base Details** dialog, fill in the following fields:
573+
c. Click **Actions & Webhooks** in the left sidebar.
574+
575+
d. Click **Create new Action**.
576+
577+
e. In the **Action Base Details** dialog, fill in the following fields:
577578
578579
- **Flow** — Select **Password Migration**. The execution phase and method fields are hidden because the migration hook runs
579580
at login time automatically, outside of the standard flow lifecycle.
581+
580582
- **URL** — Enter the URL of your password migration webhook endpoint, for example `https://example.org/migrate-password`.
583+
581584
- **Method** — Select the HTTP method your endpoint expects, for example **POST**.
585+
582586
- **Action HTTP body** — The body is pre-filled with a Jsonnet template that maps `ctx.identifier` and `ctx.password` to the
583587
request payload. You can customize it. See the
584588
[webhook documentation](../../guides/integrate-with-ory-cloud-through-webhooks.mdx#customizing-request-body-with-jsonnet)
@@ -590,7 +594,7 @@ The following steps are necessary to set up password migration using a web hook:
590594
</BrowserWindow>
591595
```
592596
593-
Click **Next** to proceed to the **Action authentication** step. Select the authentication type for your webhook endpoint. Ory
597+
f. Click **Next** to proceed to the **Action authentication** step. Select the authentication type for your webhook endpoint. Ory
594598
supports **None**, **Basic** (username and password), and **Key** (API key in a header or cookie). See the
595599
[webhook authentication documentation](../../guides/integrate-with-ory-cloud-through-webhooks.mdx#request-authentication) for
596600
details on each option.
@@ -608,7 +612,7 @@ The following steps are necessary to set up password migration using a web hook:
608612
</BrowserWindow>
609613
```
610614
611-
Click **Save action**. The new **Password Migration** action appears in the actions table.
615+
g. Click **Save action**. The new **Password Migration** action appears in the actions table.
612616
613617
```mdx-code-block
614618
<BrowserWindow url="https://console.ory.sh/projects/b3b748e5-7ddc-4860-a672-2436a877dc93/developers/actions">
@@ -677,13 +681,18 @@ The following steps are necessary to set up password migration using a web hook:
677681
678682
To verify that an identity is pending migration in the Ory Console:
679683
680-
1. Go to your project in the [Ory Console](https://console.ory.sh).
681-
2. Click **User management** in the top navigation bar.
682-
3. Click **Users & identities** in the left sidebar.
683-
4. Find the identity you want to review and click the three-dot menu (**⋮**) on its row.
684-
5. Click **View identity** to open its details.
685-
6. In the **Basic Information** section, under **Credential Identifiers**, the identity shows a **Migration pending** badge if
686-
the user hasn't logged in and completed the password migration yet.
684+
a. Go to your project in the [Ory Console](https://console.ory.sh).
685+
686+
b. Click **User management** in the top navigation bar.
687+
688+
c. Click **Users & identities** in the left sidebar.
689+
690+
d. Find the identity you want to review and click the three-dot menu (**⋮**) on its row.
691+
692+
e. Click **View identity** to open its details.
693+
694+
f. In the **Basic Information** section, under **Credential Identifiers**, the identity shows a **Migration pending** badge if
695+
the user hasn't logged in and completed the password migration yet.
687696
688697
```mdx-code-block
689698
<BrowserWindow url="https://console.ory.sh/projects/b3b748e5-7ddc-4860-a672-2436a877dc93/identities/2db9fa1c-95fd-4112-bdbc-a4bd857d7426">

0 commit comments

Comments
 (0)