ClientApplicationBase.AcquireTokenSilent Yöntem

Tanım

Ad Alanı:

Microsoft.Identity.Client

Bütünleştirilmiş Kod:

Microsoft.Identity.Client.dll

Paket:

Microsoft.Identity.Client v4.84.2

Aşırı Yüklemeler

Name	Description
AcquireTokenSilent(IEnumerable<String>, IAccount)	[V3 API] kullanıcı belirteci önbelleğinden için account erişim belirteci almaya çalışır. Diğer ayrıntılar için bkz.https://aka.ms/msal-net-acquiretokensilent
AcquireTokenSilent(IEnumerable<String>, String)	[V3 API] Kullanıcı belirteci önbelleğinden verilen loginHintile eşleşmesi Username için IAccount bir erişim belirteci almaya çalışır. Diğer ayrıntılar için bkz.https://aka.ms/msal-net-acquiretokensilent

AcquireTokenSilent(IEnumerable<String>, IAccount)

[V3 API] kullanıcı belirteci önbelleğinden için account erişim belirteci almaya çalışır. Diğer ayrıntılar için bkz.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.AcquireTokenSilentParameterBuilder

Public Function AcquireTokenSilent (scopes As IEnumerable(Of String), account As IAccount) As AcquireTokenSilentParameterBuilder

Parametreler

scopes

IEnumerable<String>

Korumalı API'ye erişmek için istenen kapsamlar

account

IAccount

Belirtecin istendiği hesap.

Döndürülenler

AcquireTokenSilentParameterBuilder

İsteğe AcquireTokenSilentParameterBuilder bağlı parametreler ekleyerek belirteç isteğini oluşturmak için kullanılan

Uygulamalar

AcquireTokenSilent(IEnumerable<String>, IAccount)

Özel durumlar

MsalUiRequiredException

örneğin önbellekte yenileme belirteci yoksa veya kullanıcının yeniden oturum açması gerekiyorsa (örneğin, parolanın süresi dolduysa) veya kullanıcının iki faktörlü kimlik doğrulaması gerçekleştirmesi gerekiyorsa, uygulamanın son kullanıcısıyla bir etkileşimin gerekli olduğu durumlarda oluşturulur

Açıklamalar

Erişim belirteci , en azından istenen tüm kapsamları içeriyorsa eşleşme olarak kabul edilir. Bu, istenenden daha fazla kapsama sahip bir erişim belirtecinin döndürülebileceği anlamına gelir. Erişim belirtecinin süresi dolduysa veya süresi dolmak üzereyse (5 dakikalık bir süre içinde) önbelleğe alınan yenileme belirteci (varsa) sessiz ağ çağrısı yaparak yeni bir erişim belirteci almak için kullanılır.

Oluşturucuyu ile zincirleyerek ek parametreler ayarlayabilirsiniz: WithTenantId(String) Kullanıcı belirteci önbelleğini atlamak ve belirteci yenilemeye Microsoft.Identity.Client.AbstractAcquireTokenParameterBuilder`1.WithExtraQueryParameters(System.Collections.Generic.Dictionary{System.String,System.String}) zorlamak ve ek sorgu parametreleri belirtmek için uygulama yapısındaki WithForceRefresh(Boolean) kümeden farklı bir yetkiliye belirteç istemek için

AcquireTokenSilent(IEnumerable<String>, String)

[V3 API] Kullanıcı belirteci önbelleğinden verilen loginHintile eşleşmesi Username için IAccount bir erişim belirteci almaya çalışır. Diğer ayrıntılar için bkz.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.AcquireTokenSilentParameterBuilder

Public Function AcquireTokenSilent (scopes As IEnumerable(Of String), loginHint As String) As AcquireTokenSilentParameterBuilder

Parametreler

scopes

IEnumerable<String>

Korumalı API'ye erişmek için istenen kapsamlar

loginHint

String

Genellikle kullanıcı adı, UPN biçiminde, örneğin. johnd@contoso.com

Döndürülenler

AcquireTokenSilentParameterBuilder

İsteğe AcquireTokenSilentParameterBuilder bağlı parametreler ekleyerek belirteç isteğini oluşturmak için kullanılan

Uygulamalar

AcquireTokenSilent(IEnumerable<String>, String)

Özel durumlar

MsalUiRequiredException

örneğin önbellekte yenileme belirteci yoksa veya kullanıcının yeniden oturum açması gerekiyorsa (örneğin, parolanın süresi dolduysa) veya kullanıcının iki faktörlü kimlik doğrulaması gerçekleştirmesi gerekiyorsa, uygulamanın son kullanıcısıyla bir etkileşimin gerekli olduğu durumlarda oluşturulur

Açıklamalar

birden çok IAccount ile eşleşiyorsa loginHintveya eşleşme yoksa, bir özel durum oluşturulur.

Erişim belirteci , en azından istenen tüm kapsamları içeriyorsa eşleşme olarak kabul edilir. Bu, istenenden daha fazla kapsama sahip bir erişim belirtecinin döndürülebileceği anlamına gelir. Erişim belirtecinin süresi dolduysa veya süresi dolmak üzereyse (5 dakikalık bir süre içinde) önbelleğe alınan yenileme belirteci (varsa) sessiz ağ çağrısı yaparak yeni bir erişim belirteci almak için kullanılır.

Oluşturucuyu şu şekilde zincirleyerek ek parametreler ayarlayabilirsiniz: WithTenantId(String) Kullanıcı belirteci önbelleğini atlamak ve belirteci yenilemeye Microsoft.Identity.Client.AbstractAcquireTokenParameterBuilder`1.WithExtraQueryParameters(System.Collections.Generic.Dictionary{System.String,System.String}) zorlamak ve ek sorgu parametreleri belirtmek için uygulama yapısında WithForceRefresh(Boolean) ayarlanandan farklı bir yetkiliye belirteç istemek için