Pokyny k nasazení pro ukázky MSAL v Javě

MsAL Java lze nasadit na řadu webových a aplikačních serverů. I když přesný postup sestavení a nasazení bude záviset na vašem prostředí a stávajícím nastavení, tady jsou pokyny pro spuštění našich ukázek msAL Java na některých oblíbených webových nebo aplikačních serverech.

Sestavení souboru .war pomocí Mavenu

Všechny naše ukázky je možné sestavit pomocí Mavenu. Přejděte do adresáře obsahujícího soubor pom.xml projektu (obvykle stejný jako hlavní soubor README, pokud se pokoušíte spustit naše ukázky) a spusťte následující příkaz Maven:

mvn clean package

Tím by se měl vygenerovat soubor .war, který se dá spustit na různých webových nebo aplikačních serverech.

Před sestavením balíčku si všimněte, že většina konfiguračních souborů ukázek a pokynů README používá http://localhost:8080 nebo https://localhost:8443 jako výchozí adresu URL pro přesměrování. Tyto porty fungují pro Apache Tomcat a možná i integrované aplikační servery při spuštění přímo z integrovaného vývojového prostředí (IDE), ale některé podnikové aplikační servery, jako je Weblogic, JBoss a Websphere, používají jiné výchozí porty. Pokud chcete spustit ukázku na těchto serverech, budete muset změnit konfiguraci v určitých souborech a v registraci aplikace Azure pro tuto ukázku a následující pokyny zahrnují, kde provést tyto změny a jaké jsou pravděpodobné výchozí porty.

Spuštění na Apache Tomcatu

(Tyto pokyny předpokládají, že máte v systému nainstalovaný Tomcat)

Spuštění ukázky v Tomcatu:

1. V instalaci Tomcat se ujistěte, že je <connector> položka v tomcat/conf/server.xml pro adresu, na které chcete hostovat aplikaci.

   • Ve výchozím nastavení naše ukázky očekávají připojení k http://localhost:8080 nebo https://localhost:8443, jak je definováno hodnotou app.homePage v souboru authentication.properties.

2. Zkopírujte soubor .war, který jste vygenerovali pomocí Mavenu, do adresáře /webapps/ v instalaci Tomcat a spusťte server Tomcat.

3. Po spuštění aplikace Tomcat otevřete prohlížeč a přejděte na libovolnou adresu URL, kterou jste definovali v kroku 1, a měli byste mít přístup k aplikaci.

Na platformě WebLogic

(Tyto pokyny předpokládají, že jste nainstalovali WebLogic a nastavili jste určitou doménu serveru).

Před nasazením do WebLogic budete muset provést určité změny konfigurace v samotné ukázce a (znovu) sestavit balíček:

1. V ukázce pravděpodobně je soubor application.properties nebo authentication.properties, ve kterém jste nakonfigurovali ID klienta, tenanta, adresu URL přesměrování atd.

2. Ve výše uvedeném souboru změňte odkazy na localhost:8080 nebo localhost:8443 na adresu URL/port, na kterých bude WebLogic spuštěn, což by ve výchozím nastavení mělo být localhost:7001

3. Budete také muset provést stejnou změnu v registraci aplikace v Azure, kde ji nastavíte jako „identifikátor URI pro přesměrování“ na kartě „Authentication“.

Nasazení ukázky do WebLogic prostřednictvím webové konzoly:

1. Spuštění serveru WebLogic pomocí DOMAIN_NAME\bin\startWebLogic.cmd

2. Přejděte do webové konzoly WebLogic v prohlížeči. http://localhost:7001/console

3. Přejděte do části Nasazení struktury > domény, klikněte na Nainstalovat, klikněte na nahrát soubory a najděte soubor .war, který jste vytvořili pomocí Mavenu.

4. Vyberte možnost „Nainstalovat toto nasazení jako aplikaci“, klikněte na tlačítko Další, klikněte na tlačítko Dokončit a potom na tlačítko Uložit.

   • Většina výchozích nastavení by měla být v pořádku s tím rozdílem, že byste měli aplikaci pojmenovat tak, aby odpovídala identifikátoru URI přesměrování, který jste nastavili v ukázkové konfiguraci/Azure registraci aplikace, tj. pokud je http://localhost:7001/msal4j-servlet-auth identifikátor URI přesměrování, měli byste aplikaci pojmenovat msal4j-servlet-auth.

5. Vraťte se do části Struktura domény > Nasazení a spusťte aplikaci.

6. Po spuštění aplikace přejděte na http://localhost:7001/{whatever you named the application}/a měli byste mít přístup k aplikaci.

Spuštění v JBoss EAP

Před nasazením do JBoss budete muset provést určité změny konfigurace v samotné ukázce a (znovu) sestavit balíček:

1. V ukázce je pravděpodobně soubor application.properties nebo authentication.properties, ve kterém jste nakonfigurovali ID klienta, tenanta, adresu URL pro přesměrování atd.

2. Ve výše uvedeném souboru změňte odkazy na localhost:8080 nebo localhost:8443 na adresu URL/port, na které bude JBoss spuštěn; ve výchozím nastavení by to mělo být localhost:9990

3. Budete také muset provést stejnou změnu v registraci aplikace v Azure, kde ji nastavíte jako „Redirect URI“ na kartě „Authentication“.

Nasazení ukázky do protokolu JBoss EAP prostřednictvím webové konzoly:

1. Spuštění serveru JBoss pomocí %JBOSS_HOME%\bin\standalone.bat

2. V prohlížeči přejděte na webovou konzolu JBoss. http://localhost:9990

3. Přejděte do části Nasazení, klikněte na Přidat a nahrajte .war, kterou jste vytvořili.

4. Většina výchozích nastavení by měla být v pořádku s tím rozdílem, že byste měli aplikaci pojmenovat tak, aby odpovídala identifikátoru URI přesměrování, který jste nastavili v ukázkové konfiguraci/Azure registraci aplikace, tj. pokud je http://localhost:9990/msal4j-servlet-auth/ identifikátor URI přesměrování, měli byste aplikaci pojmenovat msal4j-servlet-auth.

5. Vyberte soubor .war, který jste nahráli, klikněte na En/Disable a potvrďte spuštění aplikace.

6. Po spuštění aplikace přejděte na http://localhost:9990/{whatever you named the application}/a měli byste mít přístup k aplikaci.

Běží na platformě WebSphere

(Tyto pokyny předpokládají, že jste nainstalovali Websphere a nastavili nějaký server) Před nasazením do Websphere budete muset provést určité změny konfigurace v samotné ukázce a (znovu) sestavit balíček:

1. V ukázce pravděpodobně najdete soubor application.properties nebo authentication.properties, ve kterém jste nakonfigurovali ID klienta, tenanta, adresu URL pro přesměrování atd.
2. Ve výše uvedeném souboru změňte odkazy na localhost:8080 nebo localhost:8443 na adresu URL nebo port, na kterých poběží Websphere, což by ve výchozím nastavení mělo být localhost:9080
3. Budete také muset provést stejnou změnu v registraci aplikace v Azure, kde ji nastavíte jako „Redirect URI“ na kartě „Authentication“.

Nasazení ukázky pomocí konzole Integrated Solutions Console systému WebSphere:

1. Na kartě Aplikace vyberte Nová aplikace a pak Nová podniková aplikace.

2. Vyberte soubor .war, který jste vytvořili, a potom klikejte na „Další“, dokud se nedostanete ke kroku instalace „Map context roots for Web modules“ (ostatní výchozí nastavení by měla vyhovovat).

3. U kořenového kontextu jej nastavte na stejnou hodnotu, jaká následuje za číslem portu v identifikátoru „Redirect URI“, který jste nastavili v ukázkové konfiguraci nebo při registraci aplikace v Azure, tj. pokud je identifikátor URI přesměrování http://localhost:9080/msal4j-servlet-auth/, pak by kořenový kontext měl být pouze „msal4j-servlet-auth“.

4. Klikněte na „Dokončit“ a po dokončení instalace aplikace přejděte na kartě „Aplikace“ do části „Websphere enterprise applications“.

5. V seznamu aplikací vyberte .war, kterou jste právě nainstalovali, a kliknutím na Spustit nasaďte

6. Jakmile se dokončí nasazení, přejděte na http://localhost:9080/{whatever you set as the context root} a měli byste vidět aplikaci.