Intégrer avec Azure Management API

Le service Azure Management API vous permet de créer de nouvelles API ou d’importer des définitions d’API existantes et de les publier pour qu’elles soient utilisées par les audiences approuvées. Auth0 facilite l’autorisation des utilisateurs de votre API (à l’aide des normes OAuth 2.0).

Dans ce tutoriel, vous apprendrez à utiliser Auth0 pour authentifier et autoriser les utilisateurs lorsqu’ils accèdent à une API de calculatrice de base gérée par Azure Management API.

Vous devez créer une API dans Auth0 pour représenter l’API gérée par Azure Management API. Pour en savoir plus, lisez Enregistrer des API.

1. Naviguez vers Auth0 Dashboard > Applications > API, et sélectionnez Créer une API.

2. Établissez les paramètres suivants :

   Champ	Valeur
   Nom	Basic Calculator
   Identifiant	basic-calculator
   Algorithme de signature	RS256

3. Sélectionnez Créer.

Vous devrez créer une application Web ordinaire (RWA) dans Auth0 pour communiquer avec le serveur d’autorisation OAuth 2.0 dans Azure :

1. Naviguez vers Auth0 Dashboard > Applications > Applications, et sélectionnez le bouton Créer une application.

2. Saisissez un Nom pour votre application et sélectionnez Applications Web ordinairespour le type d’application.

Vous devrez créer une connexion dans Auth0 et l’activer pour votre application :

1. Allez à Auth0 Dashboard > Authentification > Base de données et sélectionnez Créer une connexion DB.

2. Saisissez un Nom pour votre connexion. Nous vous suggérons de choisir un nom qui reflète la source des utilisateurs (par exemple Facebook pour une connexion qui contient des utilisateurs utilisant leurs informations d’identification Facebook ou site-sign-ups pour une connexion de base de données où les utilisateurs s’inscrivent sur votre site).

3. Sélectionnez Créer.

4. Accédez à la page Paramètres de votre connexion.

5. Passez à la vue Applications, où vous verrez une liste de toutes les applications de votre locataire.

6. Basculez l’application que vous avez créée précédemment pour l’activer pour la connexion.

Vous devez avoir au moins un utilisateur sur votre connexion pour tester l’authentification et l’autorisation. Si vous ne disposez pas d’un ensemble d’utilisateurs pour la connexion, vous pouvez en créer un manuellement :

1. Naviguez vers Auth0 Dashboard > Gestion des utilisateurs > Utilisateurs, et sélectionnez Créer un utilisateur.

2. Saisissez un Courriel et un Mot de passe, et sélectionnez la connexion créée à l’étape 3 dans le champ Connexion.

3. Sélectionnez Créer.

Vous devrez créer une instance de service API Management dans Azure pour gérer votre API :

1. Dans la barre de navigation, sélectionnez Créer une ressource.

2. Une fois redirigé, sélectionnez Web > Gestion de l’API.

3. Fournissez les variables de configuration suivantes :

   Paramètre	Description
   Name	Le nom de votre service (qui sera également utilisé pour créer l’URL dont vous avez besoin pour accéder au service)
   Subscription	Le plan d’abonnement Entra que vous utiliserez avec le service
   Resource Group_	La collection de ressources partageant un cycle de vie, des autorisations et des politiques. Vous pouvez utiliser un groupe de ressources existant ou en créer un nouveau (vous devrez fournir un nom pour le groupe si vous en créez un nouveau)
   Location	Choisissez l’emplacement qui dessert votre instance d’API
   Organization name	The name of your organisation
   Administrator email	L’adresse courriel de la personne qui administrera cette instance
   Pricing tier	Le niveau de tarification que vous souhaitez, qui détermine le nombre d’appels que vous pouvez faire à votre API, ainsi que la quantité maximale de transfert de données autorisée. Vous devez opter pour le plan Developer ou un plan supérieur; le plan Consumption n’offre pas suffisamment de fonctionnalités pour que cette intégration fonctionne.

4. Sélectionnez Créer pour commencer la fourniture de votre service (cette opération peut prendre jusqu’à 15 minutes).

Pour ce tutoriel, nous importerons et utiliserons l’API de Basic Calculator fournie par Microsoft. Pour des instructions détaillées, voir Importer et publier votre première API de Microsoft.

Lorsque vous avez terminé, sélectionnez Créer pour importer votre API. Vous serez redirigé vers la page de résumé de votre API lorsqu’elle sera entièrement importée.

Pour utiliser Auth0 afin de sécuriser votre API Azure, vous devez enregistrer Auth0 en tant que serveur d’autorisation OAuth 2.0 :

1. Trouvez la zone OAuth 2.0 + OpenID Connect de votre instance de service API Management près de la barre de navigation. Sélectionnez OAuth 2.0, puis sélectionnez Ajouter.

2. Accédez à l’écran de configuration Ajouter un service OAuth2 et sélectionnez le type de subvention de code d’autorisation.

3. Établissez les paramètres suivants :

   Paramètre	Description
   Nom d’affichage	Saisissez un nom descriptif pour votre serveur d’autorisation, tel que Auth0.
   Identifiant	Ce champ devrait se remplir automatiquement en fonction du nom d’affichage que vous avez fourni.
   Description	Saisissez une description de votre serveur d’autorisation, par exemple Auth0 API Authentication.
   URL de la page d’inscription client	Saisissez https://placeholder.contoso.com comme espace réservé.
   Types de consentement de code d’autorisation	Sélectionnez Authorization code.
   URL de point de terminaison d’autorisation	Reportez-vous à Point de terminaison de découverte OIDC de votre locataire et ajoutez le paramètre audience. Par exemple : https://{yourDomain}/authorize?audience={API_AUDIENCE}.
   Authorization request method(Méthode de requête d’autorisation)	La valeur par défaut est GET.
   URL du point de terminaison du jeton	Reportez-vous à Point de terminaison de découverte OIDC de votre locataire.
   Méthodes d’authentification de votre client	Choisir Basic.
   Méthode d’envoi d’un jeton d’accès	Choisir Authorization header.
   Permission par défaut	Spécifiez une permission scope par défaut , si requis.

4. Dans la section Client Credentials (Identifiants du client), saisissez l’ID client des applications Auth0 dans le champ Client ID (ID client) et le secret du client dans le champ Client secret (Secret du client).

5. Passez à la vue URI de redirection et copiez la valeur de l’URI dans le champ Octroi de flux de code d’autorisation.

6. Sélectionnez Créer.

Après avoir créé votre serveur d’autorisation OAuth 2.0 dans Azure, vous devrez mettre à jour votre API Azure afin d’utiliser Auth0 pour l’autorisation de l’utilisateur :

1. Dans la section API de la navigation, sélectionnez API.

2. Sélectionnez l’API de Basic Calculator et passez à la vue Conception.

3. Passez à la vue Paramètres .

4. Naviguez jusqu’à la section Sécurité et sélectionnez OAuth 2.0sous Autorisation de l’utilisateur.

5. Sélectionnez le serveur que vous avez configuré à l’étape précédente dans le champ Serveur d’autorisation.

6. Cliquez sur Enregistrer.

Une fois votre API Azure fournie et configurée pour utiliser Auth0 pour l’autorisation des utilisateurs, vous devrez mettre à jour votre application Auth0.

1. Naviguez jusqu’à Auth0 Dashboard > Applications > Applications.

2. Sélectionnez votre application et passez à la vue Paramètres.

3. Saisissez l’URI de redirection que vous avez copié précédemment dans le champ URL de rappel autorisées.

4. Cliquez sur Enregistrer.

Dans le portail Azure, ouvrez votre instance du service API Management.

1. Sélectionnez Console du développeur pour lancer le côté développeur de vos API.

2. Allez sur API > Basic Calculator. Vous accédez à la page où vous pouvez effectuer un appel GET qui vous permet d’ajouter deux nombres entiers.

3. Sélectionnez Essayer. Ceci ouvre la page où vous pouvez fournir les paramètres de votre appel.

4. Naviguez jusqu’à la section Autorisation et sélectionnez Code d’autorisation (à côté du champ Auth0).

5. Une fenêtre contextuelle apparaîtra avec le gadget logiciel de connexion Auth0 (si ce n’est pas le cas, assurez-vous que les bloqueurs de fenêtres contextuelles sont désactivés dans votre navigateur). Saisissez les informations d’identification de l’utilisateur Auth0 que vous avez créé à l’étape 4 et connectez-vous.

6. Si vous avez réussi à vous connecter, un message s’affichera avec la date d’expiration du jeton d’accès que vous pouvez utiliser pour appeler votre API.

7. Naviguez vers le bas et sélectionnez Envoyer. Si la demande aboutit, vous verrez un message contenant la réponse HTTP 200 au bas de la page.

À l’étape précédente, l’utilisateur est invité à se connecter lorsqu’il tente d’effectuer un appel à partir de la console de développement. La console de développement tente d’obtenir un jeton d’accès au nom de l’utilisateur pour l’inclure dans la demande d’API. Tous les jetons d’accès seront transmis à l’API via l’en-tête Authorization.

Si vous souhaitez valider le jeton d’accès inclus dans chaque demande, vous pouvez le faire en utilisant la politique Validation JWT. Veuillez consulter la documentation de Microsoft sur la définition d’une politique de Management API.