Segredos de autenticação segura no Cofre da Chave do Azure para Aplicativos Web Estáticos do Azure
Ao configurar provedores de autenticação personalizados, convém armazenar segredos de conexão no Cofre da Chave do Azure. Este artigo demonstra como usar uma identidade gerenciada para conceder aos Aplicativos Web Estáticos do Azure acesso ao Cofre da Chave para segredos de autenticação personalizados.
Nota
O Azure Serverless Functions não oferece suporte à integração direta do Cofre de Chaves. Se você precisar de integração do Cofre da Chave com seu aplicativo Function gerenciado, precisará implementar o acesso ao Cofre da Chave no código do seu aplicativo.
Os segredos de segurança exigem que os seguintes itens estejam no lugar.
- Crie uma identidade atribuída pelo sistema em seu aplicativo Web estático.
- Conceda à identidade acesso a um segredo do Cofre da Chave.
- Faça referência ao segredo do Cofre da Chave nas configurações do aplicativo Static Web Apps.
Este artigo demonstra como configurar cada um desses itens em produção para trazer seus próprios aplicativos de funções.
A integração com o Key Vault não está disponível para:
- Versões de preparo do seu aplicativo Web estático. A integração do Key Vault só é suportada no ambiente de produção.
- Aplicações Web estáticas utilizando funções geridas.
Nota
O uso da identidade gerenciada só está disponível no plano Padrão de Aplicativos Web Estáticos do Azure.
Pré-requisitos
- Site existente de Aplicativos Web Estáticos do Azure usando suas próprias funções.
- Recurso existente do Cofre da Chave com um valor secreto.
Criar identidade
Abra seus aplicativos Web estáticos no portal do Azure.
Em Configurações, selecione Identidade.
Selecione o separador Sistema atribuído .
No rótulo Status, selecione Ativado.
Selecione Guardar.
Quando a caixa de diálogo de confirmação for exibida, selecione Sim.
Agora você pode adicionar uma política de acesso para permitir que seu aplicativo Web estático leia os segredos do Cofre da Chave.
Adicionar uma política de acesso ao Cofre da Chave
Abra o recurso Cofre da Chave no portal do Azure.
No menu Configurações, selecione Políticas de acesso.
Selecione o link, Adicionar Política de Acesso.
Na lista suspensa Permissões secretas, selecione Obter.
Ao lado de Selecionar rótulo principal, selecione o link Nenhum selecionado.
Na caixa de pesquisa, procure o nome do aplicativo Web estático.
Selecione o item de lista que corresponde ao nome do aplicativo.
Selecione Selecionar.
Selecione Adicionar.
Selecione Guardar.
A política de acesso agora é salva no Cofre da Chave. Em seguida, acesse o URI do segredo para usar ao associar seu aplicativo Web estático ao recurso Cofre da Chave.
No menu Configurações, selecione Segredos.
Selecione o segredo desejado na lista.
Selecione a versão secreta desejada na lista.
Selecione copiar no final da caixa de texto Identificador Secreto para copiar o valor de URI secreto para a área de transferência.
Cole esse valor em um editor de texto para uso posterior.
Adicionar configuração do aplicativo
Abra seu site de Aplicativos Web estáticos no portal do Azure.
No menu Configurações, selecione Configuração.
Na seção Configurações do aplicativo , selecione Adicionar.
Insira um nome na caixa de texto do campo Nome .
Determine o valor secreto na caixa de texto para o campo Valor .
O valor secreto é um composto de alguns valores diferentes. O modelo a seguir mostra como a cadeia de caracteres final é construída.
@Microsoft.KeyVault(SecretUri=<YOUR_KEY_VAULT_SECRET_URI>)Por exemplo, uma cadeia de caracteres final seria semelhante ao exemplo a seguir:
@Microsoft.KeyVault(SecretUri=https://myvault.vault.azure.net/secrets/mysecret/)Em alternativa:
@Microsoft.KeyVault(VaultName=myvault;SecretName=mysecret)Use as etapas a seguir para criar o valor secreto completo.
Copie o modelo de cima e cole-o em um editor de texto.
Substitua
<YOUR_KEY_VAULT_SECRET_URI>pelo valor de URI do Cofre da Chave reservado anteriormente.Copie o novo valor de cadeia de caracteres completa.
Cole o valor na caixa de texto do campo Valor .
Selecione OK.
Selecione Salvar na parte superior da barra de ferramentas Configurações do aplicativo.
Agora, quando sua configuração de autenticação personalizada faz referência à configuração do aplicativo recém-criado, o valor é extraído do Cofre de Chaves do Azure usando a identidade do seu aplicativo Web estático.