Saltar al contenido principal

OIDC y funciones

Si utiliza un control de acceso basado en roles, puede asignar roles principales de OIDC para darles acceso a su infraestructura de Equinix. Luego, cuando su principal OIDC realice un intercambio de tokens , utilice el roleassignments:<org-id>parámetro FOR THE SCOPE. Si el principal tiene asignaciones de roles en la organización, el intercambio de tokens emite un token portador.

Los permisos necesarios para asignar y gestionar roles son:

  • Control de acceso basado en roles - El IAM Admin rol.
  • Control de acceso basado en atributos - Una política de acceso que contiene: use/createRoleAssignment, use/listRoleAssignments, use/getRoleAssignment, use/deleteRoleAssignment.

Funciones disponibles​

Para enumerar todos los roles, envíe una GET solicitud al /v1/roles punto final.

Ejemplo de solicitud cURL:

curl -X GET 'https://access.eqix.equinix.com/v1/roles' \
-H 'Authorization: Bearer <token>'

Para enumerar los roles disponibles en un proyecto determinado, envíe una GET solicitud al /v1/projects/{projectId}/roles punto final. Ejemplo de solicitud cURL:

curl -X GET 'https://access.eqix.equinix.com/v1/projects/project:{projectId}/roles' \
-H 'Authorization: Bearer <token>'

La respuesta contiene el ID del rol y el ámbito de asignación.

El assignmentScope.type campo enumera los posibles alcances de asignación permitidos para ese rol de la siguiente lista: assignmentScopeType=PDS_ORG, assignmentScopeType=ORGANIZATION, assignmentScopeType=PROJECT assignmentScopeType=BILLING_ACCOUNT, , , assignmentScopeType=SUBSCRIPTION_KEY``assignmentScopeType=PORT. assignmentScope.idEs el ID único para ese ámbito.

Cuando cree una asignación de funciones, deberá especificar el ID del proyecto y la información sobre el alcance.

Crear una asignación de funciones​

Para crear una asignación de roles, envíe una POST solicitud al /v1/roleAssignments punto final.

Ejemplo de solicitud 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>"
}
}'

Lista de asignaciones de funciones​

Para enumerar todas las asignaciones de roles para un tipo de ámbito de asignación, envíe una GET solicitud al /v1/roleAssignments punto final. Utilice los assignmentScopeIdparámetros de consulta y assignmentScopeTypepara limitar la respuesta al tipo de ámbito especificado.

Ejemplo de solicitud cURL:

curl -X GET 'https://access.eqix.equinix.com/v1/roleAssignments?assignmentScopeId=<assignment_scope_id>&assignmentScopeType=<assignment_scope_type>' \
-H 'Authorization: Bearer <token>'

Obtener una asignación de funciones Detalles​

Para obtener los detalles de una asignación de roles específica, envíe una GET solicitud al /v1/roleAssignments/{roleAssignmentId} punto final.

Ejemplo de solicitud cURL:

curl -X GET 'https://access.eqix.equinix.com/v1/roleAssignments/{roleassignment:roleAssignmentId}' \
-H 'Authorization: Bearer <token>'

Eliminar una asignación de funciones​

Al eliminar una asignación de rol, el usuario OIDC pierde el acceso a los permisos concedidos por el rol. Para eliminar una asignación de roles, envíe una DELETE solicitud al /v1/roleAssignments/{roleAssignmentId} punto final.

Ejemplo de solicitud cURL:

curl -X DELETE 'https://access.eqix.equinix.com/v1/roleAssignments/roleassignment:{roleAssignmentId}' \
-H 'Authorization: Bearer <token>'
¿Le ha resultado útil esta página?