Sprache

MicrosoftIdentityOptions Klasse

Definition

Optionen zum Konfigurieren der Authentifizierung mithilfe von Azure Active Directory. Es verfügt sowohl über AAD- als auch über B2C-Konfigurationsattribute.

public class MicrosoftIdentityOptions : Microsoft.AspNetCore.Authentication.OpenIdConnect.OpenIdConnectOptions
type MicrosoftIdentityOptions = class
    inherit OpenIdConnectOptions
Public Class MicrosoftIdentityOptions
Inherits OpenIdConnectOptions
Vererbung
MicrosoftIdentityOptions

Konstruktoren

Name Beschreibung
MicrosoftIdentityOptions()

Optionen zum Konfigurieren der Authentifizierung mithilfe von Azure Active Directory. Es verfügt sowohl über AAD- als auch über B2C-Konfigurationsattribute.

Eigenschaften

Name Beschreibung
AllowWebApiToBeAuthorizedByACL

Daemonanwendungen können ein Token basierend auf Rollen überprüfen oder das ACL-basierte Autorisierungsmuster verwenden, um Token ohne Rollenanspruch zu steuern. Wenn Sie ACL-basierte Autorisierung verwenden, wird Microsoft Identity Web nicht ausgelöst, wenn Rollen oder Bereiche nicht in den Ansprüchen enthalten sind. Weitere Informationen finden Sie unter https://aka.ms/ms-identity-web/daemon-ACL.

ClientCertificates

Beschreibung der Zertifikate, die verwendet werden, um die Identität der Web-App oder Web-API zu beweisen.

ClientCredentials

Optionen zum Konfigurieren der Authentifizierung mithilfe von Azure Active Directory. Es verfügt sowohl über AAD- als auch über B2C-Konfigurationsattribute.

ClientCredentialsUsingManagedIdentity

Optionen zum Konfigurieren von Zertifikaten ohne Zertifikat

DefaultUserFlow

Ruft den Standardbenutzerfluss (signUpSignIn) ab.

Domain

Ruft die Domäne des Azure Active Directory Mandanten ab, z. B. contoso.onmicrosoft.com.

EditProfilePolicyId

Dient zum Abrufen oder Festlegen des Bearbeitungsprofilbenutzerflussnamens für B2C, z. B. b2c_1_edit_profile.

ErrorPath

Legt den Pfad der Fehlerroute fest. Der Standardwert ist der Wert "/MicrosoftIdentity/Account/Error", der von Microsoft verwendet wird. Identity.Web.UI.

ExtraQueryParameters

Legt Abfrageparameter für die Abfragezeichenfolge in der HTTP-Anforderung auf den IdP fest.

Instance

Dient zum Abrufen oder Festlegen der Azure Active Directory Instanz, z. B. "https://login.microsoftonline.com".

LegacyCacheCompatibilityEnabled

Aktiviert die ADAL-Cache-Serialisierung und Deserialisierung. Leistungsverbesserungen beim Arbeiten mit nur MSAL-Apps. Auf "true" festgelegt, wenn Sie über einen freigegebenen Cache für ADAL-Apps verfügen.

PartitionAppTokenCacheByAudience

Bei Festlegung auf true, wird der Anwendungstokencache (Clientanmeldeinformationen, d. h. AcquireTokenForClient) von der Zielgruppe (Ressource) des angeforderten Tokens partitioniert.

Anwendungen, die App-Token für viele Ressourcen mit demselben Client und Mandanten abrufen, sammeln andernfalls alle diese Token in einer einzelnen Cachepartition, wodurch Cache-Nachschlagevorgänge O(n) in der Anzahl der Ressourcen erstellt werden. Wenn Sie dies aktivieren, wird die Ressource (abgeleitet vom angeforderten <resource>/.default Bereich) als nicht protokollbezogene Cacheschlüsselkomponente hinzugefügt, sodass jede Ressource eine eigene Partition abruft und Cachelesevorgänge O(1) beibehalten.

Wird standardmäßig auf false festgelegt. Dies kann über die Konfiguration festgelegt werden, z. B. "AzureAd": { "PartitionAppTokenCacheByAudience": true }.

ResetPasswordPath

Legt den Pfad der ResetPassword-Route fest. Standardmäßig ist /MicrosoftIdentity/Account/ResetPassword der Wert, der von Microsoft verwendet wird. Identity.Web.UI.

ResetPasswordPolicyId

Dient zum Abrufen oder Festlegen des Kennwort-Benutzerflussnamens für B2C, z. B. B2C_1_password_reset.

SendX5C

Gibt an, ob der x5c-Anspruch (öffentlicher Schlüssel des Zertifikats) an den STS gesendet werden soll. Durch das Senden von x5c können Anwendungsentwickler einen einfachen Zertifikatrollover in Azure AD erzielen: Mit dieser Methode wird das öffentliche Zertifikat zusammen mit der Tokenanforderung an Azure AD gesendet, sodass Azure AD diesen verwenden kann, um den Antragstellernamen basierend auf einer Richtlinie für vertrauenswürdige Aussteller zu überprüfen. Dadurch wird der Anwendungsadministrator vor der expliziten Verwaltung des Zertifikatrollovers (entweder über das Portal oder über den PowerShell/CLI-Vorgang) gespeichert. Weitere Informationen finden Sie unter https://aka.ms/msal-net-sni.

SignUpSignInPolicyId

Dient zum Abrufen oder Festlegen des Registrierungs- oder Anmeldebenutzerflussnamens für B2C, z. B. b2c_1_susi.

TenantId

Ruft die Mandanten-ID ab oder legt sie fest.

TokenDecryptionCertificates

Beschreibung der Zertifikate, die zum Entschlüsseln eines verschlüsselten Tokens in einer Web-API verwendet werden.

TokenDecryptionCredentials

Optionen zum Konfigurieren der Authentifizierung mithilfe von Azure Active Directory. Es verfügt sowohl über AAD- als auch über B2C-Konfigurationsattribute.

UseFastUnboundedCache

Wenn dieser Wert auf true festgelegt ist, verwendet der Cache im Speichertoken den internen freigegebenen (statischen) Cache von MSAL anstelle des IMemoryCache Serialisierungsanbieters.

Standardwert ist false (empfohlen). Wenn falseToken über den In-Memory-Serialisierungsanbieter gespeichert werden, berücksichtigt der Cache den Ablauf pro Eintrag, die Speichercachegrößenbeschränkung und die Cacheschlüsselpartitionierung.

true Für den schnellen, prozessweiten statischen Cache festgelegt. Sie vermeidet die Serialisierung pro Anforderung, ist aber ungebunden (keine Eviction von abgelaufenen Token) und ignoriert die Ablauf-/Größenoptionen und den Partitionierungs-Hook. Dies kann über die Konfiguration (z. B. "AzureAd": { "UseFastUnboundedCache": true }) festgelegt werden.

UserAssignedManagedIdentityClientId

Wird verwendet, wenn sie für Azure bereitgestellt wird, um explizit eine vom Benutzer zugewiesene verwaltete Identität anzugeben. Siehe https://learn.microsoft.com/azure/active-directory/managed-identities-azure-resources/how-to-manage-ua-identity-portal.

WithSpaAuthCode

Fordert einen Authentifizierungscode für das Frontend an (spa using MSAL.js for instance). Weitere Informationen finden Sie unter https://aka.ms/msal-net/spa-auth-code.

Gilt für: