PublicClientApplicationBuilder Sınıf
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
public sealed class PublicClientApplicationBuilder : Microsoft.Identity.Client.AbstractApplicationBuilder<Microsoft.Identity.Client.PublicClientApplicationBuilder>type PublicClientApplicationBuilder = class
inherit AbstractApplicationBuilder<PublicClientApplicationBuilder>Public NotInheritable Class PublicClientApplicationBuilder
Inherits AbstractApplicationBuilder(Of PublicClientApplicationBuilder)- Devralma
-
PublicClientApplicationBuilder
Yöntemler
| Name | Description | |||
|---|---|---|---|---|
| Build() |
içinde ayarlanan parametrelerden bir örneğini IPublicClientApplicationPublicClientApplicationBuilderoluşturur. |
|||
| Create(String) |
Bir clientID'den PublicClientApplicationBuilder oluşturur. Bkz. https://aka.ms/msal-net-application-configuration |
|||
| CreateWithApplicationOptions(PublicClientApplicationOptions) |
Genel istemci uygulaması yapılandırma seçeneklerinden bir PublicClientApplicationBuilder oluşturur. Bkz. https://aka.ms/msal-net-application-configuration |
|||
| IsBrokerAvailable() |
Bir aracının kullanılıp kullanılamayabileceğini döndürür |
|||
| WithAdfsAuthority(String, Boolean) |
ADFS sunucusuna karşılık gelen bilinen bir Yetkili ekler. Bkz. https://aka.ms/msal-net-adfs (Devralındığı yer: AbstractApplicationBuilder<T>) |
|||
| WithAuthority(AadAuthorityAudience, Boolean) |
Oturum açma hedef kitlesini (bulut, Azure genel bulut) belirten oturum açma kullanıcılarına uygulamaya bilinen bir Azure AD yetkilisi ekler. Bkz. https://aka.ms/msal-net-application-configuration. (Devralındığı yer: AbstractApplicationBuilder<T>) |
|||
| WithAuthority(AzureCloudInstance, AadAuthorityAudience, Boolean) |
Bulut örneğini ve oturum açma hedef kitlesini belirten oturum açma kullanıcıları için uygulamaya bilinen bir Azure AD yetkilisi ekler. Bkz. https://aka.ms/msal-net-application-configuration. (Devralındığı yer: AbstractApplicationBuilder<T>) |
|||
| WithAuthority(AzureCloudInstance, Guid, Boolean) |
Bulut örneği ve kiracı kimliği tarafından açıklanan tek bir kuruluştan (tek kiracılı uygulama) kullanıcılara oturum açmak için uygulamaya bilinen bir Azure AD yetkilisi ekler. Bkz. https://aka.ms/msal-net-application-configuration. (Devralındığı yer: AbstractApplicationBuilder<T>) |
|||
| WithAuthority(AzureCloudInstance, String, Boolean) |
Bulut örneği ve etki alanı adı veya kiracı kimliği tarafından açıklanan tek bir kuruluştaki (tek kiracılı uygulama) kullanıcılara oturum açmak için uygulamaya bilinen bir Azure AD yetkilisi ekler. Bkz. https://aka.ms/msal-net-application-configuration. (Devralındığı yer: AbstractApplicationBuilder<T>) |
|||
| WithAuthority(String, Boolean) |
Tam yetkili URI'sini belirten oturum açma kullanıcılarına uygulamaya bilinen bir Azure AD yetkilisi ekler. Bkz. Uygulama yapılandırma seçenekleri. (Devralındığı yer: AbstractApplicationBuilder<T>) |
|||
| WithAuthority(String, Guid, Boolean) |
Kiracı kimliğiyle belirtilen tek bir kuruluştan (tek kiracılı uygulama) kullanıcılara oturum açmak için uygulamaya bilinen bir Azure AD yetkilisi ekler. Bkz. Uygulama yapılandırma seçenekleri. (Devralındığı yer: AbstractApplicationBuilder<T>) |
|||
| WithAuthority(String, String, Boolean) |
Tek bir kuruluştaki (tek kiracılı uygulama) kullanıcıların etki alanı adıyla açıklandığı şekilde oturum açmak için uygulamaya bilinen bir Azure AD yetkilisi ekler. Bkz. https://aka.ms/msal-net-application-configuration. (Devralındığı yer: AbstractApplicationBuilder<T>) |
|||
| WithAuthority(Uri, Boolean) |
Uygulamaya bilinen bir yetkili ekler. Bkz. Uygulama yapılandırma seçenekleri. Bu oluşturucu temel olarak, yetkilinin standart Azure AD yetkilisi, ADFS yetkilisi veya Azure AD B2C yetkilisi olmadığı senaryolar için kullanılır. Azure AD için, bağımsız bulutlarda bile, gibi diğer geçersiz kılmaları kullanmayı tercih edinWithAuthority(AzureCloudInstance, AadAuthorityAudience, Boolean) (Devralındığı yer: AbstractApplicationBuilder<T>) |
|||
| WithB2CAuthority(String) |
Azure AD B2C ilkesine karşılık gelen bilinen bir yetkili ekler. Bkz. https://aka.ms/msal-net-b2c-specificities (Devralındığı yer: AbstractApplicationBuilder<T>) |
|||
| WithBroker(Boolean) | ||||
| WithCacheOptions(CacheOptions) |
MSAL belirteci önbellekleri seçenekleri. MSAL, dahili olarak bellekte bir belirteç önbelleği tutar. Varsayılan olarak, bu önbellek nesnesi her veya PublicClientApplicationörneğinin ConfidentialClientApplication bir parçasıdır. Bu yöntem, MSAL'nin bellek içi belirteç önbelleğinin özelleştirilmesini sağlar. MSAL'nin bellek önbelleği, belirteç önbelleği serileştirmesinden farklıdır. Önbellek serileştirmesi, belirteçleri JSON biçiminde depolandıkları bir önbellekten (örneğin Redis, Cosmos veya diskteki bir dosya) MSAL'nin iç bellek önbelleğine çeker. Bellek önbelleği işlemleri JSON işlemlerini içermez. Dış önbellek serileştirmesi, kalıcılık sağladığından masaüstü uygulamalarını, web sitesini ve web API'lerini işlemek için önerilen yöntem olmaya devam eder. Bu seçenekler şu anda dış önbellek serileştirmeyi denetlemez. Her uygulama türü ve platform için ayrıntılı yönergeler: https://aka.ms/msal-net-token-cache-serialization (Devralındığı yer: AbstractApplicationBuilder<T>) |
|||
| WithClientCapabilities(IEnumerable<String>) |
Microsoft Kimlikle ilgili OIDC uzantısı, kaynak sorunlarının etkileşim olmadan çözülmesini sağlar. "llt" gibi bir veya daha fazla istemci özelliği yapılandırmaya izin verir (Devralındığı yer: AbstractApplicationBuilder<T>) |
|||
| WithClientId(String) |
Uygulamanın İstemci Kimliğini ayarlar (Devralındığı yer: AbstractApplicationBuilder<T>) |
|||
| WithClientName(String) |
Telemetri amacıyla çağıran SDK API'sinin adını ayarlar. (Devralındığı yer: BaseAbstractApplicationBuilder<T>) |
|||
| WithClientVersion(String) |
Telemetri amacıyla çağrı SDK'sının sürümünü ayarlar. (Devralındığı yer: BaseAbstractApplicationBuilder<T>) |
|||
| WithDebugLoggingCallback(LogLevel, Boolean, Boolean) |
Hata ayıklama günlüğü geri çağırmasını, iletinin düzeyini ve iletinin kendisini görüntüleyen varsayılan bir hata ayıklama yöntemine ayarlar. Ayrıntılar için bkz. https://aka.ms/msal-net-logging (Devralındığı yer: BaseAbstractApplicationBuilder<T>) |
|||
| WithDefaultRedirectUri() |
Genel istemci uygulamasını platform için önerilen yanıt URI'sini kullanacak şekilde yapılandırılır. Bkz. https://aka.ms/msal-net-default-reply-uri.
|
|||
| WithExperimentalFeatures(Boolean) |
Deneysel özelliklerin ve API'lerin kullanımına izin verir. Bu bayrak ayarlanmazsa, deneysel özellikler bir özel durum oluşturur. Ayrıntılar için bkz. https://aka.ms/msal-net-experimental-features (Devralındığı yer: BaseAbstractApplicationBuilder<T>) |
|||
| WithExtraQueryParameters(IDictionary<String,String>) |
Geçersiz.
HTTP kimlik doğrulama isteğindeki sorgu dizesi için Ek Sorgu Parametreleri ayarlar (Devralındığı yer: AbstractApplicationBuilder<T>) |
|||
| WithExtraQueryParameters(IDictionary<String,ValueTuple<String,Boolean>>) |
HTTP kimlik doğrulama isteğindeki sorgu dizesi için Ek Sorgu Parametreleri'ni ayarlar ve önbellek anahtarına hangi parametrelerin dahil olduğunu denetler (Devralındığı yer: AbstractApplicationBuilder<T>) |
|||
| WithExtraQueryParameters(String) |
Geçersiz.
HTTP kimlik doğrulama isteğindeki sorgu dizesi için Ek Sorgu Parametreleri ayarlar (Devralındığı yer: AbstractApplicationBuilder<T>) |
|||
| WithHttpClientFactory(IMsalHttpClientFactory, Boolean) |
IdP ile iletişim kurmak için belirli IMsalHttpClientFactory bir kullanır. Bu, ara sunucu ayarlama veya Aracıyı ayarlama gibi gelişmiş senaryoları etkinleştirir. (Devralındığı yer: BaseAbstractApplicationBuilder<T>) |
|||
| WithHttpClientFactory(IMsalHttpClientFactory) |
IdP ile iletişim kurmak için belirli IMsalHttpClientFactory bir kullanır. Bu, ara sunucu ayarlama veya Aracıyı ayarlama gibi gelişmiş senaryoları etkinleştirir. (Devralındığı yer: BaseAbstractApplicationBuilder<T>) |
|||
| WithInstanceDicoveryMetadata(String) |
Geçersiz.
Geliştiricilerin kendi geçerli yetkililerini yapılandırmasına izin verir. benzeri https://aka.ms/aad-instance-discovery bir json dizesi sağlanmalıdır. MSAL bu bilgileri aşağıdakiler için kullanır:
|
|||
| WithInstanceDicoveryMetadata(Uri) |
Geçersiz.
Bir kuruluşun, mikro hizmet/hizmet ortamları için daha iyi önbelleğe almayı sağlayan örnek bulmayı işlemek için kendi hizmetini ayarlamasına olanak tanır. Şuna benzer https://aka.ms/aad-instance-discovery bir yanıt döndüren bir Uri sağlanmalıdır. MSAL bu bilgileri aşağıdakiler için kullanır:
|
|||
| WithInstanceDiscovery(Boolean) |
Kimlik doğrulaması yapılırken örnek bulma işleminin gerçekleştirilip gerçekleştirilmeyeceğini belirler. Bunu false olarak ayarlamak, örnek bulma ve yetkili doğrulamasını tamamen devre dışı bırakır. Ancak bu, bölgesel uç noktalarla yapılandırılan uygulamanın davranışını etkilemez. (Devralındığı yer: AbstractApplicationBuilder<T>) |
|||
| WithInstanceDiscoveryMetadata(String) |
Geliştiricilerin kendi geçerli yetkililerini yapılandırmasına izin verir. benzeri https://aka.ms/aad-instance-discovery bir json dizesi sağlanmalıdır. MSAL bu bilgileri aşağıdakiler için kullanır:
|
|||
| WithInstanceDiscoveryMetadata(Uri) |
Bir kuruluşun, mikro hizmet/hizmet ortamları için daha iyi önbelleğe almayı sağlayan örnek bulmayı işlemek için kendi hizmetini ayarlamasına olanak tanır. Şuna benzer https://aka.ms/aad-instance-discovery bir yanıt döndüren bir Uri sağlanmalıdır. MSAL bu bilgileri aşağıdakiler için kullanır:
|
|||
| WithIosKeychainSecurityGroup(String) |
Belirteç önbelleğini birden çok uygulamada kalıcı hale getirmek için kullanılacak bir AnahtarLık Erişim Grubu belirtebilirsiniz. Bu, belirteç önbelleğini aynı Anahtar zinciri erişim grubuna sahip birkaç uygulama arasında paylaşmanızı sağlar. Belirteç önbelleğinin paylaşılması, aynı Anahtarlık erişim Grubunu kullanan tüm uygulamalar arasında çoklu oturum açmaya olanak tanır. Daha fazla bilgi için bkz. https://aka.ms/msal-net-ios-keychain-security-group. |
|||
| WithKerberosTicketClaim(String, KerberosTicketContainer) |
Geçersiz.
Azure AD hizmetinden Kerberos Anahtarı almak için gereken parametreleri ayarlar. |
|||
| WithLegacyCacheCompatibility(Boolean) |
Eski ADAL önbelleği serileştirmesini ve seri durumdan çıkarmayı etkinleştirir. (Devralındığı yer: AbstractApplicationBuilder<T>) |
|||
| WithLogging(IIdentityLogger, Boolean) |
Kimlik Günlükçüsüsü'ne ayarlar. Ayrıntılar için bkz. https://aka.ms/msal-net-logging (Devralındığı yer: BaseAbstractApplicationBuilder<T>) |
|||
| WithLogging(LogCallback, Nullable<LogLevel>, Nullable<Boolean>, Nullable<Boolean>) |
Günlük geri çağırmasını ayarlar. Ayrıntılar için bkz. https://aka.ms/msal-net-logging (Devralındığı yer: BaseAbstractApplicationBuilder<T>) |
|||
| WithMultiCloudSupport(Boolean) |
Genel istemci uygulamasının bu örneği için çoklu bulut desteğini etkinleştirir. Uygulamaların genel bir genel bulut yetkilisinde kitaplığı kullanmasını sağlar ve bağımsız bulutlardan kaynaklar için belirteçleri almaya devam edebilir. |
|||
| WithOidcAuthority(String) |
Genel bir OpenIdConnect Kimlik Sağlayıcısına karşılık gelen bilinen bir yetkili ekler. MSAL, yetkiliye ".well-known/openid-configuration" ekler ve uç noktaları bulmak için OIDC meta verilerini oradan alır. Bkz. https://openid.net/specs/openid-connect-core-1_0.html#Terminology |
|||
| WithOptions(ApplicationOptions) |
Örneğin yapılandırma dosyalarından okunmuş olabilecek uygulama seçeneklerini ayarlar. Bkz. https://aka.ms/msal-net-application-configuration. (Devralındığı yer: AbstractApplicationBuilder<T>) |
|||
| WithOptions(BaseApplicationOptions) |
Örneğin yapılandırma dosyalarından okunmuş olabilecek uygulama seçeneklerini ayarlar. Bkz. https://aka.ms/msal-net-application-configuration. (Devralındığı yer: BaseAbstractApplicationBuilder<T>) |
|||
| WithParentActivityOrWindow(Func<IntPtr>) |
IntPtr'ye başvuruyu, tarayıcının gösterilmesini tetikleyen bir pencereye ayarlar. Bu pencereye açılan tarayıcıyı ortalamak için kullanılır. |
|||
| WithParentActivityOrWindow(Func<Object>) |
ViewController (iOS kullanıyorsanız), Etkinlik (Android kullanıyorsanız) IWin32Window veya IntPtr (.Net Framework kullanıyorsanız) için bir başvuru ayarlar. Tarayıcıyı çağırmak için kullanılır. |
|||
| WithRedirectUri(String) |
Uygulamanın yeniden yönlendirme URI'sini ayarlar. URI'nin uygulama portalına da kaydedilmesi gerekir. Bkz. https://aka.ms/msal-net-application-configuration (Devralındığı yer: AbstractApplicationBuilder<T>) |
|||
| WithTelemetry(ITelemetryConfig) |
Geçersiz.
Telemetri toplama olayları oluşturun. (Devralındığı yer: AbstractApplicationBuilder<T>) |
|||
| WithTenantId(String) |
Uygulamanın kullanıcıların oturum açmasına izin verecek kuruluşun kiracı kimliğini ayarlar. Bu klasik olarak bir GUID veya etki alanı adıdır. Bkz. https://aka.ms/msal-net-application-configuration.
, ve olarak ayarlamak |
|||
| WithWindowsBrokerOptions(WindowsBrokerOptions) |
Geçersiz.
Windows 10 Aracısı deneyiminin özelleştirilmesine izin verir. |
|||
Uzantı Metotları
| Name | Description |
|---|---|
| WithBroker(PublicClientApplicationBuilder, BrokerOptions) |
Aracılar Çoklu Oturum Açma, cihaz belirleme ve uygulama belirleme doğrulamasını etkinleştirirken uygulamaların güvenliğini de artırır. Masaüstü platformlarında aracıları etkinleştirmek için bu API'yi kullanın. Yeniden yönlendirme URI'leri gibi aracıyı etkinleştirmek için gereken platforma özgü ayarlar hakkında daha fazla bilgi için bkz https://aka.ms/msal-net-wam . |
| WithBroker(PublicClientApplicationBuilder, BrokerOptions) |
Aracılar Çoklu Oturum Açmayı, cihaz tanımlamayı ve gelişmiş güvenliği etkinleştirir. Masaüstü platformlarında aracıları etkinleştirmek için bu API'yi kullanın. Yeniden yönlendirme URI'leri gibi aracıyı etkinleştirmek için gereken platforma özgü ayarlar hakkında daha fazla bilgi için bkz https://aka.ms/msal-net-wam . |
| WithBrokerPreview(PublicClientApplicationBuilder, Boolean) |
Geçersiz.
MSAL'nin tarayıcılardan daha güvenli olan Aracı akışlarını kullanmasını sağlar. Windows aracısı hakkında ayrıntılı bilgi için bkz.https://aka.ms/msal-net-wam |
| WithDesktopFeatures(PublicClientApplicationBuilder) |
Geçersiz.
CLI, WinForms WPF uygulamaları gibi masaüstü uygulamaları için gelişmiş destek ekler. Eklenen destek şu şekildedir:
|
| WithSsoPolicy(PublicClientApplicationBuilder) |
SsoPolicy zorlamasını etkinleştirmek için bu API'yi kullanın. Yalnızca birinci taraf Microsoft uygulamalar tarafından kullanılmalıdır. Bu yalnızca aracı etkinleştirilmediğinde ve ekli web görünümü tercih edilen seçenek olduğunda geçerlidir. Varsayılan olarak, aracı SsoPolicy'yi destekler ve sistem web görünümü SsoPolicy de işletim sistemi düzeyinde desteklenir. |
| WithWindowsBroker(PublicClientApplicationBuilder, Boolean) |
Geçersiz.
Microsoft içeren kutuda bulunmayan .NET çerçevesi gibi eski platformlarda Windows aracı akışlarını etkinleştirir. Identity.Client Windows aracısı hakkındaki ayrıntılar için bkz.https://aka.ms/msal-net-wam |
| WithWindowsDesktopFeatures(PublicClientApplicationBuilder, BrokerOptions) |
CLI, WinForms WPF uygulamaları gibi masaüstü uygulamaları için gelişmiş destek ekler.
|
| WithWindowsEmbeddedBrowserSupport(PublicClientApplicationBuilder) |
MSAL'ye daha iyi ekli tarayıcı desteği ekler. AAD uygulamaları eski WebBrowser denetimini kullanır. Diğer uygulamalar (B2C, ADFS vb.) Microsoft Edge tabanlı bir ekli tarayıcı kullanır -https://aka.ms/msal-net-webview2 |