Passer au contenu principal

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 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​

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>'
Cette page vous a-t-elle été utile ?