# OIDC e Funções Se você estiver usando controle de acesso baseado em funções, poderá atribuir funções principais do OIDC para dar acesso à sua infraestrutura Equinix. Em seguida, quando o principal do OIDC realizar [uma troca de token](https://docs.equinix.com/pt-BR/equinix-api/oidc-api-authentication.md) , use o `roleassignments:` para o parâmetro Scope. Se o principal tiver atribuições de função na organização, a troca de tokens emitirá um token ao portador. As permissões necessárias para atribuir e gerenciar funções são: * Controle de acesso baseado em função - A `IAM Admin` função. * Controle de acesso baseado em atributos - uma política de acesso que contém: `use/createRoleAssignment`, `use/listRoleAssignments`, `use/getRoleAssignment`, `use/deleteRoleAssignment`. ## Vagas disponíveis[​](#vagas-disponíveis "Link direto para Vagas disponíveis") Para listar todas as funções, envie uma `GET` solicitação para o [`/v1/roles`](https://docs.equinix.com/pt-BR/api-catalog/accessv1/v1-role/listroles.md) terminal. Exemplo de solicitação cURL: ``` curl -X GET 'https://access.eqix.equinix.com/v1/roles' \ -H 'Authorization: Bearer ' ``` Para listar as funções disponíveis em um projeto específico, envie uma `GET` solicitação para o [`/v1/projects/{projectId}/roles`](https://docs.equinix.com/pt-BR/api-catalog/accessv1/v1-role/listrolesbyprojectid.md) terminal. Exemplo de solicitação cURL: ``` curl -X GET 'https://access.eqix.equinix.com/v1/projects/project:{projectId}/roles' \ -H 'Authorization: Bearer ' ``` A resposta contém o ID da função e o escopo da atribuição. O `assignmentScope.type` campo lista os possíveis escopos de atribuição permitidos para essa função na seguinte lista: `assignmentScopeType=PDS_ORG``assignmentScopeType=ORGANIZATION`, , `assignmentScopeType=PROJECT`, `assignmentScopeType=BILLING_ACCOUNT`, `assignmentScopeType=SUBSCRIPTION_KEY`, , `assignmentScopeType=PORT`. O `assignmentScope.id` é o ID exclusivo desse escopo. Ao criar uma atribuição de função, você precisa especificar o ID do projeto e as informações de escopo. ## Criar uma atribuição de função[​](#criar-uma-atribuição-de-função "Link direto para Criar uma atribuição de função") Para criar uma atribuição de função, envie uma `POST` solicitação para o [`/v1/roleAssignments`](https://docs.equinix.com/pt-BR/api-catalog/accessv1/v1-role-assignment/createroleassignment.md) terminal. Exemplo de solicitação 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 atribuições de funções[​](#lista-de-atribuições-de-funções "Link direto para Lista de atribuições de funções") Para listar todas as atribuições de função para um tipo de escopo de atribuição, envie uma `GET` solicitação ao [`/v1/roleAssignments`](https://docs.equinix.com/pt-BR/api-catalog/accessv1/v1-role-assignment/listroleassignments.md)terminal. Use os `assignmentScopeId`parâmetros de consulta e `assignmentScopeType`para limitar a resposta ao tipo de escopo especificado. Exemplo de solicitação cURL: ``` curl -X GET 'https://access.eqix.equinix.com/v1/roleAssignments?assignmentScopeId=&assignmentScopeType=' \ -H 'Authorization: Bearer ' ``` ## Obtenha detalhes sobre a atribuição de função.[​](#obtenha-detalhes-sobre-a-atribuição-de-função "Link direto para Obtenha detalhes sobre a atribuição de função.") Para obter os detalhes de uma atribuição de função específica, envie uma `GET` solicitação para o [`/v1/roleAssignments/{roleAssignmentId}`](https://docs.equinix.com/pt-BR/api-catalog/accessv1/v1-role-assignment/getroleassignment.md) terminal. Exemplo de solicitação cURL: ``` curl -X GET 'https://access.eqix.equinix.com/v1/roleAssignments/{roleassignment:roleAssignmentId}' \ -H 'Authorization: Bearer ' ``` ## Excluir uma atribuição de função[​](#excluir-uma-atribuição-de-função "Link direto para Excluir uma atribuição de função") Ao excluir uma atribuição de função, o usuário do OIDC perde o acesso às permissões concedidas pela função. Para excluir uma atribuição de função, envie uma `DELETE` solicitação ao [`/v1/roleAssignments/{roleAssignmentId}`](https://docs.equinix.com/pt-BR/api-catalog/accessv1/v1-role-assignment/deleteroleassignment.md) terminal. Exemplo de solicitação cURL: ``` curl -X DELETE 'https://access.eqix.equinix.com/v1/roleAssignments/roleassignment:{roleAssignmentId}' \ -H 'Authorization: Bearer ' ```