Skip to content

Commit ca965f4

Browse files
hperlclaude
andcommitted
docs: make the mfa overview partial prettier-stable
The cross-reference tags carrying oss= overrides are too long for any inline arrangement at printWidth 80, so prettier kept reformatting them into a shape that orphans the lead-in as its own paragraph. Restructure each reference as a single list item, the established stable form. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
1 parent 843a22f commit ca965f4

1 file changed

Lines changed: 53 additions & 22 deletions

File tree

src/components/Shared/kratos/01_mfa-overview.mdx

Lines changed: 53 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -18,9 +18,14 @@ user to start the session by logging in with the first factor and only require
1818
the second factor at the point where the user is about to perform a
1919
security-sensitive operation.
2020

21-
Read the
22-
<SameDeploymentLink to="kratos/mfa/step-up-authentication" oss="network/kratos/mfa/step-up-authentication">step-up
23-
authentication</SameDeploymentLink> guide to learn more about dynamic MFA.
21+
- Read the
22+
<SameDeploymentLink
23+
to="kratos/mfa/step-up-authentication"
24+
oss="network/kratos/mfa/step-up-authentication"
25+
>
26+
step-up authentication
27+
</SameDeploymentLink>
28+
guide to learn more about dynamic MFA.
2429

2530
## Available methods
2631

@@ -32,9 +37,11 @@ Time-based one time passwords (TOTP) are a flexible 2FA authentication method
3237
based on a shared secret, and can be used both with browser-based apps and
3338
native apps.
3439

35-
Read
36-
<SameDeploymentLink to="kratos/mfa/totp" oss="network/kratos/mfa/totp">Time-based
37-
one-time passwords (TOTP)</SameDeploymentLink> to learn more.
40+
- Read
41+
<SameDeploymentLink to="kratos/mfa/totp" oss="network/kratos/mfa/totp">
42+
Time-based one-time passwords (TOTP)
43+
</SameDeploymentLink>
44+
to learn more.
3845

3946
### WebAuthn
4047

@@ -43,9 +50,14 @@ This method uses the
4350
also known as WebAuthn, which allows servers to register and authenticate users
4451
using public-key cryptography.
4552

46-
Read
47-
<SameDeploymentLink to="kratos/mfa/webauthn-fido-yubikey" oss="network/kratos/mfa/webauthn-fido-yubikey">WebAuthn
48-
and FIDO2 (YubiKey)</SameDeploymentLink> to learn more.
53+
- Read
54+
<SameDeploymentLink
55+
to="kratos/mfa/webauthn-fido-yubikey"
56+
oss="network/kratos/mfa/webauthn-fido-yubikey"
57+
>
58+
WebAuthn and FIDO2 (YubiKey)
59+
</SameDeploymentLink>
60+
to learn more.
4961

5062
### Lookup Secrets
5163

@@ -54,18 +66,28 @@ fail-safe mechanism, rather than a standalone two-factor authentication method.
5466
They can be used to complete the second factor when users lose access to their
5567
selected 2FA method.
5668

57-
Read
58-
<SameDeploymentLink to="kratos/mfa/lookup-secrets" oss="network/kratos/mfa/lookup-secrets">Lookup
59-
Secrets (Recovery Codes)</SameDeploymentLink> to learn more.
69+
- Read
70+
<SameDeploymentLink
71+
to="kratos/mfa/lookup-secrets"
72+
oss="network/kratos/mfa/lookup-secrets"
73+
>
74+
Lookup Secrets (Recovery Codes)
75+
</SameDeploymentLink>
76+
to learn more.
6077

6178
### SMS
6279

6380
SMS for MFA sends a one-time password to the user's registered mobile phone
6481
number via text message.
6582

66-
Read the
67-
<SameDeploymentLink to="kratos/mfa/mfa-via-sms" oss="network/kratos/mfa/mfa-via-sms">Code
68-
via SMS</SameDeploymentLink> documentation to learn more.
83+
- Read the
84+
<SameDeploymentLink
85+
to="kratos/mfa/mfa-via-sms"
86+
oss="network/kratos/mfa/mfa-via-sms"
87+
>
88+
Code via SMS
89+
</SameDeploymentLink>
90+
documentation to learn more.
6991

7092
### Device authentication
7193

@@ -78,9 +100,14 @@ learn more.
78100

79101
Email for MFA sends a one-time code to the user's registered email address.
80102

81-
Read the
82-
<SameDeploymentLink to="kratos/mfa/mfa-via-sms" oss="network/kratos/mfa/mfa-via-sms">Code
83-
via Email</SameDeploymentLink> documentation to learn more.
103+
- Read the
104+
<SameDeploymentLink
105+
to="kratos/mfa/mfa-via-sms"
106+
oss="network/kratos/mfa/mfa-via-sms"
107+
>
108+
Code via Email
109+
</SameDeploymentLink>
110+
documentation to learn more.
84111

85112
## Terminology
86113

@@ -173,10 +200,14 @@ Authentication methods are classified into factors:
173200

174201
You can use `code` as first or second factor but not both at the same time.
175202

176-
Enabling
177-
<SameDeploymentLink to="kratos/passwordless/passkeys" oss="network/kratos/passwordless/passkeys">passwordless
178-
authentication with WebAuthn or Passkeys</SameDeploymentLink> isn't considered a
179-
second authentication factor.
203+
- Enabling
204+
<SameDeploymentLink
205+
to="kratos/passwordless/passkeys"
206+
oss="network/kratos/passwordless/passkeys"
207+
>
208+
passwordless authentication with WebAuthn or Passkeys
209+
</SameDeploymentLink>
210+
isn't considered a second authentication factor.
180211

181212
:::
182213

0 commit comments

Comments
 (0)