From 707ffc213011850a6106c19171cc464294ef9d32 Mon Sep 17 00:00:00 2001 From: matt423 Date: Thu, 16 Apr 2026 17:57:56 +0100 Subject: [PATCH 1/3] 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) --- src/pages/docs/platform/account/2fa.mdx | 37 +++++++++++-------------- 1 file changed, 16 insertions(+), 21 deletions(-) diff --git a/src/pages/docs/platform/account/2fa.mdx b/src/pages/docs/platform/account/2fa.mdx index 01e9b7a609..78b54ee6ae 100644 --- a/src/pages/docs/platform/account/2fa.mdx +++ b/src/pages/docs/platform/account/2fa.mdx @@ -6,7 +6,7 @@ redirect_from: - /docs/account/2fa --- -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. +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. Access your [security settings](https://ably.com/users/settings/security) to configure two-factor authentication for your Ably account. @@ -14,31 +14,26 @@ Access your [security settings](https://ably.com/users/settings/security) to con To enable 2FA for your own user login: -1. Log in to your account and select [Profile Settings](https://ably.com/users/edit) in your account. -2. Toggle **Enable Two-Factor Authentication** under the **Two-factor authentication** section. - * Re-enter your password as prompted. -3. Select your **Country**. -4. Enter your **Phone number** -5. Click **Next** to receive an SMS with a security token. -6. Enter the security token and click **Verify security code**. -7. Scan the QR code into an authenticator app such as Authy, or Google Authenticator. -8. Store your recovery codes in a safe location. +1. Log in to your [account](https://ably.com/accounts/any) and go to [Security](https://ably.com/users/settings/security). +2. Click **Enable** on the **Two-factor authentication** card. +3. Enter your password in the dialog to confirm. +4. Scan the QR code into an authenticator app such as Google Authenticator or 1Password. +5. Enter the generated code to verify. +6. Store your recovery codes in a safe location. ### Disable 2FA To disable 2FA for your own user login: -1. Log in to your account and select [Profile Settings](https://ably.com/users/edit) in your account. -2. Click the **Disable Two-Factor Authentication** button. - * Re-enter your password as prompted. +1. Log in to your [account](https://ably.com/accounts/any) and go to [Security](https://ably.com/users/settings/security). +2. Click **Disable** on the **Two-factor authentication** card. +3. Enter your password in the dialog to confirm. -### Change phone number +### SMS 2FA -Disable and re-enable 2FA in order to update your phone number. - -### SMS and TOTP 2FA - -Disable and re-enable 2FA in order to switch between SMS 2FA and TOTP (time-based one-time password) 2FA. + ## Enforce 2FA for all users @@ -50,7 +45,7 @@ The account owner must already have 2FA enabled for their own login before they To enforce 2FA for all users: -1. Log in to your account and select [Profile Settings](https://ably.com/users/edit) in your account. +1. Log in to your [account](https://ably.com/accounts/any) and go to the account [Security](https://ably.com/accounts/any/security) page. 2. Toggle **Require Two-Factor Authentication for all account users** under the **Authentication Settings** section. 3. **Save** the authentication settings. @@ -58,6 +53,6 @@ To enforce 2FA for all users: To remove the requirement for all users to authenticate with 2FA: -1. Log in to your account and select [Profile Settings](https://ably.com/users/edit) in your account. +1. Log in to your [account](https://ably.com/accounts/any) and go to the account [Security](https://ably.com/accounts/any/security) page. 2. Toggle **Require Two-Factor Authentication for all account users** under the **Authentication Settings** section. 3. **Save** the authentication settings. From 7b830864faad149f8338e40805ef935c52aeea57 Mon Sep 17 00:00:00 2001 From: matt423 Date: Thu, 16 Apr 2026 17:59:18 +0100 Subject: [PATCH 2/3] docs(account): update user management URLs and SSO disconnect flow Replace legacy /users/edit links with /users/settings/profile and /users/settings/security. Rewrite the SSO disconnect steps to match the new Password and Login provider cards, and add a note about lock-out prevention when a password is not set. DX-1074 Co-Authored-By: Claude Opus 4.7 (1M context) --- src/pages/docs/platform/account/team.mdx | 23 +++++++++++++---------- 1 file changed, 13 insertions(+), 10 deletions(-) diff --git a/src/pages/docs/platform/account/team.mdx b/src/pages/docs/platform/account/team.mdx index 83f9aa14a0..9f94267283 100644 --- a/src/pages/docs/platform/account/team.mdx +++ b/src/pages/docs/platform/account/team.mdx @@ -77,10 +77,10 @@ You must be an account owner or admin to remove users: ## Delete your profile or leave an account 1. Log in to your [account](https://ably.com/accounts/any). -2. Go to [My Settings](https://ably.com/users/edit). +2. Go to [Profile settings](https://ably.com/users/settings/profile). 3. [Disconnect SSO provider](#sso) if you use SSO to log in. -4. Scroll to "Want to delete your profile?" -5. Click "Start" to remove yourself from this account. +4. Scroll to the **Delete profile** section. +5. Click **Delete profile** to remove yourself from this account.