You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs(account): update 2FA flow for new security settings UX
Enable and disable flows now go through the dedicated Security settings
page with password-confirmation dialogs. Drop SMS setup steps (TOTP-only
for new users) and replace the SMS/TOTP section with a deprecation note
for legacy users.
DX-1074
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: src/pages/docs/platform/account/2fa.mdx
+16-21Lines changed: 16 additions & 21 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,39 +6,34 @@ redirect_from:
6
6
- /docs/account/2fa
7
7
---
8
8
9
-
Two-factor authentication (2FA) is an authentication process requiring users to utilize two different forms of verification. 2FA for your Ably account requires your password and a security token sent to your mobile phone.
9
+
Two-factor authentication (2FA) is an authentication process requiring users to utilize two different forms of verification. 2FA for your Ably account requires your password and a time-based one-time password (TOTP) from an authenticator app.
10
10
11
11
Access your [security settings](https://ably.com/users/settings/security) to configure two-factor authentication for your Ably account.
12
12
13
13
## Enable 2FA <aid="enable"/>
14
14
15
15
To enable 2FA for your own user login:
16
16
17
-
1. Log in to your account and select [Profile Settings](https://ably.com/users/edit) in your account.
18
-
2. Toggle **Enable Two-Factor Authentication** under the **Two-factor authentication** section.
19
-
* Re-enter your password as prompted.
20
-
3. Select your **Country**.
21
-
4. Enter your **Phone number**
22
-
5. Click **Next** to receive an SMS with a security token.
23
-
6. Enter the security token and click **Verify security code**.
24
-
7. Scan the QR code into an authenticator app such as Authy, or Google Authenticator.
25
-
8. Store your recovery codes in a safe location.
17
+
1. Log in to your [account](https://ably.com/accounts/any) and go to [Security](https://ably.com/users/settings/security).
18
+
2. Click **Enable** on the **Two-factor authentication** card.
19
+
3. Enter your password in the dialog to confirm.
20
+
4. Scan the QR code into an authenticator app such as Google Authenticator or 1Password.
21
+
5. Enter the generated code to verify.
22
+
6. Store your recovery codes in a safe location.
26
23
27
24
### Disable 2FA <aid="disable"/>
28
25
29
26
To disable 2FA for your own user login:
30
27
31
-
1. Log in to your account and select [Profile Settings](https://ably.com/users/edit) in your account.
32
-
2. Click the **DisableTwo-Factor Authentication**button.
33
-
* Re-enter your password as prompted.
28
+
1. Log in to your [account](https://ably.com/accounts/any) and go to [Security](https://ably.com/users/settings/security).
29
+
2. Click **Disable** on the **Two-factor authentication**card.
30
+
3. Enter your password in the dialog to confirm.
34
31
35
-
### Change phone number <aid="phone"/>
32
+
### SMS 2FA <aid="sms"/>
36
33
37
-
Disable and re-enable 2FA in order to update your phone number.
38
-
39
-
### SMS and TOTP 2FA <aid="sms"/>
40
-
41
-
Disable and re-enable 2FA in order to switch between SMS 2FA and TOTP (time-based one-time password) 2FA.
34
+
<Asidedata-type='note'>
35
+
SMS-based 2FA is deprecated. Users who previously enabled SMS 2FA remain supported, but new setups use TOTP.
36
+
</Aside>
42
37
43
38
## Enforce 2FA for all users <aid="enforce"/>
44
39
@@ -50,14 +45,14 @@ The account owner must already have 2FA enabled for their own login before they
50
45
51
46
To enforce 2FA for all users:
52
47
53
-
1. Log in to your account and select [Profile Settings](https://ably.com/users/edit) in your account.
48
+
1. Log in to your [account](https://ably.com/accounts/any) and go to the account [Security](https://ably.com/accounts/any/security) page.
54
49
2. Toggle **Require Two-Factor Authentication for all account users** under the **Authentication Settings** section.
55
50
3.**Save** the authentication settings.
56
51
57
52
### Remove 2FA requirement of all users <aid="remove"/>
58
53
59
54
To remove the requirement for all users to authenticate with 2FA:
60
55
61
-
1. Log in to your account and select [Profile Settings](https://ably.com/users/edit) in your account.
56
+
1. Log in to your [account](https://ably.com/accounts/any) and go to the account [Security](https://ably.com/accounts/any/security) page.
62
57
2. Toggle **Require Two-Factor Authentication for all account users** under the **Authentication Settings** section.
0 commit comments