AbstractApplicationBuilder<T> Sınıf

Tanım

public abstract class AbstractApplicationBuilder<T> : Microsoft.Identity.Client.BaseAbstractApplicationBuilder<T> where T : BaseAbstractApplicationBuilder<T>
type AbstractApplicationBuilder<'T (requires 'T :> BaseAbstractApplicationBuilder<'T>)> = class
    inherit BaseAbstractApplicationBuilder<'T (requires 'T :> BaseAbstractApplicationBuilder<'T>)>
Public MustInherit Class AbstractApplicationBuilder(Of T)
Inherits BaseAbstractApplicationBuilder(Of T)

Tür Parametreleri

T
Devralma
AbstractApplicationBuilder<T>
Türetilmiş

Yöntemler

Name Description
WithAdfsAuthority(String, Boolean)

ADFS sunucusuna karşılık gelen bilinen bir Yetkili ekler. Bkz. https://aka.ms/msal-net-adfs

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.

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.

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.

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.

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.

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.

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.

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)

WithB2CAuthority(String)

Azure AD B2C ilkesine karşılık gelen bilinen bir yetkili ekler. Bkz. https://aka.ms/msal-net-b2c-specificities

WithCacheOptions(CacheOptions)

MSAL belirteci önbellekleri seçenekleri.

MSAL, dahili olarak bellekte bir belirteç önbelleği tutar. Varsayılan olarak, bu önbellek nesnesi her veya ConfidentialClientApplicationörneğinin PublicClientApplication 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

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

WithClientId(String)

Uygulamanın İstemci Kimliğini ayarlar

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>)
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

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

WithExtraQueryParameters(String)
Geçersiz.

HTTP kimlik doğrulama isteğindeki sorgu dizesi için Ek Sorgu Parametreleri ayarlar

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:

  • preferred_network belirtilen ortamda REST API'lerini çağırma
  • Önbellekte belirteçlerin ve hesapların kaydedildiği ortamı belirleme
  • Diğer yetkililere verilen belirteçleri eşleştirmek için ortam diğer adlarını kullanın
Daha fazla ayrıntı için bkz. https://aka.ms/msal-net-custom-instance-metadata
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:

  • preferred_network belirtilen ortamda REST API'lerini çağırma
  • Önbellekte belirteçlerin ve hesapların kaydedildiği ortamı belirleme
  • Diğer yetkililere verilen belirteçleri eşleştirmek için ortam diğer adlarını kullanın
Daha fazla ayrıntı için bkz. https://aka.ms/msal-net-custom-instance-metadata
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.

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:

  • preferred_network belirtilen ortamda REST API'lerini çağırma
  • Önbellekte belirteçlerin ve hesapların kaydedildiği ortamı belirleme
  • Diğer yetkililere verilen belirteçleri eşleştirmek için ortam diğer adlarını kullanın
Daha fazla ayrıntı için bkz. https://aka.ms/msal-net-custom-instance-metadata
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:

  • preferred_network belirtilen ortamda REST API'lerini çağırma
  • Önbellekte belirteçlerin ve hesapların kaydedildiği ortamı belirleme
  • Diğer yetkililere verilen belirteçleri eşleştirmek için ortam diğer adlarını kullanın
Daha fazla ayrıntı için bkz. https://aka.ms/msal-net-custom-instance-metadata
WithLegacyCacheCompatibility(Boolean)

Eski ADAL önbelleği serileştirmesini ve seri durumdan çıkarmayı etkinleştirir.

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>)
WithOptions(ApplicationOptions)

Örneğin yapılandırma dosyalarından okunmuş olabilecek uygulama seçeneklerini ayarlar. Bkz. https://aka.ms/msal-net-application-configuration.

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>)
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

WithTelemetry(ITelemetryConfig)
Geçersiz.

Telemetri toplama olayları oluşturun.

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 tenantIdcommonda mümkün olsa da, geçersiz kılmalarından WithAuthority(AzureCloudInstance, AadAuthorityAudience, Boolean)birinin kullanılması önerilir.consumersorganizations

Şunlara uygulanır