Démarrage rapide : Créer une connexion de service dans Azure Functions avec Azure CLI

Ce démarrage rapide vous montre comment connecter Azure Functions à d’autres ressources cloud à l’aide d’Azure CLI et de Service Connector. Service Connector vous permet de connecter rapidement des services de calcul aux services cloud, tout en gérant les paramètres d’authentification et de mise en réseau de votre connexion.

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

Prérequis

• Utilisez l’environnement Bash dans Azure Cloud Shell. Pour plus d’informations, consultez Démarrage rapide pour Bash dans Azure Cloud Shell.

  

• Si vous préférez exécuter les commandes de référence de l’interface de ligne de commande localement, installez l’interface 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 Guide pratique pour 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 finir le processus d’authentification, suivez les étapes affichées dans votre terminal. Pour connaître les autres options de connexion, consultez Se connecter avec 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 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.

• La version 2.30.0 ou ultérieure d’Azure CLI est exigée pour ce guide de démarrage rapide. Si vous utilisez Azure Cloud Shell, la version la plus récente est déjà installée.
• Ce démarrage rapide suppose que vous disposez déjà d’une fonction Azure. Si vous n’en avez pas encore, créez une fonction Azure.
• Ce démarrage rapide part du principe que vous disposez déjà d’un compte stockage Azure. Si vous n’en avez pas encore, créez un compte de stockage Azure.

Configuration initiale

1. 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

   Vous pouvez vérifier si le fournisseur de ressources a déjà été inscrit en exécutant la commandeaz provider show -n "Microsoft.ServiceLinker" --query registrationState. Si la sortie est Registered, Service Connector a alors déjà été inscrit.

2. Vous pouvez également utiliser la commande Azure CLI az functionapp connection list-support-types pour obtenir la liste des services cibles pris en charge par l’application de fonction.

   az functionapp connection list-support-types --output table
   

Créer une connexion de service

Utilisation d’une identité managée

Important

Pour utiliser une identité managée, vous devez être autorisé à attribuer des rôles Azure AD. Sans l’autorisation, la création de votre connexion échouera. Vous pouvez demander à votre propriétaire d’abonnement l’autorisation ou utiliser une clé d’accès pour créer la connexion.

Utilisez la commande Azure CLI az functionapp connection pour créer une connexion de service à un Stockage Blob avec une identité managée affectée par le système, en indiquant les informations suivantes :

• Nom du groupe de ressources du service de calcul source : nom du groupe de ressources de l’application de fonction.
• Nom de l’application de fonction : nom de votre application de fonction qui se connecte au service cible.
• Nom du groupe de ressources du service cible : nom du groupe de ressources du Stockage Blob.
• Nom du compte de stockage : nom du compte du stockage d’objets blob.

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

Remarque

Si vous ne disposez pas d’un Stockage Blob, vous pouvez exécuter az functionapp connection create storage-blob --new --system-identity pour en approvisionner un nouveau et vous connecter directement à votre application de fonction.

Utilisation d’une clé d’accès

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 degré de confiance très élevé dans l'application et comporte des risques qui ne sont pas présents dans d'autres flux. Vous ne devez utiliser ce flux que si d’autres flux plus sécurisés, tels que les identités managées, ne sont pas viables.

Utilisez la commande Azure CLI az functionapp connection create pour créer une connexion de service à un stockage d’objets blob Azure avec une clé d’accès, en indiquant les informations suivantes :

• Nom du groupe de ressources du service de calcul source : nom du groupe de ressources de l’application de fonction.
• Nom de l’application de fonction : nom de votre application de fonction qui se connecte au service cible.
• Nom du groupe de ressources du service cible : nom du groupe de ressources du Stockage Blob.
• Nom du compte de stockage : nom du compte du stockage d’objets blob.

az functionapp connection create storage-blob --secret

Remarque

Si vous ne disposez pas d’un Stockage Blob, vous pouvez exécuter az functionapp connection create storage-blob --new --secret pour en approvisionner un nouveau et vous connecter directement à votre application de fonction.

Afficher les connexions

Utilisez la commande Azure CLI az functionapp connection list pour répertorier les connexions à votre application de fonction, en fournissant les informations suivantes :

• Nom du groupe de ressources du service de calcul source : nom du groupe de ressources de l’application de fonction.
• Nom de l’application de fonction : nom de votre application de fonction qui se connecte au service cible.

az functionapp connection list -g "<your-function-app-resource-group>" -n "<your-function-app-name>" --output table

Étapes suivantes

Suivez les didacticiels ci-dessous pour commencer à créer votre propre application de fonction avec Service Connector.

Didacticiel : Fonction Python avec Stockage File d’attente Azure en tant que déclencheur

Didacticiel : Fonction Python avec Stockage Blob Azure en tant qu’entrée

Didacticiel : Fonction Python avec Stockage Table Azure en tant que sortie