Skip to content

Commit d5b5864

Browse files
matt423claude
andcommitted
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>
1 parent 34005a9 commit d5b5864

1 file changed

Lines changed: 16 additions & 21 deletions

File tree

  • src/pages/docs/platform/account

src/pages/docs/platform/account/2fa.mdx

Lines changed: 16 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -6,39 +6,34 @@ redirect_from:
66
- /docs/account/2fa
77
---
88

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.
1010

1111
Access your [security settings](https://ably.com/users/settings/security) to configure two-factor authentication for your Ably account.
1212

1313
## Enable 2FA <a id="enable"/>
1414

1515
To enable 2FA for your own user login:
1616

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.
2623

2724
### Disable 2FA <a id="disable"/>
2825

2926
To disable 2FA for your own user login:
3027

31-
1. Log in to your account and select [Profile Settings](https://ably.com/users/edit) in your account.
32-
2. Click the **Disable Two-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.
3431

35-
### Change phone number <a id="phone"/>
32+
### SMS 2FA <a id="sms"/>
3633

37-
Disable and re-enable 2FA in order to update your phone number.
38-
39-
### SMS and TOTP 2FA <a id="sms"/>
40-
41-
Disable and re-enable 2FA in order to switch between SMS 2FA and TOTP (time-based one-time password) 2FA.
34+
<Aside data-type='note'>
35+
SMS-based 2FA is deprecated. Users who previously enabled SMS 2FA remain supported, but new setups use TOTP.
36+
</Aside>
4237

4338
## Enforce 2FA for all users <a id="enforce"/>
4439

@@ -50,14 +45,14 @@ The account owner must already have 2FA enabled for their own login before they
5045

5146
To enforce 2FA for all users:
5247

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.
5449
2. Toggle **Require Two-Factor Authentication for all account users** under the **Authentication Settings** section.
5550
3. **Save** the authentication settings.
5651

5752
### Remove 2FA requirement of all users <a id="remove"/>
5853

5954
To remove the requirement for all users to authenticate with 2FA:
6055

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.
6257
2. Toggle **Require Two-Factor Authentication for all account users** under the **Authentication Settings** section.
6358
3. **Save** the authentication settings.

0 commit comments

Comments
 (0)