InteractiveRequestParameters.InteractiveRequestParametersBuilder 클래스

  • java.lang.Object
    • com.microsoft.aad.msal4j.InteractiveRequestParameters.InteractiveRequestParametersBuilder

public static class InteractiveRequestParameters.InteractiveRequestParametersBuilder

메서드 요약

한정자 및 형식 메서드 및 설명
InteractiveRequestParameters build()
InteractiveRequestParametersBuilder claims(ClaimsRequest claims)

표준 및 사용자 지정 클레임에 대한 요청을 허용하는 OIDC 클레임 요청 매개 변수를 통해 요청되는 클레임

InteractiveRequestParametersBuilder claimsChallenge(String claimsChallenge)

토큰 요청이 실패하고 응답에 챌린지 문자열이 있을 때 사용됩니다.

InteractiveRequestParametersBuilder domainHint(String domainHint)

사용자가 로그인하는 데 사용해야 하는 테넌트 또는 도메인에 대한 힌트를 제공합니다.

InteractiveRequestParametersBuilder extraHttpHeaders(Map<String,String> extraHttpHeaders)

토큰 요청에 헤더 추가

InteractiveRequestParametersBuilder extraQueryParameters(Map<String,String> extraQueryParameters)

사용되지 않음

프로덕션 시나리오에는 권장되지 않습니다. 이후 릴리스에서 제거될 예정이며 동작은 새 API로 대체될 수 있습니다.

토큰 요청에 추가 쿼리 매개 변수 추가

InteractiveRequestParametersBuilder httpPollingTimeoutInSeconds(int httpPollingTimeoutInSeconds)

라이브러리에서 인증 결과를 기다리는 시간(초)입니다.

InteractiveRequestParametersBuilder instanceAware(boolean instanceAware)

true로 설정하면 권한 부여 결과에는 사용자의 홈 클라우드에 대한 권한이 포함되며, 이 권한은 애플리케이션에 설정된 권한 대신 토큰 요청에 사용됩니다.

InteractiveRequestParametersBuilder loginHint(String loginHint)

사용자 이름/전자 메일 주소를 미리 알고 있는 경우 사용자의 로그인 페이지의 사용자 이름/전자 메일 주소 필드를 미리 채우는 데 사용할 수 있습니다.

InteractiveRequestParametersBuilder prompt(Prompt prompt)

필요한 사용자 상호 작용 유형을 나타냅니다.

InteractiveRequestParametersBuilder proofOfPossession(HttpMethod httpMethod, URI uri, String nonce)

이 요청에 대한 Pop매개 변수를 설정하여 요청이 전달자 토큰이 아닌 소유 증명 토큰을 검색할 수 있도록 합니다.

InteractiveRequestParametersBuilder redirectUri(URI redirectUri)

MSAL이 Azure AD에서 반환된 권한 부여 코드를 수신 대기하는 리디렉션 URI입니다.

InteractiveRequestParametersBuilder scopes(Set<String> scopes)

애플리케이션이 액세스를 요청하고 사용자가 동의할 범위입니다.

InteractiveRequestParametersBuilder systemBrowserOptions(SystemBrowserOptions systemBrowserOptions)

공용SystemBrowserOptions클라이언트애플리케이션에서 사용할 집합

InteractiveRequestParametersBuilder tenant(String tenant)

이 요청에 대한 기관 URL의 테넌트 값을 재정의합니다.

java.lang.String toString()
InteractiveRequestParametersBuilder windowHandle(long windowHandle)

올바른 부모로 UI 요소를 여는 데 사용되는 부모 창 핸들

다음에서 상속된 메서드 java.lang.Object

java.lang.Object.clone java.lang.Object.equals java.lang.Object.finalize java.lang.Object.getClass java.lang.Object.hashCode java.lang.Object.notify java.lang.Object.notifyAll java.lang.Object.toString java.lang.Object.wait java.lang.Object.wait java.lang.Object.wait

메서드 세부 정보

build

public InteractiveRequestParameters build()

claims

public InteractiveRequestParameters.InteractiveRequestParametersBuilder claims(ClaimsRequest claims)

표준 및 사용자 지정 클레임에 대한 요청을 허용하는 OIDC 클레임 요청 매개 변수를 통해 요청되는 클레임

매개 변수:

claims

claimsChallenge

public InteractiveRequestParameters.InteractiveRequestParametersBuilder claimsChallenge(String claimsChallenge)

토큰 요청이 실패하고 응답에 챌린지 문자열이 있을 때 사용됩니다.

매개 변수:

claimsChallenge

domainHint

public InteractiveRequestParameters.InteractiveRequestParametersBuilder domainHint(String domainHint)

사용자가 로그인하는 데 사용해야 하는 테넌트 또는 도메인에 대한 힌트를 제공합니다. 도메인 힌트의 값은 테넌트에 등록된 도메인입니다.

매개 변수:

domainHint

extraHttpHeaders

public InteractiveRequestParameters.InteractiveRequestParametersBuilder extraHttpHeaders(Map<String,String> extraHttpHeaders)

토큰 요청에 헤더 추가

매개 변수:

extraHttpHeaders

extraQueryParameters


public InteractiveRequestParameters.InteractiveRequestParametersBuilder extraQueryParameters(Map<String,String> extraQueryParameters)

사용되지 않음

프로덕션 시나리오에는 권장되지 않습니다. 이후 릴리스에서 제거될 예정이며 동작은 새 API로 대체될 수 있습니다.

토큰 요청에 추가 쿼리 매개 변수 추가

매개 변수:

extraQueryParameters

httpPollingTimeoutInSeconds

public InteractiveRequestParameters.InteractiveRequestParametersBuilder httpPollingTimeoutInSeconds(int httpPollingTimeoutInSeconds)

라이브러리에서 인증 결과를 기다리는 시간(초)입니다. 120초는 기본 시간 제한입니다.

이 시간 제한을 0 이하로 설정하면 무시되고 라이브러리는 대신 1초 시간 제한을 사용합니다.

매개 변수:

httpPollingTimeoutInSeconds

instanceAware

public InteractiveRequestParameters.InteractiveRequestParametersBuilder instanceAware(boolean instanceAware)

true로 설정하면 권한 부여 결과에는 사용자의 홈 클라우드에 대한 권한이 포함되며, 이 권한은 애플리케이션에 설정된 권한 대신 토큰 요청에 사용됩니다.

매개 변수:

instanceAware

loginHint

public InteractiveRequestParameters.InteractiveRequestParametersBuilder loginHint(String loginHint)

사용자 이름/전자 메일 주소를 미리 알고 있는 경우 사용자의 로그인 페이지의 사용자 이름/전자 메일 주소 필드를 미리 채우는 데 사용할 수 있습니다. 앱은 preferred_username 클레임을 사용하여 이전 로그인에서 사용자 이름을 이미 추출한 상태에서 다시 인증하는 동안 이 매개 변수를 사용하는 경우가 많습니다.

매개 변수:

loginHint

prompt

public InteractiveRequestParameters.InteractiveRequestParametersBuilder prompt(Prompt prompt)

필요한 사용자 상호 작용 유형을 나타냅니다.

매개 변수:

prompt

proofOfPossession

public InteractiveRequestParameters.InteractiveRequestParametersBuilder proofOfPossession(HttpMethod httpMethod, URI uri, String nonce)

이 요청에 대한 PopParameters를 설정하여 요청이 전달자 토큰이 아닌 소유 증명 토큰을 검색할 수 있도록 합니다.

자세한 내용은 다음을 참조 PopParameters 하세요. https://aka.ms/msal4j-pop

매개 변수:

httpMethod - "GET" 또는 "POST"와 같은 유효한 HTTP 메서드
uri - 애플리케이션이 액세스하려고 하는 다운스트림 보호 API의 URI(예: https://graph.microsoft.com/beta/me/profile
nonce - 인증되지 않은 리소스(예: Microsoft Graph)를 호출하고 팝 인증 체계와 연결된 WWW-Authenticate 헤더를 구문 분석하고 nonce 매개 변수를 추출하거나 후속 호출에서 Autheticate-Info 헤더를 구문 분석하고 다음 동의어 매개 변수를 추출하여 얻은 문자열입니다.

redirectUri

public InteractiveRequestParameters.InteractiveRequestParametersBuilder redirectUri(URI redirectUri)

MSAL이 Azure AD에서 반환된 권한 부여 코드를 수신 대기하는 리디렉션 URI입니다. 포트가 지정된 루프백 주소여야 합니다(예: http://localhost:3671). 포트가 지정되지 않은 경우 MSAL은 열린 포트를 찾습니다. 자세한 내용은 https://aka.ms/msal4j-interactive-request를 참조하세요.

null일 수 없습니다.

매개 변수:

redirectUri

scopes

public InteractiveRequestParameters.InteractiveRequestParametersBuilder scopes(Set<String> scopes)

애플리케이션이 액세스를 요청하고 사용자가 동의할 범위입니다.

매개 변수:

scopes

systemBrowserOptions

public InteractiveRequestParameters.InteractiveRequestParametersBuilder systemBrowserOptions(SystemBrowserOptions systemBrowserOptions)

PublicClientApplication에서 사용할 집합 SystemBrowserOptions

매개 변수:

systemBrowserOptions

tenant

public InteractiveRequestParameters.InteractiveRequestParametersBuilder tenant(String tenant)

이 요청에 대한 기관 URL의 테넌트 값을 재정의합니다.

매개 변수:

tenant

toString

public String toString()

재정의:

InteractiveRequestParameters.InteractiveRequestParametersBuilder.toString()

windowHandle

public InteractiveRequestParameters.InteractiveRequestParametersBuilder windowHandle(long windowHandle)

올바른 부모로 UI 요소를 여는 데 사용되는 부모 창 핸들

브라우저 시나리오 및 Windows 콘솔 애플리케이션의 경우 이 값을 설정할 필요가 없습니다.

Windows 콘솔 애플리케이션의 경우 MSAL Java 이 매개 변수가 설정되지 않은 경우 콘솔의 창 핸들을 검색하려고 시도합니다.

MSAL Java UI 요소 열기(예: MSALRuntime 사용 시)를 담당하는 시나리오의 경우 이 매개 변수가 필요하며 설정되지 않은 경우 예외가 throw됩니다.

매개 변수:

windowHandle

적용 대상