ClientApplicationBase.AcquireTokenSilent Methode
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.
Überlädt
| Name | Beschreibung |
|---|---|
| AcquireTokenSilent(IEnumerable<String>, IAccount) |
[V3-API] Versucht, ein Zugriffstoken für den |
| AcquireTokenSilent(IEnumerable<String>, String) |
[V3-API] Versucht, ein Zugriffstoken für die IAccount Übereinstimmung mit dem Username angegebenen |
AcquireTokenSilent(IEnumerable<String>, IAccount)
[V3-API] Versucht, ein Zugriffstoken für den account Benutzertokencache abzurufen.
Weitere Informationen finden Sie unter https://aka.ms/msal-net-acquiretokensilent
public Microsoft.Identity.Client.AcquireTokenSilentParameterBuilder AcquireTokenSilent(System.Collections.Generic.IEnumerable<string> scopes, Microsoft.Identity.Client.IAccount account);abstract member AcquireTokenSilent : seq<string> * Microsoft.Identity.Client.IAccount -> Microsoft.Identity.Client.AcquireTokenSilentParameterBuilder
override this.AcquireTokenSilent : seq<string> * Microsoft.Identity.Client.IAccount -> Microsoft.Identity.Client.AcquireTokenSilentParameterBuilderPublic Function AcquireTokenSilent (scopes As IEnumerable(Of String), account As IAccount) As AcquireTokenSilentParameterBuilderParameter
- scopes
- IEnumerable<String>
Bereiche, die für den Zugriff auf eine geschützte API angefordert wurden
- account
- IAccount
Konto, für das das Token angefordert wird.
Gibt zurück
Ein AcquireTokenSilentParameterBuilder Verwendeter Zum Erstellen der Tokenanforderung, Hinzufügen optionaler Parameter
Implementiert
Ausnahmen
wird ausgelöst, wenn eine Interaktion mit dem Endbenutzer der Anwendung erforderlich ist, z. B. wenn sich kein Aktualisierungstoken im Cache befand, oder der Benutzer muss zustimmen oder erneut anmelden (z. B. wenn das Kennwort abgelaufen ist), oder der Benutzer muss zweistufige Authentifizierung durchführen.
Hinweise
Das Zugriffstoken gilt als Übereinstimmung, wenn es mindestens alle angeforderten Bereiche enthält. Dies bedeutet, dass ein Zugriffstoken mit mehr Bereichen als angefordert zurückgegeben werden kann. Wenn das Zugriffstoken abgelaufen ist oder nahe am Ablauf liegt – innerhalb eines 5-Minuten-Fensters – wird das zwischengespeicherte Aktualisierungstoken (sofern verfügbar) verwendet, um ein neues Zugriffstoken zu erhalten, indem ein automatischer Netzwerkaufruf ausgeführt wird.
Sie können zusätzliche Parameter festlegen, indem Sie den Generator verketten mit: WithTenantId(String) um ein Token für eine andere Autorität als die für die Anwendungskonstruktion WithForceRefresh(Boolean) festzulegen, um den Benutzertokencache zu umgehen und das Aktualisieren des Tokens zu erzwingen sowie Microsoft.Identity.Client.AbstractAcquireTokenParameterBuilder`1.WithExtraQueryParameters(System.Collections.Generic.Dictionary{System.String,System.String}) zusätzliche Abfrageparameter anzugeben
Gilt für:
AcquireTokenSilent(IEnumerable<String>, String)
[V3-API] Versucht, ein Zugriffstoken für die IAccount Übereinstimmung mit dem Username angegebenen loginHintVom Benutzertokencache abzurufen.
Weitere Informationen finden Sie unter https://aka.ms/msal-net-acquiretokensilent
public Microsoft.Identity.Client.AcquireTokenSilentParameterBuilder AcquireTokenSilent(System.Collections.Generic.IEnumerable<string> scopes, string loginHint);abstract member AcquireTokenSilent : seq<string> * string -> Microsoft.Identity.Client.AcquireTokenSilentParameterBuilder
override this.AcquireTokenSilent : seq<string> * string -> Microsoft.Identity.Client.AcquireTokenSilentParameterBuilderPublic Function AcquireTokenSilent (scopes As IEnumerable(Of String), loginHint As String) As AcquireTokenSilentParameterBuilderParameter
- scopes
- IEnumerable<String>
Bereiche, die für den Zugriff auf eine geschützte API angefordert wurden
- loginHint
- String
In der Regel der Benutzername im UPN-Format, z. B. johnd@contoso.com
Gibt zurück
Ein AcquireTokenSilentParameterBuilder Verwendeter Zum Erstellen der Tokenanforderung, Hinzufügen optionaler Parameter
Implementiert
Ausnahmen
wird ausgelöst, wenn eine Interaktion mit dem Endbenutzer der Anwendung erforderlich ist, z. B. wenn sich kein Aktualisierungstoken im Cache befand, oder der Benutzer muss zustimmen oder erneut anmelden (z. B. wenn das Kennwort abgelaufen ist), oder der Benutzer muss zweistufige Authentifizierung durchführen.
Hinweise
Wenn mehrere IAccount Übereinstimmungen mit dem loginHint, oder wenn keine Übereinstimmungen vorhanden sind, wird eine Ausnahme ausgelöst.
Das Zugriffstoken gilt als Übereinstimmung, wenn es mindestens alle angeforderten Bereiche enthält. Dies bedeutet, dass ein Zugriffstoken mit mehr Bereichen als angefordert zurückgegeben werden kann. Wenn das Zugriffstoken abgelaufen ist oder nahe am Ablauf liegt – innerhalb eines 5-Minuten-Fensters – wird das zwischengespeicherte Aktualisierungstoken (sofern verfügbar) verwendet, um ein neues Zugriffstoken zu erhalten, indem ein automatischer Netzwerkaufruf ausgeführt wird.
Sie können zusätzliche Parameter festlegen, indem Sie den Generator verketten mit: WithTenantId(String) um ein Token für eine andere Autorität als die für die Anwendungskonstruktion WithForceRefresh(Boolean) festzulegen, um den Benutzertokencache zu umgehen und das Aktualisieren des Tokens zu erzwingen sowie Microsoft.Identity.Client.AbstractAcquireTokenParameterBuilder`1.WithExtraQueryParameters(System.Collections.Generic.Dictionary{System.String,System.String}) zusätzliche Abfrageparameter anzugeben