AcquireTokenForManagedIdentityParameterBuilder 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 AcquireTokenForManagedIdentity (wird verwendet, um Token für verwaltete Identitäten abzurufen). Siehe https://aka.ms/msal-net-managed-identity.
public sealed class AcquireTokenForManagedIdentityParameterBuilder : Microsoft.Identity.Client.AbstractManagedIdentityAcquireTokenParameterBuilder<Microsoft.Identity.Client.AcquireTokenForManagedIdentityParameterBuilder>type AcquireTokenForManagedIdentityParameterBuilder = class
inherit AbstractManagedIdentityAcquireTokenParameterBuilder<AcquireTokenForManagedIdentityParameterBuilder>Public NotInheritable Class AcquireTokenForManagedIdentityParameterBuilder
Inherits AbstractManagedIdentityAcquireTokenParameterBuilder(Of AcquireTokenForManagedIdentityParameterBuilder)- Vererbung
-
AcquireTokenForManagedIdentityParameterBuilder
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 AbstractManagedIdentityAcquireTokenParameterBuilder<T>) |
| Validate() |
Überprüft die Parameter des AcquireToken-Vorgangs. (Geerbt von BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithClaims(String) |
Fügt der Tokenanforderung eine Forderungsanforderung hinzu. Das SDK umgeht den Tokencache, wenn eine Forderungsabfrage angegeben wird. Wiederholen Sie den Tokenerwerb, und verwenden Sie diesen Wert in der WithClaims(String) Methode. Eine Forderungsaufforderung tritt in der Regel beim Aufrufen der geschützten downstream-API auf, z. B. wenn der Mandantenadministrator Anmeldeinformationen widerruft. Apps müssen nach einer 401 nicht autorisierten Antwort aus der geschützten API suchen und den WWW-Authenticate Antwortheader analysieren, um die Ansprüche zu extrahieren. Weitere Informationen finden Sie unter https://aka.ms/msal-net-claim-challenge. |
| 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>) |
| WithForceRefresh(Boolean) |
Gibt an, ob die Clientanwendung Zugriffstoken beim Lesen des Tokencaches ignorieren soll. Neue Token werden weiterhin in den Anwendungstokencache geschrieben. Bei MSI v2 mTLS-Anforderungen wird dadurch auch das zwischengespeicherte Bindungszertifikat umgangen und ein neues Zertifikat verwendet. Standardmäßig wird das Token aus dem Anwendungstokencache (forceRefresh=false) übernommen. |
Erweiterungsmethoden
| Name | Beschreibung |
|---|---|
| WithCachePartitionKey<T>(BaseAbstractAcquireTokenParameterBuilder<T>, String, String, Boolean) |
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 |
| 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 zum Partitionieren zwischengespeicherter Zugriffstoken (z. B. Isolieren von kurzlebigen Sitzungen aus regulären Sitzungen für denselben Benutzer). Beide und |
| WithMtlsProofOfPossession(AcquireTokenForManagedIdentityParameterBuilder, PoPOptions) |
Ermöglicht mTLS Proof-of-Possession für den Erwerb von verwalteten Identitätstoken mit zusätzlichen PoP-Optionen, z. B. einer mindest erforderlichen Bindungsstärke. Wenn der Nachweis erforderlich ist (KeyGuard-Szenarien), verwenden Sie das Msal.KeyAttestation-Paket und den Anruf. WithAttestationSupport() nach dieser Methode. |
| WithMtlsProofOfPossession(AcquireTokenForManagedIdentityParameterBuilder) |
Aktiviert mTLS Proof-of-Possession für den Erwerb von verwalteten Identitätstoken. Wenn der Nachweis erforderlich ist (KeyGuard-Szenarien), verwenden Sie das Msal.KeyAttestation-Paket und den Anruf. WithAttestationSupport() nach dieser Methode. |
| WithOtelTagsEnricher<T>(AbstractManagedIdentityAcquireTokenParameterBuilder<T>, Action<ExecutionResult,IList<KeyValuePair<String,Object>>>) |
Registriert einen Delegaten, der zusätzliche Tags (Dimensionen) zu den OpenTelemetry-Metriken hinzufügt, die MSAL emittiert, um dieses verwaltete Identitätstoken zu erwerben. Der Delegat wird aufgerufen, während MSAL seine Metriken aufzeichnet und den ExecutionResult Kauf empfängt (der Erfolg oder Fehler mit dem Ergebnis oder der Ausnahme angibt) zusammen mit einer änderbaren Liste von Tags. An diese Liste angefügte Tags werden an jede Metrik angefügt, die für die Anforderung aufgezeichnet wird, einschließlich der Metriken, die während der proaktiven Hintergrundaktualisierung ausgegeben werden. |
| WithRequestOverMtls(AcquireTokenForManagedIdentityParameterBuilder) |
Verwendet den imDSv2-nachweisten Fluss (Credential Guard ausgestelltes Zertifikat über mTLS), um ein Standardmäßiges Bearertoken abzurufen. Das mTLS-Zertifikat authentifiziert die Verbindung mit dem ESTS-Tokenendpunkt, das zurückgegebene Token enthält |