AcquireTokenOptions Klass

Definition

Namnområde:

Microsoft.Identity.Abstractions

Sammansättning:

Microsoft.Identity.Abstractions.dll

Paket:

Microsoft.Identity.Abstractions v12.1.0

Alternativ som styr tokenförvärvet. Dessa alternativ tillhandahålls till ITokenAcquirer metoderna, eller en del av AuthorizationHeaderProviderOptions, eller DownstreamApiOptions.

public class AcquireTokenOptions

type AcquireTokenOptions = class

Public Class AcquireTokenOptions

Arv

Object

AcquireTokenOptions

Härledda

Microsoft.Identity.Web.TokenAcquisitionOptions

Konstruktorer

Name	Description
AcquireTokenOptions()	Standardkonstruktor.
AcquireTokenOptions(AcquireTokenOptions)	Kopiera konstruktor för AcquireTokenOptions

Egenskaper

Name	Description
AuthenticationOptionsName	Hämtar namnet på alternativen som beskriver det konfidentiella klientprogrammet (ClientID, Region, Authority, client credentials). I ASP.NET Core är autentiseringsalternativens namn samma som autentiseringsschemat.
Claims	En sträng med ett eller flera anspråk att begära. Det är en json-blob (kodad eller inte) som normalt används med villkorsstyrd åtkomst. Den tar emot anspråksmedlemmen i UiRequiredException. Den kan också användas för att begära specifika valfria anspråk och för CA-autentiseringskontext
CorrelationId	Anger korrelations-ID som ska användas i begäran till STS-slutpunkten "/token".
ExtraHeadersParameters	Alternativ som styr tokenförvärvet. Dessa alternativ tillhandahålls till ITokenAcquirer metoderna, eller en del av AuthorizationHeaderProviderOptions, eller DownstreamApiOptions.
ExtraParameters	En egenskapsväska som används för extensiblitet.
ExtraQueryParameters	Anger frågeparametrar för frågesträngen i HTTP-begäran till slutpunkten "/token".
FmiPath	Undersökväg för federerad hanterad identitet (FMI).
ForceRefresh	Anger om tokenbegäran ignorerar åtkomsttoken i tokencachen och försöker hämta en ny åtkomsttoken. Om trueignoreras tokencacheminnet i begäran. Standardvärdet är false. Använd det här alternativet med försiktighet och endast när det behövs, till exempel om du vet att principer för villkorlig åtkomst har ändrats, för det leder till prestandaförsämring, eftersom tokencache inte används och STS kan begränsa appen.
LongRunningWebApiSessionKey	Nyckel som används för långvariga webb-API:er som behöver anropa underordnade webb-API:er för användarens räkning. Kan vara null om du inte utvecklar ett tidskrävande webb-API, LongRunningWebApiSessionKeyAuto om du vill att tokeninlösaren ska allokera en sessionsnyckel åt dig eller en egen sträng om du vill associera sessionen med viss information som du har externt (till exempel en Microsoft Graph hook-identifierare).
LongRunningWebApiSessionKeyAuto	Värde som kan användas för LongRunningWebApiSessionKey så att tokeninlösaren allokerar den tidskrävande webb-API-sessionsnyckeln för utvecklaren.
ManagedIdentity	När ManagedIdentity har angetts använder programmet en hanterad identitet i stället för klientautentiseringsuppgifter för att hämta en apptoken. Om du vill använda en systemtilldelad identitet lämnar UserAssignedClientId du bara null. Om du vill använda en användartilldelad identitet anger du UserAssignedClientId till ClientID för den användartilldelade identitet som du vill använda. Om du använder någon av formerna av hanterad identitet måste programmet distribueras på Azure och den hanterade identiteten ska konfigureras. Mer information finns i dokumentationen om hanterade identiteter för Azure.
PopClaim	Förutom PopPublicKeyanger du PopClaim när det behövs i specifika POP-protokoll.
PopPublicKey	Ändrar begäran om tokenförvärv så att den förvärvade token är en PoP (Proof of Possession token) i stället för en ägartoken. PoP-token liknar ägartoken, men är bundna till HTTP-begäran och till en kryptografisk nyckel som MSAL kan hantera. Se även https://aka.ms/msal-net-pop.
Tenant	(Microsoft identitetsspecifik) Gör det möjligt att åsidosätta klientorganisationen/kontot för vilket en token ska hämtas. Detta är användbart i appar med flera klientorganisationer i de fall där ett visst användarkonto är en gäst i andra klienter och du vill hämta token för en specifik klientorganisation.
UserFlow	(Microsoft identitetsspecifik) När det gäller AzureAD B2C använder ett visst användarflöde.

Metoder

Name	Description
Clone()	Utför en ytlig Klona alternativen (för att kunna åsidosätta dem).

Tilläggsmetoder

Name	Description
WithClientAssertion(AcquireTokenOptions, String)	Överväg klientkontroll för tokenbegäran.
WithExtraBodyParameters(AcquireTokenOptions, IDictionary<String,String>)	Lägger till extra brödtextparametrar i begäran om tokenförvärv. Parametrar sammanfogas i valfri befintlig extra ordlista för brödtextparametrar, så detta kan bestå av andra tillägg som också lägger till brödtextparametrar.