Configurar as credenciais de implantação do Serviço de Aplicativo do Azure

Para garantir a implantação do aplicativo de um computador local, o Serviço de Aplicativo do Azure dá suporte a dois tipos de credenciais para implantação Git local e implantação FTP/S. Essas credenciais não são iguais às suas credenciais de assinatura do Azure.

  • Credenciais de nível de usuário: um conjunto de credenciais para toda a conta do Azure. Ele pode ser usado para implantar no Serviço de Aplicativo para qualquer aplicativo e em qualquer assinatura que a conta do Azure tem permissão para acessar. É o conjunto padrão que aparece na GUI do portal (como a Visão geral e Propriedades da página de recursos do aplicativo). Quando um usuário recebe acesso ao aplicativo por meio de RBAC (Controle de Acesso Baseado na Função) ou permissões coadmin, esse usuário pode usar suas próprias credenciais em nível de usuário até que o acesso seja revogado. Não compartilhe essas credenciais com outros usuários do Azure.

  • Credenciais de nível de aplicativo: um conjunto de credenciais para cada aplicativo. Podem ser usadas para implantar nesse aplicativo somente. As credenciais de cada aplicativo são geradas automaticamente na criação do aplicativo. Eles não podem ser configurados manualmente, mas podem ser redefinidos a qualquer momento. Para que um usuário tenha acesso às credenciais no nível do aplicativo via (RBAC), esse usuário deve ser colaborador ou superior no aplicativo (incluindo a função interna de colaborador do site). Os leitores não têm permissão para publicar e não pode acessar essas credenciais.

Observação

Quando a autenticação básica está desabilitada, você não pode exibir nem configurar credenciais de implantação no Centro de Implantação.

Configurar credenciais de escopo de usuário

Execute o comando az webapp deployment user set. Substitua <nome de usuário> e <senha> pelo nome de usuário e pela senha do usuário de implantação.

  • O nome de usuário deve ser exclusivo no Azure. Para envios por push do Git local, não deve conter o símbolo "\@".
  • A senha deve ter pelo menos oito caracteres, com dois destes três elementos: letras, números, símbolos.
az webapp deployment user set --user-name <username> --password <password>

A saída JSON mostra a senha como null.

Usar credenciais de escopo de usuário com FTP/FTPS

A autenticação em um terminal FTP/FTPS usando credenciais de escopo de usuário requer um nome de usuário no seguinte formato: <app-name>\<user-name>

Como as credenciais de escopo de usuário estão vinculadas ao usuário e não a um recurso específico, o nome de usuário deve estar neste formato para direcionar a ação de entrada para o ponto de extremidade correto do aplicativo.

Obter credenciais de escopo de aplicativo

Obtenha as credenciais de escopo de aplicativo usando o comando az webapp deployment list-publishing-profiles. Por exemplo:

az webapp deployment list-publishing-profiles --resource-group <group-name> --name <app-name>

Para a implantação Git local, você também pode usar o comando az webapp deployment list-publishing-credentials a fim de obter um URI remoto do Git para o aplicativo com as credenciais de escopo do aplicativo já inseridas. Por exemplo:

az webapp deployment list-publishing-credentials --resource-group <group-name> --name <app-name> --query scmUri

Observe que o URI remoto do Git retornado não contém /<app-name>.git no final. Ao adicionar o URI remoto, acrescente/<app-name>.git para evitar um erro 22 com git-http-push. Além disso, ao usar git remote add ... por meio de shells que empregam o cifrão para interpolação de variáveis (como o bash), escape de qualquer cifrão (\$) no nome de usuário ou na senha. A falha ao escapar esse caractere pode resultar em erros de autenticação.

Redefinir credenciais de escopo de aplicativo

Redefina as credenciais de escopo de aplicativo usando o comando az resource invoke-action:

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

Desabilitar a autenticação básica

Consulte Desabilitar a autenticação básica em implantações do Serviço de Aplicativo.

Próximas etapas

Saiba como usar essas credenciais para implantar seu aplicativo do Git local ou usando FTP/S.