# Autenticação da API OIDC As APIs da Equinix usam o protocolo OAuth 2,0 para autenticar as solicitações do seu usuário OIDC para endpoints API. Para interagir com as APIs Equinix, você precisa de um token de acesso ao portador. ## Pré-requisitos[​](#pré-requisitos "Link direto para Pré-requisitos") 1. Um [provedor de OIDC](https://docs.equinix.com/pt-BR/iam/oidc/create-oidc-provider.md) . 2. Um token de identificação OIDC do seu provedor OIDC registrado. 3. Permissões específicas do produto ou serviço para especificar o escopo do token de acesso API. Você precisa de: * `ern:` onde `` é uma política de acesso único que foi concedida ao principal. * `roleassignments:` Onde `` está o ID da organização para a qual o diretor do OIDC atribuiu [funções](https://docs.equinix.com/pt-BR/iam/oidc/oidc-for-roles.md). * `projectpolicies:` Onde `` é um ID de projeto em que o principal do OIDC recebeu uma [política de acesso](https://docs.equinix.com/pt-BR/iam/oidc/oidc-access-policies.md) ou políticas de acesso. * `orgpolicies:` Onde `` é um ID da organização em que o principal recebeu uma política de acesso ou políticas de acesso. * `orgpolicies: roleassignments:` Onde `` é um ID da organização em que o principal recebeu funções e políticas de acesso. Para obter mais informações, consulte [Escopos de controle de acesso](https://docs.equinix.com/pt-BR/iam/oidc/overview.md#access-control-scopes) . ## Solicitação de um token de acesso[​](#solicitação-de-um-token-de-acesso "Link direto para Solicitação de um token de acesso") Para solicitar um token de acesso ao portador, envie uma `POST` solicitação ao [`/v1/token`](https://docs.equinix.com/pt-BR/api-catalog/stsv1/v1-pre-auth/generateststoken.md)terminal. No corpo da solicitação, especifique: * `grant_type` - Use `urn:ietf:params:oauth:grant-type:token-exchange` para receber um token de acesso. * `scope` (Obrigatório) - Forneça o escopo. As permissões concedidas pelo token são verificadas em relação ao fato de o principal ter recebido as funções ou políticas de acesso apropriadas. Para obter mais informações, consulte [Escopos de controle de acesso](https://docs.equinix.com/pt-BR/iam/oidc/overview.md#access-control-scopes) . * `subject_token` - O token de ID do OIDC. * `subject_token_type` - Use `urn:ietf:params:oauth:token-type:id_token` que identifica seu `subject_token` como um token de ID OIDC. Exemplo de solicitação cURL: ``` curl -X POST 'https://sts.eqix.equinix.com/v1/token' \ --data-urlencode 'grant_type=urn:ietf:params:oauth:grant-type:token-exchange' \ --data-urlencode 'subject_token_type=urn:ietf:params:oauth:token-type:id_token' \ --data-urlencode 'scope=' \ --data-urlencode 'subject_token=' ``` ## Utilizando tokens de acesso[​](#utilizando-tokens-de-acesso "Link direto para Utilizando tokens de acesso") Para interagir com o Equinix API, envie seu token de acesso no cabeçalho de autorização da solicitação HTTP com `Authorization: Bearer `.