Ir para o conteúdo principal

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​

  1. Um provedor de OIDC .

  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:<access-policy-ern> onde <access-policy-ern> é uma política de acesso único que foi concedida ao principal.
    • roleassignments:<org-id> Onde <org-id> está o ID da organização para a qual o diretor do OIDC atribuiu funções.
    • projectpolicies:<project-id> Onde <project-id> é um ID de projeto em que o principal do OIDC recebeu uma política de acesso ou políticas de acesso.
    • orgpolicies:<org-id> Onde <org-id> é um ID da organização em que o principal recebeu uma política de acesso ou políticas de acesso.
    • orgpolicies:<org-id> roleassignments:<org-id> Onde <org-id> é 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 .

Solicitação de um token de acesso​

Para solicitar um token de acesso ao portador, envie uma POST solicitação ao /v1/tokenterminal.

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 .
  • 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=<role_or_access_policy>' \
--data-urlencode 'subject_token=<oidc_id_token>'

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 <token>.

Esta página foi útil?