Skip to content

Commit b5170b6

Browse files
feat(acc): webauth
1 parent df41d3d commit b5170b6

File tree

8 files changed

+120
-72
lines changed

8 files changed

+120
-72
lines changed

pages/account/concepts.mdx

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -38,14 +38,22 @@ A **M**edia **A**ccess **C**ontrol Address is a unique ID assigned to network in
3838

3939
## Multifactor Authentication (MFA)
4040

41-
Multifactor authentication (MFA) is any form of verification that requires two factors to authenticate to a device you wish to connect to. Scaleway supports MFA for Cloud accounts in the form of a security code that you use in addition to your [password](#password) when you log in. You can receive the code via SMS or an authenticator app on your smartphone. Enabling MFA adds an additional layer of security against unauthorized access to your account.
41+
Multifactor authentication provides extra layers of security. In addition to your password (the first factor), other factors (such as TOTP and passkeys) are required to access your account.
4242

43-
Refer to the [How to use MFA](/account/how-to/use-2fa) documentation page for more information.
43+
You can enable Multifactor Authentication (MFA) on your Scaleway account for heightened security. Even in the event of a leaked password, your account is protected.
44+
45+
Two MFA methods are available:
46+
- **One-time password (TOTP)** - method through which you access your account using a unique, time-based validation code generated by an app.
47+
- **Passkey** - secure authentication method that eliminates the need to create, manage, or remember passwords.
4448

4549
## Password
4650

4751
A password is a string of characters associated with your account's email address that allows you to access the [Scaleway console](https://console.scaleway.com/). It is personal and must not be shared with anyone. Alternatively, you can use an [authentication code](#authentication-code) to authenticate yourself.
4852

53+
## Password Manager
54+
55+
A password manager is a secure tool that stores and manages your login credentials—like usernames, passwords, and passkeys—in an encrypted vault. You only need to remember one master password to access the vault, and the manager can automatically fill in your login details for websites and apps.
56+
4957
## Single Sign-on (SSO)
5058

5159
Single Sign-On (SSO) allows you to use your Google, Microsoft, or Github account to log in to the console. To do so, make sure the email address associated with your Scaleway account matches the email address of your Google, Microsoft, or Github account.

pages/account/how-to/change-ownership-organization.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ The process of changing the Owner of an Organization varies, depending on whethe
4242
The Owner account is now registered under the newly entered email address.
4343

4444
### Ownership transition
45-
Ensure you communicate the current password to the new Owner and [disable MFA](/account/how-to/use-2fa/#how-to-disable-mfa), if enabled. This lets them easily access the Owner account, and they can re-enable multifactor authentication on their personal device later on.
45+
Ensure you communicate the current password to the new Owner and [disable MFA](/account/how-to/use-2fa/), if enabled. This lets them easily access the Owner account, and they can re-enable multifactor authentication on their personal device later on.
4646

4747
If the old Owner must still have access to the Organization, you can [create a Member account](/iam/how-to/manage-members/#how-to-create-a-member) using their email address.
4848
Then, using permission sets, you can grant them rights to view, edit, and manage resources within the Organization. [Learn more about permission sets](/iam/reference-content/permission-sets/#scoped-by-project)

pages/account/how-to/log-in-to-the-console.mdx

Lines changed: 23 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -109,12 +109,27 @@ If you were added to a Scaleway Organization as an [IAM Member](/iam/concepts#me
109109

110110
If [Multifactor Authentication (MFA)](/account/how-to/use-2fa) is enabled on your account, MFA authentication will be an additional step for all methods of log in described on this page.
111111

112-
If the login information provided in any of the previous methods is valid, you will be redirected the Multifactor Authentication screen.
113-
114-
1. Enter a valid two-factor token or backup key.
115-
<Message type="note">
116-
This is the token provided in your MFA app.
117-
</Message>
118-
2. Click **Log in**.
112+
You can authenticate using either a:
113+
- **One-time password (TOTP)** - method through which you access your account using a unique, time-based validation code generated by an app, or
114+
- **Passkey** - secure authentication method that eliminates the need to create, manage, or remember passwords.
115+
116+
If the login information provided in any of the previous methods is valid, you will be redirected the Multifactor Authentication screen. If both MFA methods are enabled in your account, you will see the **passkey** screen by default.
117+
118+
<Tabs id="mfa-login">
119+
<TabsTab label="Log in with a passkey">
120+
1. Click **Use passkey**. Your password manager pops-up.
121+
2. Follow the steps in your password manager.
122+
123+
If the passkey is valid, you are redirected to the Organization dashboard.
124+
</TabsTab>
125+
<TabsTab label="Log in with TOTP">
126+
1. Click **Switch to authenticator app**.
127+
2. Enter a valid TOTP token or backup key.
128+
<Message type="note">
129+
This is the token provided in your TOTP app.
130+
</Message>
131+
2. Click **Log in**.
119132

120-
If the code is correct, you are redirected to the Organization dashboard.
133+
If the code is correct, you are redirected to the Organization dashboard.
134+
</TabsTab>
135+
</Tabs>

pages/account/how-to/use-2fa.mdx

Lines changed: 62 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -3,98 +3,117 @@ title: How to use Multifactor Authentication (MFA)
33
description: Enable and use Two-Factor Authentication (2FA) in Scaleway.
44
tags: authentication 2FA two-factor two multifactor security google authenticator authenticator
55
dates:
6-
validation: 2025-09-03
6+
validation: 2025-10-01
77
posted: 2022-01-14
88
---
99
import Requirements from '@macros/iam/requirements.mdx'
1010

11+
Multifactor authentication provides extra layers of security. In addition to your password (the first factor), other factors (such as TOTP and passkeys) are required to access your account.
1112

12-
You can enable multifactor authentication on your Scaleway account for heightened security. Once enabled, an additional security code generated by your phone is required to access your account.
13+
You can enable Multifactor Authentication (MFA) on your Scaleway account for heightened security. Even in the event of a leaked password, your account is protected.
1314

14-
Multifactor authentication provides extra layers of security. In addition to your password (the first factor), other factors (such as an MFA app) are required to access your account. Even in the event of a leaked password, your account is protected.
15+
Two MFA methods are available:
16+
- **One-time password (TOTP)** - method through which you access your account using a unique, time-based validation code generated by an app.
17+
- **Passkey** - secure authentication method that eliminates the need to create, manage, or remember passwords.
18+
19+
<Message type="important">
20+
If you are an account Owner, you can set up the two different MFA methods at the same time. We recommend you have at least one of the two MFA methods set up at a time, to keep your account safe.
21+
</Message>
1522

1623
<Requirements />
1724

1825
- A Scaleway account logged into the [console](https://console.scaleway.com)
1926

20-
## How to download an MFA app
27+
## How to enable TOTP
2128

22-
To use [multifactor authentication](/account/concepts/#multifactor-authentication-mfa) on your account, you first need to download an MFA app onto your smartphone. Once configured, MFA apps display a constantly rotating set of codes to use with your different accounts when you are prompted for one during login. Popular MFA apps include:
29+
To use TOTP on your account, you first need to download a TOTP app onto your smartphone. Once configured, TOTP apps display a constantly rotating set of codes to use with your different accounts when you are prompted for one during login. Popular TOTP apps include:
2330
- [Authy](https://authy.com/download/)
2431
- [FreeOTP](https://freeotp.github.io/)
2532
- [Google Authenticator](https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2&hl=en&gl=US)
2633

27-
Download the app of your choice and install it onto your smartphone.
28-
29-
## How to enable MFA
30-
31-
1. Go to your [Account Security](https://console.scaleway.com/settings/account/security) page.
34+
1. Download the app of your choice and install it onto your smartphone.
35+
2. Go to your [Account Security](https://console.scaleway.com/settings/account/security) page.
3236
<Message type="important">
33-
If you are logged in as an [IAM Member](/iam/concepts/#member), click **Credentials** in your user overview page and scroll down to the **Multifactor authentication** section.
37+
If you are logged in as an [IAM Member](/iam/concepts/#member), click **Credentials** in your user overview page.
3438
</Message>
35-
2. Click **Enable MFA**, in the **Multifactor authentication** section. A pop-up displays.
39+
3. Click **Set up TOTP**, in the **Multifactor authentication** section. A pop-up displays.
3640
3. Enter the code shown on the pop-up into your MFA app, or scan the QR code into your app.
3741
Your app sets up MFA for your Scaleway account and displays a 6-digit code.
38-
4. Enter the 6-digit authentication code given by your app into the pop-up box, then click **Submit**. A pop-up displays.
39-
5. Download or copy the backup codes shown, and save them in a safe place. These codes will be the only way to regain access to your account without your MFA app.
42+
4. Enter the 6-digit authentication code given by your app into the box, then click **Submit**.
43+
5. Download or copy the backup codes shown, and store them in a safe place. These codes will be the only way to regain access to your account without your TOTP app.
4044

41-
MFA is now enabled on your account.
45+
TOTP MFA is now enabled on your account.
4246

43-
Next time you log in to your Scaleway account, you will be prompted for an MFA code. Use your MFA app to get the code and enter it in the Scaleway console.
47+
Next time you log in to your Scaleway account, you will be prompted for a TOTP code. Use your TOTP app to get the code and enter it in the Scaleway console.
4448

45-
## How to update MFA
49+
### How to update TOTP
4650

47-
If you no longer have access to the device in which you set up your MFA, you can update your MFA information and set it up via the Scaleway console.
51+
If you no longer have access to the device in which you set up your TOTP, you can update your TOTP information and set it up via the Scaleway console.
4852

4953
<Requirements />
5054

51-
- A Scaleway account logged into the [console](https://console.scaleway.com)
5255
- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
53-
- [Enabled MFA](#how-to-enable-mfa) on your account
56+
- [Enabled TOTP](#how-to-enable-totp) on your account
5457

5558
<Message type="important">
5659
If you have lost access to your account and are not able to log in, follow the [Cannot log into my account](/account/troubleshooting/cannot-log-into-my-account/) troubleshooting procedure.
5760
</Message>
5861

5962
1. Go to your [Account Security](https://console.scaleway.com/settings/account/security) page.
60-
2. Click **Update MFA**, in the **Multifactor authentication** section. A pop-up displays.
63+
2. Click **Update TOTP**, in the **Multifactor authentication** section. A pop-up displays.
6164
3. Enter the code shown on the pop-up into your MFA app, or scan the QR code into your app.
62-
Your app sets up MFA for your Scaleway account and displays a 6-digit code.
63-
4. Enter the 6-digit code given by your app into the pop-up box, and click **Submit**. A pop-up displays.
64-
5. Download or copy the backup codes shown, and save them in a safe place. These codes will be the only way to regain access to your account without your MFA app.
65+
Your app sets up TOTP for your Scaleway account and displays a 6-digit code.
66+
4. Enter the 6-digit code given by your app into the pop-up box, and click **Submit**.
67+
5. Download or copy the backup codes shown, and store them in a safe place. These codes will be the only way to regain access to your account without your TOTP app.
68+
69+
### How to delete TOTP
70+
71+
1. Go to your [Account Security](https://console.scaleway.com/settings/account/security) page.
72+
2. Click **Delete TOTP**, in the **Multifactor authentication** section. A pop-up displays.
73+
3. Type **DELETE** in the box to confirm, then click **Delete TOTP**.
6574

66-
## How to disable MFA
75+
TOTP is now disabled on your account.
6776

6877
<Message type="important">
69-
If you disable MFA as a Member of an Organization that has MFA enforced, you will need to re-enable it before the Organization's [grace period](/iam/how-to/comply-with-sec-requirements-member/#grace-period) ends, otherwise your Member account will be locked.
78+
If you delete TOTP as a Member of an Organization that has MFA enforced, you will need to re-enable it before the Organization's [grace period](/iam/how-to/comply-with-sec-requirements-member/#grace-period) ends, otherwise your Member account will be locked.
7079
</Message>
7180

72-
1. Go to your [Account Security](https://console.scaleway.com/settings/account/security) page.
73-
2. Click **Disable MFA**, in the **Multifactor authentication** section. A pop-up displays.
74-
3. Type **DISABLE** in the box to confirm, then click **Disable**.
81+
## How to enable passkeys
82+
83+
A passkey is a passwordless authentication method that allows you to securely log in to apps and websites through public-key cryptography. Passkeys at Scaleway are supported by the WebAuthn standard.
7584

76-
MFA is now disabled on your account.
85+
When you enable a passkey, your password manager or device generates a public/private key pair. The private key stays securely on your device while the public key is sent to Scaleway.
7786

78-
## How to regain access to your account
87+
When you log in, the Scaleway sends a challenge to your device. Your device uses the private key to sign the challenge. Scaleway verifies the response using the public key.
7988

80-
### If you lose your MFA device
89+
<Message type="important">
90+
This MFA method is currently not available for IAM Members.
91+
</Message>
8192

82-
If you lose your authentication device, you can regain access to your account using the backup codes that were generated when you enabled MFA.
93+
<Requirements />
8394

84-
When you log into your account, you are prompted for an MFA code.
95+
- [Owner](/iam/concepts/#owner) status
96+
- Set up a [password manager](/iam/concepts/#password-manager) on your device
8597

86-
Enter one of your **backup codes** instead of a code generated by your MFA device in real-time, then click **Log in**. You are logged into your account and can [disable MFA](#how-to-disable-mfa) if you wish.
98+
1. Go to your [Account Security](https://console.scaleway.com/settings/account/security) page.
99+
2. Click **+ Add passkey**, in the **Multifactor authentication** section. A pop-up displays.
100+
3. Enter the passkey name you configured in your password manager.
101+
4. Click **Start**. Your password manager will be called and a pop-up might appear in your browser.
102+
5. Follow your password manager's instructions to confirm and finish setting up the passkey.
103+
If the process was successful, you will see a pop-up affirming that the **passkey was added**.
104+
6. Click **Close**.
87105

88-
### If you lose your MFA device and backup codes
106+
You see a list of your passkeys.
89107

90-
If you lose both your MFA app and backup codes, the only way to regain access to your account is through a manual identity verification.
108+
### How to delete a passkey
91109

92-
To do so, make a request to our Trust and Safety team. You must make your request from the e-mail address registered on your account. In your email, provide the following information:
110+
1. Go to your [Account Security](https://console.scaleway.com/settings/account/security) page.
111+
2. Click <Icon name="delete" />, next to the passkey you want to delete in the **Multifactor authentication** section. A pop-up displays.
112+
3. Type **DELETE** in the box to confirm, then click **Delete passkey**.
93113

94-
- The telephone number registered on your account
95-
- If you have an individual account, your passport or local ID card
96-
- If you have a corporate account, the certificate of incorporation and a copy of the last Scaleway invoice you received
114+
TOTP is now disabled on your account.
97115

98-
Submit the complete set of required documents via email to `[email protected]`.
116+
<Message type="important">
117+
Keep in mind that the passkey will be deleted from your Scaleway account only. You may need to manually delete it from your authenticator service account.
118+
</Message>
99119

100-
After analyzing your documents, our team will deactivate your two-factor authentication (2FA).

pages/account/reference-content/protecting-yourself-fraud-phishing.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ Phishing is a method where attackers trick you into providing personal informati
3131

3232
### Multifactor authentication (MFA)
3333

34-
Enable [Multifactor authentication (MFA) on your Scaleway account](/account/how-to/use-2fa/#how-to-update-mfa) to add an extra layer of security. MFA requires a second form of verification beyond just a password.
34+
Enable [Multifactor authentication (MFA) on your Scaleway account](/account/how-to/use-2fa/) to add an extra layer of security. MFA requires a second form of verification beyond just a password.
3535

3636
### Strong password practices
3737

0 commit comments

Comments
 (0)