AbstractApplicationBuilder<T>.WithAuthority Methode

Definition

Namespace:: Microsoft.Identity.Client

Assembly:: Microsoft.Identity.Client.dll

Paket:: Microsoft.Identity.Client v4.84.2

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Überlädt

Name	Beschreibung
WithAuthority(AadAuthorityAudience, Boolean)	Fügt der Anwendung eine bekannte Azure AD-Autorität hinzu, um Anmeldebenutzer anzugeben, die die Anmeldegruppe angeben (die Cloud ist die Azure öffentliche Cloud). Siehe https://aka.ms/msal-net-application-configuration.
WithAuthority(String, Boolean)	Fügt der Anwendung eine bekannte Azure AD-Autorität hinzu, um Sich-Benutzer anzumelden, die den vollständigen Autoritäts-URI angeben. Siehe Anwendungskonfigurationsoptionen.
WithAuthority(Uri, Boolean)	Fügt der Anwendung eine bekannte Autorität hinzu. Siehe Anwendungskonfigurationsoptionen. Dieser Konstruktor wird hauptsächlich für Szenarien verwendet, in denen die Autorität keine Standard-Azure AD-Autorität oder eine ADFS-Autorität oder eine Azure AD B2C-Autorität ist. Für Azure AD, auch in souveränen Clouds, bevorzugen Sie die Verwendung anderer Außerkraftsetzungen wie z. B.WithAuthority(AzureCloudInstance, AadAuthorityAudience, Boolean)
WithAuthority(AzureCloudInstance, AadAuthorityAudience, Boolean)	Fügt der Anwendung eine bekannte Azure AD-Autorität hinzu, um Anmeldebenutzern die Cloudinstanz und die Anmeldegruppe anzugeben. Siehe https://aka.ms/msal-net-application-configuration.
WithAuthority(AzureCloudInstance, Guid, Boolean)	Fügt der Anwendung eine bekannte Azure AD-Autorität hinzu, um Benutzer aus einer einzelnen Organisation (Einzelmandantenanwendung) anzumelden, die von ihrer Cloudinstanz und ihrer Mandanten-ID beschrieben wird. Siehe https://aka.ms/msal-net-application-configuration.
WithAuthority(AzureCloudInstance, String, Boolean)	Fügt der Anwendung eine bekannte Azure AD-Autorität hinzu, um Benutzer aus einer einzigen Organisation (Einzelmandantenanwendung) anzumelden, die von der Cloudinstanz und dem Domänennamen oder der Mandanten-ID beschrieben wird. Siehe https://aka.ms/msal-net-application-configuration.
WithAuthority(String, Guid, Boolean)	Fügt der Anwendung eine bekannte Azure AD-Autorität hinzu, um Benutzer aus einer einzigen Organisation (Einzelmandantenanwendung) anzumelden, die durch ihre Mandanten-ID angegeben wird. Siehe Anwendungskonfigurationsoptionen.
WithAuthority(String, String, Boolean)	Fügt der Anwendung eine bekannte Azure AD-Autorität hinzu, um Benutzer aus einer einzigen Organisation (Einzelmandantenanwendung) anzumelden, die durch ihren Domänennamen beschrieben wird. Siehe https://aka.ms/msal-net-application-configuration.

WithAuthority(AadAuthorityAudience, Boolean)

Fügt der Anwendung eine bekannte Azure AD-Autorität hinzu, um Anmeldebenutzer anzugeben, die die Anmeldegruppe angeben (die Cloud ist die Azure öffentliche Cloud). Siehe https://aka.ms/msal-net-application-configuration.

public T WithAuthority(Microsoft.Identity.Client.AadAuthorityAudience authorityAudience, bool validateAuthority = true);

member this.WithAuthority : Microsoft.Identity.Client.AadAuthorityAudience * bool -> 'T

Public Function WithAuthority (authorityAudience As AadAuthorityAudience, Optional validateAuthority As Boolean = true) As T

Parameter

authorityAudience: AadAuthorityAudience

Anmeldegruppe (eine AAD-Organisation, Geschäfts-, Schul- und Unikonten oder Geschäfts-, Schul- und Unikonten und Microsoft persönlichen Konten

validateAuthority: Boolean

Gibt an, ob die Autorität anhand der Servermetadaten überprüft werden soll.

Gibt zurück

Der Generator zum Verketten der . Mit Methoden

Gilt für:

WithAuthority(String, Boolean)

Fügt der Anwendung eine bekannte Azure AD-Autorität hinzu, um Sich-Benutzer anzumelden, die den vollständigen Autoritäts-URI angeben. Siehe Anwendungskonfigurationsoptionen.

public T WithAuthority(string authorityUri, bool validateAuthority = true);

member this.WithAuthority : string * bool -> 'T

Public Function WithAuthority (authorityUri As String, Optional validateAuthority As Boolean = true) As T

Parameter

authorityUri: String

URI der Autorität, von der MSAL.NET die Token erhält. Autoritätsendpunkte für die öffentliche Azure Cloud sind:

https://login.microsoftonline.com/tenant/dabei tenant handelt es sich um die Mandanten-ID des Azure AD-Mandanten oder einer Domäne, die diesem Azure AD-Mandanten zugeordnet ist, um nur Benutzer einer bestimmten Organisation anzumelden.
https://login.microsoftonline.com/common/um Benutzer mit Geschäfts-, Schul- und Unikonten oder persönlichen Microsoft-Konten anzumelden
https://login.microsoftonline.com/organizations/ für die Anmeldung von Benutzern mit allen Geschäfts-, Schul- und Unikonten
https://login.microsoftonline.com/consumers/um Benutzer mit nur persönlichen Microsoft-Konten (live) anzumelden

Beachten Sie, dass diese Einstellung mit dem, was im Anwendungsregistrierungsportal deklariert ist, konsistent sein muss.

validateAuthority: Boolean

Gibt an, ob die Autorität anhand der Servermetadaten überprüft werden soll.

Gibt zurück

Der Generator zum Verketten der . Mit Methoden

Ausnahmen

ArgumentNullException

Wird ausgelöst, wenn authorityUri null oder leer ist.

ArgumentException

Wird ausgelöst, wenn authorityUri es nicht gut formatiert ist (z. B. Leerzeichen).

MsalClientException

Wird in allgemeinen Ausnahmeszenarien ausgelöst (z. B. wenn die Anwendung mit mehreren verschiedenen Autoritätshosts konfiguriert wurde).

Gilt für:

WithAuthority(Uri, Boolean)

Fügt der Anwendung eine bekannte Autorität hinzu. Siehe Anwendungskonfigurationsoptionen. Dieser Konstruktor wird hauptsächlich für Szenarien verwendet, in denen die Autorität keine Standard-Azure AD-Autorität oder eine ADFS-Autorität oder eine Azure AD B2C-Autorität ist. Für Azure AD, auch in souveränen Clouds, bevorzugen Sie die Verwendung anderer Außerkraftsetzungen wie z. B.WithAuthority(AzureCloudInstance, AadAuthorityAudience, Boolean)

public T WithAuthority(Uri authorityUri, bool validateAuthority = true);

member this.WithAuthority : Uri * bool -> 'T

Public Function WithAuthority (authorityUri As Uri, Optional validateAuthority As Boolean = true) As T

Parameter

authorityUri: Uri

URI der Autorität

validateAuthority: Boolean

Gibt an, ob die Autorität anhand der Servermetadaten überprüft werden soll.

Gibt zurück

Der Generator zum Verketten der . Mit Methoden

Ausnahmen

ArgumentNullException

Wird ausgelöst, wenn authorityUri null ist.

ArgumentException

Wird ausgelöst, wenn authorityUri es nicht gut formatiert ist (z. B. Leerzeichen).

MsalClientException

Wird in allgemeinen Ausnahmeszenarien ausgelöst (z. B. wenn die Anwendung mit mehreren verschiedenen Autoritätshosts konfiguriert wurde).

Gilt für:

WithAuthority(AzureCloudInstance, AadAuthorityAudience, Boolean)

Fügt der Anwendung eine bekannte Azure AD-Autorität hinzu, um Anmeldebenutzern die Cloudinstanz und die Anmeldegruppe anzugeben. Siehe https://aka.ms/msal-net-application-configuration.

public T WithAuthority(Microsoft.Identity.Client.AzureCloudInstance azureCloudInstance, Microsoft.Identity.Client.AadAuthorityAudience authorityAudience, bool validateAuthority = true);

member this.WithAuthority : Microsoft.Identity.Client.AzureCloudInstance * Microsoft.Identity.Client.AadAuthorityAudience * bool -> 'T

Public Function WithAuthority (azureCloudInstance As AzureCloudInstance, authorityAudience As AadAuthorityAudience, Optional validateAuthority As Boolean = true) As T

Parameter

azureCloudInstance: AzureCloudInstance

Instanz von Azure Cloud (z. B. Azure weltweite Cloud, Azure deutsche Cloud, US-Regierung ...)

authorityAudience: AadAuthorityAudience

Anmeldegruppe (eine AAD-Organisation, Geschäfts-, Schul- und Unikonten oder Geschäfts-, Schul- und Unikonten und Microsoft persönlichen Konten

validateAuthority: Boolean

Gibt an, ob die Autorität anhand der Servermetadaten überprüft werden soll.

Gibt zurück

Der Generator zum Verketten der . Mit Methoden

Gilt für:

WithAuthority(AzureCloudInstance, Guid, Boolean)

Fügt der Anwendung eine bekannte Azure AD-Autorität hinzu, um Benutzer aus einer einzelnen Organisation (Einzelmandantenanwendung) anzumelden, die von ihrer Cloudinstanz und ihrer Mandanten-ID beschrieben wird. Siehe https://aka.ms/msal-net-application-configuration.

public T WithAuthority(Microsoft.Identity.Client.AzureCloudInstance azureCloudInstance, Guid tenantId, bool validateAuthority = true);

member this.WithAuthority : Microsoft.Identity.Client.AzureCloudInstance * Guid * bool -> 'T

Public Function WithAuthority (azureCloudInstance As AzureCloudInstance, tenantId As Guid, Optional validateAuthority As Boolean = true) As T

Parameter

azureCloudInstance: AzureCloudInstance

Instanz Azure Cloud (z. B. Azure öffentliche Cloud, Azure China oder Azure Government).

tenantId: Guid

Mandanten-ID des Mandanten, von dem benutzer angemeldet werden sollen

validateAuthority: Boolean

Gibt an, ob die Autorität anhand der Servermetadaten überprüft werden soll.

Gibt zurück

Der Generator zum Verketten der . Mit Methoden

Gilt für:

WithAuthority(AzureCloudInstance, String, Boolean)

Fügt der Anwendung eine bekannte Azure AD-Autorität hinzu, um Benutzer aus einer einzigen Organisation (Einzelmandantenanwendung) anzumelden, die von der Cloudinstanz und dem Domänennamen oder der Mandanten-ID beschrieben wird. Siehe https://aka.ms/msal-net-application-configuration.

public T WithAuthority(Microsoft.Identity.Client.AzureCloudInstance azureCloudInstance, string tenant, bool validateAuthority = true);

member this.WithAuthority : Microsoft.Identity.Client.AzureCloudInstance * string * bool -> 'T

Public Function WithAuthority (azureCloudInstance As AzureCloudInstance, tenant As String, Optional validateAuthority As Boolean = true) As T

Parameter

azureCloudInstance: AzureCloudInstance

Instanz Azure Cloud (z. B. Azure öffentliche Cloud, Azure China oder Azure Government).

tenant: String

Domänenname, der dem Azure AD-Mandanten zugeordnet ist, von dem aus Benutzer angemeldet werden sollen. Dies kann auch eine GUID sein.

validateAuthority: Boolean

Gibt an, ob die Autorität anhand der Servermetadaten überprüft werden soll.

Gibt zurück

Der Generator zum Verketten der . Mit Methoden.

Ausnahmen

ArgumentNullException

Wird ausgelöst, wenn tenant null oder tenant leer ist.

Gilt für:

WithAuthority(String, Guid, Boolean)

Fügt der Anwendung eine bekannte Azure AD-Autorität hinzu, um Benutzer aus einer einzigen Organisation (Einzelmandantenanwendung) anzumelden, die durch ihre Mandanten-ID angegeben wird. Siehe Anwendungskonfigurationsoptionen.

public T WithAuthority(string cloudInstanceUri, Guid tenantId, bool validateAuthority = true);

member this.WithAuthority : string * Guid * bool -> 'T

Public Function WithAuthority (cloudInstanceUri As String, tenantId As Guid, Optional validateAuthority As Boolean = true) As T

Parameter

cloudInstanceUri: String

Azure Cloudinstanz.

tenantId: Guid

GUID des Mandanten, von dem Benutzer angemeldet werden sollen.

validateAuthority: Boolean

Gibt an, ob die Autorität anhand der Servermetadaten überprüft werden soll.

Gibt zurück

Der Generator zum Verketten der . Mit Methoden.

Ausnahmen

ArgumentNullException

Wird ausgelöst, wenn cloudInstanceUri null oder leer ist.

ArgumentException

Wird ausgelöst, wenn cloudInstanceUri es nicht gut formatiert ist (z. B. Leerzeichen).

MsalClientException

Wird in allgemeineren Ausnahmeszenarien ausgelöst (z. B. wenn die Anwendung mit mehreren verschiedenen Autoritätshosts konfiguriert wurde).

Gilt für:

WithAuthority(String, String, Boolean)

Fügt der Anwendung eine bekannte Azure AD-Autorität hinzu, um Benutzer aus einer einzigen Organisation (Einzelmandantenanwendung) anzumelden, die durch ihren Domänennamen beschrieben wird. Siehe https://aka.ms/msal-net-application-configuration.

public T WithAuthority(string cloudInstanceUri, string tenant, bool validateAuthority = true);

member this.WithAuthority : string * string * bool -> 'T

Public Function WithAuthority (cloudInstanceUri As String, tenant As String, Optional validateAuthority As Boolean = true) As T

Parameter

cloudInstanceUri: String

URI für die Azure Cloudinstanz (z. B.https://login.microsoftonline.com)

tenant: String

Domänenname, der dem Mandanten zugeordnet ist, von dem benutzer angemeldet werden sollen

validateAuthority: Boolean

Gibt an, ob die Autorität anhand der Servermetadaten überprüft werden soll.

Gibt zurück

Der Generator zum Verketten der . Mit Methoden

Ausnahmen

ArgumentNullException

Wird ausgelöst, wenn cloudInstanceUri null oder tenant leer ist.

ArgumentException

Wird ausgelöst, wenn cloudInstanceUri oder tenant nicht gut formatiert ist (z. B. Leerzeichen).

MsalClientException

Wird in allgemeineren Ausnahmeszenarien ausgelöst (z. B. wenn die Anwendung mit mehreren verschiedenen Autoritätshosts konfiguriert wurde).

Hinweise

tenant kann auch die Zeichenfolgendarstellung einer GUID (tenantId) oder sogar commonenthalten, organizations oder consumers in diesem Fall wird empfohlen, eine andere Außerkraftsetzung zu verwenden (WithAuthority(AzureCloudInstance, Guid, Boolean) und WithAuthority(AzureCloudInstance, AadAuthorityAudience, Boolean)

Gilt für:

Feedback

War diese Seite hilfreich?