Gérer l’authentification dans Azure Maps

Lorsque vous créez un compte Azure Maps, votre ID client et vos clés partagées sont créés automatiquement. Ces valeurs sont requises pour l’authentification lors de l’utilisation de l’ID Microsoft Entra ou de l’authentification par clé partagée.

Prerequisites

Connectez-vous au portail Azure. Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.

• Une familiarisation avec les identités managées pour les ressources Azure. Veillez à comprendre les deux types d’identité managée et comment ils diffèrent.
• Un compte Azure Maps.
• Une familiarisation avec l’authentification Azure Maps.

Afficher les détails de l’authentification

Pour afficher les détails de votre authentification Azure Maps :

1. Connectez-vous au portail Azure.

2. Sélectionnez toutes les ressources dans la section services Azure , puis sélectionnez votre compte Azure Maps.

   

3. Sélectionnez Authentification dans la section paramètres du volet gauche.

   

Choisir une catégorie d’authentification

En fonction des besoins de votre application, il existe des voies spécifiques pour la sécurité des applications. Microsoft Entra ID définit des catégories d’authentification spécifiques pour prendre en charge un large éventail de flux d’authentification. Pour choisir la meilleure catégorie pour votre application, consultez les catégories d’applications.

Comment ajouter et supprimer des identités managées

Pour activer l’authentification par jeton de signature d’accès partagé (SAP) avec l’API REST Azure Maps, vous devez ajouter une identité managée affectée par l’utilisateur à votre compte Azure Maps.

Créer une identité managée

Vous pouvez créer une identité managée affectée par l’utilisateur avant ou après la création d’un compte Maps. Vous pouvez ajouter l’identité managée via le portail, les sdk de gestion Azure ou le modèle Azure Resource Manager (ARM). Pour ajouter une identité managée affectée par l’utilisateur via un modèle ARM, spécifiez l’identificateur de ressource de l’identité managée affectée par l’utilisateur.

"identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
        "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/example/providers/Microsoft.ManagedIdentity/userAssignedIdentities/exampleidentity": {}
    }
}

Supprimer une identité managée

Vous pouvez supprimer une identité affectée par le système en désactivant la fonctionnalité via le portail ou le modèle Azure Resource Manager de la même façon qu’elle a été créée. Les identités attribuées par l’utilisateur peuvent être supprimées individuellement. Pour supprimer toutes les identités, définissez le type d’identité sur "None".

La suppression d’une identité affectée par le système de cette façon le supprime également de l’ID Microsoft Entra. Les identités affectées par le système sont également supprimées automatiquement de l’ID Microsoft Entra lorsque le compte Azure Maps est supprimé.

Pour supprimer toutes les identités à l’aide du modèle Azure Resource Manager, mettez à jour cette section :

"identity": {
    "type": "None"
}

Choisir un scénario d’authentification et d’autorisation

Ce tableau décrit les scénarios d’authentification et d’autorisation courants dans Azure Maps. Chaque scénario décrit un type d’application qui peut être utilisé pour accéder à l’API REST Azure Maps. Utilisez les liens pour découvrir des informations de configuration détaillées pour chaque scénario.

Afficher les définitions de rôle Azure Maps intégrées

Pour afficher la définition de rôle Azure Maps intégrée :

1. Dans le volet gauche, sélectionnez Contrôle d’accès (IAM) .

2. Sélectionnez l’onglet Rôles.

3. Dans la zone de recherche, entrez Azure Maps.

Les résultats affichent les définitions de rôle intégrées disponibles pour Azure Maps.

Voir les attributions de rôles

Pour afficher les utilisateurs et les applications auxquels l’accès a été accordé pour Azure Maps, accédez au contrôle d’accès (IAM). Là, sélectionnez Attributions de rôles, puis filtrez par Azure Maps.

1. Dans le volet gauche, sélectionnez Contrôle d’accès (IAM) .

2. Sélectionnez l’onglet Attributions de rôles.

3. Dans la zone de recherche, entrez Azure Maps.

Les résultats affichent les attributions de rôles Azure Maps actuelles.

Demander des jetons pour Azure Maps

Demandez un jeton à partir du point de terminaison de jeton Microsoft Entra. Dans votre demande d’ID Microsoft Entra, utilisez les détails suivants :

Pour plus d’informations sur la demande de jetons d’accès à partir de l’ID Microsoft Entra pour les utilisateurs et les principaux de service, consultez scénarios d’authentification pour l’ID Microsoft Entra. Pour afficher des scénarios spécifiques, consultez la table des scénarios.

Gérer et faire pivoter les clés partagées

Vos clés d’abonnement Azure Maps sont similaires à un mot de passe racine pour votre compte Azure Maps. Veillez toujours à protéger vos clés d’abonnement. Utilisez Azure Key Vault pour gérer et faire pivoter vos clés en toute sécurité. Évitez de distribuer des clés d’accès à d’autres utilisateurs, de les coder en dur ou de les enregistrer n’importe où en texte brut accessible à d’autres utilisateurs. Si vous pensez que vos clés ont peut-être été compromises, faites-les pivoter.

Faire pivoter manuellement les clés d’abonnement

Pour sécuriser votre compte Azure Maps, nous vous recommandons de faire pivoter régulièrement vos clés d’abonnement. Si possible, utilisez Azure Key Vault pour gérer vos clés d’accès. Si vous n’utilisez pas Key Vault, vous devez faire pivoter manuellement vos clés.

Deux clés d’abonnement sont attribuées pour que vous puissiez faire pivoter vos clés. Le fait de disposer de deux clés garantit que votre application conserve l’accès à Azure Maps tout au long du processus.

Pour faire pivoter vos clés d’abonnement Azure Maps dans le portail Azure :

1. Mettez à jour le code de votre application pour référencer la clé secondaire du compte Azure Maps et déployer.
2. Dans le portail Azure, accédez à votre compte Azure Maps.
3. Sous Paramètres, sélectionnez Authentication.
4. Pour régénérer la clé primaire de votre compte Azure Maps, sélectionnez le bouton Régénérer en regard de la clé primaire.
5. Mettez à jour le code de votre application pour référencer la nouvelle clé primaire et déployer.
6. Régénérez la clé secondaire de la même manière.

Étapes suivantes

Recherchez les métriques d’utilisation de l’API pour votre compte Azure Maps :

Explorez des échantillons qui montrent comment intégrer Microsoft Entra ID à Azure Maps :