Skip to content

Commit 6d48f7b

Browse files
Y0CossY0Coss
committed
Proofreading
1 parent cf77521 commit 6d48f7b

File tree

1 file changed

+54
-56
lines changed

1 file changed

+54
-56
lines changed

‎pages/account/customer/iam-policies-api/guide.fr-fr.md

Lines changed: 54 additions & 56 deletions
Original file line numberDiff line numberDiff line change
@@ -5,43 +5,41 @@ excerpt: "Découvrez comment donner des droits d'accès spécifiques aux utilisa
55
section: 'Utilisation avancée'
66
order: 03
77
updated: 2023-03-07
8-
routes:
9-
canonical: 'https://docs.ovh.com/gb/en/customer/iam-policies-api/'
108
---
119

1210
**Dernière mise à jour le 07/03/2023**
1311

1412
> [!warning]
1513
>
1614
> Cette fonctionnalité est actuellement en version bêta. Pour rejoindre la version bêta, inscrivez-vous ici : <https://labs.ovhcloud.com/en/>
17-
>
15+
>
1816
1917
## Objectif
2018

2119
Ce guide explique comment fournir des droits d'accès spécifiques aux utilisateurs d'un compte OVHcloud.
2220

23-
La gestion des accès d'OVHcloud est basée sur un système de gestion de "politiques". Il est possible d'écrire différentes "politiques" qui donnent aux utilisateurs l'accès à des fonctionnalités spécifiques sur les produits liés à un compte OVHcloud.
21+
La gestion des accès d'OVHcloud est basée sur un système de gestion de « politiques ». Il est possible d'écrire différentes politiques qui donnent aux utilisateurs l'accès à des fonctionnalités spécifiques sur les produits liés à un compte OVHcloud.
2422

2523
Dans le détail, une politique contient :
2624

2725
- Une ou plusieurs **identités** ciblées par cette politique.
2826
- Il peut s'agir d'identifiants de compte, d'utilisateurs ou de groupes d'utilisateurs (comme ceux utilisés dans l'[Active Directory Federation Services (ADFS)](https://docs.ovh.com/fr/customer/connect-saml-sso/)). 
29-
- Une ou plusieurs **ressources** impactées par cette politique.
30-
- Une ressource est un produit OVHcloud qui sera impacté par cette politique (un nom de domaine, un serveur Nutanix, un Load Balancer, etc.)
31-
- Une ou plusieurs **actions** autorisées ou exceptées par cette politique.
27+
- Une ou plusieurs **ressources** concernées par cette politique.
28+
- Une ressource est un produit OVHcloud qui sera concerné par cette politique (un nom de domaine, un serveur Nutanix, un Load Balancer, etc.)
29+
- Une ou plusieurs **actions** autorisées ou exclues par cette politique.
3230
- Les actions sont les droits spécifiques affectés par cette politique (redémarrer le serveur, créer un compte email, résilier un produit, etc).
3331

34-
Par exemple, nous pouvons créer une politique pour donner à un utilisateur appelé John, pour un VPS, l'accès à l'action "reboot".
32+
Par exemple, nous pouvons créer une politique pour donner à un utilisateur appelé John, pour un VPS, l'accès à l'action « reboot ».
3533

36-
**Décourez en détail comment ces politiques peuvent être déclarées en utilisant l'API d'OVHcloud, et comment lister les identités, ressources et actions disponibles pour celles-ci.**
34+
**Découvrez en détail comment ces politiques peuvent être déclarées en utilisant l'API OVHcloud, comment lister les identités, ressources et actions disponibles pour ces politiques.**
3735

3836
![IAM Policies](images/iam_policies.png){.thumbnail}
3937

4038
## Prérequis
4139

42-
Pour mettre en place une politique, vous aurez besoin :
40+
Pour mettre en place une politique, vous aurez besoin des éléments suivants :
4341

44-
- D'un [compte client OVHcloud](https://docs.ovh.com/fr/customer/creer-compte-ovhcloud/)
42+
- Un [compte client OVHcloud](https://docs.ovh.com/fr/customer/creer-compte-ovhcloud/)
4543
- Savoir [gérer des comptes utilisateurs](https://docs.ovh.com/fr/customer/gestion-utilisateurs/)
4644
- Disposer de produits liés à votre compte OVHcloud (Load Balancer, nom de domaine, VPS, etc.)
4745

@@ -59,17 +57,17 @@ Les ressources, les groupes de ressources et les actions nécessaires à la cré
5957

6058
|**Méthode**|**Chemin**|**Description**|
6159
| :-: | :-: | :-: |
62-
|GET|/iam/policy|Retrieve all policies|
63-
|POST|/iam/policy|Create a new policy|
64-
|GET|/iam/policy/{policyId}|Retrieve the given policy|
65-
|PUT|/iam/policy/{policyId}|Update an existing policy|
66-
|DELETE|/iam/policy/{policyId}|Delete the given policy|
60+
|GET|/iam/policy|Récupérer toutes les politiques|
61+
|POST|/iam/policy|Créer une nouvelle politique|
62+
|GET|/iam/policy/{policyId}|Récupérer une politique spécifique|
63+
|PUT|/iam/policy/{policyId}|Mettre à jour une politique existante|
64+
|DELETE|/iam/policy/{policyId}|Supprimer une politique spécifique|
6765

6866
#### Récupérer toutes les politiques
6967

7068
L'exemple suivant montre comment une politique est construite.
7169

72-
Trouvez toutes les politiques, y compris celles pré-générées par OVHcloud, en appelant le point de sortie de l'API : **/iam/policy**
70+
Récupérez toutes les politiques, y compris celles pré-générées par OVHcloud, en appelant le endpoint API suivant : **/iam/policy**
7371

7472
*Exemple de sortie :*
7573

@@ -105,12 +103,12 @@ Trouvez toutes les politiques, y compris celles pré-générées par OVHcloud, e
105103

106104
Dans cet exemple, le compte "*urn:v1:eu:identity:account:xx1111-ovh*" peut faire toutes les actions (*"action":"\*"*) pour le groupe de ressources "*urn:v1:eu:resourceGroup:aa0713ab-ed13-4f1a-89a5-32aa0cb936d8*". Cette police est détenue par l'idientifiant client OVHcloud "*xx1111-ovh*" (il correspond au rôle d'administrateur, il est créé par OVHcloud et ne peut pas être modifié).
107105

108-
Les éléments des politiques sont définis par des URN. Ces URNs sont définis par le modèle suivant :
106+
Les éléments des politiques sont définis par des URN. Ces URN sont définis par le modèle suivant :
109107

110108
||**URN**|**:**|**version**|**:**|**plaque**|**:**|**type**|**:**|**sous-type**|**:**|**id**|
111109
| :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: |
112110
|**Description**|préfixe immuable|:|version du système IAM|:|Plaque où se trouve l'URN|:|Type de l'URN actuelle|:|(optionnel) Sous-type pour les types **identity** ou **resource** |:|Identifiant unique associé à l'URN|
113-
|**Possible values**|urn|:|v1|:|eu, ca, us|:|identité, resource, resourceGroup|:|<p>Pour le type **identity** : account, user, group</p><p>Pour le type **resource** : tous les types de ressources</p>|:|Valeur alphanumérique|
111+
|**Possible values**|urn|:|v1|:|eu, ca, us|:|identité, ressource, resourceGroup|:|<p>Pour le type **identity** : account, user, group</p><p>Pour le type **resource** : tous les types de ressources</p>|:|Valeur alphanumérique|
114112
|**Account ID Example**|urn|:|v1|:|eu|:|identity|:|account|:|xx1111-ovh|
115113
|**User group Example**|urn|:|v1|:|eu|;|identity|:|group|:|xx1111-ovh/[email protected]|
116114
|**VPS Example**|urn|:|v1|:|ca|:|resource|:|vps|:|b96ffed4-3467-4129-b8be-39a3eb3a0a93|
@@ -120,25 +118,25 @@ Les éléments des politiques sont définis par des URN. Ces URNs sont définis
120118

121119
- **id**: Identifiant unique de la politique. Il suit le format UUID.
122120
- **owner**: Le compte qui a créé cette politique.
123-
- **name**: Le nom de la politique. Il est possible d'utiliser ce nom pour organiser les politiques. Il n'y a pas de format à suivre (sauf que le préfixe "ovh-" est réservé aux politiques OVHcloud).
124-
- **readOnly**: S'il est vrai, il indique que la politique ne peut pas être modifiée. Il représente souvent les politiques gérées par OVHcloud.
125-
- **identities**: Les identités concernées par la politique. Elles sont spécifiées par un URN. **account**:**account-id** pour le compte client OVHcloud, **user**:**account-id**/**username** pour le compte utilisateur, **group**:**account-id**/**username** pour un groupe utilisateur.
126-
- **resources**: The resources concerned by the policy. They are specified by a URN. **resource** pour une ressource, **resourceGroup** pour un groupe de ressources.
121+
- **name**: Le nom de la politique. Il est possible d'utiliser ce nom pour organiser les politiques. Il n'y a pas de format à suivre (sauf le préfixe « ovh- » qui est réservé aux politiques OVHcloud).
122+
- **readOnly**: S'il est en « true », il indique que la politique ne peut pas être modifiée. Il représente souvent les politiques gérées par OVHcloud.
123+
- **identities**: Les identités concernées par la politique. Elles sont spécifiées par un URN. **account**: **account-id** pour le compte client OVHcloud, **user**: **account-id**/**username** pour le compte utilisateur, **group**: **account-id**/**username** pour un groupe utilisateur.
124+
- **resources**: Les ressources concernées par la politique. Elles sont spécifiées par un URN, **resource** pour une ressource, **resourceGroup** pour un groupe de ressources.
127125
- **permissions**: Peut être **allow** ou **except**:
128-
- **allow**: Tableau des actions autorisées pour les identités concernant les ressources. Toutes les actions sont refusées par défaut.
129-
- **except**: Extension du paramètre d'autorisation : **allow**. Tableau d'actions à ne pas autoriser même si elles sont incluses dans les actions **autorisées**. Par exemple, ceci est utile lorsqu'il y a une action autorisée par un wildcard mais qu'il est nécessaire d'exclure une action spécifique qui serait autrement incluse dans le wildcard.
126+
- **allow**: Ensemble des actions autorisées pour les identités concernant les ressources. Toutes les actions sont refusées par défaut.
127+
- **except**: Extension du paramètre d'autorisation **allow**. Ensemble d'actions à ne pas autoriser même si elles sont incluses dans les actions **autorisées**. Par exemple, ceci est utile lorsqu'il y a une action autorisée par un wildcard mais qu'il est nécessaire d'exclure une action spécifique qui serait autrement incluse dans le wildcard.
130128
- **createdAt**: Date de création de la politique.
131129
- **updateAt**: Dernière mise à jour de la politique.
132130

133131
#### Créer une politique
134132

135-
Créez une nouvelle politique en utilisant cette API :
133+
Créez une nouvelle politique en utilisant cet appel API :
136134

137135
|**Méthode**|**Chemin**|**Description**|
138136
| :-: | :-: | :-: |
139-
|POST|/iam/policy|Create a new policy|
137+
|POST|/iam/policy|Créer une nouvelle politique|
140138

141-
Par exemple, créer une politique autorisant l'utilisateur nommé "*user1*" à faire des actions sur un VPS:
139+
Par exemple, créez une politique autorisant l'utilisateur nommé "*user1*" à faire des actions sur un VPS :
142140

143141
**Exemple de création de politique**
144142

@@ -229,7 +227,7 @@ Vérifiez cela avec `GET /iam/policy`:
229227
]
230228
```
231229

232-
La politique a été créée avec succès. Maintenant, "***user1***" peut **effectuer des redémarrages et créer des sauvegardes instantanées** sur le VPS "***urn:v1:eu:resource:vps:b96ffed4-3467-4129-b8be-39a3eb3a0a93***".
230+
La politique a été créée avec succès. Maintenant, "***user1***" peut **effectuer des redémarrages et créer des sauvegardes (snapshots))** sur le VPS "***urn:v1:eu:resource:vps:b96ffed4-3467-4129-b8be-39a3eb3a0a93***".
233231

234232
### Identités
235233

@@ -254,9 +252,9 @@ Cette section décrit comment récupérer ou créer un utilisateur pour la polit
254252
|PUT|/me/identity/group/{group}|Modifier un groupe|
255253
|DELETE|/me/identity/group/{group}|Supprimer un groupe|
256254

257-
#### Créer des utilisateur
255+
#### Créer des utilisateurs
258256

259-
Listez tous les utilisateurs actuels liés au compte en appelant:
257+
Listez tous les utilisateurs actuels liés au compte en appelant :
260258

261259
**/me/identity/user**
262260

@@ -269,7 +267,7 @@ Listez tous les utilisateurs actuels liés au compte en appelant:
269267

270268
Ces utilisateurs peuvent être utilisés sur des politiques avec le format URN: urn:v1:eu:identity:user:**xx1111-ovh**/**user1**
271269

272-
Pour créer un nouvel utilisateur, appelez l'API avec le body suivant:
270+
Pour créer un nouvel utilisateur, appelez l'API avec le body suivant :
273271

274272
**post /me/identity/user**
275273

@@ -283,9 +281,9 @@ Pour créer un nouvel utilisateur, appelez l'API avec le body suivant:
283281
}
284282
```
285283

286-
#### Créer un groupe d'utilisateur
284+
#### Créer un groupe d'utilisateurs
287285

288-
Listez tous les groupes actuels liés au compte en appelant:
286+
Listez tous les groupes actuels liés au compte en appelant :
289287

290288
**/me/identity/group**
291289

@@ -298,9 +296,9 @@ Listez tous les groupes actuels liés au compte en appelant:
298296
]
299297
```
300298

301-
Ces groupes utilisateur peuvent être utilisés sur des politiques avec le format URN: urn:v1:eu:identity:group:**xx1111-ovh**/**[email protected]**
299+
Ces groupes d'utilisateurs peuvent être utilisés sur des politiques avec le format URN : urn:v1:eu:identity:group:**xx1111-ovh**/**[email protected]**
302300

303-
Pour créer un nouveau groupe utilisateur, appelez l'API avec le body suivant:
301+
Pour créer un nouveau groupe d'utilisateurs, appelez l'API avec le body suivant:
304302

305303
**post /me/identity/group**
306304

@@ -312,15 +310,15 @@ Pour créer un nouveau groupe utilisateur, appelez l'API avec le body suivant:
312310
}
313311
```
314312

315-
Pour plus d'informations, consultez notre [documentation sur la gestion des utilisateurs](https://docs.ovh.com/fr/customer/managing-users/).
313+
Pour plus d'informations, consultez notre [documentation sur la gestion des utilisateurs](https://docs.ovh.com/fr/customer/gestion-utilisateurs/).
316314

317315
#### Avec une connexion SSO active
318316

319317
Si l'ADFS est activée via la [connexion SSO](https://docs.ovh.com/fr/customer/connect-saml-sso/), les politiques s'appliquent uniquement aux groupes d'utilisateurs, comme décrit dans la section précédente.
320318

321319
### Ressources
322320

323-
Les politiques font référence à des **ressources.** Les ressources correspondent à tous les produits OVHcloud souscrits par le compte OVHcloud pouvant être contrôlés par ce compte.
321+
Les politiques font référence à des **ressources.** Les ressources correspondent à tous les produits OVHcloud souscrits par le compte OVHcloud et pouvant être contrôlés par ce compte.
324322

325323
Cette section décrit comment récupérer les informations sur les ressources pour les utiliser dans une politique.
326324

@@ -379,7 +377,7 @@ Dans cet exemple, le compte a trois ressources disponibles (un VPS, un domaine p
379377
- **type**: Le type de la ressource (vps, publicCloudProject, dnsZone, domain, emailDomain, etc.)
380378
- **owner**: Le détenteur de la ressource (Account ID)
381379

382-
### Resource Groups
380+
### Groupes de ressources
383381

384382
Pour faciliter la gestion des politiques pour un grand nombre de ressources, il est possible de mettre en place un groupe de ressources qui regroupe plusieurs ressources sous un URN unique.
385383

@@ -389,17 +387,17 @@ Pour faciliter la gestion des politiques pour un grand nombre de ressources, il
389387

390388
|**Méthode**|**Chemin**|**Description**|
391389
| :-: | :-: | :-: |
392-
|GET|/iam/resourceGroup|Récupèrer tous les groupes de ressources|
393-
|POST|/iam/resourceGroup|Créer une nouveau groupe de ressources|
394-
|GET|/iam/resourceGroup/{groupId}|Récupérer le groupe de ressources donné|
390+
|GET|/iam/resourceGroup|Récupérer tous les groupes de ressources|
391+
|POST|/iam/resourceGroup|Créer un nouveau groupe de ressources|
392+
|GET|/iam/resourceGroup/{groupId}|Récupérer un groupe de ressources spécifique|
395393
|PUT|/iam/resourceGroup/{groupId}|Mettre à jour un groupe de ressources existant|
396-
|DELETE|/iam/resourceGroup/{groupId}|Supprier le groupe de ressources donné|
394+
|DELETE|/iam/resourceGroup/{groupId}|Supprimer un groupe de ressources spécifique|
397395

398396
#### Récupérer un groupe de ressources
399397

400-
Lister tous les groupes de ressources en appelant **/iam/resourceGroup**.
398+
Listez tous les groupes de ressources en appelant **/iam/resourceGroup**.
401399

402-
Cette API peut être appelé avec une requête-chaîne de paramètres "details" pour développer les résultats avec tous les attributs des ressources retournées.
400+
Cette API peut être appelée avec une requête-chaîne de paramètres « details » pour développer les résultats avec tous les attributs des ressources retournées.
403401

404402
*Exemple de sortie:*
405403

@@ -440,14 +438,14 @@ Dans cet exemple, nous pouvons voir que ce groupe de ressources "*urn:v1:eu:reso
440438
- **name**: Nom du groupe de ressources.
441439
- **owner**: Détenteur du groupe de ressources (Account ID).
442440
- **resources**:
443-
- Si details = **false**: Tableau des UUID des ressources.
444-
- Si details = **true**: Les ressources seront développées avec leurs attributs (comme le résultat que nous avons via l'API des ressources).
441+
- Si details = **false** : Ensemble des UUID des ressources.
442+
- Si details = **true** : Les ressources seront développées avec leurs attributs (comme le résultat que nous obtenons via l'API des ressources).
445443
- **createdAt**: Date de création du groupe de ressources.
446444
- **updateAt**: Date de la dernière mise à jour du groupe de ressources.
447445

448446
#### Créer un groupe de ressources
449447

450-
Créez un groupe de ressources avec l'API suivante:
448+
Créez un groupe de ressources avec l'API suivante :
451449

452450
|**Méthode**|**Chemin**|**Description**|
453451
| :-: | :-: | :-: |
@@ -472,7 +470,7 @@ L'exemple suivant crée un groupe de ressources "*Test\_Envrionment*" contenant
472470

473471
### Action
474472

475-
Les politiques contiennent une liste de **Actions** qui seront autorisées ou refusées aux utilisateurs.
473+
Les politiques contiennent une liste des **Actions** qui seront autorisées ou refusées aux utilisateurs.
476474

477475
Ces actions sont spécifiques à chaque produit, comme le redémarrage d'un serveur de base de données, la commande d'une mise à niveau, la restauration d'un snapshot, etc.
478476

@@ -486,9 +484,9 @@ Ces actions sont spécifiques à chaque produit, comme le redémarrage d'un serv
486484

487485
#### Exemple
488486

489-
Liste de toutes les actions disponibles pour les politiques avec l'API, par exemple:
487+
Listez toutes les actions disponibles pour les politiques avec l'API, par exemple :
490488

491-
**exemple pour une action**
489+
**exemple d'action**
492490

493491
```json
494492
{
@@ -503,11 +501,11 @@ Liste de toutes les actions disponibles pour les politiques avec l'API, par exem
503501

504502
Cette action est "*vps:apiovh:reboot*", elle vise la capacité de redémarrer un VPS.
505503

506-
L'appel à **/iam/reference/action** listera **toutes les actions disponibles** (ATTENTION : Ceci contient une quantité énorme d'éléments).
504+
L'appel à **/iam/reference/action** listera **toutes les actions disponibles** (ATTENTION : cela représente une quantité énorme d'éléments).
507505

508-
Il est fortement recommandé de spécifier le **resourceType** comme paramètre de chaîne de requête pour cet appel d'API (voir la section suivante).
506+
Il est fortement recommandé de spécifier le **resourceType** comme paramètre de chaîne de requête pour cet appel API (voir la section suivante).
509507

510-
#### attributs de l'action
508+
#### Attributs de l'action
511509

512510
- **action**: L'action elle-même
513511
- **description**: Description de l'action
@@ -541,6 +539,6 @@ Voici une partie du résultat:
541539
]
542540
```
543541

544-
## Go further
542+
## Aller plus loin
545543

546-
Join our community of users on <https://community.ovh.com/>.
544+
Échangez avec notre communauté d'utilisateurs sur <https://community.ovh.com/>.

0 commit comments

Comments
 (0)