Hızlı Başlangıç: Java web uygulamasına Microsoft ile oturum açma ekleme

Bu hızlı başlangıçta, bir Java web uygulamasının kullanıcıların oturum açmasını ve Microsoft Graph API'sini nasıl çağırasını gösteren bir kod örneği indirip çalıştırabilirsiniz. Herhangi bir Azure Active Directory (Azure AD) kuruluşundan kullanıcılar uygulamada oturum açmasını sağlar.

Genel bakış için örneğin nasıl çalıştığının diyagramına bakın.

Önkoşullar

Bu örneği çalıştırmak için şunları gerekir:

• Java Development Kit (JDK) 8 veya sonraki bir sürümü.
• Maven.

2. Adım: Kod örneğini indirme

 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

Projeyi çalıştırmak için şu adımlardan birini uygulayın:

• Ekli sunucuyu kullanarak doğrudan IDE'Spring Boot çalıştırın.
• Mavenkullanarak bunu bir WAR dosyasına paketlenin ve ardından Apache Tomcat gibi bir J2EE kapsayıcı çözümüne dağıtın.

Projeyi bir IDE'den çalıştırma

Web uygulamasını bir IDE'den çalıştırmak için Çalıştır'ı seçin ve projenin giriş sayfasına gidin. Bu örnek için standart giriş sayfası URL'si https://localhost:8443 olur.

1. Ön sayfada, kullanıcıları oturum açma bilgilerine yönlendirmek ve kimlik Azure Active Directory için Oturum Aç düğmesini seçin.

2. Kullanıcıların kimliği doğrulandıktan sonra, bu kullanıcılar'a yeniden yönlendir https://localhost:8443/msal4jsample/secure/aad edilir. Artık oturumlar ve sayfada kullanıcı hesabıyla ilgili bilgiler görüntülenir. Örnek kullanıcı arabiriminde şu düğmeler bulunur:

   • Oturum Açma: Geçerli kullanıcının uygulama dışında oturum açmasını sağlar ve bu kullanıcı giriş sayfasına yeniden yönlendirebilir.
   • Kullanıcı Bilgilerini Göster: Microsoft Graph için bir belirteç alır ve Graph içeren bir istekle Microsoft Graph'i çağırarak oturum açık olan kullanıcıyla ilgili temel bilgileri döndürür.

Projeyi Tomcat'den çalıştırma

Web örneğini Tomcat'e dağıtmak için kaynak kodda birkaç değişiklik yapın.

1. ms-identity-java-webapp/src/main/java/com.microsoft.azure.msalwebsample/MsalWebSampleApplication'ı açın.

   • Tüm kaynak kodu silin ve bu kodu şu kodla değiştirin:

      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. Tomcat'in varsayılan HTTP bağlantı noktası 8080'tir, ancak 8443 bağlantı noktası üzerinden bir HTTPS bağlantısına ihtiyacınız vardır. Bu ayarı yapılandırmak için:

   • tomcat/conf/server.xml.

   • etiketini <connector> arayın ve mevcut bağlayıcıyı şu bağlayıcıyla değiştirin:

     <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. Bir komut istemi penceresi açın. Bu örneğin kök klasörüne (dosyanın bulunduğu pom.xml) gidin ve projeyi mvn package derlemek için çalıştırın.

   • Bu komut, /targets dizininize bir msal-web-sample-0.1.0.war dosyası oluşturacak.
   • Bu dosyayı msal4jsample.war olarak yeniden adlandırır.
   • Tomcat veya başka bir J2EE kapsayıcı çözümünü kullanarak WAR dosyasını dağıtın.
     • msal4jsample.war dosyasını dağıtmak için, dosyayı Tomcat yüklemenizin /webapps/ dizinine kopyalayın ve ardından Tomcat sunucusunu başlatın.

4. Dosya dağıtıldıktan sonra tarayıcı kullanarak https://localhost:8443/msal4jsample 'a gidin.

Daha fazla bilgi

Örneğin nasıl çalıştığı

MSAL al

java için MSAL (MSAL4J), kullanıcıları oturum açmak için kullanılan java kitaplığı ve Microsoft kimlik platformu tarafından korunan bir apı 'ye erişmek için kullanılan belirteçleri ister.

Uygulamanızın pom.xml (Maven) veya Build. Gradle (Gradle) dosyasında aşağıdaki değişiklikleri yaparak bağımlılıklarınızı yönetmek için Maven veya Gradle kullanarak uygulamanıza MSAL4J ekleyin.

pom.xml:

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

Build. Gradle içinde:

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

MSAL Başlat

MSAL4J kullanacağınız dosyanın başlangıcına aşağıdaki kodu ekleyerek Java için MSAL öğesine bir başvuru ekleyin:

import com.microsoft.aad.msal4j.*;

Yardım ve destek

Yardıma ihtiyacınız varsa, bir sorun bildirmek veya Destek seçenekleriniz hakkında bilgi edinmek istiyorsanız, bkz. geliştiriciler Için yardım ve destek.

Sonraki adımlar

Microsoft kimlik platformu kullanıcılara oturum açmış web uygulamaları oluşturmaya yönelik daha ayrıntılı bir tartışma için bkz. çok parçalı senaryo serisi: