Skip to content

Commit 12f505d

Browse files
fix(iam): members - MTA-5495 (#4395)
1 parent 468b2cd commit 12f505d

21 files changed

+443
-60
lines changed

macros/iam/login-member.mdx

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
---
2+
macro: login-member
3+
---
4+
5+
If you were added to a Scaleway Organization as an [IAM member](/iam/concepts#members), the login process is different.
6+
7+
<Message type="important">
8+
Login via [Single Sign-On (SSO)](/account/concepts/#single-sign-on-sso) is currently not available for members.
9+
</Message>
10+
11+
1. Open your web browser and go to the [Scaleway console](https://console.scaleway.com).
12+
2. Click the **Log in as an IAM Member**.
13+
3. Enter the Organization ID and click **Continue**.
14+
<Message type="important">
15+
When you are added to an Organization as a member, a Scaleway account is automatically created for you. An Organization administrator must provide a username, email and Organization ID for you to log in.
16+
</Message>
17+
4. Enter the username given to you by your Organization's Owner or administrator.
18+
5. Select an authentication method between **Send code** and **Enter password**.
19+
<Tabs id="create-account">
20+
<TabsTab label="Email code">
21+
1. Click **Send code** to receive a login code in your email.
22+
2. Enter the code you received in your email.
23+
<Message type="tip">
24+
If you did not receive the email you can follow these steps, in order:
25+
- Make sure you check your spam folder
26+
- Click **Resend email**
27+
- Contact an Organization administrator to make sure your information was correctly registered
28+
- If none of the actions above work, ask an administrator to [contact the support](/account/how-to/open-a-support-ticket/#writing-an-effective-subject-and-description)
29+
</Message>
30+
3. Click **Continue**.
31+
</TabsTab>
32+
<TabsTab label="Password">
33+
1. Click **Enter password**.
34+
2. Type your password in the box.
35+
3. Click **Continue**.
36+
</TabsTab>
37+
</Tabs>

menu/navigation.json

Lines changed: 29 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -52,10 +52,6 @@
5252
"label": "Configure support plans",
5353
"slug": "configure-support-plans"
5454
},
55-
{
56-
"label": "Enforce multifactor authentication",
57-
"slug": "enforce-mfa"
58-
},
5955
{
6056
"label": "Use multifactor authentication",
6157
"slug": "use-2fa"
@@ -279,6 +275,10 @@
279275
"label": "Generate an SSH key",
280276
"slug": "create-ssh-key"
281277
},
278+
{
279+
"label": "Enforce multifactor authentication",
280+
"slug": "enforce-mfa"
281+
},
282282
{
283283
"label": "Add resources to a Project",
284284
"slug": "add-resources-project"
@@ -336,24 +336,20 @@
336336
{
337337
"items": [
338338
{
339-
"label": "Invite a user to an Organization",
339+
"label": "Invite a Guest to an Organization",
340340
"slug": "invite-user-to-orga"
341341
},
342342
{
343343
"label": "Accept an invitation to an Organization",
344344
"slug": "accept-invitation-to-orga"
345345
},
346346
{
347-
"label": "Manage users",
348-
"slug": "manage-users"
349-
},
350-
{
351-
"label": "Create an application",
352-
"slug": "create-application"
347+
"label": "Log in as a Member",
348+
"slug": "log-in-as-a-member"
353349
},
354350
{
355-
"label": "Manage applications",
356-
"slug": "manage-applications"
351+
"label": "Comply with security requirements as a Member",
352+
"slug": "comply-with-sec-requirements-member"
357353
},
358354
{
359355
"label": "Create API keys",
@@ -363,6 +359,26 @@
363359
"label": "Manage API keys",
364360
"slug": "manage-api-keys"
365361
},
362+
{
363+
"label": "Manage users",
364+
"slug": "manage-users"
365+
},
366+
{
367+
"label": "Manage Members",
368+
"slug": "manage-members"
369+
},
370+
{
371+
"label": "Enforce security requirements for Members",
372+
"slug": "enforce-security-requirements-members"
373+
},
374+
{
375+
"label": "Create an application",
376+
"slug": "create-application"
377+
},
378+
{
379+
"label": "Manage applications",
380+
"slug": "manage-applications"
381+
},
366382
{
367383
"label": "Create a group",
368384
"slug": "create-group"

pages/account/concepts.mdx

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -50,6 +50,10 @@ Multifactor authentication (MFA) is any form of verification that requires two f
5050

5151
A password is a string of characters associated to 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 a [magic link](#magic-link) to authenticate yourself.
5252

53+
## Single Sign-on (SSO)
54+
55+
Single Sign-On (SSO) allows you to use your Google or Microsoft 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 or Microsoft account.
56+
5357
## Support plan
5458

5559
Scaleway provides four different types of [support plans](https://console.scaleway.com/support/plans): Basic, Silver, Gold and Platinum. Your support plan determines the level of service and dedicated assistance you have access to, and the guaranteed response time of your support requests. You can [configure your support plan in the console](/account/how-to/configure-support-plans/).

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

Lines changed: 23 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ content:
77
paragraph: Steps to log in to the Scaleway console.
88
tags: account login password access magic-link magic link SSO
99
dates:
10-
validation: 2024-12-05
10+
validation: 2024-12-05
1111
posted: 2024-06-11
1212
categories:
1313
- console
@@ -17,7 +17,7 @@ categories:
1717

1818
- A [Scaleway](https://www.scaleway.com/en/) account
1919

20-
## Log in to the console with a Magic Link
20+
## How to log in with a Magic Link
2121

2222
Instead of using your password, you can use a **Magic Link** to authenticate yourself when you log into the Scaleway console. This provides quick and secure access to your account without the hassle of remembering your password. When you choose to sign in with Magic Link, you receive a unique link sent directly to your email inbox which you can use one time only to authenticate your login. Afterward, it automatically becomes invalid.
2323

@@ -36,11 +36,29 @@ A confirmation email is sent to your inbox, confirming that you have authenticat
3636
The Magic Link becomes invalid as soon as you have used it. If you log out from the console and want to log in again without your password, you will need to request a new magic link by repeating the steps above.
3737
</Message>
3838

39-
## Log in to the console with SSO
39+
## How to log in with SSO
4040

4141
Scaleway provides Single Sign-On (SSO) options for a seamless login experience. You can use your Google or Microsoft 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 or Microsoft account.
4242

4343
1. Open your web browser and go to the [Scaleway console](https://console.scaleway.com).
44-
2. Click the **Log in with Google** , **Log in with Microsoft**, or **Log in with GitHub** button, depending on the account you want to use.
44+
2. Click the **Log in with Google**, **Log in with Microsoft**, or **Log in with GitHub** button, depending on the account you want to use.
4545
3. You will be redirected to the respective login page of Google, Microsoft or GitHub.
46-
4. If multifactor authentication (MFA) is activated, enter the authentication code.
46+
4. If multifactor authentication (MFA) is activated, enter the authentication code.
47+
48+
## Log in as an IAM member
49+
50+
<Macro id="login-member" />
51+
52+
## How to log in using MFA
53+
54+
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.
55+
56+
If the login information provided in any of the previous methods is valid, you will be redirected the Multifactor Authentication screen.
57+
58+
1. Enter a valid two-factor token or backup key.
59+
<Message type="note">
60+
This is the the token provided in your MFA app.
61+
</Message>
62+
2. Click **Log in**.
63+
64+
If the code is correct, you are redirected to the Organization dashboard.

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

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -32,8 +32,10 @@ Download the app of your choice and install it onto your smartphone.
3232

3333
## How to enable MFA
3434

35-
1. Access the [Security](https://console.scaleway.com/account/security) tab of your **User Account** page.
36-
Alternatively, click your Organization name on the top-right corner of the console navigation menu, click **Profile**, then **Security**.
35+
1. Click your Organization name on the top-right corner of the console navigation menu, click **Profile**, then **Security**.
36+
<Message type="important">
37+
If you are logged in as an [IAM Member](/iam/concepts/#member), Click **Profile**, then **Credentials** and scroll down to the **Multifactor authentication** section.
38+
</Message>
3739
2. Click **Enable MFA**, in the **Multifactor authentication** section. A pop-up displays.
3840
3. Enter the code shown on the pop-up into your MFA app, or scan the QR code into your app.
3941
Your app sets up MFA for your Scaleway account and displays a 6-digit code.
@@ -69,7 +71,7 @@ If you no longer have access to the device in which you set up your MFA, you can
6971
## How to disable MFA
7072

7173
<Message type="important">
72-
You cannot disable MFA if you are a member of one or more Organizations where MFA is enforced. If you wish to disable MFA, you must first leave these Organizations. If you do not know which of your Organizations enforce MFA, follow the procedure below until step 2. The Organizations will be listed in the **Disable MFA** pop-up.
74+
You cannot disable MFA if you are a Member of one or more Organizations where MFA is enforced. If you wish to disable MFA, you must first leave these Organizations. If you do not know which of your Organizations enforce MFA, follow the procedure below until step 2. The Organizations will be listed in the **Disable MFA** pop-up.
7375
</Message>
7476

7577
1. Access the [Security](https://console.scaleway.com/account/security) tab of your **User Account** page.

pages/iam/concepts.mdx

Lines changed: 11 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,10 @@ The Common Expression Language (CEL) is used to define expressions in [condition
4040

4141
A condition is an additional layer of restrictions for your rule. You can allow access to specific user agents or IP addresses, and allow actions to be performed only at certain dates and times. Conditions are defined through [CEL](#common-expression-language-cel) expressions, and can be set up and configured in the Scaleway console. Refer to the [Understanding policy conditions](/iam/reference-content/understanding-policy-conditions) documentation page to learn how they are set up and how you can define them.
4242

43+
## Grace period
44+
45+
The grace period is the time an [IAM Member](#members) has to comply with the security requirements that are enforced in your Organization before their account is automatically locked. The accounts can be manually unlocked by an Owner or IAM Manager. Upon regaining access, the grace period resets, giving IAM Members another chance to meet security requirements.
46+
4347
## Group
4448

4549
A group (also known as an IAM group) is a grouping of [users](#user) and/or [applications](#application). Creating groups allows you to attach [policies](#policy) to multiple users and/or applications at the same time.
@@ -62,6 +66,12 @@ Similarly, you may participate as a Guest in someone else's Organization, where
6266

6367
You can also create non-human users in your Organization, called [IAM applications](#application), in order to give applications programmatic access to your Scaleway resources.
6468

69+
## Member
70+
71+
You are a Member when you are added to an Organization by an Owner or user with IAM Manager permissions. Members exist only within the specific Organizations in which they are created. This is one of the methods employed at Scaleway to allow Organizations to have multi-users. Members fufill the same purpose as Guest, while ensuring the security of the Organization.
72+
73+
As a Member you are subject to [complying with the security requirements](/iam/how-to/comply-with-sec-requirements-member) in effect in your Organization.
74+
6575
## Organization
6676

6777
An Organization is made of one or several [Projects](#project). When you create your Scaleway account, an Organization is automatically created, of which you are the Owner. When you create [IAM rules](#rule), you can set their scope at Organization level.
@@ -79,8 +89,6 @@ The Organization ID identifies the [Organization](#organization) created with yo
7989

8090
You are the [Owner](#owner) of the Organization that is created with your Scaleway account. Owners have full rights and access to all resources and features in their Organization. See also [Guest](#guest).
8191

82-
<Lightbox src="scaleway-iam-owners-guests.webp" alt="" />
83-
8492
## Permission
8593

8694
A permission is a granular right, which is checked to determine whether to give access to an API endpoint. Permissions are grouped into [permission sets](#permission-set) to facilitate access management within [policies](#policy).
@@ -158,7 +166,7 @@ Keep in mind that:
158166
A user (also known as an IAM user) is a human user in an Organization. They can be of two types:
159167
- **Owner**: You are the Owner of the [Organization](#organization) that was created with your account.
160168
- **Guest**: You are a Guest when invited to another Organization of which you are not the Owner. Similarly, you can invite other users to be Guests in your Organization.
169+
- **Member**: You are a Member when you are added to an Organization by an Owner or user with IAM Manager permissions. Members exist only within the specific Organizations in which they are created.
161170

162171
Within each Organization, different IAM users can have different rights (defined through [policies](#policy)) to perform actions on resources.
163172

164-
<Lightbox src="scaleway-iam-owners-guests.webp" alt="" />

pages/iam/how-to/accept-invitation-to-orga.mdx

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ dates:
1010
posted: 2022-06-20
1111
---
1212

13-
When you [create a Scaleway account](/account/how-to/create-an-account/), an Organization is automatically created, of which you are the [Owner](/iam/concepts/#owner). If you are invited to someone else's Organization, you will simultaneously be the Owner of your own Organization and a guest in the other Organization, where you will have the rights and permissions granted to you via [policies](/iam/concepts/#policy).
13+
When you [create a Scaleway account](/account/how-to/create-an-account/), an Organization is automatically created, of which you are the [Owner](/iam/concepts/#owner). If you are invited to someone else's Organization, you will simultaneously be the Owner of your own Organization and a Guest in the other Organization, where you will have the rights and permissions granted to you via [policies](/iam/concepts/#policy).
1414

1515
<Lightbox src="scaleway-iam-owners-guests.webp" alt="" />
1616

@@ -22,7 +22,9 @@ When you [create a Scaleway account](/account/how-to/create-an-account/), an Org
2222
When someone invites you to join their Organization, you receive an email to inform you.
2323

2424
<Message type="important">
25-
If the Organization you were invited to [enforces MFA](/account/how-to/enforce-mfa/), make sure you have [activated MFA](/account/how-to/use-2fa/) before accepting the invitation.
25+
Keep in mind that:
26+
- The procedure described on this page applies only to [IAM Guests](/iam/concepts/#guest)
27+
- If the Organization you were invited to [enforces MFA](/organizations-and-projects/how-to/enforce-mfa/), make sure you have [activated MFA](/account/how-to/use-2fa/) before accepting the invitation.
2628
</Message>
2729

2830
## If you already have a Scaleway account
179 KB
Loading
317 KB
Loading

0 commit comments

Comments
 (0)