AcquireTokenInteractiveParameterBuilder 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 een interactieve tokenaanvraag. Zie https://aka.ms/msal-net-acquire-token-interactively
public sealed class AcquireTokenInteractiveParameterBuilder : Microsoft.Identity.Client.AbstractPublicClientAcquireTokenParameterBuilder<Microsoft.Identity.Client.AcquireTokenInteractiveParameterBuilder>type AcquireTokenInteractiveParameterBuilder = class
inherit AbstractPublicClientAcquireTokenParameterBuilder<AcquireTokenInteractiveParameterBuilder>Public NotInheritable Class AcquireTokenInteractiveParameterBuilder
Inherits AbstractPublicClientAcquireTokenParameterBuilder(Of AcquireTokenInteractiveParameterBuilder)- Overname
-
AcquireTokenInteractiveParameterBuilder
Methoden
| Name | 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 AbstractPublicClientAcquireTokenParameterBuilder<T>) |
| Validate() |
Valideert de parameters van de AcquireToken-bewerking. (Overgenomen van BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithAccount(IAccount) |
Hiermee stelt u het account in waarvoor het token wordt opgehaald. Deze methode sluiten elkaar wederzijds uit met WithLoginHint(String). Als beide worden gebruikt, wordt er een uitzondering gegenereerd |
| WithAdfsAuthority(String, Boolean) |
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>) |
| 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>) |
| WithEmbeddedWebViewOptions(EmbeddedWebViewOptions) |
Hiermee geeft u opties voor het gebruik van de ingesloten webweergave voor interactieve verificatie. |
| 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>) |
| WithExtraScopesToConsent(IEnumerable<String>) |
Opbouwfunctie voor een interactieve tokenaanvraag. Zie https://aka.ms/msal-net-acquire-token-interactively |
| WithLoginHint(String) |
Hiermee stelt u de |
| WithParentActivityOrWindow(IntPtr) |
Hiermee stelt u een verwijzing naar de IntPtr in op een venster waarmee de browser wordt geactiveerd. Wordt gebruikt om de browser te centreren die in dit venster wordt weergegeven. Het midden van het scherm of de voorgrond-app als een waarde is geconfigureerd. |
| WithParentActivityOrWindow(Object) |
Hiermee stelt u een verwijzing in naar de ViewController (als u iOS gebruikt), Activity (als u Android gebruikt) IWin32Window of IntPtr (als u .Net Framework gebruikt). Wordt gebruikt voor het aanroepen van de browser. |
| WithPrompt(Prompt) |
Hiermee geeft u op wat de interactieve ervaring voor de gebruiker is. |
| WithProofOfPossession(String, HttpMethod, Uri) |
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. Houd er rekening mee dat alleen de host- en padonderdelen van de aanvraag-URI zijn gebonden. Zie https://aka.ms/msal-net-pop |
| 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> voor>https://docs.microsoft.com/azure/active-directory/develop/v2-permissions-and-consent< 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>) |
| WithSystemWebViewOptions(SystemWebViewOptions) |
Hiermee geeft u opties voor het gebruik van de browser van het besturingssysteem van het systeem interactieve verificatie af. |
| 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 - |
| WithUseEmbeddedWebView(Boolean) |
Hiermee geeft u op of de openbare clienttoepassing een ingesloten webbrowser of de standaardbrowser van het systeem moet gebruiken. Als de broker (WAM, Authenticator, Bedrijfsportal) is geconfigureerd, wordt deze instelling alleen gebruikt wanneer de broker niet is geïnstalleerd. Op .NET, waaronder net8-windows, moeten app-ontwikkelaars verwijzen naar Microsoft. Identity.Client.Desktop en roep PublicClientApplicationBuilder.WithDesktopFeatures() aan om de ingesloten webbrowser in te schakelen. |
Extensiemethoden
| Name | 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. |
| 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) |
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 |
| WithCustomWebUi(AcquireTokenInteractiveParameterBuilder, ICustomWebUi) |
Extensiemethode voor het inschakelen van MSAL.NET extenders voor openbare clienttoepassingen om een aangepaste webgebruikersinterface in te stellen waarmee de gebruiker zich kan aanmelden met Azure AD, toestemming indien nodig kan presenteren en de autorisatiecode kan terughalen |
| 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. |
| WithProofOfPosessionKeyId<T>(AbstractAcquireTokenParameterBuilder<T>, String, String) |
Verbindt het token met een sleutel in de cache. Er worden geen cryptografische bewerkingen uitgevoerd op het token. |
| WithSSHCertificateAuthenticationScheme(AcquireTokenInteractiveParameterBuilder, String, String) |
Geeft AAD opdracht om een SSH-certificaat te retourneren in plaats van een Bearer-token. Het SSH-certificaat (niet hetzelfde als het openbare/persoonlijke sleutelpaar dat door SSH wordt gebruikt), kan worden gebruikt om een openbare SSH-sleutel veilig op een computer te implementeren. Zie https://aka.ms/msal-net-ssh voor meer informatie. |