Skip to content

Commit 234c955

Browse files
fix(gen): triangle end
1 parent 47658d4 commit 234c955

File tree

3 files changed

+27
-3
lines changed

3 files changed

+27
-3
lines changed

pages/account/concepts.mdx

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,8 @@ A magic link provides quick and secure access to your account without the hassle
4040

4141
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.
4242

43+
Refer to the [How to use MFA](/account/how-to/use-2fa) documentation page for more information.
44+
4345
## Password
4446

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

pages/iam/concepts.mdx

Lines changed: 17 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,12 +19,16 @@ The diagram above shows how different IAM concepts mentioned on this page intera
1919

2020
A user account refers to a human who owns a Scaleway account. Your account bears your personal information and authentication methods required to access the [Scaleway console](https://console.scaleway.com/). When you create your Scaleway account, an [Organization](#organization) is automatically created with you as the designated Owner. You can also be added to an existing Organization as a Member and have an account that exists only within that Organization.
2121

22+
Refer to the [How to create an account](/account/how-to/create-an-account) documentation page for more information.
23+
2224
## Application
2325

2426
An application (also known as an IAM application) is a non-human user in an [Organization](#organization). IAM applications can be used when you want to create an API key that is not linked to a user, to give programmatic access to resources.
2527

2628
Note that applications cannot, by definition, have access to the Scaleway console, as they have only an API key and no account themselves (they are not [accounts](#account)).
2729

30+
Refer to the [Users, groups and applications](/iam/reference-content/users-groups-and-applications) reference page for more information.
31+
2832
## API key
2933

3034
An API key is a unique identifier, used to authenticate requests made to the [Scaleway API](https://www.scaleway.com/en/developers/api/). An API key consists of an access key and a secret key. The access key is like a unique ID or username, and is not a sensitive piece of information. The secret key is more sensitive as it is like a password to authenticate the access key.
@@ -49,6 +53,8 @@ The grace period is the time an [IAM Member](#members) has to comply with the se
4953

5054
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.
5155

56+
Refer to the [Users, groups and applications](/iam/reference-content/users-groups-and-applications) reference page for more information.
57+
5258
## IAM
5359

5460
**I**dentity and **A**ccess **M**anagement allows you to share access to the management of your Scaleway [resources](#resource) in a controlled and secure manner.
@@ -93,12 +99,17 @@ Permission set names contain descriptions that clearly explain their purpose. Fo
9399

94100
Permissions sets (e.g.`InstanceReadAccess`) and their [scope](#scope) (e.g. "on Project A only") make up IAM rules, which define the access rights that a [principal](#principal) (user, group, or application) should have.
95101

102+
103+
Refer to the [Permission sets](/iam/reference-content/permission-sets) reference page for an extensive list of the available permission sets.
104+
96105
## Policy
97106

98-
Policies control user rights by defining one or more [rules](#rule) to apply to the attached [principals](#principal) (users, groups, or applications). A policy rule has two parts: [permission set](#permission-set) and [scope](#scope).
107+
Policies control user rights by defining one or more [rules](#rule) to apply to the attached [principals](#principal) (users, groups, or applications). A policy rule has two parts: [permission set](#permission-set), [scope](#scope) and [conditions](#conditions).
99108

100109
For each policy rule, you specify one or more permission sets (e.g. "list all Instances") and their scope (e.g. "on Project A only"). This therefore defines the actions that the principles can carry out on resources within the scope.
101110

111+
Refer to the [Understanding IAM Policies](/iam/reference-content/policy) reference page for more information.
112+
102113
## Preferred Project
103114

104115
You can carry out actions on Scaleway Object Storage resources either via the [Scaleway console](https://console.scaleway.com), or via a third-party API or CLI, such as [the AWS CLI](/object-storage/api-cli/object-storage-aws-cli/), [MinIOClient](/object-storage/api-cli/installing-minio-client/) or [Rclone](/object-storage/api-cli/installing-rclone/). While the Scaleway console gives you the option to specify the [Scaleway Project](/organizations-and-projects/concepts/#project) to carry out your Object Storage actions in, this option is not available via third-party API/CLI tools. These tools are based on a [standard Amazon S3 programming interface](https://en.wikipedia.org/wiki/Amazon_S3#S3_API_and_competing_services), which does not accept Project ID as a parameter. Therefore, when you create a Scaleway API key with IAM, you are prompted to specify the API key's **preferred Project for Object Storage**. This API key will always use this Project when carrying out Object Storage actions via any API/CLI. See our page on [using API keys with Object Storage](/iam/api-cli/using-api-key-object-storage/) for more information.
@@ -115,6 +126,8 @@ Projects are groupings of Scaleway [resources](#resource). Every Scaleway Organi
115126

116127
For example, if IAM users within your [Organization](#organization) are working on building two different systems with Scaleway resources, you can group the resources for each system into different Projects. This then allows you to restrict [IAM users'](#user) access to only the Project they are working on. It also facilitates the separation of billing between Projects.
117128

129+
Refer to the [How to create a Project](/organizations-and-projects/how-to/create-a-project) documentation page for more information.
130+
118131
## Resource
119132

120133
A Scaleway resource is either a product or a feature in the Scaleway Ecosystem. Examples of resources include Instances, Private Networks, Kubernetes Kapsule and Flexible IPs, to name a few.
@@ -152,4 +165,6 @@ A user (also known as an IAM user) is a human user in an Organization. They can
152165
- **Owner**: You are the Owner of the [Organization](#organization) that was created with your account.
153166
- **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.
154167

155-
Within each Organization, different IAM users can have different rights (defined through [policies](#policy)) to perform actions on resources.
168+
Within each Organization, different IAM users can have different rights (defined through [policies](#policy)) to perform actions on resources.
169+
170+
Refer to the [Users, groups and applications](/iam/reference-content/users-groups-and-applications) reference page for more information.

pages/organizations-and-projects/concepts.mdx

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,8 @@ The Organization ID identifies the [Organization](#organization) created with yo
2828

2929
A Project is a grouping of Scaleway [resources](#resource). Each Scaleway Organization comes with a default Project, and you can create new Projects if necessary. Projects are cross-region, meaning resources located in different [regions](/instances/concepts/#region) can be grouped in one single Project. When grouping resources into different Projects, you can use [IAM](/iam/concepts/#iam) to define custom access rights for each Project.
3030

31+
Refer to the [How to create a Project](/organizations-and-projects/how-to/create-a-project) documentation page for more information.
32+
3133
## Project dashboard
3234

3335
The Project dashboard can be viewed within the [console](https://console.scaleway.com/project). On this dashboard, you can see an overview of the Project's [resources](#resource), along with the Project's settings and credentials ([SSH keys](#ssh-key)).
@@ -45,6 +47,11 @@ An SSH key (**S**ecure **Sh**ell key) allows passwordless connection to an [Inst
4547

4648
The public key is kept in your Scaleway account and transferred to the Instance during the boot process, while the identification key is kept securely on your local computer. When connecting to the Instance via SSH, a trusted connection to the machine is established using the key pair.
4749

50+
Refer to the [How to create an SSH key](/organizations-and-projects/how-to/create-ssh-key) documentation page for more information.
51+
52+
4853
## Quotas
4954

50-
Every [Organization](/organizations-and-projects/concepts/#organization) has quotas, which are limits on the number of Scaleway resources they can use. Quotas are per product (e.g. Instances) and product type (e.g. GP1-L Instance). Quotas are designed to prevent abuse, and can be viewed on the [Organization dashboard](https://console.scaleway.com/organization/quotas) of the console and in the [Understanding quotas](/organizations-and-projects/additional-content/organization-quotas) documentation page.
55+
Every [Organization](/organizations-and-projects/concepts/#organization) has quotas, which are limits on the number of Scaleway resources they can use. Quotas are per product (e.g. Instances) and product type (e.g. GP1-L Instance). Quotas are designed to prevent abuse, and can be viewed on the [Organization dashboard](https://console.scaleway.com/organization/quotas) of the console.
56+
57+
Refer to the [Understanding quotas](/organizations-and-projects/additional-content/organization-quotas) reference page for a list of the available quotas.

0 commit comments

Comments
 (0)