# 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](https://docs.equinix.com/es/equinix-api/oidc-api-authentication.md) , utilice el `roleassignments:`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[​](#funciones-disponibles "Enlace directo a Funciones disponibles") Para enumerar todos los roles, envíe una `GET` solicitud al [`/v1/roles`](https://docs.equinix.com/es/api-catalog/accessv1/v1-role/listroles.md) punto final. Ejemplo de solicitud cURL: ``` curl -X GET 'https://access.eqix.equinix.com/v1/roles' \ -H 'Authorization: Bearer ' ``` Para enumerar los roles disponibles en un proyecto determinado, envíe una `GET` solicitud al [`/v1/projects/{projectId}/roles`](https://docs.equinix.com/es/api-catalog/accessv1/v1-role/listrolesbyprojectid.md) punto final. Ejemplo de solicitud cURL: ``` curl -X GET 'https://access.eqix.equinix.com/v1/projects/project:{projectId}/roles' \ -H 'Authorization: Bearer ' ``` 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.id`Es 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[​](#crear-una-asignación-de-funciones "Enlace directo a Crear una asignación de funciones") Para crear una asignación de roles, envíe una `POST` solicitud al [`/v1/roleAssignments`](https://docs.equinix.com/es/api-catalog/accessv1/v1-role-assignment/createroleassignment.md) punto final. Ejemplo de solicitud 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": "" } }' ``` ## Lista de asignaciones de funciones[​](#lista-de-asignaciones-de-funciones "Enlace directo a 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`](https://docs.equinix.com/es/api-catalog/accessv1/v1-role-assignment/listroleassignments.md) punto final. Utilice los `assignmentScopeId`parámetros de consulta y `assignmentScopeType`para limitar la respuesta al tipo de ámbito especificado. Ejemplo de solicitud cURL: ``` curl -X GET 'https://access.eqix.equinix.com/v1/roleAssignments?assignmentScopeId=&assignmentScopeType=' \ -H 'Authorization: Bearer ' ``` ## Obtener una asignación de funciones Detalles[​](#obtener-una-asignación-de-funciones-detalles "Enlace directo a 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}`](https://docs.equinix.com/es/api-catalog/accessv1/v1-role-assignment/getroleassignment.md) punto final. Ejemplo de solicitud cURL: ``` curl -X GET 'https://access.eqix.equinix.com/v1/roleAssignments/{roleassignment:roleAssignmentId}' \ -H 'Authorization: Bearer ' ``` ## Eliminar una asignación de funciones[​](#eliminar-una-asignación-de-funciones "Enlace directo a 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}`](https://docs.equinix.com/es/api-catalog/accessv1/v1-role-assignment/deleteroleassignment.md) punto final. Ejemplo de solicitud cURL: ``` curl -X DELETE 'https://access.eqix.equinix.com/v1/roleAssignments/roleassignment:{roleAssignmentId}' \ -H 'Authorization: Bearer ' ```