Microsoft Entra ID를 사용하여 Tomcat 앱에 로그인 사용 - Azure

아티클
03/19/2024

이 문서에서는 Java용 MSAL(Microsoft 인증 라이브러리)을 사용하여 Microsoft Entra ID 테넌트에 사용자를 로그인하는 Java Tomcat 앱을 보여 줍니다.

다음 다이어그램은 앱의 토폴로지입니다.

앱의 토폴로지 다이어그램

클라이언트 앱은 MSAL4J(Java용 MSAL)를 사용하여 사용자를 자신의 Microsoft Entra ID 테넌트에 로그인하고 Microsoft Entra ID에서 ID 토큰을 가져옵니다. ID 토큰은 사용자가 이 테넌트를 사용하여 인증됨을 증명합니다. 앱은 사용자의 인증 상태 따라 경로를 보호합니다.

필수 조건

JDK 버전 8 이상
Maven 3
Microsoft Entra ID 테넌트입니다. 자세한 내용은 Microsoft Entra ID 테넌트를 가져오는 방법을 참조 하세요.
조직 디렉터리의 계정(즉, 단일 테넌트 모드)만 사용하려는 경우 사용자 고유의 Microsoft Entra ID 테넌트에 있는 사용자 계정입니다. Microsoft Entra ID 테넌트에서 사용자 계정을 만들지 않은 경우 계속하기 전에 만들어야 합니다. 자세한 내용은 사용자를 만들고 초대하고 삭제하는 방법을 참조 하세요.
조직의 모든 디렉터리(다중 테넌트 모드)의 계정으로 작업하려는 경우 조직의 Microsoft Entra ID 테넌트의 사용자 계정입니다. 개인 Microsoft 계정으로 작업하려면 이 샘플을 수정해야 합니다. Microsoft Entra ID 테넌트에서 사용자 계정을 아직 만들지 않은 경우 계속하기 전에 만들어야 합니다. 자세한 내용은 사용자를 만들고 초대하고 삭제하는 방법을 참조 하세요.
개인 Microsoft 계정(예: Xbox, Hotmail, Live 등)을 개인 Microsoft 계정으로 작업하려는 경우

권장 사항

Java / Jakarta Servlets에 대한 몇 가지 친숙함.
Linux/OSX 터미널 또는 Windows PowerShell에 대해 잘 알고 있습니다.
토큰을 검사하기 위한 jwt.ms.
네트워크 활동 모니터링 및 문제 해결을 위한 Fiddler 입니다.
Microsoft Entra ID 블로그에 따라 최신 개발을 최신 상태로 유지합니다.

샘플 설정

다음 섹션에서는 샘플 애플리케이션을 설정하는 방법을 보여줍니다.

샘플 리포지토리 복제 또는 다운로드

샘플을 복제하려면 Bash 창을 열고 다음 명령을 사용합니다.

git clone https://github.com/Azure-Samples/ms-identity-java-servlet-webapp-authentication.git
cd 1-Authentication/sign-in

또는 ms-identity-java-servlet-webapp-authentication 리포지토리로 이동한 다음, .zip 파일로 다운로드하여 하드 드라이브에 추출합니다.

Important

Windows에서 파일 경로 길이 제한을 방지하려면 리포지토리를 하드 드라이브 루트 근처의 디렉터리에 복제하거나 추출합니다.

Microsoft Entra ID 테넌트에 샘플 애플리케이션 등록

이 샘플에는 하나의 프로젝트가 있습니다. Azure Portal에서 앱을 등록하려면 수동 구성 단계를 따르거나 PowerShell 스크립트를 사용할 수 있습니다. 스크립트는 다음 작업을 수행합니다.

Microsoft Entra ID 애플리케이션 및 관련 개체(예: 암호, 권한 및 종속성)를 만듭니다.
프로젝트 구성 파일을 수정합니다.
기본적으로 조직 디렉터리의 계정에서만 작동하는 애플리케이션을 설정합니다.

PowerShell 사용
수동 단계 사용

다음 단계를 사용하여 PowerShell 스크립트를 실행합니다.

Windows에서 PowerShell을 열고 복제된 디렉터리의 루트로 이동합니다.
다음 명령을 사용하여 PowerShell에 대한 실행 정책을 설정합니다.
```
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -Force
```
다음 명령을 사용하여 구성 스크립트를 실행합니다.
```
cd .\AppCreationScripts\
.\Configure.ps1
```
참고 항목

스크립트를 실행하는 다른 방법은 앱 만들기 스크립트에 설명되어 있습니다. 또한 스크립트는 CI/CD 시나리오에 도움이 될 수 있는 자동화된 애플리케이션 등록, 구성 및 제거에 대한 가이드를 제공합니다.

먼저 빠른 시작의 지침에 따라 Azure Portal에 앱을 등록합니다. Microsoft ID 플랫폼 애플리케이션을 등록합니다.

그런 다음, 다음 단계를 사용하여 등록을 완료합니다.

개발자용 Microsoft ID 플랫폼의 앱 등록 페이지로 이동합니다.
새 등록을 선택합니다.
표시되는 애플리케이션 등록 페이지에서 다음 애플리케이션 등록 정보를 입력합니다.
- 이름 섹션에서 앱 사용자에게 표시할 의미 있는 애플리케이션 이름(예java-servlet-webapp-authentication: .)을 입력합니다.
- 지원되는 계정 유형에서 다음 옵션 중 하나를 선택합니다.
  - 테넌트의 사용자(즉, 단일 테넌트 애플리케이션)에서만 사용할 애플리케이션을 빌드하는 경우에만 이 조직 디렉터리에서 계정을 선택합니다.
  - Microsoft Entra ID 테넌트의 사용자가 애플리케이션( 다중 테넌트 애플리케이션)을 사용할 수 있도록 하려면 조직 디렉터리에서 계정을 선택합니다.
  - 가장 광범위한 고객 집합, 즉 Microsoft 개인 계정 지원하는 다중 테넌트 애플리케이션에 대한 조직 디렉터리 및 개인 Microsoft 계정에서 계정을 선택합니다.
  - 개인 Microsoft 계정(예: Hotmail, Live, Skype 및 Xbox 계정)의 사용자만 사용할 개인 Microsoft 계정을 선택합니다.
- 리디렉션 URI 섹션의 콤보 상자에서 웹을 선택하고 다음 리디렉션 URIhttp://localhost:8080/msal4j-servlet-auth/auth/redirect를 입력합니다.
등록을 선택하여 애플리케이션을 만듭니다.
앱의 등록 페이지에서 나중에 사용할 애플리케이션(클라이언트) ID 값을 찾아 복사합니다. 앱의 구성 파일 또는 파일에서 이 값을 사용합니다.
앱의 등록 페이지에서 탐색 창에서 인증서 및 비밀을 선택하여 비밀을 생성하고 인증서를 업로드하는 페이지를 엽니다.
클라이언트 비밀 섹션에서 새 클라이언트 비밀을 선택합니다.
설명(예: 앱 비밀)을 입력합니다.
사용 가능한 기간 중 하나(1년, 2년 후 또는 만료 안 됨) 중 하나를 선택합니다.
추가를 선택합니다. 생성된 값이 표시됩니다.
이후 단계에서 사용할 생성된 값을 복사하고 저장합니다. 코드의 구성 파일에 이 값이 필요합니다. 이 값은 다시 표시되지 않으며 다른 어떤 수단으로도 검색할 수 없습니다. 따라서 다른 화면 또는 창으로 이동하기 전에 Azure Portal에서 저장해야 합니다.

앱 등록을 사용하도록 앱 구성

다음 단계를 사용하여 앱을 구성합니다.

참고 항목

다음 단계에서 ClientID 는 같거나 AppId같습니다Application ID.

IDE에서 프로젝트를 엽니다.
./src/기본/resources/authentication.properties 파일을 엽니다.
문자열 {enter-your-tenant-id-here}를 찾습니다. 기존 값을 다음 값 중 하나로 바꿉다.
- 이 조직 디렉터리 전용 옵션의 계정에 앱을 등록한 경우 Microsoft Entra ID 테넌트 ID입니다.
- 조직 디렉터리 옵션의 계정에 앱을 등록한 경우의 단어 organizations 입니다.
- 조직 디렉터리 및 개인 Microsoft 계정 옵션의 계정에 앱을 등록한 경우의 단어 common 입니다.
- 개인 Microsoft 계정 옵션으로 앱을 등록한 경우의 단어 consumers 입니다.
문자열 {enter-your-client-id-here} 을 찾아 기존 값을 애플리케이션 ID 또는 clientId Azure Portal에서 복사한 애플리케이션으로 java-servlet-webapp-authentication 바꿉니다.
문자열 {enter-your-client-secret-here} 을 찾고 Azure Portal에서 앱을 만드는 java-servlet-webapp-authentication 동안 저장한 값으로 기존 값을 바꿉니다.

샘플 빌드

Maven을 사용하여 샘플을 빌드하려면 샘플에 대한 pom.xml 파일이 포함된 디렉터리로 이동한 다음 다음 명령을 실행합니다.

mvn clean package

이 명령은 다양한 애플리케이션 서버에서 실행할 수 있는 .war 파일을 생성합니다.

다음 섹션에서는 샘플을 Azure 앱 Service에 배포하는 방법을 보여줍니다.

필수 조건

Azure 앱 Service 앱용 Maven 플러그 인

Maven이 선호하는 개발 도구가 아닌 경우 다른 도구를 사용하는 다음과 같은 유사한 자습서를 참조하세요.

Maven 플러그 인 구성

Azure 앱 Service에 배포하는 경우 배포는 Azure CLI에서 Azure 자격 증명을 자동으로 사용합니다. Azure CLI가 로컬로 설치되어 있지 않으면 Maven 플러그 인은 OAuth 또는 디바이스 로그인으로 인증됩니다. 자세한 내용은 Maven 플러그 인으로 인증을 참조하세요.

다음 단계를 사용하여 플러그 인을 구성합니다.

다음 명령을 실행하여 배포를 구성합니다. 이 명령을 사용하면 Azure 앱 Service 운영 체제, Java 버전 및 Tomcat 버전을 설정할 수 있습니다.
```
mvn com.microsoft.azure:azure-webapp-maven-plugin:2.12.0:config
```
새 실행 구성 만들기의 경우 Y 키를 누른 다음 Enter 키를 누릅니다.
OS 값 정의의 경우 Windows의 경우 1, Linux의 경우 2를 누른 다음 Enter 키를 누릅니다.
javaVersion 값 정의의 경우 Java 11에 대해 2 키를 누른 다음 Enter 키를 누릅니다.
webContainer 값 정의의 경우 Tomcat 9.0에 대해 4 키를 누른 다음 Enter 키를 누릅니다.
pricingTier에 대한 값 정의의 경우 Enter 키를 눌러 기본 P1v2 계층을 선택합니다.
확인을 위해 Y 키를 누른 다음 Enter 키를 누릅니다.

다음 예제에서는 배포 프로세스의 출력을 보여줍니다.

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

선택 사항을 확인한 후 플러그 인은 필요한 플러그 인 요소와 설정을 프로젝트의 pom.xml 파일에 추가하여 Azure 앱 Service에서 앱을 실행하도록 구성합니다.

pom.xml 파일의 관련 부분은 다음 예제와 유사해야 합니다.

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

pom.xml App Service에 대한 구성을 직접 수정할 수 있습니다. 몇 가지 일반적인 구성은 다음 표에 나열되어 있습니다.

속성	필수	설명
`subscriptionId`	false	구독 ID입니다.
`resourceGroup`	true	앱에 대한 Azure 리소스 그룹입니다.
`appName`	true	앱의 이름입니다.
`region`	false	앱을 호스트할 지역입니다. 기본값은 `centralus`입니다. 유효한 지역은 지원되는 지역을 참조 하세요.
`pricingTier`	false	앱의 가격 책정 계층입니다. 기본값은 `P1v2` 프로덕션 워크로드에 대한 것입니다. Java 개발 및 테스트에 권장되는 최소값은 .입니다 `B2`. 자세한 내용은 App Service 가격 책정을 참조 하세요.
`runtime`	false	런타임 환경 구성입니다. 자세한 내용은 구성 세부 정보를 참조하세요.
`deployment`	false	배포 구성입니다. 자세한 내용은 구성 세부 정보를 참조하세요.

전체 구성 목록은 플러그 인 참조 설명서를 참조하세요. 모든 Azure Maven 플러그 인은 공통 구성 집합을 공유합니다. 이러한 구성은 일반 구성을 참조 하세요. Azure 앱 Service와 관련된 구성은 Azure 앱: 구성 세부 정보를 참조하세요.

나중에 사용할 수 있도록 값과 resourceGroup 값을 따로 appName 저장해야 합니다.

배포를 위한 앱 준비

App Service에 애플리케이션을 배포하면 리디렉션 URL이 배포된 앱 인스턴스의 리디렉션 URL로 변경됩니다. 속성 파일에서 이러한 설정을 변경하려면 다음 단계를 사용합니다.

다음 예제와 같이 앱의 authentication.properties 파일로 이동하고 배포된 앱의 do기본 이름으로 값을 app.homePage 변경합니다. 예를 들어 이전 단계에서 앱 이름을 선택한 example-domain 경우 이제 값에 app.homePage 사용해야 https://example-domain.azurewebsites.net 합니다. 또한 프로토콜을 .로 http 변경했는지 확인합니다 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
```
이 파일을 저장한 후 다음 명령을 사용하여 앱을 다시 빌드합니다.
```
mvn clean package
```

Important

이 동일한 authentication.properties 파일에는 에 대한 설정이 있습니다 aad.secret. 이 값을 App Service에 배포하는 것은 좋지 않습니다. 이 값을 코드에 그대로 두고 git 리포지토리에 푸시하는 것도 좋은 방법이 아닙니다. 코드에서 이 비밀 값을 제거하기 위해 App Service에 배포 - 비밀 제거 섹션에서 자세한 지침을 찾을 수 있습니다. 이 지침은 Key Vault에 비밀 값을 푸시하고 Key Vault 참조를 사용하기 위한 추가 단계를 추가합니다.

Microsoft Entra ID 앱 등록 업데이트

리디렉션 URI가 배포된 앱에서 Azure 앱 서비스로 변경되므로 Microsoft Entra ID 앱 등록에서도 리디렉션 URI를 변경해야 합니다. 다음 단계에 따라 이 변경을 수행합니다.

개발자용 Microsoft ID 플랫폼의 앱 등록 페이지로 이동합니다.
검색 상자를 사용하여 앱 등록을 검색합니다(예: .) java-servlet-webapp-authentication.
이름을 선택하여 앱 등록을 엽니다.
메뉴에서 인증을 선택합니다.
웹 - 리디렉션 URI 섹션에서 URI 추가를 선택합니다.
앱의 URI를 입력하고 /auth/redirect 추가합니다(예 https://<your-app-name>.azurewebsites.net/auth/redirect: .).
저장을 선택합니다.

앱 배포하기

이제 Azure 앱 Service에 앱을 배포할 준비가 되었습니다. 다음 명령을 사용하여 배포를 실행하기 위해 Azure 환경에 로그인했는지 확인합니다.

az login

pom.xml 파일에 모든 구성이 준비되면 이제 다음 명령을 사용하여 Java 앱을 Azure에 배포할 수 있습니다.

mvn package azure-webapp:deploy

배포가 완료되면 애플리케이션이 준비됩니다 http://<your-app-name>.azurewebsites.net/. 로컬 웹 브라우저를 사용하여 URL을 엽니다. 여기서 애플리케이션의 시작 페이지가 msal4j-servlet-auth 표시됩니다.

Tomcat에서 샘플을 실행하려면 다음 단계를 사용합니다.

Tomcat 설치에서 애플리케이션을 호스트하려는 주소에 대한 tomcat/conf/server.xml 항목이 있는지 확인합니다.

기본적으로 샘플은 authentication.properties 파일의 app.homePage 값에 정의된 대로 연결http://localhost:8080 or https://localhost:8443하기만 하면 됩니다.
Maven을 사용하여 생성한 .war 파일을 Tomcat 설치의 /webapps/ 디렉터리에 복사하고 Tomcat 서버를 시작합니다.
Tomcat이 시작되면 브라우저를 열고 1단계에서 정의한 URL로 이동하여 애플리케이션에 액세스할 수 있어야 합니다.

샘플 탐색

다음 단계를 사용하여 샘플을 탐색합니다.

로그인 또는 로그아웃된 상태 화면 중앙에 표시됩니다.
모서리에서 상황에 맞는 단추를 선택합니다. 이 단추는 앱을 처음 실행할 때 로그인을 읽습니다.
다음 페이지에서 지침을 따르고 Microsoft Entra ID 테넌트에 있는 계정으로 로그인합니다.
동의 화면에서 요청되는 범위를 확인합니다.
이제 상황에 맞는 단추에 로그아웃이 표시되고 사용자 이름이 표시됩니다.
ID 토큰 세부 정보를 선택하여 ID 토큰의 디코딩된 클레임 중 일부를 확인합니다.
모서리의 단추를 사용하여 로그아웃합니다.
로그아웃한 후 ID 토큰 세부 정보를 선택하여 사용자에게 권한이 없는 경우 앱에 ID 토큰 클레임 대신 오류가 표시되는 401: unauthorized 지 확인합니다.

코드 정보

이 샘플에서는 MSAL4J(Java용 MSAL)를 사용하여 사용자를 Microsoft Entra ID 테넌트에 로그인하는 방법을 보여 줍니다. 사용자 고유의 애플리케이션에서 MSAL4J를 사용하려면 Maven을 사용하여 프로젝트에 추가해야 합니다.

이 샘플의 동작을 복제본(replica) 경우 src/기본/java/com/microsoft/azuresamples/msal4j 폴더에 있는 pom.xml 파일 및 도우미 및 authservlets 폴더의 내용을 복사할 수 있습니다. authentication.properties 파일도 필요합니다. 이러한 클래스 및 파일에는 다양한 애플리케이션에서 사용할 수 있는 제네릭 코드가 포함되어 있습니다. 샘플의 나머지 부분도 복사할 수 있지만 다른 클래스와 파일은 이 샘플의 목표를 해결하기 위해 특별히 빌드됩니다.

콘텐츠

다음 표에서는 샘플 프로젝트 폴더의 내용을 보여 줍니다.

파일/폴더	설명
AppCreationScripts/	Microsoft Entra ID 앱 등록을 자동으로 구성하는 스크립트입니다.
src/기본/java/com/microsoft/azuresamples/msal4j/authwebapp/	이 디렉터리에는 앱의 백 엔드 비즈니스 논리를 정의하는 클래스가 포함되어 있습니다.
src/기본/java/com/microsoft/azuresamples/msal4j/authservlets/	이 디렉터리에는 로그인 및 로그아웃 엔드포인트에 사용되는 클래스가 포함되어 있습니다.
____Servlet.java	사용 가능한 모든 엔드포인트는 ____Servlet.java 끝나는 .java 클래스에 정의됩니다.
src/기본/java/com/microsoft/azuresamples/msal4j/helpers/	인증을 위한 도우미 클래스입니다.
AuthenticationFilter.java	인증되지 않은 요청을 보호된 엔드포인트로 401 페이지로 리디렉션합니다.
src/기본/resources/authentication.properties	Microsoft Entra ID 및 프로그램 구성.
src/기본/webapp/	이 디렉터리에는 UI - JSP 템플릿이 포함되어 있습니다.
CHANGELOG.md	샘플의 변경 내용 목록입니다.
CONTRIBUTING.md	샘플에 기여하기 위한 지침입니다.
라이센스	샘플에 대한 라이선스입니다.

ConfidentialClientApplication

ConfidentialClientApplication 인스턴스는 다음 예제와 같이 AuthHelper.java 파일에 만들어집니다. 이 개체는 Microsoft Entra ID 권한 부여 URL을 만드는 데 도움이 되며 액세스 토큰에 대한 인증 토큰을 교환하는 데도 도움이 됩니다.

// getConfidentialClientInstance method
IClientSecret secret = ClientCredentialFactory.createFromSecret(SECRET);
confClientInstance = ConfidentialClientApplication
                     .builder(CLIENT_ID, secret)
                     .authority(AUTHORITY)
                     .build();

인스턴스화에는 다음 매개 변수가 사용됩니다.

앱의 클라이언트 ID입니다.
기밀 클라이언트 애플리케이션에 대한 요구 사항인 클라이언트 암호입니다.
Microsoft Entra ID 테넌트 ID를 포함하는 Microsoft Entra ID 기관입니다.

이 샘플에서 이러한 값은 Config.java 파일의 속성 판독기를 사용하여 authentication.properties 파일에서 읽 습니다.

단계별 안내

다음 단계에서는 앱의 기능에 대한 연습을 제공합니다.

로그인 프로세스의 첫 번째 단계는 Microsoft Entra ID 테넌트에 대한 엔드포인트에 요청을 /authorize 보내는 것입니다. MSAL4J ConfidentialClientApplication 인스턴스는 권한 부여 요청 URL을 생성하는 데 사용됩니다. 앱은 사용자가 로그인하는 이 URL로 브라우저를 리디렉션합니다.
```
final ConfidentialClientApplication client = getConfidentialClientInstance();
AuthorizationRequestUrlParameters parameters = AuthorizationRequestUrlParameters.builder(Config.REDIRECT_URI, Collections.singleton(Config.SCOPES))
        .responseMode(ResponseMode.QUERY).prompt(Prompt.SELECT_ACCOUNT).state(state).nonce(nonce).build();

final String authorizeUrl = client.getAuthorizationRequestUrl(parameters).toString();
contextAdapter.redirectUser(authorizeUrl);
```
다음 목록에서는 이 코드의 기능을 설명합니다.
- AuthorizationRequestUrlParameters: AuthorizationRequestUrl을 빌드하기 위해 설정해야 하는 매개 변수입니다.
- REDIRECT_URI: 여기서 Microsoft Entra ID는 사용자 자격 증명을 수집한 후 인증 코드와 함께 브라우저를 리디렉션합니다. Azure Portal의 Microsoft Entra ID 앱 등록에서 리디렉션 URI와 일치해야 합니다.
- SCOPES: 범위는 애플리케이션에서 요청한 권한입니다. 일반적으로 세 가지 범위는 openid profile offline_access ID 토큰 응답을 수신하는 데 충분합니다.
  
  authentication.properties 파일에서 앱에서 요청한 전체 범위 목록을 찾을 수 있습니다. 와 같은 User.Read더 많은 범위를 추가할 수 있습니다.
사용자에게 Microsoft Entra ID의 로그인 프롬프트가 표시됩니다. 로그인 시도가 성공하면 사용자의 브라우저가 앱의 리디렉션 엔드포인트로 리디렉션됩니다. 이 엔드포인트에 대한 유효한 요청에는 권한 부여 코드가 포함되어 있습니다.
그런 다음, 인스턴스는 ConfidentialClientApplication Microsoft Entra ID에서 ID 토큰 및 액세스 토큰에 대해 이 권한 부여 코드를 교환합니다.
```
// First, validate the state, then parse any error codes in response, then extract the authCode. Then:
// build the auth code params:
final AuthorizationCodeParameters authParams = AuthorizationCodeParameters
        .builder(authCode, new URI(Config.REDIRECT_URI)).scopes(Collections.singleton(Config.SCOPES)).build();

// Get a client instance and leverage it to acquire the token:
final ConfidentialClientApplication client = AuthHelper.getConfidentialClientInstance();
final IAuthenticationResult result = client.acquireToken(authParams).get();
```
다음 목록에서는 이 코드의 기능을 설명합니다.
- AuthorizationCodeParameters: ID 및/또는 액세스 토큰에 대한 권한 부여 코드를 교환하기 위해 설정해야 하는 매개 변수입니다.
- authCode: 리디렉션 엔드포인트에서 받은 권한 부여 코드입니다.
- REDIRECT_URI: 이전 단계에서 사용된 리디렉션 URI를 다시 전달해야 합니다.
- SCOPES: 이전 단계에서 사용된 범위를 다시 전달해야 합니다.

acquireToken이 성공하면 토큰 클레임이 추출됩니다. nonce 검사 통과하면 결과가 인스턴스 IdentityContextData 에 배치 context 되고 세션에 저장됩니다. 그런 다음, 애플리케이션은 다음 코드와 같이 액세스가 필요할 때마다 인스턴스 IdentityContextAdapterServlet 를 통해 세션에서 인스턴스화 IdentityContextData 할 수 있습니다.

// parse IdToken claims from the IAuthenticationResult:
// (the next step - validateNonce - requires parsed claims)
context.setIdTokenClaims(result.idToken());

// if nonce is invalid, stop immediately! this could be a token replay!
// if validation fails, throws exception and cancels auth:
validateNonce(context);

// set user to authenticated:
context.setAuthResult(result, client.tokenCache().serialize());

경로 보호

샘플 앱이 경로에 대한 액세스를 필터링하는 방법에 대한 자세한 내용은 AuthenticationFilter.java 참조하세요. authentication.properties 파일 app.protect.authenticated 에서 속성은 다음 예제와 같이 인증된 사용자만 액세스할 수 있는 쉼표로 구분된 경로를 포함합니다.

# for example, /token_details requires any user to be signed in and does not require special roles claim(s)
app.protect.authenticated=/token_details

범위

범위는 Microsoft Entra ID에 애플리케이션이 요청하는 액세스 수준을 알려줍니다.

요청된 범위에 따라 Microsoft Entra ID는 로그인 시 사용자에게 동의 대화 상자를 제공합니다. 사용자가 하나 이상의 범위에 동의하고 토큰을 가져오는 경우 범위 동의가 결과 access_token로 인코딩됩니다.

애플리케이션에서 요청한 범위는 authentication.properties를 참조하세요. 이러한 세 가지 범위는 MSAL에서 요청되며 기본적으로 Microsoft Entra ID에 의해 제공됩니다.

필수 조건

권장 사항

샘플 설정

샘플 리포지토리 복제 또는 다운로드

Microsoft Entra ID 테넌트에 샘플 애플리케이션 등록

앱 등록을 사용하도록 앱 구성

샘플 빌드

샘플 실행

필수 조건

Maven 플러그 인 구성

배포를 위한 앱 준비

Microsoft Entra ID 앱 등록 업데이트

앱 배포하기

샘플 탐색

코드 정보

콘텐츠

ConfidentialClientApplication

단계별 안내

경로 보호

범위

자세한 정보

피드백

피드백

추가 리소스

Microsoft Entra ID를 사용하여 Java Tomcat 앱에 로그인 사용

필수 조건

권장 사항

샘플 설정

샘플 리포지토리 복제 또는 다운로드

Microsoft Entra ID 테넌트에 샘플 애플리케이션 등록

앱 등록을 사용하도록 앱 구성

샘플 빌드

샘플 실행

필수 조건

Maven 플러그 인 구성

배포를 위한 앱 준비

Microsoft Entra ID 앱 등록 업데이트

앱 배포하기

샘플 탐색

코드 정보

콘텐츠

ConfidentialClientApplication

단계별 안내

경로 보호

범위

자세한 정보

피드백

피드백

추가 리소스