Authentification de l'API 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
-
Un fournisseur OIDC .
-
Un jeton d'identification OIDC fourni par votre fournisseur OIDC enregistré.
-
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 .
Demande d'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 requête, veuillez préciser:
grant_type- À utiliserurn:ietf:params:oauth:grant-type:token-exchangepour 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- Utilisationurn:ietf:params:oauth:token-type:id_tokenqui identifie votresubject_tokencomme 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 des 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>.