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 , utilisez le roleassignments:<org-id>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 Adminrôle. - Contrôle d'accès basé sur les attributs - une politique d'accès contenant :
use/createRoleAssignment,use/listRoleAssignments, ,use/getRoleAssignmentuse/deleteRoleAssignment.
Rôles disponibles
Pour répertorier tous les rôles, envoyez une GET demande au /v1/rolesnoeud final.
Exemple de requête cURL :
curl -X GET 'https://access.eqix.equinix.com/v1/roles' \
-H 'Authorization: Bearer <token>'
Pour répertorier les rôles disponibles dans un projet particulier, envoyez une GET demande au /v1/projects/{projectId}/rolesnoeud final.
Exemple de requête cURL :
curl -X GET 'https://access.eqix.equinix.com/v1/projects/project:{projectId}/roles' \
-H 'Authorization: Bearer <token>'
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
Pour créer une attribution de rôle, envoyez une POST demande au /v1/roleAssignmentspoint final.
Exemple de requête cURL :
curl -X POST 'https://access.eqix.equinix.com/v1/roleAssignments' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
"principal": "<principal:principal_id>",
"roleId": "<role:role_id>",
"assignmentScope": {
"id": "<role_assignment_scope_id>",
"type": "<role_assignment_scope>"
}
}'
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/roleAssignmentspoint final. Utilisez les assignmentScopeIdparamètres de requête et assignmentScopeTypepour 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=<assignment_scope_id>&assignmentScopeType=<assignment_scope_type>' \
-H 'Authorization: Bearer <token>'
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}terminal.
Exemple de requête cURL :
curl -X GET 'https://access.eqix.equinix.com/v1/roleAssignments/{roleassignment:roleAssignmentId}' \
-H 'Authorization: Bearer <token>'
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}point final.
Exemple de requête cURL :
curl -X DELETE 'https://access.eqix.equinix.com/v1/roleAssignments/roleassignment:{roleAssignmentId}' \
-H 'Authorization: Bearer <token>'