# 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-CA/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 permissions nécessaires pour attribuer et gérer les 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-CA/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-CA/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 la portée d'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 affectation de rôle, vous devez spécifier l'ID du projet et les informations relatives à la portée. ## Créer une affectation de rôle[​](#créer-une-affectation-de-rôle "Lien direct vers Créer une affectation de rôle") Pour créer une attribution de rôle, envoyez une `POST` demande au [`/v1/roleAssignments`](https://docs.equinix.com/fr-CA/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 affectations de rôles[​](#liste-des-affectations-de-rôles "Lien direct vers Liste des affectations 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-CA/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 ' ``` ## Obtenez les détails de votre attribution de rôle[​](#obtenez-les-détails-de-votre-attribution-de-rôle "Lien direct vers Obtenez les détails de votre attribution de rôle") 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-CA/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 affectation de rôle[​](#supprimer-une-affectation-de-rôle "Lien direct vers Supprimer une affectation 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-CA/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 ' ```