AbstractApplicationBuilder<T> Klas

Definitie

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)

Type parameters

T
Overname
AbstractApplicationBuilder<T>
Afgeleid

Methoden

Name Description
WithAdfsAuthority(String, Boolean)

Hiermee voegt u een bekende instantie toe die overeenkomt met een ADFS-server. Zie https://aka.ms/msal-net-adfs

WithAuthority(AadAuthorityAudience, Boolean)

Voegt een bekende Azure AD-instantie toe aan de toepassing om gebruikers aan te melden die de aanmeldingsdoelgroep opgeven (de cloud is de Azure openbare cloud). Zie https://aka.ms/msal-net-application-configuration.

WithAuthority(AzureCloudInstance, AadAuthorityAudience, Boolean)

Voegt een bekende Azure AD-instantie toe aan de toepassing om gebruikers aan te melden die het cloudexemplaren en de aanmeldingsdoelgroep opgeven. Zie https://aka.ms/msal-net-application-configuration.

WithAuthority(AzureCloudInstance, Guid, Boolean)

Voegt een bekende Azure AD-instantie toe aan de toepassing om gebruikers aan te melden vanuit één organisatie (één tenanttoepassing) die wordt beschreven door het cloudexemplaren en de tenant-id. Zie https://aka.ms/msal-net-application-configuration.

WithAuthority(AzureCloudInstance, String, Boolean)

Voegt een bekende Azure AD-instantie toe aan de toepassing om gebruikers aan te melden vanuit één organisatie (toepassing met één tenant) die wordt beschreven door het cloudexemplaren en de domeinnaam of tenant-id. Zie https://aka.ms/msal-net-application-configuration.

WithAuthority(String, Boolean)

Voegt een bekende Azure AD-instantie toe aan de toepassing om gebruikers aan te melden die de volledige instantie-URI opgeven. Zie Opties voor toepassingsconfiguratie.

WithAuthority(String, Guid, Boolean)

Voegt een bekende Azure AD-instantie toe aan de toepassing om gebruikers aan te melden vanuit één organisatie (toepassing met één tenant) die is opgegeven door de tenant-id. Zie Opties voor toepassingsconfiguratie.

WithAuthority(String, String, Boolean)

Voegt een bekende Azure AD-instantie toe aan de toepassing om gebruikers aan te melden vanuit één organisatie (toepassing met één tenant) die wordt beschreven door de domeinnaam. Zie https://aka.ms/msal-net-application-configuration.

WithAuthority(Uri, Boolean)

Hiermee voegt u een bekende instantie toe aan de toepassing. Zie Opties voor toepassingsconfiguratie. Deze constructor wordt voornamelijk gebruikt voor scenario's waarbij de instantie geen standaard-Azure AD-instantie is, noch een ADFS-instantie, noch een Azure AD B2C-instantie. Voor Azure AD, zelfs in onafhankelijke clouds, gebruikt u liever andere onderdrukkingen, zoalsWithAuthority(AzureCloudInstance, AadAuthorityAudience, Boolean)

WithB2CAuthority(String)

Voegt een bekende instantie toe die overeenkomt met een Azure AD B2C-beleid. Zie https://aka.ms/msal-net-b2c-specificities

WithCacheOptions(CacheOptions)

Opties voor MSAL-tokencaches.

MSAL onderhoudt intern een tokencache in het geheugen. Dit cacheobject maakt standaard deel uit van elk exemplaar van PublicClientApplication of ConfidentialClientApplication. Met deze methode kunt u de cache van het in-memory token van MSAL aanpassen.

De geheugencache van MSAL verschilt van de serialisatie van tokencaches. Met cacheserialisatie worden de tokens opgehaald uit een cache (bijvoorbeeld Redis, Cosmos of een bestand op schijf), waar ze zijn opgeslagen in JSON-indeling, in de interne geheugencache van MSAL. Geheugencachebewerkingen omvatten geen JSON-bewerkingen.

Serialisatie van externe cache blijft de aanbevolen manier om bureaublad-apps, website- en web-API's te verwerken, omdat deze persistentie biedt. Deze opties beheren momenteel geen serialisatie van externe cache.

Gedetailleerde richtlijnen voor elk toepassingstype en elk platform: https://aka.ms/msal-net-token-cache-serialization

WithClientCapabilities(IEnumerable<String>)

Microsoft Identiteitsspecifieke OIDC-extensie waarmee resourceuitdagingen zonder tussenkomst kunnen worden opgelost. Hiermee staat u de configuratie van een of meer clientmogelijkheden toe, bijvoorbeeld 'llt'

WithClientId(String)

Hiermee stelt u de client-id van de toepassing in

WithClientName(String)

Hiermee stelt u de naam van de AANroepende SDK-API in voor telemetriedoeleinden.

(Overgenomen van BaseAbstractApplicationBuilder<T>)
WithClientVersion(String)

Hiermee stelt u de versie van de aanroepende SDK in voor telemetriedoeleinden.

(Overgenomen van BaseAbstractApplicationBuilder<T>)
WithDebugLoggingCallback(LogLevel, Boolean, Boolean)

Hiermee stelt u de callback voor foutopsporing in op een standaardopsporingsmethode waarmee het niveau van het bericht en het bericht zelf wordt weergegeven. Zie voor meer informatie https://aka.ms/msal-net-logging

(Overgenomen van BaseAbstractApplicationBuilder<T>)
WithExperimentalFeatures(Boolean)

Hiermee staat u het gebruik van experimentele functies en API's toe. Als deze vlag niet is ingesteld, genereren experimentele functies een uitzondering. Zie voor meer informatie https://aka.ms/msal-net-experimental-features

(Overgenomen van BaseAbstractApplicationBuilder<T>)
WithExtraQueryParameters(IDictionary<String,String>)
Verouderd.

Hiermee stelt u extra queryparameters in voor de querytekenreeks in de HTTP-verificatieaanvraag

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

Hiermee stelt u extra queryparameters voor de queryreeks in de HTTP-verificatieaanvraag in met controle over welke parameters zijn opgenomen in de cachesleutel

WithExtraQueryParameters(String)
Verouderd.

Hiermee stelt u extra queryparameters in voor de querytekenreeks in de HTTP-verificatieaanvraag

WithHttpClientFactory(IMsalHttpClientFactory, Boolean)

Maakt gebruik van een specifieke IMsalHttpClientFactory communicatie met de IdP. Dit maakt geavanceerde scenario's mogelijk, zoals het instellen van een proxy of het instellen van de agent.

(Overgenomen van BaseAbstractApplicationBuilder<T>)
WithHttpClientFactory(IMsalHttpClientFactory)

Maakt gebruik van een specifieke IMsalHttpClientFactory communicatie met de IdP. Dit maakt geavanceerde scenario's mogelijk, zoals het instellen van een proxy of het instellen van de agent.

(Overgenomen van BaseAbstractApplicationBuilder<T>)
WithInstanceDicoveryMetadata(String)
Verouderd.

Hiermee kunnen ontwikkelaars hun eigen geldige instanties configureren. Er moet een json-tekenreeks worden opgegeven die vergelijkbaar https://aka.ms/aad-instance-discovery is met deze tekenreeks. MSAL gebruikt deze informatie om:

  • REST API's aanroepen in de omgeving die is opgegeven in de preferred_network
  • Een omgeving identificeren waaronder tokens en accounts in de cache moeten worden opgeslagen
  • De omgevingsaliassen gebruiken om tokens te koppelen die zijn uitgegeven aan andere instanties
Zie voor meer informatie https://aka.ms/msal-net-custom-instance-metadata
WithInstanceDicoveryMetadata(Uri)
Verouderd.

Hiermee kan een organisatie een eigen service instellen voor het afhandelen van exemplaardetectie, waardoor de cache voor microservice-/serviceomgevingen beter kan worden opgeslagen. Er moet een URI worden opgegeven die een antwoord retourneert dat vergelijkbaar is met https://aka.ms/aad-instance-discovery . MSAL gebruikt deze informatie om:

  • REST API's aanroepen in de omgeving die is opgegeven in de preferred_network
  • Een omgeving identificeren waaronder tokens en accounts in de cache moeten worden opgeslagen
  • De omgevingsaliassen gebruiken om tokens te koppelen die zijn uitgegeven aan andere instanties
Zie voor meer informatie https://aka.ms/msal-net-custom-instance-metadata
WithInstanceDiscovery(Boolean)

Bepaalt of de detectie van exemplaren al dan niet wordt uitgevoerd bij het verifiëren. Als u dit instelt op false, wordt detectie van exemplaren en autorisatie volledig uitgeschakeld. Dit heeft echter geen invloed op het gedrag van de toepassing die is geconfigureerd met regionale eindpunten.

WithInstanceDiscoveryMetadata(String)

Hiermee kunnen ontwikkelaars hun eigen geldige instanties configureren. Er moet een json-tekenreeks worden opgegeven die vergelijkbaar https://aka.ms/aad-instance-discovery is met deze tekenreeks. MSAL gebruikt deze informatie om:

  • REST API's aanroepen in de omgeving die is opgegeven in de preferred_network
  • Een omgeving identificeren waaronder tokens en accounts in de cache moeten worden opgeslagen
  • De omgevingsaliassen gebruiken om tokens te koppelen die zijn uitgegeven aan andere instanties
Zie voor meer informatie https://aka.ms/msal-net-custom-instance-metadata
WithInstanceDiscoveryMetadata(Uri)

Hiermee kan een organisatie een eigen service instellen voor het afhandelen van exemplaardetectie, waardoor de cache voor microservice-/serviceomgevingen beter kan worden opgeslagen. Er moet een URI worden opgegeven die een antwoord retourneert dat vergelijkbaar is met https://aka.ms/aad-instance-discovery . MSAL gebruikt deze informatie om:

  • REST API's aanroepen in de omgeving die is opgegeven in de preferred_network
  • Een omgeving identificeren waaronder tokens en accounts in de cache moeten worden opgeslagen
  • De omgevingsaliassen gebruiken om tokens te koppelen die zijn uitgegeven aan andere instanties
Zie voor meer informatie https://aka.ms/msal-net-custom-instance-metadata
WithLegacyCacheCompatibility(Boolean)

Hiermee schakelt u verouderde ADAL-cacheserialisatie en deserialisatie in.

WithLogging(IIdentityLogger, Boolean)

Hiermee stelt u de identiteitslogger in. Zie voor meer informatie https://aka.ms/msal-net-logging

(Overgenomen van BaseAbstractApplicationBuilder<T>)
WithLogging(LogCallback, Nullable<LogLevel>, Nullable<Boolean>, Nullable<Boolean>)

Hiermee stelt u de callback voor logboekregistratie in. Zie voor meer informatie https://aka.ms/msal-net-logging

(Overgenomen van BaseAbstractApplicationBuilder<T>)
WithOptions(ApplicationOptions)

Hiermee stelt u toepassingsopties in, die bijvoorbeeld kunnen worden gelezen uit configuratiebestanden. Zie https://aka.ms/msal-net-application-configuration.

WithOptions(BaseApplicationOptions)

Hiermee stelt u toepassingsopties in, die bijvoorbeeld kunnen worden gelezen uit configuratiebestanden. Zie https://aka.ms/msal-net-application-configuration.

(Overgenomen van BaseAbstractApplicationBuilder<T>)
WithRedirectUri(String)

Hiermee stelt u de omleidings-URI van de toepassing in. De URI moet ook worden geregistreerd in de toepassingsportal. Zie https://aka.ms/msal-net-application-configuration

WithTelemetry(ITelemetryConfig)
Verouderd.

Telemetrieaggregatie-gebeurtenissen genereren.

WithTenantId(String)

Hiermee stelt u de tenant-id in van de organisatie waaruit gebruikers zich kunnen aanmelden met de toepassing. Dit is klassiek een GUID of een domeinnaam. Zie https://aka.ms/msal-net-application-configuration. Hoewel het ook mogelijk is om in te stellen tenantId op common, organizationsen consumers, is het raadzaam om een van de onderdrukkingen van WithAuthority(AzureCloudInstance, AadAuthorityAudience, Boolean).

Van toepassing op