Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
L’approche recommandée pour authentifier une application hébergée par Azure auprès d’autres ressources Azure consiste à utiliser une identité managée. Cette approche est prise en charge pour la plupart des services Azure, y compris les applications hébergées sur Azure App Service, Azure Container Apps et Machines virtuelles Azure. Découvrez-en davantage sur les différentes techniques et approches d’authentification sur la page vue d’ensemble de l’authentification . Dans les sections suivantes, vous allez découvrir :
- Concepts essentiels de l’identité managée
- Comment créer une identité managée assignée par l'utilisateur pour votre application
- Comment attribuer des rôles à une identité managée assignée par l'utilisateur
- Comment s’authentifier à l’aide de l’identité managée affectée par l’utilisateur à partir de votre code d’application
Concepts essentiels de l’identité managée
Une identité managée permet à votre application de se connecter en toute sécurité à d’autres ressources Azure sans utiliser de clés secrètes ou d’autres secrets d’application. En interne, Azure effectue le suivi de l’identité et des ressources auxquelles il est autorisé à se connecter. Azure utilise ces informations pour obtenir automatiquement des jetons Microsoft Entra pour que l’application lui permette de se connecter à d’autres ressources Azure.
Il existe deux types d’identités managées à prendre en compte lors de la configuration de votre application hébergée :
- Les identités managées affectées par le système sont activées directement sur une ressource Azure et sont liées à son cycle de vie. Lorsque la ressource est supprimée, Azure supprime automatiquement l'identité pour vous. Les identités affectées par le système fournissent une approche minimaliste de l’utilisation d’identités managées.
- Les identités managées affectées par l’utilisateur sont créées en tant que ressources Azure autonomes et offrent une plus grande flexibilité ainsi que des fonctionnalités et des capacités accrues. Elles sont idéales pour les solutions impliquant plusieurs ressources Azure qui doivent partager les mêmes identités et autorisations. Par exemple, si plusieurs machines virtuelles doivent accéder au même ensemble de ressources Azure, une identité managée affectée par l’utilisateur fournit une réutilisation et une gestion optimisée.
Tip
En savoir plus sur la sélection et la gestion des identités managées affectées par le système et affectées par l’utilisateur dans l’article recommandations sur les meilleures pratiques d’identité managée .
Les sections suivantes décrivent les étapes permettant d’activer et d’utiliser une identité managée affectée par l’utilisateur pour une application hébergée Azure. Si vous devez utiliser une identité managée affectée par le système, consultez l’article sur les identités managées affectées par le système pour plus d’informations.
Créer une identité managée assignée à l'utilisateur
Les identités managées affectées par l’utilisateur sont créées en tant que ressources autonomes dans votre abonnement Azure à l’aide du portail Azure ou d’Azure CLI. Les commandes Azure CLI peuvent être exécutées dans Azure Cloud Shell ou sur une station de travail dans laquelle l’interface Azure CLI est installée.
Dans le portail Azure, entrez Identités managées dans la barre de recherche principale et sélectionnez le résultat correspondant sous la section Services.
Dans la page Identités managés, sélectionnez + Créer.
Dans la page Créer une identité managée affectée par l’utilisateur , sélectionnez un abonnement, un groupe de ressources et une région pour l’identité managée affectée par l’utilisateur, puis fournissez un nom.
Sélectionnez Vérifier + créer pour passer en revue et valider vos entrées.
Sélectionnez Créer pour créer l’identité managée affectée par l’utilisateur.
Une fois l’identité créée, sélectionnez Accéder à la ressource.
Dans la page Vue d’ensemble de la nouvelle identité, copiez la valeur de l’ID client à utiliser ultérieurement lorsque vous configurez le code de l’application.
Affecter l’identité managée à votre application
Une identité managée affectée par l’utilisateur peut être associée à une ou plusieurs ressources Azure. Toutes les ressources qui utilisent cette identité obtiennent les autorisations appliquées via les rôles de l’identité.
Dans le portail Azure, accédez à la ressource qui héberge le code de votre application, telle qu’une instance Azure App Service ou Azure Container Apps.
Dans la page Vue d’ensemble de la ressource, développez Paramètres et sélectionnez Identité dans le volet de navigation.
Dans la page Identité, basculez vers l’onglet Utilisateur affecté.
Sélectionnez + Ajouter pour ouvrir le panneau Ajouter une identité managée affectée par l’utilisateur .
Dans le panneau Ajouter une identité managée affectée par l’utilisateur , utilisez la liste déroulante Abonnement pour filtrer les résultats de recherche de vos identités. Utilisez la zone de recherche Utilisateur affecté aux identités managées pour rechercher l’identité managée affectée par l’utilisateur que vous avez activée pour la ressource Azure hébergeant votre application.
Sélectionnez l’identité et choisissez Ajouter en bas du panneau pour continuer.
Attribuer des rôles à l’identité managée
Ensuite, déterminez les rôles dont votre application a besoin et attribuez ces rôles à l’identité managée. Vous pouvez attribuer des rôles à une identité managée dans les étendues suivantes :
- Ressource : les rôles attribués s’appliquent uniquement à cette ressource spécifique.
- Groupe de ressources : les rôles attribués s’appliquent à toutes les ressources contenues dans le groupe de ressources.
- Abonnement : les rôles attribués s’appliquent à toutes les ressources contenues dans l’abonnement.
L’exemple suivant montre comment attribuer des rôles à l’étendue du groupe de ressources, car de nombreuses applications gèrent toutes leurs ressources Azure associées à l’aide d’un seul groupe de ressources.
Accédez à la page Vue d’ensemble du groupe de ressources qui contient l’application avec l’identité managée affectée par l’utilisateur.
Sélectionnez Contrôle d’accès (IAM) dans le volet de navigation gauche.
Dans la page Contrôle d’accès (IAM), sélectionnez + Ajouter dans le menu supérieur, puis choisissez Ajouter une attribution de rôle pour accéder à la page Ajouter une attribution de rôle .
La page Ajouter une attribution de rôle présente un flux de travail à onglets et à plusieurs étapes pour attribuer des rôles à des identités. Sous l’onglet Rôle initial, utilisez la zone de recherche en haut pour localiser le rôle que vous souhaitez affecter à l’identité.
Sélectionnez le rôle dans les résultats, puis choisissez Suivant pour accéder à l’onglet Membres .
Pour l’option Attribuer l’accès à , sélectionnez Identité managée.
Pour l’option Membres , choisissez + Sélectionner des membres pour ouvrir le panneau Sélectionner des identités managées .
Dans le panneau Sélectionner les identités gérées, utilisez les menus déroulants Abonnement et Identité gérée pour filtrer les résultats de la recherche de vos identités. Utilisez la zone de recherche Select pour rechercher l’identité managée affectée par l’utilisateur que vous avez activée pour la ressource Azure hébergeant votre application.
Sélectionnez l’identité, puis sélectionnez Sélectionner en bas du panneau pour continuer.
Sélectionnez Vérifier + affecter en bas de la page.
Sous l’onglet Révision + affectation finale, sélectionnez Vérifier + affecter pour terminer le flux de travail.
S’authentifier auprès des services Azure à partir de votre application
Le package azure_identity fournit diverses informations d’identification — des implémentations de TokenCredential qui prennent en charge différents scénarios et les flux d’authentification Microsoft Entra. Étant donné que l’identité managée n’est pas disponible lorsque vous exécutez localement, les instructions suivantes expliquent quel type d’informations d’identification utiliser dans chaque scénario :
-
Environnement de développement local : pendant le développement local uniquement, utilisez
DeveloperToolsCredentialpour une chaîne simplifiée d’informations d’identification de l’outil de développement.DeveloperToolsCredentialtente de s’authentifier à l’aide d’outils de développement tels que Azure CLI et s’arrête lorsqu’un d’entre eux réussit. Pour plus d’informations, consultez S’authentifier auprès des services Azure pendant le développement local. -
applications hébergées Azure : lorsque votre application est en cours d’exécution dans Azure, utilisez
ManagedIdentityCredential.
Implémenter le code
Ajoutez le crate azure_identity.
Dans un terminal, accédez au répertoire du projet d’application et exécutez :
cargo add azure_identity
Les clients spécialisés des différents Kit de développement logiciel (SDK) Azure accèdent aux services Azure. Pour tout code Rust qui instancie un client Kit de développement logiciel (SDK) Azure dans votre application, vous devez :
- Importez la
azure_identitycrate. - Créez une instance de
ManagedIdentityCredentialavec l’identité de votre identité managée attribuée par l’utilisateur. - Transmettez l’instance
ManagedIdentityCredentialau constructeur client Kit de développement logiciel (SDK) Azure.
La ManagedIdentityCredentialOptions structure accepte une UserAssignedId énum pour spécifier quelle identité affectée par l’utilisateur utiliser pour l’authentification. Vous pouvez identifier l’identité managée à l’aide de son ID client, de son ID d’objet (principal) ou de l’ID de ressource Azure.
L’approche la plus courante consiste à utiliser l’ID client de l’identité managée affectée par l’utilisateur :
use azure_identity::{ManagedIdentityCredential, ManagedIdentityCredentialOptions, UserAssignedId};
use azure_security_keyvault_secrets::SecretClient;
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
// Create a user-assigned managed identity credential
let options = ManagedIdentityCredentialOptions {
user_assigned_id: Some(UserAssignedId::ClientId(String::from("abcd1234-..."))),
..Default::default()
};
let credential = ManagedIdentityCredential::new(Some(options))?;
// 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(())
}
Important
En production, utilisez
ManagedIdentityCredential pour s’authentifier avec l’identité managée affectée à votre application.
Pendant le développement local, vous pouvez utiliser DeveloperToolsCredential pour vous authentifier à l’aide de vos outils de développement. Pour plus d’informations, consultez l’article d’authentification de développement local .