AcquireTokenByIntegratedWindowsAuthParameterBuilder Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Generator für AcquireTokenByIntegratedWindowsAuth
public sealed class AcquireTokenByIntegratedWindowsAuthParameterBuilder : Microsoft.Identity.Client.AbstractPublicClientAcquireTokenParameterBuilder<Microsoft.Identity.Client.AcquireTokenByIntegratedWindowsAuthParameterBuilder>type AcquireTokenByIntegratedWindowsAuthParameterBuilder = class
inherit AbstractPublicClientAcquireTokenParameterBuilder<AcquireTokenByIntegratedWindowsAuthParameterBuilder>Public NotInheritable Class AcquireTokenByIntegratedWindowsAuthParameterBuilder
Inherits AbstractPublicClientAcquireTokenParameterBuilder(Of AcquireTokenByIntegratedWindowsAuthParameterBuilder)- Vererbung
-
AbstractPublicClientAcquireTokenParameterBuilder<AcquireTokenByIntegratedWindowsAuthParameterBuilder>AcquireTokenByIntegratedWindowsAuthParameterBuilder
Methoden
| Name | Beschreibung |
|---|---|
| ExecuteAsync() |
Führt die Tokenanforderung asynchron aus. (Geerbt von BaseAbstractAcquireTokenParameterBuilder<T>) |
| ExecuteAsync(CancellationToken) |
Führt die Tokenanforderung asynchron aus, mit der Möglichkeit, die asynchrone Methode abzusagen. (Geerbt von AbstractPublicClientAcquireTokenParameterBuilder<T>) |
| Validate() |
Überprüft die Parameter des AcquireToken-Vorgangs. (Geerbt von BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithAdfsAuthority(String, Boolean) |
Fügt eine bekannte Autorität hinzu, die einem ADFS-Server entspricht. Siehe https://aka.ms/msal-net-adfs. (Geerbt von AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(AadAuthorityAudience, Boolean) |
Veraltet.
Wichtig: Verwenden Sie stattdessen WithTenantId oder WithTenantIdFromAuthority oder WithB2CAuthority für B2C-Behörden. Fügt der Anwendung eine bekannte Azure AD-Autorität hinzu, um Anmeldebenutzer anzugeben, die die Anmeldegruppe angeben (die Cloud ist die Azure öffentliche Cloud). Siehe https://aka.ms/msal-net-application-configuration. (Geerbt von AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(AzureCloudInstance, AadAuthorityAudience, Boolean) |
Veraltet.
Fügt der Anwendung eine bekannte Azure AD-Autorität hinzu, um Anmeldebenutzern die Cloudinstanz und die Anmeldegruppe anzugeben. Siehe https://aka.ms/msal-net-application-configuration. (Geerbt von AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(AzureCloudInstance, Guid, Boolean) |
Veraltet.
Wichtig: Verwenden Sie stattdessen WithTenantId oder WithTenantIdFromAuthority oder WithB2CAuthority für B2C-Behörden. Fügt der Anwendung eine bekannte Azure AD-Autorität hinzu, um Benutzer aus einer einzelnen Organisation (Einzelmandantenanwendung) anzumelden, die von ihrer Cloudinstanz und ihrer Mandanten-ID beschrieben wird. Siehe https://aka.ms/msal-net-application-configuration. (Geerbt von AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(AzureCloudInstance, String, Boolean) |
Veraltet.
Wichtig: Verwenden Sie stattdessen WithTenantId oder WithTenantIdFromAuthority oder WithB2CAuthority für B2C-Behörden. Fügt der Anwendung eine bekannte Azure AD-Autorität hinzu, um Benutzer aus einer einzelnen Organisation (Einzelmandantenanwendung) anzumelden, die von der Cloudinstanz und dem Domänennamen oder der Mandanten-ID beschrieben wird. Siehe https://aka.ms/msal-net-application-configuration. (Geerbt von AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(String, Boolean) |
Veraltet.
Wichtig: Verwenden Sie stattdessen WithTenantId oder WithTenantIdFromAuthority oder WithB2CAuthority für B2C-Behörden. Spezifische Autorität, für die das Token angefordert wird. Durch Übergeben eines anderen Werts als beim Anwendungskonstruktor wird die Auswahl auf einen bestimmten Mandanten beschränkt. Dadurch wird der konfigurierte Wert in der Anwendung nicht geändert. Dies gilt speziell für Anwendungen, die mehrere Konten verwalten (z. B. einen E-Mail-Client mit mehreren Postfächern). Siehe https://aka.ms/msal-net-application-configuration. (Geerbt von AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(String, Guid, Boolean) |
Veraltet.
Wichtig: Verwenden Sie stattdessen WithTenantId oder WithTenantIdFromAuthority oder WithB2CAuthority für B2C-Behörden. Fügt der Anwendung eine bekannte Azure AD-Autorität hinzu, um Benutzer aus einer einzelnen Organisation (Einzelmandantenanwendung) anzumelden, die durch ihre Mandanten-ID angegeben wird. Siehe https://aka.ms/msal-net-application-configuration. (Geerbt von AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(String, String, Boolean) |
Veraltet.
Wichtig: Verwenden Sie stattdessen WithTenantId oder WithTenantIdFromAuthority oder WithB2CAuthority für B2C-Behörden. Fügt der Anwendung eine bekannte Azure AD-Autorität hinzu, um Benutzer aus einer einzelnen Organisation (Einzelmandantenanwendung) anzumelden, die durch ihren Domänennamen beschrieben wird. Siehe https://aka.ms/msal-net-application-configuration. (Geerbt von AbstractAcquireTokenParameterBuilder<T>) |
| WithB2CAuthority(String) |
Fügt eine bekannte Autorität hinzu, die einer Azure AD B2C-Richtlinie entspricht. Siehe https://aka.ms/msal-net-b2c-specificities. (Geerbt von AbstractAcquireTokenParameterBuilder<T>) |
| WithClaims(String) |
Legt Ansprüche in der Abfrage fest. Wird verwendet, wenn der AAD-Administrator bedingten Zugriff aktiviert hat. Das Abrufen des Tokens führt normalerweise zu einem MsalUiRequiredException Mit dem Claims Eigenschaftensatz. Wiederholen Sie den Tokenerwerb, und verwenden Sie diesen Wert in der WithClaims(String) Methode. Details sowie weitere Informationen finden https://aka.ms/msal-net-claim-challengeSie https://aka.ms/msal-exceptions unter . (Geerbt von AbstractAcquireTokenParameterBuilder<T>) |
| WithCorrelationId(Guid) |
Legt die Korrelations-ID fest, die in der Authentifizierungsanforderung verwendet werden soll. Wird verwendet, um eine Anforderung in den Protokollen des SDK und des Identitätsanbieterdiensts nachzuverfolgen. Wenn sie nicht festgelegt ist, wird ein zufälliges Generiert. (Geerbt von BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithExtraQueryParameters(Dictionary<String,String>) |
Veraltet.
Legt zusätzliche Abfrageparameter für die Abfragezeichenfolge in der HTTP-Authentifizierungsanforderung fest. (Geerbt von BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithExtraQueryParameters(IDictionary<String,ValueTuple<String,Boolean>>) |
Legt zusätzliche Abfrageparameter für die Abfragezeichenfolge in der HTTP-Authentifizierungsanforderung fest, mit der Kontrolle, welche Parameter im Cacheschlüssel enthalten sind (Geerbt von BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithExtraQueryParameters(String) |
Veraltet.
Legt zusätzliche Abfrageparameter für die Abfragezeichenfolge in der HTTP-Authentifizierungsanforderung fest. (Geerbt von AbstractAcquireTokenParameterBuilder<T>) |
| WithFederationMetadata(String) |
Ermöglicht MSAL, die Verbundmetadaten für einen WS-Trust Austausch aus der bereitgestellten Eingabe zu lesen, anstatt sie von einem Endpunkt zu erwerben. Dies gilt nur für verwaltete ADFS-Konten. Siehe https://aka.ms/MsalFederationMetadata. |
| WithScopes(IEnumerable<String>) |
Gibt an, welche Bereiche angefordert werden sollen. Diese Methode wird verwendet, wenn Ihre Anwendung die Bereiche angeben muss, die zum Aufrufen einer geschützten API erforderlich sind. Weitere Informationen <zu Bereichen, Berechtigungen und Zustimmung>https://docs.microsoft.com/azure/active-directory/develop/msal-v1-app-scopes<< finden Sie unter>https://docs.microsoft.com/azure/active-directory/develop/v2-permissions-and-consent</>finden Sie unter/finden Sie unter/erfahren> Sie, wie Sie Bereiche für Ältere Anwendungen erstellen, die zum Verfügbarmachen von OAuth2-Berechtigungen verwendet wurden. (Geerbt von AbstractAcquireTokenParameterBuilder<T>) |
| WithTenantId(String) |
Überschreibt die mandanten-ID, die in der Autorität auf Anwendungsebene angegeben ist. Dieser Vorgang behält den Autoritätshost (Umgebung) bei. Wenn auf Anwendungsebene keine Autorität angegeben wurde, wird |
| WithTenantIdFromAuthority(Uri) |
Extrahiert die Mandanten-ID aus dem bereitgestellten Autoritäts-URI und überschreibt die mandanten-ID, die in der Autorität auf Anwendungsebene angegeben ist. Dieser Vorgang behält den Autoritätshost (Umgebung) bei, der für den Anwendungs-Generator bereitgestellt wird.
Wenn dem Anwendungs-Generator keine Autorität bereitgestellt wurde, ersetzt diese Methode die Mandanten-ID in der Standardautorität - |
| WithUsername(String) |
Gibt den Benutzernamen an. |
Erweiterungsmethoden
| Name | Beschreibung |
|---|---|
| OnBeforeTokenRequest<T>(AbstractAcquireTokenParameterBuilder<T>, Func<OnBeforeTokenRequestData,Task>) |
Greift in die Anforderungspipeline ein, indem ein vom Benutzer bereitgestellter Delegat ausgeführt wird, bevor MSAL die Tokenanforderung vorgibt. Der Delegat kann die Anforderungsnutzlast ändern, indem Textkörperparameter und Header hinzugefügt oder entfernt werden. OnBeforeTokenRequestData |
| WithAdditionalCacheParameters<T>(AbstractAcquireTokenParameterBuilder<T>, IEnumerable<String>) |
Gibt zusätzliche Parameter an, die aus Authentifizierungsantworten abgerufen werden, die mit dem Zugriffstoken zwischengespeichert werden, die normalerweise nicht im Cacheobjekt enthalten sind. diese Werte können aus dem AdditionalResponseParameters Parameter gelesen werden. |
| WithAuthenticationExtension<T>(AbstractAcquireTokenParameterBuilder<T>, MsalAuthenticationExtension) |
Ermöglicht Clientanwendungen die Bereitstellung eines benutzerdefinierten Authentifizierungsvorgangs, der in der Tokenakquisitionsanforderung verwendet werden soll. |
| WithCachePartitionKey<T>(BaseAbstractAcquireTokenParameterBuilder<T>, String, String) |
Fügt dem Tokencacheschlüssel ein Schlüssel-Wert-Paar hinzu, ohne es als Abfrageparameter zu senden.
Verwenden Sie dies, um zwischengespeicherte Token zu partitionieren (z. B. das Isolieren von kurzlebigen Sitzungen aus regulären Sitzungen für denselben Benutzer). Beide und |
| WithExtraClientAssertionClaims<T>(AbstractAcquireTokenParameterBuilder<T>, String) |
Gibt zusätzliche Ansprüche an, die in die Client assertion aufgenommen werden sollen. Diese Ansprüche werden mit Standardansprüchen zusammengeführt, wenn die Client assertion generiert wird. Auf diese Weise können APIs auf höherer Ebene wie Microsoft. Identity.Web stellt zusätzliche Ansprüche für die Client assertion bereit. Wichtig: Token sind den zusätzlichen Client assertionsansprüchen zugeordnet, die sich auf Cache-Nachschlagevorgänge auswirken. Dies ist eine Erweiterbarkeits-API und sollte nicht direkt von Anwendungen verwendet werden. |
| WithExtraHttpHeaders<T>(AbstractAcquireTokenParameterBuilder<T>, IDictionary<String,String>) |
Veraltet.
Fügt der Tokenanforderung zusätzliche HTTP-Header hinzu. |
| WithExtraHttpHeaders<T>(AbstractAcquireTokenParameterBuilder<T>, IDictionary<String,String>) |
Fügt der Tokenanforderung zusätzliche HTTP-Header hinzu. |
| WithFmiPathForClientAssertion<T>(AbstractAcquireTokenParameterBuilder<T>, String) |
Gibt einen FMI-Pfad an, der für die Client assertion verwendet werden soll. Auf diese Weise können APIs auf höherer Ebene wie Id.Web Anmeldeinformationen bereitstellen, die von FMI vertraulich sind. Wichtig: Token sind dem FMI-Pfad für Anmeldeinformationen zugeordnet, was sich auf Cache-Nachschlagevorgänge auswirkt. Dies ist eine Erweiterbarkeits-API und sollte nicht von Anwendungen verwendet werden. |
| WithProofOfPosessionKeyId<T>(AbstractAcquireTokenParameterBuilder<T>, String, String) |
Bindet das Token an einen Schlüssel im Cache. Für das Token werden keine kryptografischen Vorgänge ausgeführt. |