AbstractClientApplicationBase.Builder<T> 클래스

형식 매개 변수

T

public abstract static class AbstractClientApplicationBase.Builder<T>
extends Builder<T>

필드 요약

한정자 및 형식 필드 및 설명
protected boolean isInstanceDiscoveryEnabled

생성자 요약

생성자 Description
Builder(String clientId)

클라이언트 애플리케이션의 Builder 인스턴스를 만드는 생성자

메서드 요약

한정자 및 형식 메서드 및 설명
T aadInstanceDiscoveryResponse(String val)

테넌트 검색 엔드포인트 및 기관 별칭을 결정하는 데 사용할 인스턴스 검색 응답 데이터를 설정합니다.

T applicationName(String val)

원격 분석 목적으로 애플리케이션 이름 설정

T applicationVersion(String val)

원격 분석을 위해 애플리케이션 버전 설정

T authority(String val)

MSAL이 보안 토큰을 획득할 인증 기관 또는 STS(보안 토큰 서비스)의 URL을 설정합니다.

T autoDetectRegion(boolean val)

라이브러리가 인스턴스 검색 메타데이터를 가져올 때 애플리케이션이 실행 중인 Azure 지역을 검색하려고 시도해야 했음을 나타냅니다.

T azureRegion(String val)

라이브러리가 토큰 요청에서 기관의 서식을 지정하는 데 사용할 지역을 설정합니다.

T b2cAuthority(String val)

MSAL이 토큰을 획득할 인증 B2C 기관의 URL을 설정합니다. 유효한 B2C 기관은 다음과 같습니다. https://< something.b2clogin.com/tenant>/<<policy> MSAL Java 레거시 B2C 기관 형식도 지원합니다. https://< host>/tfp/tenant>/<<policy>는 그러나 MSAL Java 결국 레거시 형식 지원을 중지합니다.

T clientCapabilities(Set<String> capabilities)
T connectTimeoutForDefaultHttpClient(Integer val)

에서 만든 DefaultHttpClientHttpsURLConnection 연결에 사용되는 연결 시간 제한 값을 설정하며 사용자 지정 HTTP 클라이언트를 사용하는 경우에는 필요하지 않습니다.

T correlationId(String val)

API에서 사용할 선택적 상관 관계 ID를 설정합니다.

T executorService(ExecutorService val)

요청을 실행하는 데 사용할 Executor서비스를 설정합니다.

T httpClient(IHttpClient val)

모든 HTTP 요청에 대해 클라이언트 애플리케이션에서 사용할 HTTP 클라이언트를 설정합니다.

T instanceDiscovery(boolean val)

지금까지 MSAL은 ''microsoftonline'https://login.에 있는 중앙 엔드포인트에 연결했습니다.com'''은 특히 익숙하지 않은 기관을 사용하는 경우 일부 메타데이터를 획득합니다.

T logPii(boolean val)

로그Pii 설정 - Pii(개인 식별 정보)가 로그인될지 여부를 결정하는 부울 값입니다.

T oidcAuthority(String val)

일반 OpenIdConnect ID 공급자에 해당하는 알려진 기관을 설정합니다.

T proxy(Proxy val)

모든 네트워크 통신에 클라이언트 애플리케이션에서 사용할 프록시 구성(기본적으로 MSAL4J 사용 javax.net.ssl.HttpsURLConnection)을 설정합니다.

T readTimeoutForDefaultHttpClient(Integer val)

사용자 지정 HTTP 클라이언트를 사용하는 경우 필요하지 않은 HttpsURLConnection 연결에 DefaultHttpClient사용되는 읽기 시간 제한 값을 설정합니다.

T setTokenCacheAccessAspect(ITokenCacheAccessAspect val)

cache_data 지속성에 사용할 ITokenCacheAccessAspect를 설정합니다.

T sslSocketFactory(SSLSocketFactory val)

클라이언트 애플리케이션에서 모든 네트워크 통신에 사용할 SSLSocketFactory를 설정합니다.

T validateAuthority(boolean val)

알려진 기관 목록에 대해 기관을 확인해야 하는 경우 애플리케이션에 알리는 부울 값을 설정합니다.

다음에서 상속된 메서드 Builder

다음에서 상속된 메서드 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

필드 세부 정보

isInstanceDiscoveryEnabled

protected boolean isInstanceDiscoveryEnabled

생성자 세부 정보

Builder

public Builder(String clientId)

클라이언트 애플리케이션의 Builder 인스턴스를 만드는 생성자

매개 변수:

clientId - 애플리케이션 등록 포털에 등록된 애플리케이션의 클라이언트 ID(애플리케이션 ID)(portal.azure.com)

메서드 세부 정보

aadInstanceDiscoveryResponse

public T aadInstanceDiscoveryResponse(String val)

테넌트 검색 엔드포인트 및 기관 별칭을 결정하는 데 사용할 인스턴스 검색 응답 데이터를 설정합니다.

인증 기관 유효성 검사는 true로 설정된 경우에도 AbstractClientApplicationBase#validateAuthority 수행되지 않습니다.

자세한 내용은 https://aka.ms/msal4j-instance-discovery를 참조하세요.

매개 변수:

val - AAD 인스턴스 검색 엔드포인트의 JSON 형식 응답 값

반품:

메서드가 호출된 Builder의 인스턴스

applicationName

public T applicationName(String val)

원격 분석 목적으로 애플리케이션 이름 설정

매개 변수:

val - 애플리케이션 이름

반품:

메서드가 호출된 Builder의 인스턴스

applicationVersion

public T applicationVersion(String val)

원격 분석을 위해 애플리케이션 버전 설정

매개 변수:

val - 애플리케이션 버전

반품:

메서드가 호출된 Builder의 인스턴스

authority

public T authority(String val)

MSAL이 보안 토큰을 획득할 인증 기관 또는 STS(보안 토큰 서비스)의 URL을 설정합니다. 기본값은 AbstractClientApplicationBase#DEFAULT_AUTHORITY

매개 변수:

val - 권한의 문자열 값

반품:

메서드가 호출된 Builder의 인스턴스

Throw:

java.net.MalformedURLException - val이 잘못된 URL인 경우

autoDetectRegion

public T autoDetectRegion(boolean val)

라이브러리가 인스턴스 검색 메타데이터를 가져올 때 애플리케이션이 실행 중인 Azure 지역을 검색하려고 시도해야 했음을 나타냅니다. Azure VM 또는 다른 서비스와 같은 Azure 환경에서 실행하거나 환경에 구성된 환경 변수가 REGION_NAME 경우에만 지역을 검색할 수 있습니다. 여기서 자동 검색과 동시에 특정 지역을 AbstractClientApplicationBase#azureRegion 모두 사용하도록 설정할 수 있지만 불일치가 있는 경우 설정된 AbstractClientApplicationBase#azureRegion 지역이 우선합니다. 지원되는 시나리오에 대한 자세한 내용은 여기를 참조하세요. https://aka.ms/msal4j-azure-regions

매개 변수:

val - 부울(기본값은 false)

반품:

메서드가 호출된 Builder의 인스턴스

azureRegion

public T azureRegion(String val)

라이브러리가 토큰 요청에서 기관의 서식을 지정하는 데 사용할 지역을 설정합니다. 유효한 Azure 지역이 제공되면 라이브러리는 전역 ESTS 엔드포인트가 아닌 지역 ESTS-R 엔드포인트에서 토큰 요청을 시도합니다. 지역은 유효한 Azure 지역이어야 하며 미국 서부 Azure 지역의 'westus', 미국 중부 Azure 지역의 '중앙부'와 같은 짧은 이름을 사용해야 합니다. 여기서 특정 지역을 설정하고 동시에 자동 검색 AbstractClientApplicationBase#autoDetectRegion 을 사용하도록 설정할 수 있지만 불일치가 있는 경우 여기에 설정된 특정 지역이 자동 검색된 지역보다 우선합니다. 지원되는 시나리오에 대한 자세한 내용은 여기를 참조하세요. https://aka.ms/msal4j-azure-regions

매개 변수:

val - 문자열 지역 이름

반품:

메서드가 호출된 Builder의 인스턴스

b2cAuthority

public T b2cAuthority(String val)

MSAL이 토큰을 획득할 인증 B2C 기관의 URL을 설정합니다. https://< something.b2clogin.com/< 테넌트>/<정책> MSAL Java 레거시 B2C 기관 형식도 지원합니다. https://< host>/tfp/tenant>/<<policy>, 그러나 MSAL Java 결국 레거시 형식 지원을 중지합니다. 새 형식으로 마이그레이션하는 방법에 대한 자세한 내용은 여기를 참조하세요. https://aka.ms/msal4j-b2c

매개 변수:

val - validateAuthority에 대한 부울 값

반품:

메서드가 호출된 Builder의 인스턴스

Throw:

java.net.MalformedURLException

clientCapabilities

public T clientCapabilities(Set<String> capabilities)

매개 변수:

capabilities

connectTimeoutForDefaultHttpClient

public T connectTimeoutForDefaultHttpClient(Integer val)

에서 만든 DefaultHttpClientHttpsURLConnection 연결에 사용되는 연결 제한 시간 값을 설정하며 사용자 지정 HTTP 클라이언트를 사용하는 경우에는 필요하지 않습니다.

재정의:

AbstractClientApplicationBase.Builder<T>.connectTimeoutForDefaultHttpClient(Integer val)

매개 변수:

val - 시간 제한 값(밀리초)

반품:

메서드가 호출된 Builder의 인스턴스

correlationId

public T correlationId(String val)

API에서 사용할 선택적 상관 관계 ID를 설정합니다. 제공되지 않으면 API는 임의의 UUID를 생성합니다.

재정의:

AbstractClientApplicationBase.Builder<T>.correlationId(String val)

매개 변수:

val - 상관 관계 ID의 문자열 값

반품:

메서드가 호출된 Builder의 인스턴스

executorService

public T executorService(ExecutorService val)

요청을 실행하는 데 사용할 ExecutorService를 설정합니다. 개발자는 ExecutorService의 수명 주기를 유지 관리해야 합니다.

재정의:

AbstractClientApplicationBase.Builder<T>.executorService(ExecutorService val)

매개 변수:

val - ExecutorService 인스턴스

반품:

메서드가 호출된 Builder의 인스턴스

httpClient

public T httpClient(IHttpClient val)

모든 HTTP 요청에 대해 클라이언트 애플리케이션에서 사용할 HTTP 클라이언트를 설정합니다. HTTP 클라이언트의 세분화된 구성을 허용합니다.

재정의:

AbstractClientApplicationBase.Builder<T>.httpClient(IHttpClient val)

매개 변수:

val - 의 구현 IHttpClient

반품:

메서드가 호출된 Builder의 인스턴스

instanceDiscovery

public T instanceDiscovery(boolean val)

지금까지 MSAL은 특히 익숙하지 않은 기관을 사용하는 경우 일부 메타데이터를 얻기 위해 ''https://login.microsoftonline.com''에 있는 중앙 엔드포인트에 연결합니다. 이 동작을 인스턴스 검색이라고 합니다. 이 매개 변수는 기본적으로 true로 설정되며 인스턴스 검색을 사용하도록 설정합니다. 일부 기관을 미리 알지 못하지만 MSAL이 제공할 권한을 수락하도록 하려면 ''False'를 사용하여 인스턴스 검색을 무조건 사용하지 않도록 설정할 수 있습니다.

매개 변수:

val

logPii

public T logPii(boolean val)

logPii 설정 - Pii(개인 식별 정보)가 로그인될지 여부를 결정하는 부울 값입니다. 기본값은 false입니다.

재정의:

AbstractClientApplicationBase.Builder<T>.logPii(boolean val)

매개 변수:

val - logPii에 대한 부울 값

반품:

메서드가 호출된 Builder의 인스턴스

oidcAuthority

public T oidcAuthority(String val)

일반 OpenIdConnect ID 공급자에 해당하는 알려진 기관을 설정합니다. MSAL은 기관에 ".well-known/openid-configuration"을 추가하여 OIDC 메타데이터를 검색하고 엔드포인트를 확인합니다.

매개 변수:

val - 권한의 문자열 값

반품:

메서드가 호출된 Builder의 인스턴스

Throw:

java.net.MalformedURLException

proxy

public T proxy(Proxy val)

모든 네트워크 통신에 클라이언트 애플리케이션에서 사용할 프록시 구성(기본적으로 MSAL4J 사용 javax.net.ssl.HttpsURLConnection)을 설정합니다. 프록시 값이 전달되지 않으면 시스템 정의 속성이 사용됩니다. 클라이언트 애플리케이션에서 HTTP 클라이언트가 설정된 경우(ClientApplication.builder().httpClient()를 통해) 프록시 구성은 이 메서드를 통하지 않고 전달되는 HTTP 클라이언트 개체에서 수행되어야 합니다.

재정의:

AbstractClientApplicationBase.Builder<T>.proxy(Proxy val)

매개 변수:

val - 프록시 인스턴스

반품:

메서드가 호출된 Builder의 인스턴스

readTimeoutForDefaultHttpClient

public T readTimeoutForDefaultHttpClient(Integer val)

에서 만든 DefaultHttpClientHttpsURLConnection 연결에 사용되는 읽기 시간 제한 값을 설정하며 사용자 지정 HTTP 클라이언트를 사용하는 경우에는 필요하지 않습니다.

재정의:

AbstractClientApplicationBase.Builder<T>.readTimeoutForDefaultHttpClient(Integer val)

매개 변수:

val - 시간 제한 값(밀리초)

반품:

메서드가 호출된 Builder의 인스턴스

setTokenCacheAccessAspect

public T setTokenCacheAccessAspect(ITokenCacheAccessAspect val)

cache_data 지속성에 사용할 ITokenCacheAccessAspect를 설정합니다.

매개 변수:

val - ITokenCacheAccessAspect 인스턴스

반품:

메서드가 호출된 Builder의 인스턴스

sslSocketFactory

public T sslSocketFactory(SSLSocketFactory val)

클라이언트 애플리케이션에서 모든 네트워크 통신에 사용할 SSLSocketFactory를 설정합니다. 클라이언트 애플리케이션에서 HTTP 클라이언트를 설정하는 경우(ClientApplication.builder().httpClient()를 통해) SSL의 구성은 이 메서드가 아닌 HTTP 클라이언트에서 수행되어야 합니다.

재정의:

AbstractClientApplicationBase.Builder<T>.sslSocketFactory(SSLSocketFactory val)

매개 변수:

val - SSLSocketFactory의 인스턴스

반품:

메서드가 호출된 Builder의 인스턴스

validateAuthority

public T validateAuthority(boolean val)

알려진 기관 목록에 대해 기관을 확인해야 하는 경우 애플리케이션에 알리는 부울 값을 설정합니다. 권한은 다음 경우에만 유효성을 검사합니다. 1 - Azure Active Directory 기관(B2C 또는 ADFS 아님) 2 - 인스턴스 검색 메타데이터를 통해 설정되지 않음AbstractClientApplicationBase#aadAadInstanceDiscoveryResponse

기본값은 true입니다.

매개 변수:

val - validateAuthority에 대한 부울 값

반품:

메서드가 호출된 Builder의 인스턴스

적용 대상