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 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 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 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
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 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/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>'
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}terminal.
Exemple de requête cURL:
curl -X GET 'https://access.eqix.equinix.com/v1/roleAssignments/{roleassignment:roleAssignmentId}' \
-H 'Authorization: Bearer <token>'
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}point final.
Exemple de requête cURL:
curl -X DELETE 'https://access.eqix.equinix.com/v1/roleAssignments/roleassignment:{roleAssignmentId}' \
-H 'Authorization: Bearer <token>'