ClientApplicationBase.AcquireTokenSilent Methode
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.
Overloads
| Name | Description |
|---|---|
| AcquireTokenSilent(IEnumerable<String>, IAccount) |
[V3 API] Hiermee probeert u een toegangstoken voor het |
| AcquireTokenSilent(IEnumerable<String>, String) |
[V3 API] Probeert een toegangstoken te verkrijgen voor het IAccount feit dat het overeenkomt met de Username opgegeven |
AcquireTokenSilent(IEnumerable<String>, IAccount)
[V3 API] Hiermee probeert u een toegangstoken voor het account tokencache van de gebruiker te verkrijgen.
Zie https://aka.ms/msal-net-acquiretokensilent voor meer informatie
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 AcquireTokenSilentParameterBuilderParameters
- scopes
- IEnumerable<String>
Bereiken die zijn aangevraagd voor toegang tot een beveiligde API
- account
- IAccount
Account waarvoor het token wordt aangevraagd.
Retouren
Een AcquireTokenSilentParameterBuilder gebruikt om de tokenaanvraag te bouwen en optionele parameters toe te voegen
Implementeringen
Uitzonderingen
wordt gegenereerd in het geval dat een interactie met de eindgebruiker van de toepassing vereist is, bijvoorbeeld als er geen vernieuwingstoken in de cache staat, of dat de gebruiker toestemming moet geven of zich opnieuw moet aanmelden (bijvoorbeeld als het wachtwoord is verlopen), of als de gebruiker tweeledige verificatie moet uitvoeren
Opmerkingen
Het toegangstoken wordt beschouwd als een overeenkomst als het ten minste alle aangevraagde bereiken bevat. Dit betekent dat een toegangstoken met meer bereiken dan aangevraagd kan worden geretourneerd. Als het toegangstoken is verlopen of bijna is verlopen - binnen een periode van vijf minuten - wordt het vernieuwingstoken in de cache (indien beschikbaar) gebruikt om een nieuw toegangstoken te verkrijgen door een stille netwerkoproep te maken.
U kunt extra parameters instellen door de opbouwfunctie te koppelen aan: WithTenantId(String) om een token aan te vragen voor een andere instantie dan de instantie die is ingesteld bij de toepassingsconstructie WithForceRefresh(Boolean) om de cache van het gebruikerstoken te omzeilen en het token te vernieuwen, en Microsoft.Identity.Client.AbstractAcquireTokenParameterBuilder`1.WithExtraQueryParameters(System.Collections.Generic.Dictionary{System.String,System.String}) om extra queryparameters op te geven
Van toepassing op
AcquireTokenSilent(IEnumerable<String>, String)
[V3 API] Probeert een toegangstoken te verkrijgen voor het IAccount feit dat het overeenkomt met de Username opgegeven loginHint, uit de cache van het gebruikerstoken.
Zie https://aka.ms/msal-net-acquiretokensilent voor meer informatie
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 AcquireTokenSilentParameterBuilderParameters
- scopes
- IEnumerable<String>
Bereiken die zijn aangevraagd voor toegang tot een beveiligde API
- loginHint
- String
Meestal de gebruikersnaam, in UPN-indeling, bijvoorbeeld johnd@contoso.com
Retouren
Een AcquireTokenSilentParameterBuilder gebruikt om de tokenaanvraag te bouwen en optionele parameters toe te voegen
Implementeringen
Uitzonderingen
wordt gegenereerd in het geval dat een interactie met de eindgebruiker van de toepassing vereist is, bijvoorbeeld als er geen vernieuwingstoken in de cache staat, of dat de gebruiker toestemming moet geven of zich opnieuw moet aanmelden (bijvoorbeeld als het wachtwoord is verlopen), of als de gebruiker tweeledige verificatie moet uitvoeren
Opmerkingen
Als er meerdere IAccount overeenkomsten loginHintzijn of als er geen overeenkomsten zijn, wordt er een uitzondering gegenereerd.
Het toegangstoken wordt beschouwd als een overeenkomst als het ten minste alle aangevraagde bereiken bevat. Dit betekent dat een toegangstoken met meer bereiken dan aangevraagd kan worden geretourneerd. Als het toegangstoken is verlopen of bijna is verlopen - binnen een periode van vijf minuten - wordt het vernieuwingstoken in de cache (indien beschikbaar) gebruikt om een nieuw toegangstoken te verkrijgen door een stille netwerkoproep te maken.
U kunt extra parameters instellen door de opbouwfunctie te koppelen aan: WithTenantId(String) om een token aan te vragen voor een andere instantie dan de instantie die is ingesteld bij de toepassingsconstructie WithForceRefresh(Boolean) om de cache van het gebruikerstoken te omzeilen en het token te vernieuwen, en Microsoft.Identity.Client.AbstractAcquireTokenParameterBuilder`1.WithExtraQueryParameters(System.Collections.Generic.Dictionary{System.String,System.String}) om extra queryparameters op te geven