Démarrage rapide : Connecter Azure Container Apps aux bases de données et services avec Service Connector (préversion)

Commencez avec Service Connector pour connecter vos applications Azure Container Apps aux bases de données, aux comptes de stockage et à d’autres services Azure. Service Connector simplifie l’authentification et la configuration, ce qui vous permet de vous connecter aux ressources à l’aide d’identités managées ou d’autres méthodes d’authentification.

Cet article fournit des instructions pas à pas pour le portail Azure et Azure CLI. Choisissez votre méthode préférée à l’aide des onglets ci-dessus.

Important

La prise en charge de Service Connector (préversion) sur Azure Container Apps se termine le 30 mars 2026. Après cette date, les nouvelles connexions de service à l'aide de Service Connector (préversion) ne seront plus disponibles via aucune interface. Pour plus d’informations, consultez RETIREMENT : Service Connector (préversion) sur Azure Container Apps.

Prérequis

Compte Azure avec un abonnement actif. Créez un compte gratuitement.
Application déployée sur Container Apps dans une région prise en charge par Service Connector.
Ressource cible à laquelle connecter vos applications conteneur, telles qu’un compte de stockage Blob.
Autorisations nécessaires pour créer et gérer des connexions de service.

Compte Azure avec un abonnement actif. Créez un compte gratuitement.
Application déployée sur Container Apps dans une région prise en charge par Service Connector.
Ressource cible à laquelle connecter vos applications conteneur, telles qu’un compte de stockage Blob.
Autorisations nécessaires pour créer et gérer des connexions de service.

Utilisez l’environnement Bash dans Azure Cloud Shell. Pour obtenir plus d’informations, consultez Démarrage d’Azure Cloud Shell.
Si vous préférez exécuter des commandes de référence CLI localement, installez Azure CLI. Si vous exécutez sur Windows ou macOS, envisagez d’exécuter Azure CLI dans un conteneur Docker. Pour plus d’informations, consultez Comment exécuter Azure CLI dans un conteneur Docker.
- Si vous utilisez une installation locale, connectez-vous à Azure CLI à l’aide de la commande az login. Pour terminer le processus d’authentification, suivez les étapes affichées dans votre terminal. Pour obtenir d’autres options de connexion, consultez S’authentifier auprès d’Azure à l’aide d’Azure CLI.
- Lorsque vous y êtes invité, installez l’extension Azure CLI lors de la première utilisation. Pour plus d’informations sur les extensions, consultez Utiliser et gérer des extensions avec Azure CLI.
- Exécutez az version pour rechercher la version et les bibliothèques dépendantes installées. Pour effectuer une mise à niveau vers la dernière version, exécutez az upgrade.

Ce guide de démarrage rapide nécessite la version 2.30.0 ou ultérieure d’Azure CLI. Pour effectuer une mise à niveau vers la dernière version, exécutez az upgrade. Si vous utilisez Azure Cloud Shell, la dernière version est déjà installée.

Configurer votre environnement

Si vous utilisez Service Connector pour la première fois, commencez par exécuter la commande az provider register pour inscrire le fournisseur de ressources Service Connector.
```
az provider register -n Microsoft.ServiceLinker
```
Conseil / Astuce

Vous pouvez vérifier si le fournisseur de ressources a déjà été inscrit en exécutant la commande az provider show -n "Microsoft.ServiceLinker" --query registrationState. Si la sortie est Registered, Service Connector a déjà été inscrit.
Si vous le souhaitez, exécutez la commande az containerapp connection list-support-types pour obtenir la liste des services cibles pris en charge pour Container Apps.
```
az containerapp connection list-support-types --output table
```

Créer une connexion de service (aperçu)

Utilisez Service Connector pour créer une connexion de service entre vos applications Azure Container Apps et stockage Blob Azure. Cet exemple illustre la connexion au stockage Blob, mais vous pouvez utiliser le même processus pour d’autres services Azure pris en charge.

Sélectionnez la barre de recherche Rechercher des ressources, des services et des documents (G +/) en haut du Portail Azure, tapez Container Apps dans le filtre et sélectionnez Container Apps.
Sélectionnez le nom de la ressource Container Apps que vous souhaitez connecter à une ressource cible.
Sélectionnez Service Connector (préversion) dans la table des matières située sur la gauche. Sélectionnez ensuite Créer.

Sous l’onglet Informations de base , sélectionnez ou entrez les paramètres suivants.

Paramètre	Exemple	Description
Conteneur	my-container-app	Le conteneur dans votre application de conteneur.
Type de service	Stockage – Blob	Type de service que vous souhaitez connecter à votre application conteneur.
Abonnement	my-subscription	Abonnement qui contient le service auquel vous souhaitez vous connecter. La valeur par défaut est l’abonnement qui contient cette application conteneur.
Nom de connexion	storageblob_700ae	Nom de la connexion qui existe entre votre application de conteneur et le service cible Utilisez le nom de la connexion fourni par le connecteur de services ou choisissez votre propre nom de connexion.
Compte de stockage	my-storage-account	Compte de stockage cible auquel vous souhaitez vous connecter. Si vous choisissez un autre type de service, sélectionnez l’instance de service cible correspondante.
Type de client	.NET	La pile d’applications qui fonctionne avec le service cible que vous avez sélectionné. La valeur par défaut est None, qui génère une liste de configurations. Si vous connaissez la pile d’applications ou le Kit de développement logiciel (SDK) client dans votre choix, sélectionnez la même pile d’applications pour le type de client.

Sélectionnez Suivant : Authentification pour choisir une méthode d’authentification : identité managée affectée par le système (SMI), identité managée affectée par l’utilisateur (UMI), chaîne de connexion ou principal de service.
Sélectionnez Identité managée affectée par le système pour vous connecter via une identité générée automatiquement dans Microsoft Entra ID et associée au cycle de vie de l’instance de service. Il s’agit de l’option d’authentification recommandée.
Sélectionnez Identité managée affectée par l’utilisateur pour vous authentifier via une identité autonome affectée à une ou plusieurs instances d’un service Azure. Sélectionnez un abonnement qui contient une identité managée affectée par l’utilisateur, puis sélectionnez l’identité.

Si vous n’avez pas encore d’identité managée affectée par l’utilisateur, créez-en une :
1. Ouvrez la plateforme Azure dans un nouvel onglet et recherchez les identités managées.
2. Sélectionnez Identités managées et sélectionnez Créer.
3. Entrez un abonnement, un groupe de ressources, une région et un nom d’instance.
4. Sélectionnez Vérifier + créer , puis Créer
5. Une fois votre identité managée déployée, revenez à votre onglet Connecteur de service, sélectionnez Précédent , puis Suivant pour actualiser les données du formulaire. Sous Identité managée affectée par l’utilisateur, sélectionnez l’identité que vous avez créée.
Pour plus d’informations, consultez créer une identité managée affectée par l’utilisateur.
1. Sélectionnez Principal de service pour utiliser un principal de service qui définit la stratégie d’accès et les autorisations pour l’utilisateur/application dans Microsoft Entra ID.
2. Sélectionnez un principal de service dans la liste et entrez un secret
Avertissement

Microsoft vous recommande d’utiliser le flux d’authentification le plus sécurisé disponible. Le flux d’authentification décrit dans cette procédure demande un très haut niveau de confiance dans l’application et comporte des risques qui ne sont pas présents dans d’autres flux. Utilisez ce flux seulement si d’autres flux plus sécurisés, tels que les identités managées, ne sont pas viables.

Sélectionnez Chaîne de connexion pour générer ou configurer une ou plusieurs paires clé-valeur avec des secrets ou des jetons purs.
Sélectionnez Suivant : Mise en réseau pour sélectionner la configuration réseau et configurer des règles de pare-feu pour activer l’accès au service cible afin que votre application conteneur puisse accéder au stockage Blob.
Sélectionnez Suivant : Vérifier + créer pour passer en revue les informations fournies. La validation finale prend quelques secondes.
Sélectionnez Créer pour créer la connexion de service. L'opération peut prendre jusqu'à une minute.

Identité managée (recommandé)
Chaîne de connexion

Exécutez la az containerapp connection create commande pour créer une connexion de service entre Container Apps et un stockage Blob avec une identité managée affectée par le système. Vous pouvez exécuter cette commande de deux façons différentes :

Générez la nouvelle connexion étape par étape.

az containerapp connection create storage-blob --system-identity

Générez immédiatement la nouvelle connexion. Remplacez les espaces réservés par vos propres informations : <source-subscription>, , <source_resource_group><app>, <target-subscription>, <target_resource_group>, et <account>.

az containerapp connection create storage-blob \                         
   --source-id /subscriptions/<source-subscription>/resourceGroups/<source_resource_group>/providers/Microsoft.App/containerApps/<app> \
   --target-id /subscriptions/<target-subscription>/resourceGroups/<target_resource_group>/providers/Microsoft.Storage/storageAccounts/<account>/blobServices/default \
   --system-identity

Conseil / Astuce

Si vous n'avez pas de compte de stockage d'objets blob, exécutez la commande az containerapp connection create storage-blob --new --system-identity pour en créer un et le connecter à votre application conteneur à l'aide d'une identité gérée.

Avertissement

Microsoft vous recommande d’utiliser le flux d’authentification le plus sécurisé disponible. Le flux d’authentification décrit dans cette procédure demande un très haut niveau de confiance dans l’application et comporte des risques qui ne sont pas présents dans d’autres flux. Utilisez ce flux seulement si d’autres flux plus sécurisés, tels que les identités managées, ne sont pas viables.

Exécutez la az containerapp connection create commande pour créer une connexion de service à partir de Container Apps vers un stockage Blob avec une chaîne de connexion. Vous pouvez exécuter cette commande de deux façons différentes :

Générez la nouvelle connexion étape par étape.

az containerapp connection create storage-blob --secret

az containerapp connection create storage-blob \                         
   --source-id /subscriptions/<source-subscription>/resourceGroups/<source_resource_group>/providers/Microsoft.App/containerApps/<app> \
   --target-id /subscriptions/<target-subscription>/resourceGroups/<target_resource_group>/providers/Microsoft.Storage/storageAccounts/<account>/blobServices/default \
   --secret name=<secret-name> secret=<secret>

Conseil / Astuce

Si vous n'avez pas de compte de stockage d'objets blob, exécutez la commande az containerapp connection create storage-blob --new --secret pour en créer un et le connecter à votre application conteneur à l'aide d'une identité gérée.

Voir les connexions de service

Les connexions Container Apps s’affichent sous Paramètres > Connecteur de services (préversion). Sélectionnez > pour développer la liste et consulter les propriétés requises par votre application.
Sélectionnez votre connexion, puis Valider pour inviter Service Connector à vérifier votre connexion.
Sélectionnez En savoir plus pour consulter les détails de la validation de connexion.

Exécutez la commande az containerapp connection list pour répertorier toutes les connexions approvisionnées de votre application conteneur. Remplacez les espaces réservés <container-app-resource-group> et <container-app-name> dans la commande ci-dessous par vos propres informations. Vous pouvez également supprimer l’option --output table pour afficher plus d’informations sur vos connexions.

az containerapp connection list --resource-group "<container-app-resource-group>" --name "<container-app-name>" --output table

La sortie affiche également l’état d’approvisionnement de vos connexions.

Pour plus d’informations sur Service Connector, consultez les guides suivants :

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2025-09-19