Skip to content

Commit 03bbdec

Browse files
aeneasrjonas-jonas
andauthored
docs: account enumeration mitigation (#2126)
* docs: account enumeration mitigation * Update docs/identities/sign-in/identifier-first-authentication.mdx Co-authored-by: Jonas Hungershausen <[email protected]> * chore: synchronize workspaces --------- Co-authored-by: Jonas Hungershausen <[email protected]>
1 parent d5238be commit 03bbdec

File tree

2 files changed

+29
-0
lines changed

2 files changed

+29
-0
lines changed

docs/identities/sign-in/identifier-first-authentication.mdx

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,12 @@ sidebar_label: Identifier first authentication
77
Identifier first authentication first requests the user's identifier such as an email or username before prompting for a password
88
or other authentication methods.
99

10+
:::note
11+
12+
Identifier first authentication is required when using B2B Organization login.
13+
14+
:::
15+
1016
This guide explains how to enable and use identifier first authentication in Ory Network and self-hosted Ory Kratos.
1117

1218
## Ory Network
@@ -35,3 +41,23 @@ selfservice:
3541
```
3642
3743
To disable this feature, set `style` to `unified`.
44+
45+
## Account enumeration mitigation
46+
47+
Account enumeration mitigation prevents malicious actors from being able to identify if a user exists or not.
48+
49+
By default, Ory does not prevent account enumeration in the identifier first authentication flow. This improves user experience as
50+
the user quickly knows if they have an account with the chosen identifier (email / username) or not. To enable account
51+
enumeration, use the Ory CLI patch command
52+
53+
```shell
54+
ory patch identity-config --project <project-id> --add '/security/account_enumeration/mitigate=true'
55+
```
56+
57+
or if you use a config file, add the following to your `kratos.yaml` config file:
58+
59+
```yaml title="kratos-config.yaml"
60+
security:
61+
account_enumeration:
62+
mitigate: true
63+
```

docs/kratos/organizations/organizations.mdx

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -56,6 +56,9 @@ graph LR
5656
/>
5757
```
5858

59+
Organizations require identifier-first authentication and two-step registration when using Account Experience 2.x or Ory Elements
60+
1.x.
61+
5962
## Manage organizations
6063

6164
```mdx-code-block

0 commit comments

Comments
 (0)