Passer au contenu principal

Authentification de l'API de l'OIDC

Les API Equinix utilisent le protocole OAuth 2,0 pour authentifier les demandes de votre utilisateur OIDC auprès des terminaux API. Pour interagir avec les API Equinix, vous avez besoin d'un jeton d'accès porteur.

Conditions préalables​

  1. Un fournisseur OIDC .

  2. Un jeton d'identification OIDC de votre fournisseur OIDC enregistré.

  3. Autorisations spécifiques au produit ou au service pour spécifier l'étendue du jeton d'accès API. Vous avez besoin de :

    • ern:<access-policy-ern> où <access-policy-ern> est une stratégie d'accès unique qui a été accordée à l'entité de sécurité.
    • roleassignments:<org-id> Où <org-id> est l'identifiant de l'organisation à laquelle l'entité de sécurité OIDC a attribué des rôles.
    • projectpolicies:<project-id> Où <project-id> est un identifiant de projet pour lequel l'entité de sécurité OIDC a obtenu une ou plusieurs politiques d'accès.
    • orgpolicies:<org-id> Où <org-id> est un identifiant d'organisation pour lequel l'entité de sécurité s'est vu accorder une ou plusieurs stratégies d'accès.
    • orgpolicies:<org-id> roleassignments:<org-id> Où <org-id> est un identifiant d'organisation pour lequel l'entité de sécurité a obtenu à la fois des rôles et des stratégies d'accès.

    Pour plus d'informations, reportez-vous à la rubrique étendues de contrôle d'accès .

Demander un jeton d'accès​

Pour demander un jeton d’accès porteur, envoyez une POST demande au /v1/tokenpoint final.

Dans le corps de la demande, indiquez :

  • grant_type - À utiliser urn:ietf:params:oauth:grant-type:token-exchange pour recevoir un jeton d'accès.
  • scope (Obligatoire) - indiquez le champ d'application. Les autorisations accordées par le jeton sont vérifiées par rapport au fait que l'entité de sécurité a reçu les rôles ou les stratégies d'accès appropriés. Pour plus d'informations, reportez-vous à la rubrique étendues de contrôle d'accès .
  • subject_token - Le jeton d'identifiant OIDC.
  • subject_token_type - Utilisation urn:ietf:params:oauth:token-type:id_token qui identifie votre subject_token comme jeton d'identifiant OIDC.

Exemple de requête 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>'

Utilisation de jetons d'accès​

Pour interagir avec Equinix API, envoyez votre jeton d’accès dans l’en-tête autorisation de la demande HTTP avec Authorization: Bearer <token>.

Cette page vous a-t-elle été utile ?