Remarque
L’accès à cette page requiert une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page requiert une autorisation. Vous pouvez essayer de modifier des répertoires.
Pendant le développement local, les applications doivent s’authentifier auprès d’Azure pour utiliser différents services Azure. Authentifiez-vous localement à l’aide de l’une des approches suivantes :
- Utilisez un compte de développeur avec l’un des outils de développement pris en charge par la bibliothèque Azure Identity.
- Utilisez un service principal.
Cet article explique comment s’authentifier à l’aide d’un compte de développeur avec des outils pris en charge par la bibliothèque Azure Identity. Dans les sections suivantes, vous allez apprendre :
- Comment utiliser des groupes Microsoft Entra pour gérer efficacement les autorisations pour plusieurs comptes de développeur.
- Comment attribuer des rôles à des comptes de développeurs pour définir les autorisations.
- Comment se connecter aux outils de développement locaux pris en charge.
- Comment s’authentifier à l’aide d’un compte de développeur à partir de votre code d’application.
Outils de développement pris en charge pour l’authentification
Pour qu’une application s’authentifie auprès d’Azure pendant le développement local à l’aide des informations d’identification Azure du développeur, le développeur doit être connecté à Azure à partir de l’un des outils de développement suivants :
- Azure CLI
- Azure CLI pour développeurs
La bibliothèque Azure Identity peut détecter que le développeur est connecté à partir de l’un de ces outils. La bibliothèque peut ensuite obtenir le jeton d’accès Microsoft Entra via l’outil pour authentifier l’application auprès d’Azure en tant qu’utilisateur connecté.
Cette approche tire parti des comptes Azure existants du développeur pour simplifier le processus d’authentification. Toutefois, le compte d’un développeur a probablement plus d’autorisations que nécessaire par l’application, ce qui dépasse les autorisations avec laquelle l’application s’exécute en production. En guise d’alternative, vous pouvez créer des principaux de service d’application à utiliser pendant le développement local, qui peuvent être limités pour avoir uniquement l’accès nécessaire par l’application.
Créer un groupe Microsoft Entra pour le développement local
Créez un groupe Microsoft Entra pour encapsuler les rôles (autorisations) dont l’application a besoin dans le développement local plutôt que d’affecter les rôles à des objets de principal de service individuels. Cette approche offre les avantages suivants :
- Chaque développeur a les mêmes rôles attribués au niveau du groupe.
- Si un nouveau rôle est nécessaire pour l’application, il doit uniquement être ajouté au groupe de l’application.
- Si un nouveau développeur rejoint l’équipe, un nouveau principal du service d’application est créé pour le développeur et ajouté au groupe, ce qui garantit que le développeur dispose des autorisations appropriées pour travailler sur l’application.
Accédez à la page de présentation Microsoft Entra ID dans le portail Azure.
Sélectionnez Tous les groupes dans le menu de gauche.
Dans la page Groupes , sélectionnez Nouveau groupe.
Dans la page Nouveau groupe , renseignez les champs de formulaire suivants :
- Type de groupe : sélectionnez Sécurité.
- Nom du groupe : entrez un nom pour le groupe qui inclut une référence à l’application ou au nom de l’environnement.
- Description du groupe : entrez une description qui explique l’objectif du groupe.
Sélectionnez le lien Aucun membre sélectionné sous Membres pour ajouter des membres au groupe.
Dans le volet volant qui s’ouvre, recherchez le principal de service que vous avez créé précédemment et sélectionnez-le dans les résultats filtrés. Choisissez le bouton Sélectionner en bas du panneau pour confirmer votre sélection.
Sélectionnez Créer en bas de la page Nouveau groupe pour créer le groupe et revenir à la page Tous les groupes . Si vous ne voyez pas le nouveau groupe répertorié, attendez un instant et actualisez la page.
Attribuer des rôles au groupe
Ensuite, déterminez les rôles (autorisations) dont votre application a besoin sur les ressources et attribuez ces rôles au groupe Microsoft Entra que vous avez créé. Les groupes peuvent être affectés à un rôle au niveau de la ressource, du groupe de ressources ou de l’étendue de l’abonnement. Cet exemple montre comment attribuer des rôles à l’étendue du groupe de ressources, car la plupart des applications regroupent toutes leurs ressources Azure dans un seul groupe de ressources.
Dans le portail Azure, accédez à la page Vue d’ensemble du groupe de ressources qui contient votre application.
Dans le menu de navigation de gauche, sélectionnez Contrôle d’accès (IAM) .
Dans la page Contrôle d’accès (IAM), sélectionnez + Ajouter , puis choisissez Ajouter une attribution de rôle dans le menu déroulant. La page Ajouter une attribution de rôle fournit plusieurs onglets pour configurer et attribuer des rôles.
Sous l’onglet Rôle , utilisez la zone de recherche pour localiser le rôle que vous souhaitez attribuer. Sélectionnez le rôle, puis choisissez Suivant.
Sous l’onglet Membres :
- Pour la valeur Attribuer l’accès à, sélectionnez Utilisateur, groupe ou principal de service.
- Pour la valeur Membres , choisissez + Sélectionner des membres pour ouvrir le volet volant Sélectionner des membres .
- Recherchez le groupe Microsoft Entra que vous avez créé précédemment et sélectionnez-le dans les résultats filtrés. Choisissez Sélectionner pour choisir le groupe et fermer le volet déroulant.
- Sélectionnez Vérifier + affecter en bas de l’onglet Membres .
Sous l’onglet Révision + affectation , sélectionnez Vérifier + affecter en bas de la page.
Connectez-vous à Azure à l’aide d’outils de développement
Ensuite, connectez-vous à Azure à l’aide de l’un des outils de développement que vous pouvez utiliser pour effectuer l’authentification dans votre environnement de développement. Le compte que vous authentifiez doit également exister dans le groupe Microsoft Entra que vous avez créé et configuré précédemment.
Les développeurs peuvent utiliser Azure CLI pour s’authentifier. Applications qui utilisent DefaultAzureCredential ou AzureCLICredential peuvent ensuite utiliser ce compte pour authentifier les demandes d’application.
Pour vous authentifier auprès d’Azure CLI, exécutez la az login commande. Sur un système avec un navigateur web par défaut, Azure CLI lance le navigateur pour authentifier l’utilisateur.
az login
Pour les systèmes sans navigateur web par défaut, la commande az login utilise le flux d’authentification du code d’appareil. Vous pouvez également forcer l’Azure CLI à utiliser le flux de code de l’appareil plutôt que de lancer un navigateur en spécifiant l’argument --use-device-code.
az login --use-device-code
S’authentifier auprès des services Azure à partir de votre application
Le crate azure_identity fournit différentes informations d’identification adaptées à différents scénarios et aux flux d’authentification Microsoft Entra. Les étapes suivantes montrent comment utiliser DeveloperToolsCredential ou utiliser des informations d’identification d’outil spécifiques lors de l’utilisation locale.
Implémenter le code
Pour authentifier les objets clients du SDK Azure à Azure, votre application doit utiliser des informations d’identification de la crate azure_identity.
DeveloperToolsCredentialtente de s’authentifier à l’aide d’une série d’outils de développement tels que le Azure CLI et s’arrête lorsqu’un utilisateur réussit.
Ajoutez le crate
azure_identityà votre projet.cargo add azure_identityPour tout code Rust qui crée un objet client Kit de développement logiciel (SDK) Azure, vous souhaitez :
- Importez le
azure_identitycrate. - Créez une instance de
DeveloperToolsCredentialou des informations d’identification d’un outil spécifique. - Transmettez l’instance d’informations d’identification au constructeur client du Kit de développement logiciel (SDK) Azure.
Pour utiliser
DeveloperToolsCredential, qui tente Azure CLI et Azure Developer CLI en séquence :use azure_identity::DeveloperToolsCredential; fn main() -> Result<(), Box<dyn std::error::Error>> { let credential = DeveloperToolsCredential::new(None)?; Ok(()) }Vous pouvez également utiliser des informations d’identification spécifiques telles que
AzureCliCredentialouAzureDeveloperCliCredential:use azure_identity::AzureCliCredential; fn main() -> Result<(), Box<dyn std::error::Error>> { let credential = AzureCliCredential::new(None)?; // or // use azure_identity::AzureDeveloperCliCredential; // let credential = AzureDeveloperCliCredential::new(None)?; Ok(()) }
- Importez le
L’exemple suivant illustre l’authentification d’un Key Vault SecretClient à l’aide de DeveloperToolsCredential :
use azure_identity::DeveloperToolsCredential;
use azure_security_keyvault_secrets::SecretClient;
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
// Create a credential
let credential = DeveloperToolsCredential::new(None)?;
// Create a client for the specified Key Vault
let client = SecretClient::new(
"https://<your-key-vault-name>.vault.azure.net/",
credential.clone(),
None,
)?;
// Use the client to interact with Azure Key Vault
// let secret = client.get("secret-name", None).await?;
Ok(())
}