Nasazení aplikací Java Tomcat do služby Azure App Service

V tomto článku se dozvíte, jak nasadit aplikaci Tomcat s přihlášením pomocí účtu Microsoft Entra do služby Azure App Service.

Tento článek předpokládá, že jste dokončili jeden z následujících článků jenom pomocí karty Spustit místně a teď chcete nasadit aplikaci na Azure. Tyto pokyny jsou stejné jako pokyny na kartě Nasazení do Azure v těchto článcích:

• Povolení přihlašování pro aplikace Java Tomcat pomocí Microsoft Entra ID
• Povolení přihlašování pro aplikace Java Tomcat pomocí MSAL4J s azure Active Directory B2C
• Umožněte aplikacím Java Tomcat přihlašovat uživatele a přistupovat k Microsoft Graphu
• zabezpečení aplikací Java Tomcat pomocí rolí a deklarací identity rolí
• zabezpečení aplikací Java Tomcat pomocí skupin a deklarací identity skupin

Požadavky

• modul plug-in Maven pro aplikace Azure App Service

  Pokud maven není vaším upřednostňovaným nástrojem pro vývoj, projděte si následující podobné kurzy, které používají jiné nástroje:

  • IntelliJ IDEA
  • Zatmění
  • Visual Studio Code

• Azure CLI

Konfigurace modulu plug-in Maven

Když nasadíte do služby Azure App Service, nasazení automaticky použije vaše přihlašovací údaje Azure z Azure CLI. Pokud se Azure CLI nenainstaluje místně, pak se modul plug-in Maven ověří pomocí OAuth nebo přihlášení zařízení. Další informace naleznete v části ověřování pomocí pluginů Maven.

Ke konfiguraci modulu plug-in použijte následující postup:

1. Spuštěním následujícího příkazu nakonfigurujte nasazení. Tento příkaz vám pomůže nastavit operační systém Azure App Service, verzi Javy a verzi Tomcat.

   mvn com.microsoft.azure:azure-webapp-maven-plugin:2.13.0:config
   

2. Pro Vytvořit novou konfiguraci spuštění, stiskněte Ya stiskněte Enter.

3. Pro Definovat hodnotu prooperačního systému stiskněte 1 pro Windows nebo 2 pro Linux a stiskněte Enter.

4. Pro Definujte hodnotu pro javaVersion, stiskněte 2 pro Javu 11 a poté stiskněte klávesu Enter.

5. Pro Definovat hodnotu prowebContainer stiskněte 4 pro Tomcat 9,0 a stiskněte Enter.

6. Pokud chcete definovat hodnotu propricingTier, stiskněte Enter k výběru výchozí úrovně P1v2.

7. Pro Potvrďte, stiskněte Ya pak stiskněte Enter.

Následující příklad ukazuje výstup procesu nasazení:

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

Jakmile potvrdíte volby, modul plug-in přidá do souboru pom.xml projektu požadovaný prvek modulu plug-in a nakonfiguruje aplikaci tak, aby běžela ve službě Azure App Service.

Relevantní část souboru pom.xml by měla vypadat podobně jako v následujícím příkladu:

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

Konfigurace služby App Service můžete upravit přímo v pom.xml. Některé běžné konfigurace jsou uvedeny v následující tabulce:

Majetek / Vlastnost	Povinný	Popis
subscriptionId	falešný	ID předplatného.
resourceGroup	pravda	Skupina prostředků Azure pro vaši aplikaci.
appName	pravdivý	Název aplikace.
region	falešný	Oblast, ve které se má aplikace hostovat. Výchozí hodnota je centralus. Pro platné regiony se podívejte na podporované regiony.
pricingTier	falešný	Cenová úroveň vaší aplikace. Výchozí hodnota je P1v2 pro produkční úlohu. Doporučená minimální hodnota pro vývoj a testování v Javě je B2. Další informace najdete na ceny služby App Service.
runtime	falešný	Konfigurace prostředí runtime. Další informace naleznete v tématu konfigurační detaily.
deployment	falešný	Konfigurace nasazení. Další informace naleznete v tématu Konfigurační podrobnosti.

Úplný seznam konfigurací najdete v referenční dokumentaci k modulu plug-in. Všechny moduly plug-in Azure Maven sdílejí společnou sadu konfigurací. Informace o těchto konfiguracích najdete v Běžných Konfiguracích . Informace o konfiguracích specifických pro Azure App Service najdete v tématu aplikace Azure: Podrobnosti o konfiguraci.

Nezapomeňte uložit appName a resourceGroup hodnoty pro pozdější použití.

Příprava aplikace na nasazení

Když nasadíte aplikaci do služby App Service, adresa URL pro přesměrování se změní na adresu URL pro přesměrování vaší nasazené instance aplikace. Pomocí následujícího postupu změňte tato nastavení v souboru vlastností:

1. Přejděte do souboru authentication.properties vaší aplikace a změňte hodnotu app.homePage na název domény nasazené aplikace, jak je znázorněno v následujícím příkladu. Pokud jste například v předchozím kroku zvolili example-domain pro název aplikace, musíte pro hodnotu app.homePage použít https://example-domain.azurewebsites.net. Ujistěte se, že jste také změnili protokol z http na 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
   

2. Po uložení tohoto souboru pomocí následujícího příkazu znovu sestavte aplikaci:

   mvn clean package
   

Aktualizace registrace aplikace Microsoft Entra ID

Protože se identifikátor URI přesměrování změní kvůli nasazení vaší aplikace do služby Azure App Service, je také nutné změnit identifikátor URI přesměrování v registraci aplikace v systému Microsoft Entra ID. K provedení této změny použijte následující postup:

1. Přejděte na platformu Microsoft identity pro vývojáře, na stránku registrace aplikací .

2. Pomocí vyhledávacího pole vyhledejte registraci aplikace , například java-servlet-webapp-authentication.

3. Výběrem jejího názvu otevřete registraci aplikace.

4. V nabídce vyberte Ověřování.

5. V části přesměrovací URI - vyberte Přidat URI.

6. Vyplňte identifikátor URI aplikace a připojte /auth/redirect – například https://<your-app-name>.azurewebsites.net/auth/redirect.

7. Vyberte Uložit.

Nasazení aplikace

Teď jste připraveni nasadit aplikaci do služby Azure App Service. Pomocí následujícího příkazu se ujistěte, že jste přihlášení ke svému prostředí Azure a spusťte nasazení:

az login

S veškerou konfigurací připravenou v souboru pom.xml teď můžete pomocí následujícího příkazu nasadit aplikaci v Javě do Azure:

mvn package azure-webapp:deploy

Po dokončení nasazení je vaše aplikace připravená k použití na http://<your-app-name>.azurewebsites.net/. Otevřete adresu URL v místním webovém prohlížeči, kde byste měli vidět úvodní stránku msal4j-servlet-auth aplikace.

Odstraňte tajné hodnoty

Soubor authentication.properties aplikace aktuálně obsahuje hodnotu tajného klíče klienta v parametru aad.secret. Tuto hodnotu v tomto souboru není vhodné zachovat. Možná také riskujete, když ho nahrajete do úložiště Git.

Jako další krok zabezpečení můžete tuto hodnotu uložit ve službě azure Key Vault a pomocí reference ke službě Key Vault ji zpřístupnit ve vaší aplikaci.

Pomocí následujících kroků přesuňte hodnotu aad.secret do služby Key Vault a použijte ji ve svém kódu:

1. K vytvoření instance služby Azure Key Vault použijte následující příkazy:

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

2. Pomocí následujících příkazů přidejte hodnotu tajného kódu aad.secret do trezoru klíčů jako nový tajný klíč:

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

3. Teď potřebujete aplikaci udělit přístup k trezoru klíčů. K provedení této úlohy nejprve vytvořte novou identitu aplikace pomocí následujících příkazů:

   export WEB_APP_NAME=<your-web-app-name>
   az webapp identity assign \
       --resource-group $RESOURCE_GROUP \
       --name $WEB_APP_NAME
   

4. Pomocí následujících příkazů dejte této identitě get a list oprávnění k tajným kódům ve službě 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
   

5. Pomocí následujícího příkazu vytvořte nastavení aplikace, které používá referenci na trezor klíčů k tajemství ve vašem trezoru klíčů. Toto nastavení zpřístupňuje hodnotu tajného kódu vaší aplikaci jako proměnnou prostředí.

   az webapp config appsettings set \
       --resource-group $RESOURCE_GROUP \
       --name $WEB_APP_NAME \
       --settings AADSECRET='@Microsoft.KeyVault(VaultName=$KEY_VAULT;SecretName=AADSECRET)'
   

6. K načtení této hodnoty z proměnných prostředí použijte následující kód. V souboru \src\main\java\com\microsoft\azuresamples\msal4j\helpers\Config.java změňte aktuální příkaz na následující řádek:

   public static final String SECRET = System.getenv("AADSECRET");
   

7. Teď můžete odstranit klíč aad.secret a hodnotu ze souboru authentication.properties.

8. Znovu sestavte kód pomocí následujícího příkazu:

   mvn clean package
   

9. Znovu nasaďte aplikaci pomocí následujícího příkazu:

   mvn package azure-webapp:deploy
   

Vaše nasazení je teď hotové.

Další informace

• Microsoft Authentication Library (MSAL) pro Javu
• Microsoft Identity Platform (Microsoft Entra ID pro vývojáře)
• Rychlý přehled: Registrace aplikace v Microsoft identity platformě
• Pochopení prostředí souhlasu aplikací Microsoft Entra ID
• Porozumění souhlasu uživatele a správce
• ukázky kódu MSAL