Rychlý Start: přidání přihlášení do webové aplikace Java pomocí Microsoftu

V tomto rychlém startu si stáhnete a spustíte ukázku kódu, která ukazuje, jak se může webová aplikace Java přihlašovat uživatelům a volat rozhraní Microsoft Graph API. uživatelé ze všech Azure Active Directory (Azure AD) se můžou přihlásit k aplikaci.

Přehled najdete v tématu o tom, jak ukázka funguje.

Požadavky

K provedení této ukázky budete potřebovat:

• Java Development Kit (JDK) 8 nebo novější.
• Maven.

Krok 2: stažení ukázky kódu

 keytool -genkeypair -alias testCert -keyalg RSA -storetype PKCS12 -keystore keystore.p12 -storepass password

 server.ssl.key-store-type=PKCS12
 server.ssl.key-store=classpath:keystore.p12
 server.ssl.key-store-password=password
 server.ssl.key-alias=testCert

Chcete-li spustit projekt, proveďte jeden z následujících kroků:

• Spusťte ji přímo z integrovaného vývojového prostředí pomocí integrovaného spouštěcího serveru.
• Zabalíte ho do souboru WAR pomocí Mavena pak ho nasadíte do řešení kontejnerů J2EE, jako je Apache Tomcat.

Spuštění projektu z integrovaného vývojového prostředí

Chcete-li spustit webovou aplikaci z rozhraní IDE, vyberte možnost spustit a poté přejít na domovskou stránku projektu. V této ukázce je adresa URL standardní domovské stránky https://localhost:8443 .

1. na přední stránce vyberte tlačítko pro přihlášení a přesměrujte uživatele na Azure Active Directory a vyzvat je k zadání přihlašovacích údajů.

2. Po ověření uživatelů budou přesměrováni na https://localhost:8443/msal4jsample/secure/aad . Jsou nyní přihlášeni a na stránce se zobrazí informace o uživatelském účtu. Ukázková uživatelská rozhraní mají tato tlačítka:

   • Odhlášení: podepíše aktuálního uživatele z aplikace a přesměruje tohoto uživatele na domovskou stránku.
   • zobrazit informace o uživateli: získá token pro Microsoft Graph a zavolá Microsoft Graph s požadavkem, který obsahuje token, který vrátí základní informace o přihlášeném uživateli.

Spuštění projektu z Tomcat

Pokud chcete nasadit webovou ukázku do Tomcat, proveďte několik změn zdrojového kódu.

1. Otevřete MS-identity-Java-WebApp/src/Main/Java/com. Microsoft. Azure. msalwebsample/MsalWebSampleApplication.

   • Odstraňte všechen zdrojový kód a nahraďte ho tímto kódem:

      package com.microsoft.azure.msalwebsample;
     
      import org.springframework.boot.SpringApplication;
      import org.springframework.boot.autoconfigure.SpringBootApplication;
      import org.springframework.boot.builder.SpringApplicationBuilder;
      import org.springframework.boot.web.servlet.support.SpringBootServletInitializer;
     
      @SpringBootApplication
      public class MsalWebSampleApplication extends SpringBootServletInitializer {
     
       public static void main(String[] args) {
        SpringApplication.run(MsalWebSampleApplication.class, args);
       }
     
       @Override
       protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
        return builder.sources(MsalWebSampleApplication.class);
       }
      }
     

2. Výchozí port HTTP Tomcat je 8080, ale budete potřebovat připojení HTTPS přes port 8443. Konfigurace tohoto nastavení:

   • Přejít na Tomcat/conf/server.xml.

   • Vyhledejte <connector> značku a nahraďte existující konektor tímto konektorem:

     <Connector
              protocol="org.apache.coyote.http11.Http11NioProtocol"
              port="8443" maxThreads="200"
              scheme="https" secure="true" SSLEnabled="true"
              keystoreFile="C:/Path/To/Keystore/File/keystore.p12" keystorePass="KeystorePassword"
              clientAuth="false" sslProtocol="TLS"/>
     

3. Otevřete okno příkazového řádku. Přejít do kořenové složky této ukázky (kde se nachází soubor pom.xml) a spustit mvn package pro sestavení projektu.

   • Tento příkaz vytvoří v adresáři /targets soubor msal-web-Sample-0.1.0. War .
   • Přejmenujte tento soubor na msal4jsample. War.
   • Nasaďte soubor WAR pomocí Tomcat nebo jakéhokoli jiného řešení kontejneru J2EE.
     • Pokud chcete nasadit soubor msal4jsample. War, zkopírujte ho do adresáře /webapps/ v instalaci Tomcat a potom spusťte server Tomcat.

4. Po nasazení souboru přejdete na https://localhost:8443/msal4jsample adresu pomocí prohlížeče.

Další informace

Jak ukázka funguje

Získat MSAL

MSAL for Java (MSAL4J) je knihovna Java používaná k přihlašování uživatelů a žádosti o tokeny, které se používají pro přístup k rozhraní API, které je chráněné Microsoft identity platform.

Přidejte do své aplikace MSAL4J pomocí Maven nebo Gradle pro správu závislostí provedením následujících změn v souboru aplikace pom.xml (Maven) nebo Build. Gradle (Gradle).

V pom.xml:

<dependency>
    <groupId>com.microsoft.azure</groupId>
    <artifactId>msal4j</artifactId>
    <version>1.0.0</version>
</dependency>

V sestavení. Gradle:

compile group: 'com.microsoft.azure', name: 'msal4j', version: '1.0.0'

Inicializovat MSAL

Přidáním následujícího kódu na začátek souboru, kde budete používat MSAL4J, přidejte odkaz na MSAL for Java:

import com.microsoft.aad.msal4j.*;

Nápověda a podpora

Pokud potřebujete pomoc, chcete ohlásit problém nebo získat informace o možnostech podpory, přečtěte si téma pomoc a podpora pro vývojáře.

Další kroky

podrobnější diskuzi o sestavování webových aplikací, které přihlásily uživatele na Microsoft identity platform, najdete v řadě scénářů s více částmi: