Implementación de aplicaciones de JBoss EAP de Java en App de Azure Service

Artículo
03/19/2024

En este artículo se muestra cómo implementar una aplicación de JBoss EAP con el inicio de sesión de la cuenta de Microsoft Entra en App de Azure Service.

En este artículo se da por supuesto que ha completado uno de los siguientes artículos con solo la pestaña Ejecutar localmente y que ahora quiere implementar en Azure. Estas instrucciones son las mismas que las de la pestaña Implementar en Azure de estos artículos:

Requisitos previos

Complemento maven para aplicaciones de App de Azure Service

Si Maven no es su herramienta de desarrollo preferida, consulte los siguientes tutoriales similares que usan otras herramientas:

CLI de Azure

Configuración del complemento Maven

El proceso de implementación en Azure App Service usa sus credenciales de Azure desde la CLI de Azure automáticamente. El complemento Maven se autentica con OAuth o el inicio de sesión del dispositivo si la CLI de Azure no está instalada localmente. Para más información, consulte Autenticación con los complementos de Maven.

Siga estos pasos para configurar el complemento:

Ejecute el siguiente comando de Maven para configurar la implementación. Este comando le ayuda a configurar el sistema operativo de App Service, la versión de Java y la versión de Tomcat.
```
mvn com.microsoft.azure:azure-webapp-maven-plugin:2.12.0:config
```
En Crear nueva configuración de ejecución, presione Y y, a continuación, presione Entrar.
En Definir valor para el sistema operativo, presione 2 para Linux y, a continuación, presione Entrar.
En Definir valor para javaVersion, presione 2 para Java 11 y, a continuación, presione Entrar.
En Definir valor para webContainer, presione 1 para JBosseap7 y, a continuación, presione Entrar.
En Definir valor para pricingTier, presione Entrar para seleccionar el nivel P1v3 predeterminado.
En Confirmar, presione Y y, a continuación, presione Entrar.

En el ejemplo siguiente se muestra la salida del proceso de implementación:

Please confirm webapp properties
AppName : msal4j-servlet-auth-1707220080695
ResourceGroup : msal4j-servlet-auth-1707220080695-rg
Region : centralus
PricingTier : P1v3
OS : Linux
Java Version: Java 11
Web server stack: JBosseap 7
Deploy to slot : false
Confirm (Y/N) [Y]:
[INFO] Saving configuration to pom.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  26.196 s
[INFO] Finished at: 2024-02-06T11:48:16Z
[INFO] ------------------------------------------------------------------------

Después de confirmar las opciones, el complemento agrega la configuración del complemento y los valores necesarios al archivo pom.xml del proyecto para configurar la aplicación para que se ejecute en App de Azure Service.

La parte pertinente del archivo pom.xml debe ser similar al ejemplo siguiente:

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

Puede modificar las configuraciones de App Service directamente en la pom.xml. Algunas configuraciones comunes se enumeran en la tabla siguiente:

Propiedad	Obligatorio	Descripción	Versión
`schemaVersion`	false	Versión del esquema de configuración. Los valores admitidos son `v1` y `v2`.	1.5.2
`subscriptionId`	false	Identificador de la suscripción.	0.1.0+
`resourceGroup`	true	El grupo de recursos de Azure para la aplicación.	0.1.0+
`appName`	true	Nombre de la aplicación.	0.1.0+
`region`	false	Región en la que se va a hospedar la aplicación. El valor predeterminado es `centralus`. Para ver las regiones válidas, consulte Regiones admitidas.	0.1.0+
`pricingTier`	false	Plan de tarifa de la aplicación. El valor predeterminado es P1v2 para una carga de trabajo de producción. El valor mínimo recomendado para desarrollo y pruebas de Java es `B2`. Para más información, consulte Precios de App Service	0.1.0+
`runtime`	false	Configuración del entorno en runtime. Para obtener más información, consulte Detalles de configuración.	0.1.0+
`deployment`	false	Configuración de implementación. Para obtener más información, consulte Detalles de configuración.	0.1.0+

Para obtener la lista completa de configuraciones, consulte la documentación de referencia del complemento. Todos los complementos de Azure Maven comparten un conjunto común de configuraciones. Para estas configuraciones, consulte Configuraciones comunes. Para conocer las configuraciones específicas de App de Azure Service, consulte Aplicación de Azure: Detalles de configuración.

Asegúrese de guardar los appName valores y resourceGroup para su uso posterior.

Preparación de la aplicación para la implementación

Al implementar la aplicación en App Service, la dirección URL de redireccionamiento cambia a la dirección URL de redireccionamiento de la instancia de aplicación implementada. Siga estos pasos para cambiar esta configuración en el archivo de propiedades:

Vaya al archivo authentication.properties de la aplicación y cambie el valor de por el nombre de dominio de app.homePage la aplicación implementada, como se muestra en el ejemplo siguiente. Por ejemplo, si eligió example-domain para el nombre de la aplicación en el paso anterior, ahora debe usar https://example-domain.azurewebsites.net para el app.homePage valor . Asegúrese de que también ha cambiado el protocolo de http a 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
```
Después de guardar este archivo, use el siguiente comando para volver a generar la aplicación:
```
mvn clean package
```

Actualización del registro de la aplicación microsoft Entra ID

Dado que el URI de redirección cambia a la aplicación implementada en App de Azure Service, también debe cambiar el URI de redirección en el registro de la aplicación de Id. de Microsoft Entra. Para realizar este cambio, siga estos pasos:

Vaya a la página de Registros de aplicaciones de la plataforma de identidad de Microsoft para desarrolladores.
Use el cuadro de búsqueda para buscar el registro de la aplicación; por ejemplo, java-servlet-webapp-authentication.
Para abrir el registro de la aplicación, seleccione su nombre.
Seleccione Autenticar desde el menú.
En la sección URI de redirección web - , seleccione Agregar URI.
Rellene el URI de la aplicación, anexando /auth/redirect , por ejemplo, https://<your-app-name>.azurewebsites.net/auth/redirect.
Seleccione Guardar.

Implementar la aplicación

Ya está listo para implementar la aplicación en App de Azure Service. Use el comando siguiente para asegurarse de que ha iniciado sesión en el entorno de Azure para ejecutar la implementación:

az login

Con toda la configuración lista en el archivo pom.xml, ahora puede usar el siguiente comando para implementar la aplicación Java en Azure:

mvn package azure-webapp:deploy

Una vez completada la implementación, la aplicación está lista en http://<your-app-name>.azurewebsites.net/. Abra la dirección URL con el explorador web local, donde debería ver la página de inicio de la msal4j-servlet-auth aplicación.

Quitar valores secretos

El archivo authentication.properties de la aplicación contiene actualmente el valor del secreto de cliente en el aad.secret parámetro . No es recomendable mantener este valor en este archivo. Es posible que también se esté arriesgando si lo confirma en un repositorio de Git.

Como paso adicional de seguridad, puede almacenar este valor en Azure Key Vault y usar referencias de Key Vault para que esté disponible en la aplicación.

Siga estos pasos para mover el valor de aad.secret a Key Vault y úselo en el código:

Use los comandos siguientes para crear una instancia de 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 los siguientes comandos para agregar el valor secreto de a su almacén de aad.secret claves como un nuevo secreto:

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

Ahora debe conceder a la aplicación acceso al almacén de claves. Para realizar esta tarea, cree primero una nueva identidad para la aplicación mediante los siguientes comandos:
```
export WEB_APP_NAME=<your-web-app-name>
az webapp identity assign \
    --resource-group $RESOURCE_GROUP \
    --name $WEB_APP_NAME
```

Use los siguientes comandos para conceder a esta identidad get y list permiso en los secretos de 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

Use el siguiente comando para crear una configuración de aplicación en la aplicación que use una referencia del almacén de claves al secreto del almacén de claves. Esta configuración hace que el valor del secreto esté disponible para la aplicación como una variable de entorno.
```
az webapp config appsettings set \
    --resource-group $RESOURCE_GROUP \
    --name $WEB_APP_NAME \
    --settings AADSECRET='@Microsoft.KeyVault(VaultName=$KEY_VAULT;SecretName=AADSECRET)'
```
Use el código siguiente para cargar este valor desde las variables de entorno. En el archivo \src\main\java\com\microsoft\azuresamples\msal4j\helpers\Config.java, en la línea 41, cambie la instrucción actual a la siguiente línea:
```
public static final String SECRET = System.getenv("AADSECRET");
```
Ahora puede eliminar la clave y el aad.secret valor del archivo authentication.properties .
Vuelva a generar el código mediante el comando siguiente:
```
mvn clean package
```
Vuelva a implementar la aplicación mediante el comando siguiente:
```
mvn package azure-webapp:deploy
```

La implementación ha finalizado.

Compartir a través de