Gérer les informations d’identification de déploiement pour Azure App Service

Vous pouvez déployer des applications locales sur Azure App Service à l’aide du déploiement Git local ou du déploiement FTP/S. Cet article explique comment créer et gérer des informations d’identification de déploiement pour le déploiement Git local ou FTP/S.

Les informations d’identification de déploiement sont différentes de vos informations d’identification d’abonnement Azure. App Service prend en charge deux types d’informations d’identification pour sécuriser le déploiement d’applications locales : les informations d’identification d’étendue utilisateur et d’étendue d’application .

• Les informations d’identification au niveau de l’utilisateur fournissent un jeu unique d’informations d’identification de déploiement pour l’ensemble du compte Azure d’un utilisateur. Un utilisateur disposant d’un accès d’application via le contrôle d’accès en fonction du rôle (RBAC) ou des autorisations de coadministrateur peut utiliser ses informations d’identification au niveau de l’utilisateur tant qu’ils disposent de ces autorisations.

  Vous pouvez utiliser vos informations d’identification spécifiques à l’utilisateur pour déployer une application sur App Service via Git local ou FTP/S dans n’importe quel abonnement auquel votre compte Azure a accès. Vous ne partagez pas ces informations d’identification avec d’autres utilisateurs Azure. Vous pouvez réinitialiser vos identifiants au niveau de l'utilisateur à tout moment.

• L’étendue de l’application ou les informations d’identification au niveau de l’application sont un ensemble d’informations d’identification par application qui peuvent être utilisées pour déployer cette application uniquement. Ces informations d’identification sont générées automatiquement pour chaque application lors de la création et ne peuvent pas être configurées manuellement, mais le mot de passe peut être réinitialisé à tout moment.

  Un utilisateur doit disposer d’au moins des autorisations de niveau Contributeur sur une application, y compris le rôle Contributeur de site web intégré, pour pouvoir accéder aux informations d’identification au niveau de l’application via RBAC. Le rôle lecteur ne peut pas publier et ne peut pas accéder à ces informations d’identification.

Conditions préalables

Pour définir, réinitialiser, accéder ou utiliser des informations d’identification de déploiement, vous devez disposer d’autorisations de niveau Contributeur sur l’application App Service.

Exigence d’authentification de base

Pour publier des applications App Service via Git ou FTP/S local, vous devez activer l’authentification de base. Les identifiants de publication SCM avec authentification de base et les identifiants de publication FTP avec authentification de base doivent être paramétrés sur Activé dans la page de Configuration de l'application dans le portail Azure.

L’authentification de base est moins sécurisée que les autres méthodes d’authentification et est désactivée par défaut pour les nouvelles applications. Si l’authentification de base est désactivée, vous ne pouvez pas afficher ou définir les informations d’identification de déploiement dans le Centre de déploiement de l’application ou utiliser ces informations d’identification pour la publication. Pour plus d’informations, consultez Désactiver l’authentification de base dans les déploiements Azure App Service.

Définir les informations d'identification au niveau utilisateur

Pour le déploiement FTP/S, vous avez besoin d’un nom d’utilisateur et d’un mot de passe. Le déploiement Git local nécessite uniquement un nom d’utilisateur. Le nom d’utilisateur doit être unique au sein de Azure.

Pour le déploiement Git local, le nom d’utilisateur ne peut pas contenir le @ caractère.

Pour le déploiement FTP/S :

• Le nom d’utilisateur doit suivre le format <app-name>\<user-name>. Étant donné que les informations d’identification d’étendue utilisateur sont liées à l’utilisateur et non à l’application, ce format dirige l’action de connexion vers le point de terminaison FTP/S approprié pour l’application.

• Le mot de passe doit comporter au moins huit caractères et contenir des lettres majuscules, des lettres minuscules, des chiffres et des symboles. Le portail Azure n’affiche pas le mot de passe d’étendue utilisateur et la sortie JSON l’affiche comme null. Si vous perdez ou oubliez votre mot de passe, vous pouvez réinitialiser vos informations d’identification pour en obtenir une nouvelle.

Vous pouvez configurer des informations d'identification à l'échelle de l'utilisateur à l'aide d'Azure CLI ou du portail Azure.

Azure CLI

Pour créer des informations d’identification à portée utilisateur à l’aide d’Azure CLI, exécutez la commande az webapp deployment user set, en remplaçant <username> et <password> par les valeurs que vous sélectionnez.

az webapp deployment user set --user-name <username> --password <password>

Azure PowerShell

Vous ne pouvez pas créer d'identifiants de l'étendue utilisateur à l'aide d'Azure PowerShell. Utilisez Azure CLI ou le portail Azure pour créer les informations d’identification, ou utilisez les informations d’identification d’étendue de l’application pour déployer sur FTP/S ou Git local.

portail Azure

Dans le portail Azure, vous devez avoir au moins une application à utiliser pour définir les informations d’identification d’étendue utilisateur. Les informations d’identification s’appliquent ensuite à toutes les applications pour tous les abonnements de votre compte Azure qui ont activé l’authentification de base SCM et l’authentification FTP De base .

1. Sélectionnez Centre de déploiement sous Déploiement dans le menu de navigation de gauche d’une application.
2. Sélectionnez l’onglet Informations d’identification FTPS , ou si Git local est configuré comme source de build, l’onglet Informations d’identification Git/FTPS local .
3. Dans la section Étendue de l’utilisateur , ajoutez un nom d’utilisateur.
4. Ajoutez et confirmez un mot de passe.
5. Cliquez sur Enregistrer.

Après avoir défini les informations d’identification de portée utilisateur, vous pouvez voir le nom d’utilisateur de votre déploiement dans la page Vue d’ensemble de votre application dans le Portail Azure. Si le déploiement Git local est configuré, l’étiquette est le nom d’utilisateur Git/Déploiement. Sinon, l’étiquette est ftp/nom d’utilisateur de déploiement.

Obtenir des informations d’identification de portée application

Les informations d’identification au niveau de l’application sont créées automatiquement lorsque l'application est créée. Le nom d’utilisateur de portée application FTP/S suit toujours le format app-name\$app-name. Le nom d’utilisateur dans le contexte de l'application Git locale utilise le format $app-name.

Remarque

Lorsque vous utilisez git remote add dans des interpréteurs de commandes qui utilisent le signe dollar pour l’interpolation de variables, comme Bash, vous devez utiliser \$ pour échapper à tout signe dollar dans le nom d’utilisateur ou le mot de passe pour éviter les erreurs d’authentification.

Vous pouvez obtenir vos informations d’identification d’étendue d’application à l’aide d’Azure CLI, d’Azure PowerShell ou du portail Azure.

Azure CLI

Dans Azure CLI, obtenez les informations d’identification de portée application à l’aide de la commande az webapp deployment list-publishing-profiles. Exemple :

az webapp deployment list-publishing-profiles --resource-group myResourceGroup --name myApp

Pour le déploiement Git local, vous pouvez également utiliser la az webapp deployment list-publishing-credentials commande. L’exemple suivant retourne un URI distant Git qui contient les informations d’identification de portée application pour l’application déjà incorporée.

az webapp deployment list-publishing-credentials --resource-group myResourceGroup --name myApp --query scmUri

L’URI distant Git retourné n’a pas /<app-name>.git à la fin. Si vous utilisez l’URI pour ajouter un serveur distant, ajoutez-le /<app-name>.git à l’URI pour éviter une erreur 22 avec git-http-push.

Azure PowerShell

Dans Azure PowerShell, récupérez les informations d'identification de l’étendue de l’application à l'aide de la commande Get-AzWebAppPublishingProfile. Exemple :

Get-AzWebAppPublishingProfile -ResourceGroupName myResourceGroup -Name myApp

portail Azure

Pour obtenir les informations d’identification à l'échelle de l'application sur le portail Azure :

1. Sélectionnez Centre de déploiement sous Déploiement dans le menu de navigation de gauche de votre application.
2. Dans la page Centre de déploiement , sélectionnez les informations d’identification FTPS ou l’onglet Informations d’identification Git/FTPS locales .
3. Dans la section Étendue de l’application , affichez le nom d’utilisateur FTPS, le nom d’utilisateur Git local et le mot de passe. Sélectionnez les icônes de copie pour copier les valeurs.

Réinitialiser les informations d’identification

Vous pouvez utiliser Azure CLI, Azure PowerShell ou le portail Azure pour réinitialiser vos informations d’identification de déploiement d’étendue d’application et obtenir un nouveau mot de passe. Les noms d’utilisateurs de la portée de l’application conservent leurs valeurs générées automatiquement.

Dans Azure CLI et le portail Azure, vous pouvez également réinitialiser vos informations d’identification d’étendue utilisateur en en créant de nouvelles. Cette action affecte toutes les applications de votre compte qui utilisent les identifiants à portée utilisateur.

Lorsque vous réinitialisez vos informations d’identification de déploiement, toutes les intégrations externes et l’automatisation via le profil de publication arrêtent de fonctionner et doivent être reconfigurées avec les nouvelles valeurs.

Azure CLI

Dans Azure CLI, réinitialisez le mot de passe à portée d'application à l’aide de la commande az resource invoke-action avec l’action newpassword.

az resource invoke-action --action newpassword --resource-group <group-name> --name <app-name> --resource-type Microsoft.Web/sites

Réinitialisez les informations d’identification de portée utilisateur en réexécutant la commande az webapp deployment user set pour créer des valeurs de nom d’utilisateur et de mot de passe.

az webapp deployment user set --user-name <new-username> --password <new-password>

Azure PowerShell

Dans Azure PowerShell, réinitialisez le mot de passe de portée application à l’aide de la commande Invoke-AzResourceAction avec l’action newpassword :

Invoke-AzResourceAction -ResourceGroupName <group-name> -ResourceType Microsoft.Web/sites -ResourceName <app-name> -Action newpassword

portail Azure

Dans le portail Azure, sélectionnez Centre de déploiement dans le menu de navigation gauche de votre application, puis sélectionnez les informations d’identification FTPS ou l’onglet Informations d’identification Git/FTPS locales .

• Pour réinitialiser vos identifiants de portée de l'application et obtenir un nouveau mot de passe, sélectionnez Réinitialiser en bas de la section de la portée de l'application.

• Pour réinitialiser vos identifiants au niveau utilisateur :

  1. Sélectionnez Réinitialiser en bas de la section Étendue de l’utilisateur . Cette sélection supprime à la fois le nom d’utilisateur et le mot de passe et désactive les informations d’identification de portée utilisateur.
  2. Pour réinitialiser et réactiver vos identifiants d'utilisateur, entrez un nouveau nom d'utilisateur et un nouveau mot de passe, puis sélectionnez Enregistrer.

Cette action prend effet sur toutes les applications de votre compte qui utilisent les identifiants à portée d'utilisateur.

Contenu connexe

• Désactiver l’authentification de base dans les déploiements Azure App Service
• Déployer sur Azure App Service à l’aide de Git local
• Déployer votre application sur Azure App Service avec FTP/S