AcquireTokenByAuthorizationCodeParameterBuilder Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Opbouwfunctie voor AcquireTokenByAuthorizationCode
public sealed class AcquireTokenByAuthorizationCodeParameterBuilder : Microsoft.Identity.Client.AbstractConfidentialClientAcquireTokenParameterBuilder<Microsoft.Identity.Client.AcquireTokenByAuthorizationCodeParameterBuilder>type AcquireTokenByAuthorizationCodeParameterBuilder = class
inherit AbstractConfidentialClientAcquireTokenParameterBuilder<AcquireTokenByAuthorizationCodeParameterBuilder>Public NotInheritable Class AcquireTokenByAuthorizationCodeParameterBuilder
Inherits AbstractConfidentialClientAcquireTokenParameterBuilder(Of AcquireTokenByAuthorizationCodeParameterBuilder)- Overname
-
AbstractConfidentialClientAcquireTokenParameterBuilder<AcquireTokenByAuthorizationCodeParameterBuilder>AcquireTokenByAuthorizationCodeParameterBuilder
Methoden
| Naam | Description |
|---|---|
| ExecuteAsync() |
Hiermee wordt de tokenaanvraag asynchroon uitgevoerd. (Overgenomen van BaseAbstractAcquireTokenParameterBuilder<T>) |
| ExecuteAsync(CancellationToken) |
Hiermee wordt de tokenaanvraag asynchroon uitgevoerd, met de mogelijkheid om de asynchrone methode te annuleren. (Overgenomen van AbstractConfidentialClientAcquireTokenParameterBuilder<T>) |
| Validate() |
Valideert de parameters van de AcquireToken-bewerking. (Overgenomen van AbstractConfidentialClientAcquireTokenParameterBuilder<T>) |
| WithAdfsAuthority(String, Boolean) |
Verouderd.
Hiermee voegt u een bekende instantie toe die overeenkomt met een ADFS-server. Zie https://aka.ms/msal-net-adfs. (Overgenomen van AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(AadAuthorityAudience, Boolean) |
Verouderd.
Belangrijk: gebruik in plaats daarvan WithTenantId of WithTenantIdFromAuthority of WithB2CAuthority voor B2C-instanties. Voegt een bekende Azure AD-instantie toe aan de toepassing om gebruikers aan te melden die de aanmeldingsdoelgroep opgeven (de cloud is de Azure openbare cloud). Zie https://aka.ms/msal-net-application-configuration. (Overgenomen van AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(AzureCloudInstance, AadAuthorityAudience, Boolean) |
Verouderd.
Voegt een bekende Azure AD-instantie toe aan de toepassing om gebruikers aan te melden die het cloudexemplaren en de aanmeldingsdoelgroep opgeven. Zie https://aka.ms/msal-net-application-configuration. (Overgenomen van AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(AzureCloudInstance, Guid, Boolean) |
Verouderd.
Belangrijk: gebruik in plaats daarvan WithTenantId of WithTenantIdFromAuthority of WithB2CAuthority voor B2C-instanties. Voegt een bekende Azure AD-instantie toe aan de toepassing om gebruikers aan te melden vanuit één organisatie (één tenanttoepassing) die wordt beschreven door het cloudexemplaren en de tenant-id. Zie https://aka.ms/msal-net-application-configuration. (Overgenomen van AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(AzureCloudInstance, String, Boolean) |
Verouderd.
Belangrijk: gebruik in plaats daarvan WithTenantId of WithTenantIdFromAuthority of WithB2CAuthority voor B2C-instanties. Voegt een bekende Azure AD-instantie toe aan de toepassing om gebruikers aan te melden vanuit één organisatie (één tenanttoepassing) die wordt beschreven door het cloudexemplaren en de domeinnaam of tenant-id. Zie https://aka.ms/msal-net-application-configuration. (Overgenomen van AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(String, Boolean) |
Verouderd.
Belangrijk: gebruik in plaats daarvan WithTenantId of WithTenantIdFromAuthority of WithB2CAuthority voor B2C-instanties. Specifieke instantie waarvoor het token wordt aangevraagd. Als u een andere waarde doorgeeft dan is geconfigureerd bij de toepassingsconstructor, wordt de selectie beperkt tot een specifieke tenant. Hiermee wordt de geconfigureerde waarde in de toepassing niet gewijzigd. Dit is specifiek voor toepassingen die verschillende accounts beheren (zoals een e-mailclient met verschillende postvakken). Zie https://aka.ms/msal-net-application-configuration. (Overgenomen van AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(String, Guid, Boolean) |
Verouderd.
Belangrijk: gebruik in plaats daarvan WithTenantId of WithTenantIdFromAuthority of WithB2CAuthority voor B2C-instanties. Voegt een bekende Azure AD-instantie toe aan de toepassing om gebruikers aan te melden vanuit één organisatie (één tenanttoepassing) die is opgegeven door de tenant-id. Zie https://aka.ms/msal-net-application-configuration. (Overgenomen van AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(String, String, Boolean) |
Verouderd.
Belangrijk: gebruik in plaats daarvan WithTenantId of WithTenantIdFromAuthority of WithB2CAuthority voor B2C-instanties. Voegt een bekende Azure AD-instantie toe aan de toepassing om gebruikers aan te melden vanuit één organisatie (één tenanttoepassing) die wordt beschreven door de domeinnaam. Zie https://aka.ms/msal-net-application-configuration. (Overgenomen van AbstractAcquireTokenParameterBuilder<T>) |
| WithB2CAuthority(String) |
Voegt een bekende instantie toe die overeenkomt met een Azure AD B2C-beleid. Zie https://aka.ms/msal-net-b2c-specificities (Overgenomen van AbstractAcquireTokenParameterBuilder<T>) |
| WithCcsRoutingHint(String, String) |
Voor hulp bij tolerantie werkt het AAD-back-upverificatiesysteem als een AAD-back-up. Dit biedt een back-upverificatiesysteem met een routeringshint om de prestaties tijdens de verificatie te verbeteren. |
| WithCcsRoutingHint(String) |
Voor hulp bij tolerantie werkt het AAD-back-upverificatiesysteem als een AAD-back-up. Dit biedt een back-upverificatiesysteem met een routeringshint om de prestaties tijdens de verificatie te verbeteren. |
| WithClaims(String) |
Hiermee stelt u claims in de query in. Gebruik deze optie wanneer de AAD-beheerder voorwaardelijke toegang heeft ingeschakeld. Het verkrijgen van het token resulteert normaal gesproken in een MsalUiRequiredException met de Claims eigenschappenset. Probeer het token opnieuw op te halen en gebruik deze waarde in de WithClaims(String) methode. Zie https://aka.ms/msal-exceptions voor meer informatie en https://aka.ms/msal-net-claim-challenge. (Overgenomen van AbstractAcquireTokenParameterBuilder<T>) |
| WithCorrelationId(Guid) |
Hiermee stelt u de correlatie-id in die moet worden gebruikt in de verificatieaanvraag. Wordt gebruikt voor het bijhouden van een aanvraag in de logboeken van zowel de SDK als de Identity Provider-service. Als deze niet is ingesteld, wordt er een willekeurige gegenereerd. (Overgenomen van BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithExtraQueryParameters(Dictionary<String,String>) |
Verouderd.
Hiermee stelt u extra queryparameters in voor de querytekenreeks in de HTTP-verificatieaanvraag. (Overgenomen van BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithExtraQueryParameters(IDictionary<String,ValueTuple<String,Boolean>>) |
Hiermee stelt u extra queryparameters voor de queryreeks in de HTTP-verificatieaanvraag in met controle over welke parameters zijn opgenomen in de cachesleutel (Overgenomen van BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithExtraQueryParameters(String) |
Verouderd.
Hiermee stelt u extra queryparameters in voor de querytekenreeks in de HTTP-verificatieaanvraag. (Overgenomen van AbstractAcquireTokenParameterBuilder<T>) |
| WithPkceCodeVerifier(String) |
Wordt gebruikt om autorisatiecode te beveiligen via Proof of Key for Code Exchange (PKCE). Zie (https://tools.ietf.org/html/rfc7636) voor meer informatie. |
| WithProofOfPossession(PoPAuthenticationConfiguration) |
Verouderd.
Wijzigt de aanvraag voor tokenverwerving zodat het verkregen token een Proof-of-Possession-token (PoP) is in plaats van een Bearer-token. PoP-tokens zijn vergelijkbaar met Bearer-tokens, maar zijn gebonden aan de HTTP-aanvraag en aan een cryptografische sleutel die MSAL op Windows kan beheren. Zie https://aka.ms/msal-net-pop (Overgenomen van AbstractConfidentialClientAcquireTokenParameterBuilder<T>) |
| WithScopes(IEnumerable<String>) |
Hiermee geeft u op welke bereiken moeten worden aangevraagd. Deze methode wordt gebruikt wanneer uw toepassing de bereiken moet opgeven die nodig zijn om een beveiligde API aan te roepen. Zie</zie>https://docs.microsoft.com/azure/active-directory/develop/v2-permissions-and-consent< voor> meer informatie over bereiken, machtigingen en toestemming en <zie/zie>https://docs.microsoft.com/azure/active-directory/develop/msal-v1-app-scopes<> voor meer informatie over het maken van bereiken voor verouderde toepassingen die worden gebruikt om OAuth2-machtigingen beschikbaar te maken. (Overgenomen van AbstractAcquireTokenParameterBuilder<T>) |
| WithSendX5C(Boolean) |
Alleen van toepassing op toepassingen van derden, met deze methode kunt u ook opgeven of de x5c-claim moet worden verzonden naar Azure AD. Door x5c te verzenden, kunnen toepassingsontwikkelaars eenvoudig certificaten in Azure AD implementeren: met deze methode wordt de certificaatketen naar Azure AD verzonden, samen met de tokenaanvraag, zodat Azure AD deze kan gebruiken om de onderwerpnaam te valideren op basis van een vertrouwd uitgeversbeleid. Hiermee wordt de toepassingsbeheerder opgeslagen, zodat de rollover van het certificaat expliciet moet worden beheerd (via de portal of via de PowerShell/CLI-bewerking). Zie voor meer informatie https://aka.ms/msal-net-sni |
| WithSignedHttpRequestProofOfPossession(PoPAuthenticationConfiguration) |
Hiermee wijzigt u de aanvraag voor het verkrijgen van een ondertekend SHR-token (Proof-of-Possession) van een HTTP-aanvraag (SHR) in plaats van een Bearer. SHR PoP-tokens zijn gebonden aan de HTTP-aanvraag en aan een cryptografische sleutel die MSAL beheert op Windows. SHR PoP-tokens verschillen van mTLS PoP-tokens, die worden gebruikt voor wederzijdse TLS-verificatie (mTLS). Zie https://aka.ms/mtls-pop voor meer informatie. (Overgenomen van AbstractConfidentialClientAcquireTokenParameterBuilder<T>) |
| WithSpaAuthorizationCode(Boolean) |
Vraagt een verificatiecode aan voor de front-end (BEVEILIGD-WACHTWOORDVERIFICATIE met MSAL.js bijvoorbeeld). Zie https://aka.ms/msal-net/spa-auth-code voor meer informatie. |
| WithTenantId(String) |
Overschrijft de tenant-id die is opgegeven in de instantie op toepassingsniveau. Met deze bewerking blijft de instantiehost (omgeving) behouden. Als een instantie niet is opgegeven op toepassingsniveau, wordt |
| WithTenantIdFromAuthority(Uri) |
Extraheert de tenant-id van de opgegeven instantie-URI en overschrijft de tenant-id die is opgegeven in de instantie op toepassingsniveau. Met deze bewerking blijft de instantiehost (omgeving) behouden die aan de opbouwfunctie voor toepassingen is verstrekt.
Als er geen instantie is verstrekt aan de opbouwfunctie voor toepassingen, vervangt deze methode de tenant-id in de standaardinstantie - |
Extensiemethoden
| Naam | Description |
|---|---|
| OnBeforeTokenRequest<T>(AbstractAcquireTokenParameterBuilder<T>, Func<OnBeforeTokenRequestData,Task>) |
Grijpt in de aanvraagpijplijn in door een door de gebruiker opgegeven gemachtigde uit te voeren voordat MSAL de tokenaanvraag doet. De gedelegeerde kan de nettolading van de aanvraag wijzigen door hoofdtekstparameters en headers toe te voegen of te verwijderen. OnBeforeTokenRequestData |
| WithAdditionalCacheParameters<T>(AbstractAcquireTokenParameterBuilder<T>, IEnumerable<String>) |
Hiermee geeft u aanvullende parameters op die zijn verkregen uit verificatiereacties die in de cache moeten worden opgeslagen met het toegangstoken dat normaal gesproken niet is opgenomen in het cacheobject. deze waarden kunnen worden gelezen uit de AdditionalResponseParameters parameter. |
| WithAttributeTokens<T>(AbstractConfidentialClientAcquireTokenParameterBuilder<T>, IEnumerable<String>) |
Verzendt |
| WithAuthenticationExtension<T>(AbstractAcquireTokenParameterBuilder<T>, MsalAuthenticationExtension) |
Hiermee kunnen clienttoepassingen een aangepaste verificatiebewerking bieden die kan worden gebruikt in de aanvraag voor het verkrijgen van tokens. |
| WithCachePartitionKey<T>(BaseAbstractAcquireTokenParameterBuilder<T>, String, String, Boolean) |
Voegt een sleutel-waardepaar toe aan de tokencachesleutel zonder deze als queryparameter te verzenden.
Gebruik dit om tokens in de cache te partitioneren (bijvoorbeeld het isoleren van kortdurende sessies van gewone sessies voor dezelfde gebruiker). Beide |
| WithCachePartitionKey<T>(BaseAbstractAcquireTokenParameterBuilder<T>, String, String) |
Voegt een sleutel-waardepaar toe aan de tokencachesleutel zonder deze als queryparameter te verzenden.
Gebruik deze optie voor het partitioneren van toegangstokens in de cache (bijvoorbeeld het isoleren van kortdurende sessies van gewone sessies voor dezelfde gebruiker). Beide |
| WithClaimsFromClient<T>(AbstractConfidentialClientAcquireTokenParameterBuilder<T>, String) |
Hiermee geeft u client-afkomstige claims op die moeten worden opgenomen in de tokenaanvraag. In tegenstelling tot WithClaims(String) (voor door de server uitgegeven claims) worden tokens die zijn verkregen met clientclaims in de cache opgeslagen en wordt de cachevermelding op de claimwaarde opgegeven. Verschillende claimwaarden produceren afzonderlijke cachevermeldingen. Gebruik stabiele, niet-dynamische waarden om niet-gebonden cachegroei te voorkomen. |
| WithExtraBodyParameters<T>(AbstractConfidentialClientAcquireTokenParameterBuilder<T>, Dictionary<String,Func<CancellationToken,Task<String>>>) |
Voeg extra hoofdtekstparameters toe aan de tokenaanvraag. Deze parameters worden toegevoegd aan de cachesleutel om deze parameters te koppelen aan het verkregen token. Werkt voor vertrouwelijke clientstromen (AcquireTokenForClient, AcquireTokenOnBehalfOf, AcquireTokenByAuthorizationCode). |
| WithExtraClientAssertionClaims<T>(AbstractAcquireTokenParameterBuilder<T>, String) |
Hiermee geeft u extra claims die moeten worden opgenomen in de clientverklaring. Deze claims worden samengevoegd met standaardclaims wanneer de clientbevestiging wordt gegenereerd. Hierdoor kunnen API's op een hoger niveau, zoals Microsoft. Identity.Web biedt aanvullende claims voor de clientverklaring. Belangrijk: tokens zijn gekoppeld aan de extra clientclaims, wat van invloed is op cachezoekacties. Dit is een uitbreidbaarheids-API en mag niet rechtstreeks door toepassingen worden gebruikt. |
| WithExtraHttpHeaders<T>(AbstractAcquireTokenParameterBuilder<T>, IDictionary<String,String>) |
Verouderd.
Voegt extra HTTP-headers toe aan de tokenaanvraag. |
| WithExtraHttpHeaders<T>(AbstractAcquireTokenParameterBuilder<T>, IDictionary<String,String>) |
Voegt extra HTTP-headers toe aan de tokenaanvraag. |
| WithFmiPathForClientAssertion<T>(AbstractAcquireTokenParameterBuilder<T>, String) |
Hiermee geeft u een FMI-pad moet worden gebruikt voor de clientverklaring. Hierdoor kunnen API's op een hoger niveau, zoals Id.Web, referenties opgeven die FMI-gevoelig zijn. Belangrijk: tokens zijn gekoppeld aan het FMI-referentiepad, wat van invloed is op cachezoekacties. Dit is een uitbreidbaarheids-API en mag niet worden gebruikt door toepassingen. |
| WithOtelTagsEnricher<T>(AbstractAcquireTokenParameterBuilder<T>, Action<ExecutionResult,IList<KeyValuePair<String,Object>>>) |
Registreert een gemachtigde die extra tags (dimensies) toevoegt aan de metrische gegevens van OpenTelemetry DIE MSAL verzendt voor het verkrijgen van dit token. De gemachtigde wordt aangeroepen terwijl MSAL de metrische gegevens registreert en de ExecutionResult overname ontvangt (wat aangeeft dat de overname is geslaagd of mislukt, met het resultaat of de uitzondering) samen met een onveranderbare lijst met tags. Tags die aan die lijst zijn toegevoegd, worden gekoppeld aan alle metrische gegevens die zijn vastgelegd voor de aanvraag. |
| WithProofOfPosessionKeyId<T>(AbstractAcquireTokenParameterBuilder<T>, String, String) |
Verbindt het token met een sleutel in de cache. Er worden geen cryptografische bewerkingen uitgevoerd op het token. |
| WithReservedScopes(AcquireTokenByAuthorizationCodeParameterBuilder, Boolean) |
Hiermee bepaalt u of MSAL het gereserveerde |