Implantar aplicativos Java Tomcat no Serviço de Aplicativo do Azure

Artigo
01/16/2025

Este artigo mostra como implantar um aplicativo Tomcat com entrada pela conta Microsoft Entra no Serviço de Aplicativo do Azure.

Este artigo pressupõe que você concluiu um dos seguintes artigos usando apenas a guia Executar localmente e agora deseja implantar no Azure. Estas instruções são as mesmas do separador "Implantar no Azure" nos artigos :

Habilitar o login para aplicativos Java Tomcat usando o Microsoft Entra ID
Habilitar o início de sessão para aplicações Java Tomcat usando MSAL4J com o Azure Active Directory B2C
Permitir que aplicativos Java Tomcat permitam que usuários iniciem sessão e acessem o Microsoft Graph
Proteja aplicativos Java Tomcat usando funções e declarações de função
Proteja aplicativos Java Tomcat usando grupos e declarações de grupo

Pré-requisitos

Plugin Maven para aplicações do Serviço de Aplicações do Azure

Se o Maven não for sua ferramenta de desenvolvimento preferida, consulte os seguintes tutoriais semelhantes que usam outras ferramentas:
- IntelliJ IDEA
- Eclipse
- de código do Visual Studio

da CLI do Azure

Configurar o plug-in Maven

Quando você implanta no Serviço de Aplicativo do Azure, a implantação usa automaticamente suas credenciais do Azure da CLI do Azure. Se a CLI do Azure não estiver instalada localmente, o plug-in do Maven será autenticado com OAuth ou entrada no dispositivo. Para obter mais informações, consulte autenticação com plug-ins do Maven.

Use as seguintes etapas para configurar o plug-in:

Execute o seguinte comando para configurar a implantação. Este comando ajuda você a configurar o sistema operacional do Serviço de Aplicativo do Azure, a versão Java e a versão do Tomcat.
```
mvn com.microsoft.azure:azure-webapp-maven-plugin:2.13.0:config
```
Para Criar nova configuração de execução, pressione Ye, em seguida, pressione Enter.
Para Definir valor para OS, pressione 1 para Windows ou 2 para Linux e, em seguida, pressione Enter.
Para definir valor para javaVersion, prima 2 para Java 11, depois prima Enter.
Para Definir valor para webContainer, pressione 4 para Tomcat 9.0 e, em seguida, pressione Enter.
Para definir valor para pricingTier, pressione Enter para selecionar o nível padrão P1v2.
Para Confirmar, prima Ye, em seguida, prima Enter.

O exemplo a seguir mostra a saída do processo de implantação:

Please confirm webapp properties
AppName : msal4j-servlet-auth-1707209552268
ResourceGroup : msal4j-servlet-auth-1707209552268-rg
Region : centralus
PricingTier : P1v2
OS : Linux
Java Version: Java 11
Web server stack: Tomcat 9.0
Deploy to slot : false
Confirm (Y/N) [Y]: [INFO] Saving configuration to pom.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  37.112 s
[INFO] Finished at: 2024-02-06T08:53:02Z
[INFO] ------------------------------------------------------------------------

Depois de confirmar suas escolhas, o plug-in adiciona o elemento e as configurações de plug-in necessários ao arquivo de pom.xml do seu projeto para configurar seu aplicativo para ser executado no Serviço de Aplicativo do Azure.

A parte relevante do arquivo pom.xml deve ser semelhante ao exemplo a seguir:

<build>
    <plugins>
        <plugin>
            <groupId>com.microsoft.azure</groupId>
            <artifactId>>azure-webapp-maven-plugin</artifactId>
            <version>x.xx.x</version>
            <configuration>
                <schemaVersion>v2</schemaVersion>
                <resourceGroup>your-resourcegroup-name</resourceGroup>
                <appName>your-app-name</appName>
            ...
            </configuration>
        </plugin>
    </plugins>
</build>

Você pode modificar as configurações do App Service diretamente em seu pom.xml. Algumas configurações comuns estão listadas na tabela a seguir:

Propriedade	Necessário	Descrição
`subscriptionId`	falso	O ID da subscrição.
`resourceGroup`	verdadeiro	O grupo de recursos do Azure para seu aplicativo.
`appName`	verdadeiro	O nome do seu aplicativo.
`region`	falso	A região na qual hospedar seu aplicativo. O valor padrão é `centralus`. Para regiões válidas, consulte Regiões suportadas.
`pricingTier`	falso	O nível de preços do seu aplicativo. O valor padrão é `P1v2` para uma carga de trabalho de produção. O valor mínimo recomendado para desenvolvimento e teste Java é `B2`. Para obter mais informações, consulte Preços do Serviço de Aplicações.
`runtime`	falso	A configuração do ambiente de tempo de execução. Para obter mais informações, consulte Detalhes de configuração.
`deployment`	falso	A configuração de implantação. Para obter mais informações, consulte Detalhes de Configuração.

Para obter a lista completa de configurações, consulte a documentação de referência do plugin. Todos os plug-ins do Azure Maven compartilham um conjunto comum de configurações. Para essas configurações, consulte Configurações comuns. Para configurações específicas do Serviço de Aplicativo do Azure, consulte aplicativo do Azure: Detalhes de configuração.

Certifique-se de salvar os valores de appName e resourceGroup para uso posterior.

Preparar o aplicativo para implantação

Quando você implanta seu aplicativo no Serviço de Aplicativo, sua URL de redirecionamento muda para a URL de redirecionamento da instância do aplicativo implantada. Use as seguintes etapas para alterar essas configurações no arquivo de propriedades:

Navegue até ao ficheiro do authentication.properties da sua aplicação e altere o valor de app.homePage para o nome de domínio da aplicação implantada, conforme mostrado no exemplo a seguir. Por exemplo, se você escolheu example-domain para o nome do aplicativo na etapa anterior, agora você deve usar https://example-domain.azurewebsites.net para o valor app.homePage. Certifique-se de que você também alterou o protocolo de http para https.
```
# app.homePage is by default set to dev server address and app context path on the server
# for apps deployed to azure, use https://your-sub-domain.azurewebsites.net
app.homePage=https://<your-app-name>.azurewebsites.net
```
Depois de salvar esse arquivo, use o seguinte comando para reconstruir seu aplicativo:
```
mvn clean package
```

Atualizar o registo da aplicação Microsoft Entra ID

Como o URI de redirecionamento muda para a aplicação que foi implementada no Azure App Service, também precisa alterar o URI de redirecionamento no registo da sua aplicação Microsoft Entra ID. Use as seguintes etapas para fazer essa alteração:

Navegue até a plataforma de identidade da Microsoft para desenvolvedores página Registros de aplicativos.
Use a caixa de pesquisa para pesquisar o registro do seu aplicativo - por exemplo, java-servlet-webapp-authentication.
Abra o registro do aplicativo selecionando seu nome.
Selecione de autenticação no menu.
Na seção Web - Redirecionar os URIs, selecione Adicionar URI.
Preencha o URI do seu aplicativo, anexando /auth/redirect - por exemplo, https://<your-app-name>.azurewebsites.net/auth/redirect.
Selecione Salvar.

Implantar o aplicativo

Agora você está pronto para implantar seu aplicativo no Serviço de Aplicativo do Azure. Use o seguinte comando para garantir que você esteja conectado ao seu ambiente do Azure para executar a implantação:

az login

Com toda a configuração pronta em seu arquivo pom.xml, agora você pode usar o seguinte comando para implantar seu aplicativo Java no Azure:

mvn package azure-webapp:deploy

Após a conclusão da implantação, seu aplicativo estará pronto em http://<your-app-name>.azurewebsites.net/. Abra o URL com seu navegador da Web local, onde você deve ver a página inicial do aplicativo msal4j-servlet-auth.

Remover valores secretos

O ficheiro authentication.properties da aplicação atualmente contém o valor do segredo do cliente no parâmetro aad.secret. Não é uma boa prática manter esse valor neste arquivo. Você também pode estar correndo um risco se confirmá-lo em um repositório Git.

Como uma etapa extra de segurança, você pode armazenar esse valor em do Cofre da Chave do Azure e usar de Referências do Cofre da Chave para disponibilizá-lo em seu aplicativo.

Utilize as seguintes etapas para mover o valor de aad.secret para o Azure Key Vault e usá-lo no seu código:

Use os seguintes comandos para criar uma instância do Azure Key Vault:

export RESOURCE_GROUP=<your-resource-group-name>
export KEY_VAULT=<your-key-vault-name>
az keyvault create \
    --resource-group $RESOURCE_GROUP \
    --name $KEY_VAULT

Use os seguintes comandos para adicionar o valor secreto de aad.secret ao cofre de chaves como um novo segredo:

az keyvault secret set \
    --vault-name $KEY_VAULT \
    --name "AADSECRET" \
    --value "<the-value-of-your-client-secret>"

Agora você precisa dar ao seu aplicativo acesso ao cofre de chaves. Para fazer essa tarefa, primeiro crie uma nova identidade para seu aplicativo usando os seguintes comandos:
```
export WEB_APP_NAME=<your-web-app-name>
az webapp identity assign \
    --resource-group $RESOURCE_GROUP \
    --name $WEB_APP_NAME
```

Use os seguintes comandos para dar permissão às identidades get e list nos segredos no Azure Key Vault:

export IDENTITY=$(az webapp identity show \
    --resource-group $RESOURCE_GROUP \
    --name $WEB_APP_NAME \
    --query principalId \
    --output tsv)
az keyvault set-policy \
    --resource-group $RESOURCE_GROUP \
    --name $KEY_VAULT \
    --secret-permissions get list \
    --object-id $IDENTITY

Utilize o comando abaixo para criar uma definição da aplicação no seu aplicativo que usa uma referência ao cofre de chaves para o segredo no seu cofre de chaves. Essa configuração torna o valor do segredo disponível para seu aplicativo como uma variável de ambiente.
```
az webapp config appsettings set \
    --resource-group $RESOURCE_GROUP \
    --name $WEB_APP_NAME \
    --settings AADSECRET='@Microsoft.KeyVault(VaultName=$KEY_VAULT;SecretName=AADSECRET)'
```
Use o código a seguir para carregar esse valor das variáveis de ambiente. No arquivo \src\main\java\com\microsoft\azuresamples\msal4j\helpers\Config.java, na linha 41, altere a instrução atual para a seguinte linha:
```
public static final String SECRET = System.getenv("AADSECRET");
```
Agora você pode excluir a chave e o valor do arquivo authentication.properties .
Reconstrua o código usando o seguinte comando:
```
mvn clean package
```
Reimplante o aplicativo usando o seguinte comando:
```
mvn package azure-webapp:deploy
```

Sua implantação agora está concluída.

Partilhar via