# OIDC et rôles Si vous utilisez le contrôle d'accès basé sur les rôles, vous pouvez attribuer un rôle principal OIDC pour leur donner accès à votre infrastructure Equinix. Ensuite, lorsque votre entité de sécurité OIDC effectue [un échange de jetons](https://docs.equinix.com/fr/equinix-api/oidc-api-authentication.md) , utilisez le `roleassignments:`paramètre Scope . Si l'entité de sécurité a des attributions de rôles dans l'organisation, l'échange de jetons émet un jeton porteur. Les autorisations nécessaires à l'attribution et à la gestion des rôles sont soit : * Contrôle d'accès basé sur les rôles - le `IAM Admin` rôle. * Contrôle d'accès basé sur les attributs - une politique d'accès contenant : `use/createRoleAssignment`, `use/listRoleAssignments`, , `use/getRoleAssignment` `use/deleteRoleAssignment`. ## Rôles disponibles[​](#rôles-disponibles "Lien direct vers Rôles disponibles") Pour répertorier tous les rôles, envoyez une `GET` demande au [`/v1/roles`](https://docs.equinix.com/fr/api-catalog/accessv1/v1-role/listroles.md)noeud final. Exemple de requête cURL : ``` curl -X GET 'https://access.eqix.equinix.com/v1/roles' \ -H 'Authorization: Bearer ' ``` Pour répertorier les rôles disponibles dans un projet particulier, envoyez une `GET` demande au [`/v1/projects/{projectId}/roles`](https://docs.equinix.com/fr/api-catalog/accessv1/v1-role/listrolesbyprojectid.md)noeud final. Exemple de requête cURL : ``` curl -X GET 'https://access.eqix.equinix.com/v1/projects/project:{projectId}/roles' \ -H 'Authorization: Bearer ' ``` La réponse contient l'identifiant du rôle et l'étendue de l'affectation. Le `assignmentScope.type` champ répertorie les étendues d'affectation possibles autorisées pour ce rôle dans la liste suivante : `assignmentScopeType=PDS_ORG`, `assignmentScopeType=ORGANIZATION`, `assignmentScopeType=PROJECT`, `assignmentScopeType=BILLING_ACCOUNT`, , `assignmentScopeType=SUBSCRIPTION_KEY``assignmentScopeType=PORT`. L' `assignmentScope.id` est l'identifiant unique de cette étendue. Lorsque vous créez une attribution de rôle, vous devez spécifier l'ID du projet et les informations relatives au périmètre. ## Créer une attribution de rôle[​](#créer-une-attribution-de-rôle "Lien direct vers Créer une attribution de rôle") Pour créer une attribution de rôle, envoyez une `POST` demande au [`/v1/roleAssignments`](https://docs.equinix.com/fr/api-catalog/accessv1/v1-role-assignment/createroleassignment.md)point final. Exemple de requête cURL : ``` curl -X POST 'https://access.eqix.equinix.com/v1/roleAssignments' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "principal": "", "roleId": "", "assignmentScope": { "id": "", "type": "" } }' ``` ## Liste des attributions de rôles[​](#liste-des-attributions-de-rôles "Lien direct vers Liste des attributions de rôles") Pour répertorier toutes les affectations de rôles pour un type de périmètre d'affectation, envoyez une `GET` demande au [`/v1/roleAssignments`](https://docs.equinix.com/fr/api-catalog/accessv1/v1-role-assignment/listroleassignments.md)point final. Utilisez les `assignmentScopeId`paramètres de requête et `assignmentScopeType`pour limiter la réponse au type de périmètre spécifié. Exemple de requête cURL : ``` curl -X GET 'https://access.eqix.equinix.com/v1/roleAssignments?assignmentScopeId=&assignmentScopeType=' \ -H 'Authorization: Bearer ' ``` ## Obtenir un rôle Détails de la mission[​](#obtenir-un-rôle-détails-de-la-mission "Lien direct vers Obtenir un rôle Détails de la mission") Pour obtenir les détails d'une attribution de rôle spécifique, envoyez une `GET` demande au [`/v1/roleAssignments/{roleAssignmentId}`](https://docs.equinix.com/fr/api-catalog/accessv1/v1-role-assignment/getroleassignment.md)terminal. Exemple de requête cURL : ``` curl -X GET 'https://access.eqix.equinix.com/v1/roleAssignments/{roleassignment:roleAssignmentId}' \ -H 'Authorization: Bearer ' ``` ## Supprimer une attribution de rôle[​](#supprimer-une-attribution-de-rôle "Lien direct vers Supprimer une attribution de rôle") Lorsque vous supprimez une attribution de rôle, l'utilisateur OIDC perd l'accès aux autorisations accordées par le rôle. Pour supprimer une attribution de rôle, envoyez une `DELETE` demande au [`/v1/roleAssignments/{roleAssignmentId}`](https://docs.equinix.com/fr/api-catalog/accessv1/v1-role-assignment/deleteroleassignment.md)point final. Exemple de requête cURL : ``` curl -X DELETE 'https://access.eqix.equinix.com/v1/roleAssignments/roleassignment:{roleAssignmentId}' \ -H 'Authorization: Bearer ' ```