ConfidentialClientApplication Klasa

Pakiet:
com.microsoft.aad.msal4j
Artefakt Maven:
com.microsoft.azure:msal4j:1.26.0

Implementuje

IConfidentialClientApplication

public class ConfidentialClientApplication
extends AbstractClientApplicationBase
implements IConfidentialClientApplication

Klasa do uzyskiwania tokenów dla poufnych aplikacji klienckich (Web Apps, internetowych interfejsów API i aplikacji demona). Aby uzyskać szczegółowe informacje, zobacz IConfidentialClientApplication

Warunkowo bezpieczne wątkowo

Podsumowanie pola

Modyfikator i typ Pole i opis
java.util.function.Function<AppTokenProviderParameters,java.util.concurrent.CompletableFuture<TokenProviderResult>> appTokenProvider

Dostawca tokenuaplikacjitworzy poświadczenie na podstawie funkcji, która zapewnia tokeny dostępu.

Podsumowanie metody

Modyfikator i typ Metoda i opis
java.util.concurrent.CompletableFuture<IAuthenticationResult> acquireToken(ClientCredentialParameters parameters)

Uzyskuje tokeny z urzędu skonfigurowanego w aplikacji dla samego klienta poufnego.
java.util.concurrent.CompletableFuture<IAuthenticationResult> acquireToken(OnBehalfOfParameters parameters)

Uzyskuje token dostępu dla tej aplikacji (zazwyczaj internetowy interfejs API) z urzędu skonfigurowanego w aplikacji w celu uzyskania dostępu do innego podrzędnego chronionego internetowego interfejsu API w imieniu użytkownika przy użyciu przepływu on-Behalf-Of.
java.util.concurrent.CompletableFuture<IAuthenticationResult> acquireToken(UserFederatedIdentityCredentialParameters parameters)

Uzyskuje token przy użyciu przepływu poświadczeń tożsamości federacyjnej użytkownika (user_fic).
static Builder builder(String clientId, IClientCredential clientCredential)

Tworzy wystąpienie konstruktora poufnejaplikacji klienckiej
boolean sendX5c()

Metody dziedziczone z AbstractApplicationBase

connectTimeoutForDefaultHttpClient correlationId httpClient logPii proxy readTimeoutForDefaultHttpClient sslSocketFactory

Metody dziedziczone z AbstractClientApplicationBase

aadAadInstanceDiscoveryResponse acquireToken acquireToken acquireTokenSilently applicationName applicationVersion authority autoDetectRegion azureRegion clientCapabilities clientId getAccounts getAuthorizationRequestUrl instanceDiscovery removeAccount tokenCache validateAuthority

Metody dziedziczone z 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

Szczegóły pola

appTokenProvider

public Function<AppTokenProviderParameters,CompletableFuture<TokenProviderResult>> appTokenProvider

AppTokenProvider tworzy poświadczenie na podstawie funkcji, która zapewnia tokeny dostępu. Funkcja musi być bezpieczna współbieżności. Ma to na celu umożliwienie Azure SDK buforowania tokenów MSI. Nie jest to przydatne w przypadku aplikacji ogólnie, ponieważ dostawca tokenów musi zaimplementować całą logikę uwierzytelniania.

Szczegóły metody

acquireToken

public CompletableFuture<IAuthenticationResult> acquireToken(ClientCredentialParameters parameters)

Uzyskuje tokeny z urzędu skonfigurowanego w aplikacji dla samego klienta poufnego. Domyślnie podejmie próbę pobrania tokenów z pamięci podręcznej tokenów. Jeśli nie znaleziono żadnych tokenów, powrót do uzyskiwania ich za pośrednictwem poświadczeń klienta z usługi STS

Parametry:

parameters

acquireToken

public CompletableFuture<IAuthenticationResult> acquireToken(OnBehalfOfParameters parameters)

Uzyskuje token dostępu dla tej aplikacji (zazwyczaj internetowy interfejs API) z urzędu skonfigurowanego w aplikacji w celu uzyskania dostępu do innego podrzędnego chronionego internetowego interfejsu API w imieniu użytkownika przy użyciu przepływu on-Behalf-Of. Domyślnie podejmie próbę pobrania tokenów z pamięci podręcznej tokenów. Ta zaufana aplikacja kliencka została wywołana za pomocą tokenu dostępu, który jest udostępniany w UserAssertion polu OnBehalfOfParameters.

Podczas serializacji/deserializacji pamięci podręcznej tokenu w pamięci do magazynu trwałego powinna istnieć pamięć podręczna tokenu na token dostępu przychodzącego, gdzie skrót tokenu dostępu przychodzącego może być używany jako klucz pamięci podręcznej tokenu. Tokeny dostępu są zwykle ważne tylko przez okres 1 godziny, a nowy token dostępu w UserAssertion ten sposób będzie istnieć nowa pamięć podręczna tokenu i nowy klucz pamięci podręcznej tokenu. Aby uniknąć wypełniania magazynu trwałego z wygasłymi pamięciami podręcznymi tokenów, należy ustawić zasady eksmisji. Na przykład pamięć podręczna tokenu, która ma więcej niż kilka godzin, może zostać uznana za wygasłą i w związku z tym eksmitowana z serializowanej pamięci podręcznej tokenów.

Parametry:

parameters

acquireToken

public CompletableFuture<IAuthenticationResult> acquireToken(UserFederatedIdentityCredentialParameters parameters)

Uzyskuje token przy użyciu przepływu poświadczeń tożsamości federacyjnej użytkownika (user_fic). Jest to element Leg 3 protokołu tożsamości agenta, w którym poświadczenia tożsamości federacyjnej (uzyskane z usługi Leg 2) są wymieniane dla tokenu o zakresie użytkownika.

Użytkownik może być identyfikowany za pomocą nazwy UPN (nazwy użytkownika) lub identyfikatora obiektu, jak określono w .UserFederatedIdentityCredentialParameters

Parametry:

parameters

builder

public static ConfidentialClientApplication.Builder builder(String clientId, IClientCredential clientCredential)

Tworzy wystąpienie konstruktora klasy ConfidentialClientApplication

Parametry:

clientId - Identyfikator klienta aplikacji (identyfikator aplikacji) zarejestrowany w portalu rejestracji aplikacji (portal.azure.com)
clientCredential - Poświadczenie klienta do użycia na potrzeby pozyskiwania tokenu.

Zwraca:

wystąpienie konstruktora elementu ConfidentialClientApplication

sendX5c

public boolean sendX5c()

Dotyczy