PublicClientApplication class

Belangrijke kenmerken in het configuratieobject voor verificatie zijn:

• clientID: de toepassings-id van uw toepassing. U kunt er een verkrijgen door uw toepassing te registreren bij onze portal voor toepassingsregistratie.
• instantie: de URL van de instantie voor uw toepassing.

AAD-autoriteiten zijn van de vorm https://login.microsoftonline.com/{Enter_the_Tenant_Info_Here}.

• Als uw toepassing accounts in één organisatiemap ondersteunt, vervangt u de waarde 'Enter_the_Tenant_Info_Here' door de tenant-id of tenantnaam (bijvoorbeeld contoso.microsoft.com).
• Als uw toepassing accounts in een organisatiemap ondersteunt, vervangt u de waarde 'Enter_the_Tenant_Info_Here' door organisaties.
• Als uw toepassing accounts in een organisatiedirectory en persoonlijke Microsoft accounts ondersteunt, vervangt u de waarde 'Enter_the_Tenant_Info_Here' door algemene waarden.
• Als u alleen ondersteuning wilt beperken tot persoonlijke Microsoft-accounts, vervangt u de waarde 'Enter_the_Tenant_Info_Here' door consumenten.

Azure B2C-autoriteiten zijn van het formulier https://{instance}/{tenant}/{policy}. Elk beleid wordt beschouwd als een eigen autoriteit. U moet alle bekende verificaties instellen op het moment van de bouw van de clienttoepassing.

ADFS-autoriteiten zijn van het formulier https://{instance}/adfs.

new PublicClientApplication(configuration: Configuration)

Parameters

Hiermee verkrijgt u een token van de instantie met behulp van de OAuth2.0-apparaatcodestroom. Deze stroom is ontworpen voor apparaten die geen toegang hebben tot een browser of invoerbeperkingen hebben. De autorisatieserver geeft een DeviceCode-object uit met een verificatiecode, een eindgebruikercode en de verificatie-URI van de eindgebruiker. Het DeviceCode-object wordt geleverd via een callback en de eindgebruiker moet worden geïnstrueerd om een ander apparaat te gebruiken om naar de verificatie-URI te navigeren om referenties in te voeren. Omdat de client geen binnenkomende aanvragen kan ontvangen, wordt de autorisatieserver herhaaldelijk gepeild totdat de eindgebruiker de invoer van referenties heeft voltooid.

function acquireTokenByDeviceCode(request: DeviceCodeRequest): Promise<null | AuthenticationResult>

Parameters

Retouren

Hiermee verkrijgt u een token interactief via de browser door een autorisatiecode aan te vragen en deze vervolgens uit te wisselen voor een token.

function acquireTokenInteractive(request: InteractiveRequest): Promise<AuthenticationResult>

Parameters

Retouren

Retourneert een token dat is opgehaald uit de cache of door het vernieuwingstoken uit te wisselen voor een nieuw toegangstoken. Als brokering is ingeschakeld, wordt de tokenaanvraag verwerkt door de broker.

function acquireTokenSilent(request: SilentFlowRequest): Promise<AuthenticationResult>

Parameters

Retouren

Retourneert alle accounts in de cache voor deze toepassing. Als brokering is ingeschakeld, wordt deze aanvraag verwerkt door de broker.

function getAllAccounts(): Promise<AccountInfo[]>

Retouren

Verwijdert cacheartefacten die zijn gekoppeld aan het opgegeven account

function signOut(request: SignOutRequest): Promise<void>

Parameters

Retouren

Hiermee verkrijgt u een token door de autorisatiecode uit te wisselen die is ontvangen uit de eerste stap van de OAuth2.0-autorisatiecodestroom.

getAuthCodeUrl(AuthorizationCodeUrlRequest) kan worden gebruikt om de URL te maken voor de eerste stap van de OAuth2.0-autorisatiecodestroom. Zorg ervoor dat waarden voor redirectUri en scopes in AuthorizationCodeUrlRequest en AuthorizationCodeRequest hetzelfde zijn.

function acquireTokenByCode(request: AuthorizationCodeRequest, authCodePayLoad?: AuthorizationCodePayload): Promise<AuthenticationResult>

Parameters

Retouren

Overgenomen vanClientApplication.acquireTokenByCode

Hiermee verkrijgt u een token door het vernieuwingstoken uit te wisselen dat is opgegeven voor een nieuwe set tokens.

Deze API is alleen beschikbaar voor scenario's waarin u wilt migreren van ADAL naar MSAL. Anders wordt het aanbevolen om te gebruiken acquireTokenSilent() voor stille scenario's. Wanneer u msal gebruikt acquireTokenSilent(), wordt de cache en het vernieuwen van tokens automatisch verwerkt.

function acquireTokenByRefreshToken(request: RefreshTokenRequest): Promise<null | AuthenticationResult>

Parameters

Retouren

Overgenomen vanClientApplication.acquireTokenByRefreshToken

Hiermee verkrijgt u tokens met wachtwoordtoekenning door de gebruikersnaam en het wachtwoord van clienttoepassingen uit te wisselen voor referenties

De meest recente best practice voor OAuth 2.0-beveiliging staat niet toe dat het wachtwoord volledig wordt verleend. Meer informatie over deze aanbeveling vindt u in https://tools.ietf.org/html/draft-ietf-oauth-security-topics-13#section-3.4 de documentatie en aanbevelingen van Microsoft:https://docs.microsoft.com/en-us/azure/active-directory/develop/msal-authentication-flows#usernamepassword

function acquireTokenByUsernamePassword(request: UsernamePasswordRequest): Promise<null | AuthenticationResult>

Parameters

Retouren

Overgenomen vanClientApplication.acquireTokenByUsernamePassword

Cache legen

function clearCache()

Overgenomen vanClientApplication.clearCache

Hiermee maakt u de URL van de autorisatieaanvraag, zodat de gebruikersreferenties kunnen invoeren en toestemming kunnen geven voor de toepassing. De URL is gericht op het eindpunt /authorize van de instantie die is geconfigureerd in het toepassingsobject.

Zodra de gebruiker zijn referenties en toestemmingen invoert, stuurt de autoriteit een antwoord naar de omleidings-URI die in de aanvraag is verzonden en moet deze een autorisatiecode bevatten, die vervolgens kan worden gebruikt om tokens te verkrijgen via acquireTokenByCode(AuthorizationCodeRequest).

function getAuthCodeUrl(request: AuthorizationUrlRequest): Promise<string>

Parameters

Retouren

Overgenomen vanClientApplication.getAuthCodeUrl

Retourneert het loggerexemplaren

function getLogger(): Logger

Retouren

Overgenomen vanClientApplication.getLogger

Hiermee haalt u de tokencache voor de toepassing op.

function getTokenCache(): TokenCache

Retouren

Overgenomen vanClientApplication.getTokenCache

Vervangt de standaardlogger die is ingesteld in configuraties door nieuwe logger door nieuwe configuraties

function setLogger(logger: Logger)

Parameters

Overgenomen vanClientApplication.setLogger