Authentification avec OAuth

Authentification avec Entra ID

Importante

En juin 2022, nous avons introduit l’authentification multifacteur comme exigence pour Bing Ads. Vous devrez peut-être encore apporter une modification au code afin de vous conformer à cette exigence. Microsoft Advertising effectue des vérifications d’application technique début octobre.

Ce billet de blog décrit les étapes à suivre pour garantir la conformité.

Pour plus d’informations, consultez le guide des exigences en matière d’authentification multifacteur .

Remarque

Les API Microsoft Advertising utilisent Azure Entra ID (anciennement Azure AD) pour l’authentification. Si vous rencontrez des problèmes liés à l’inscription d’applications, à l’accès client, au consentement administrateur ou à l’acquisition d’un jeton OAuth, contactez le support Azure ou votre administrateur client.

Prenons l’utilisateur auquel vous voulez vous connecter, par exemple. example@contoso.com L’API Bing Ads n’accepte pas cette adresse de courrier et ce mot de passe. Au lieu de cela, vous devez définir l’élément d’en-tête AuthenticationToken qui contient un jeton d’accès utilisateur. Vous pouvez imaginer un jeton d’accès comme représentant un nom d’utilisateur et un mot de passe.

Comment obtenir un jeton d’accès pour un utilisateur ? En tant que développeur d’applications, vous utilisez une URL d’autorisation Microsoft pour inviter l’utilisateur Microsoft Advertising à donner son consentement. Une fois qu’un utilisateur a donné son consentement, vous pouvez obtenir un jeton d’accès et agir en son nom.

Microsoft Advertising utilise le point de terminaison Plateforme d'identités Microsoft pour les développeurs et le protocole OAuth 2.0 pour authentifier les comptes professionnels ou scolaires à partir de Azure Active Directory (AAD) et de comptes Microsoft personnels (MSA), tels que hotmail.com, outlook.com et msn.com.

  1. Inscrire une application

  2. Demander le consentement de l’utilisateur pour que votre application gère ses comptes Microsoft Advertising

  3. Obtenir des jetons d’accès et d’actualisation

  4. Effectuer votre premier appel d’API

Conseil

Pour plus d’informations sur l’obtention de jetons d’accès et d’actualisation à l’aide des SDK Bing Ads, consultez Authentification avec les SDK.

Étapes suivantes (ID Entra)

Authentification avec Google OAuth

Les API Microsoft Advertising prennent en charge Google OAuth 2.0 en tant qu’option d’authentification supplémentaire, ainsi que l’identité Microsoft (ID Azure Entra).

  • Google OAuth est ajouté en tant que fournisseur d’identité alternatif, et non en remplacement.
  • Identité Microsoft OAuth continue d’être pris en charge sans modification de comportement.
  • Google OAuth 2.0 est une nouvelle option d’authentification prise en charge.
  • Un nouvel en-tête de demande, IdentityProvider, est introduit.
  • L’exigence de jeton de développeur reste inchangée.
  1. Inscrire une application

  2. Demandez le consentement des utilisateurs pour que votre application gère leurs comptes Google.

  3. Obtenir des jetons d’accès et d’actualisation

  4. Effectuer votre premier appel d’API

Étapes suivantes (Google OAuth)

Voir aussi

Prise en main