AbstractApplicationBuilder<T> Třída

Definice

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)

Parametry typu

T
Dědičnost
AbstractApplicationBuilder<T>
Odvozené

Metody

Name Description
WithAdfsAuthority(String, Boolean)

Přidá známou autoritu odpovídající serveru ADFS. Viz https://aka.ms/msal-net-adfs.

WithAuthority(AadAuthorityAudience, Boolean)

Přidá do aplikace známou autoritu Azure AD, aby uživatelé přihlášení určili cílovou skupinu přihlašování (cloud je Azure veřejný cloud). Viz https://aka.ms/msal-net-application-configuration.

WithAuthority(AzureCloudInstance, AadAuthorityAudience, Boolean)

Přidá do aplikace známou autoritu Azure AD, aby uživatelé přihlášení určili cloudovou instanci a cílovou skupinu přihlašování. Viz https://aka.ms/msal-net-application-configuration.

WithAuthority(AzureCloudInstance, Guid, Boolean)

Přidá do aplikace známou autoritu Azure AD pro přihlášení uživatelů z jedné organizace (aplikace s jedním tenantem), kterou popisuje její cloudová instance a ID tenanta. Viz https://aka.ms/msal-net-application-configuration.

WithAuthority(AzureCloudInstance, String, Boolean)

Přidá do aplikace známou autoritu Azure AD pro přihlášení uživatelů z jedné organizace (aplikace s jedním tenantem), kterou popisuje její cloudová instance a její název domény nebo ID tenanta. Viz https://aka.ms/msal-net-application-configuration.

WithAuthority(String, Boolean)

Přidá do aplikace známou Azure autoritu AD, aby uživatelé přihlášení zadali úplný identifikátor URI autority. Viz možnosti konfigurace aplikace.

WithAuthority(String, Guid, Boolean)

Přidá do aplikace známou autoritu Azure AD pro uživatele přihlašování z jedné organizace (aplikace s jedním tenantem) určenou jeho ID tenanta. Viz možnosti konfigurace aplikace.

WithAuthority(String, String, Boolean)

Přidá do aplikace známou autoritu Azure AD pro uživatele přihlašování z jedné organizace (aplikace s jedním tenantem), kterou popisuje její název domény. Viz https://aka.ms/msal-net-application-configuration.

WithAuthority(Uri, Boolean)

Přidá do aplikace známou autoritu. Viz možnosti konfigurace aplikace. Tento konstruktor se používá hlavně ve scénářích, kdy autorita není standardní autoritou Azure AD ani autoritou ADFS ani Azure autoritou AD B2C. Pro Azure AD, i v suverénních cloudech, raději použijte jiné přepsání, jako je napříkladWithAuthority(AzureCloudInstance, AadAuthorityAudience, Boolean)

WithB2CAuthority(String)

Přidá známou autoritu odpovídající zásadám Azure AD B2C. Viz https://aka.ms/msal-net-b2c-specificities.

WithCacheOptions(CacheOptions)

Možnosti pro mezipaměti tokenů MSAL

MSAL udržuje mezipaměť tokenů interně v paměti. Ve výchozím nastavení je tento objekt mezipaměti součástí každé instance PublicClientApplication nebo ConfidentialClientApplication. Tato metoda umožňuje přizpůsobení mezipaměti tokenů v paměti knihovny MSAL.

Mezipaměť paměti MSAL se liší od serializace mezipaměti tokenů. Serializace mezipaměti načítá tokeny z mezipaměti (např. Redis, Cosmos nebo soubor na disku), kde jsou uložené ve formátu JSON, do mezipaměti interní paměti MSAL. Operace mezipaměti paměti nezahrnují operace JSON.

Serializace externí mezipaměti zůstává doporučeným způsobem zpracování desktopových aplikací, webů a webových rozhraní API, protože zajišťuje trvalost. Tyto možnosti aktuálně neřídí serializaci externí mezipaměti.

Podrobné pokyny pro jednotlivé typy aplikací a platformy: https://aka.ms/msal-net-token-cache-serialization

WithClientCapabilities(IEnumerable<String>)

Microsoft rozšíření OIDC specifické pro identitu, které umožňuje řešení problémů s prostředky bez interakce. Umožňuje konfiguraci jedné nebo více možností klienta, například "llt".

WithClientId(String)

Nastaví ID klienta aplikace.

WithClientName(String)

Nastaví název volajícího rozhraní API sady SDK pro účely telemetrie.

(Zděděno od BaseAbstractApplicationBuilder<T>)
WithClientVersion(String)

Nastaví verzi volající sady SDK pro účely telemetrie.

(Zděděno od BaseAbstractApplicationBuilder<T>)
WithDebugLoggingCallback(LogLevel, Boolean, Boolean)

Nastaví zpětné volání protokolování ladění na výchozí metodu ladění, která zobrazí úroveň zprávy a samotné zprávy. Podrobnosti najdete v tématu https://aka.ms/msal-net-logging

(Zděděno od BaseAbstractApplicationBuilder<T>)
WithExperimentalFeatures(Boolean)

Umožňuje používat experimentální funkce a rozhraní API. Pokud tento příznak není nastavený, experimentální funkce vyvolá výjimku. Podrobnosti najdete v tématu https://aka.ms/msal-net-experimental-features

(Zděděno od BaseAbstractApplicationBuilder<T>)
WithExtraQueryParameters(IDictionary<String,String>)
Zastaralé.

Nastaví další parametry dotazu pro řetězec dotazu v požadavku na ověření HTTP.

WithExtraQueryParameters(IDictionary<String,ValueTuple<String,Boolean>>)

Nastaví další parametry dotazu pro řetězec dotazu v požadavku na ověřování HTTP s kontrolou, které parametry jsou zahrnuty do klíče mezipaměti.

WithExtraQueryParameters(String)
Zastaralé.

Nastaví další parametry dotazu pro řetězec dotazu v požadavku na ověření HTTP.

WithHttpClientFactory(IMsalHttpClientFactory, Boolean)

Používá konkrétní IMsalHttpClientFactory komunikaci s idP. To umožňuje pokročilé scénáře, jako je nastavení proxy serveru nebo nastavení agenta.

(Zděděno od BaseAbstractApplicationBuilder<T>)
WithHttpClientFactory(IMsalHttpClientFactory)

Používá konkrétní IMsalHttpClientFactory komunikaci s idP. To umožňuje pokročilé scénáře, jako je nastavení proxy serveru nebo nastavení agenta.

(Zděděno od BaseAbstractApplicationBuilder<T>)
WithInstanceDicoveryMetadata(String)
Zastaralé.

Umožňuje vývojářům konfigurovat vlastní platné autority. Měl by se poskytnout řetězec JSON podobný https://aka.ms/aad-instance-discovery sadě. MsAL používá tyto informace k:

  • Volání rozhraní REST API v prostředí zadaném v preferred_network
  • Identifikace prostředí, ve kterém se mají ukládat tokeny a účty v mezipaměti
  • Použití aliasů prostředí ke shodě tokenů vystavených jiným autoritám
Další podrobnosti najdete v tématu https://aka.ms/msal-net-custom-instance-metadata
WithInstanceDicoveryMetadata(Uri)
Zastaralé.

Umožňuje organizaci nastavit vlastní službu pro zpracování zjišťování instancí, což umožňuje lepší ukládání do mezipaměti pro prostředí mikroslužeb nebo služeb. Měl by se poskytnout identifikátor URI, který vrací odpověď podobnou https://aka.ms/aad-instance-discovery této. MsAL používá tyto informace k:

  • Volání rozhraní REST API v prostředí zadaném v preferred_network
  • Identifikace prostředí, ve kterém se mají ukládat tokeny a účty v mezipaměti
  • Použití aliasů prostředí ke shodě tokenů vystavených jiným autoritám
Další podrobnosti najdete v tématu https://aka.ms/msal-net-custom-instance-metadata
WithInstanceDiscovery(Boolean)

Určuje, zda se při pokusu o ověření provádí zjišťování instancí nebo ne. Nastavením této hodnoty na false se úplně zakáže zjišťování instancí a ověření autority. To ale neovlivní chování aplikace nakonfigurované s regionálními koncovými body.

WithInstanceDiscoveryMetadata(String)

Umožňuje vývojářům konfigurovat vlastní platné autority. Měl by se poskytnout řetězec JSON podobný https://aka.ms/aad-instance-discovery sadě. MsAL používá tyto informace k:

  • Volání rozhraní REST API v prostředí zadaném v preferred_network
  • Identifikace prostředí, ve kterém se mají ukládat tokeny a účty v mezipaměti
  • Použití aliasů prostředí ke shodě tokenů vystavených jiným autoritám
Další podrobnosti najdete v tématu https://aka.ms/msal-net-custom-instance-metadata
WithInstanceDiscoveryMetadata(Uri)

Umožňuje organizaci nastavit vlastní službu pro zpracování zjišťování instancí, což umožňuje lepší ukládání do mezipaměti pro prostředí mikroslužeb nebo služeb. Měl by se poskytnout identifikátor URI, který vrací odpověď podobnou https://aka.ms/aad-instance-discovery této. MsAL používá tyto informace k:

  • Volání rozhraní REST API v prostředí zadaném v preferred_network
  • Identifikace prostředí, ve kterém se mají ukládat tokeny a účty v mezipaměti
  • Použití aliasů prostředí ke shodě tokenů vystavených jiným autoritám
Další podrobnosti najdete v tématu https://aka.ms/msal-net-custom-instance-metadata
WithLegacyCacheCompatibility(Boolean)

Umožňuje serializaci a deserializaci mezipaměti ADAL starší verze.

WithLogging(IIdentityLogger, Boolean)

Nastaví protokolovač identity. Podrobnosti najdete v tématu https://aka.ms/msal-net-logging

(Zděděno od BaseAbstractApplicationBuilder<T>)
WithLogging(LogCallback, Nullable<LogLevel>, Nullable<Boolean>, Nullable<Boolean>)

Nastaví zpětné volání protokolování. Podrobnosti najdete v tématu https://aka.ms/msal-net-logging

(Zděděno od BaseAbstractApplicationBuilder<T>)
WithOptions(ApplicationOptions)

Nastaví možnosti aplikace, které můžou být například načteny z konfiguračních souborů. Viz https://aka.ms/msal-net-application-configuration.

WithOptions(BaseApplicationOptions)

Nastaví možnosti aplikace, které můžou být například načteny z konfiguračních souborů. Viz https://aka.ms/msal-net-application-configuration.

(Zděděno od BaseAbstractApplicationBuilder<T>)
WithRedirectUri(String)

Nastaví identifikátor URI přesměrování aplikace. Identifikátor URI musí být také zaregistrovaný na portálu aplikace. Viz https://aka.ms/msal-net-application-configuration.

WithTelemetry(ITelemetryConfig)
Zastaralé.

Generování událostí agregace telemetrie

WithTenantId(String)

Nastaví ID tenanta organizace, ze které aplikace umožní uživatelům přihlásit se. Jedná se o identifikátor GUID nebo název domény. Viz https://aka.ms/msal-net-application-configuration. I když je také možné nastavit tenantIdcommon, organizationsa consumers, je doporučeno použít jeden z přepsání WithAuthority(AzureCloudInstance, AadAuthorityAudience, Boolean).

Platí pro