MicrosoftIdentityMessageHandler Konstruktoren

public MicrosoftIdentityMessageHandler(Microsoft.Identity.Abstractions.IAuthorizationHeaderProvider headerProvider, Microsoft.Identity.Web.MicrosoftIdentityMessageHandlerOptions? defaultOptions = default, Microsoft.Extensions.Logging.ILogger<Microsoft.Identity.Web.MicrosoftIdentityMessageHandler>? logger = default);

new Microsoft.Identity.Web.MicrosoftIdentityMessageHandler : Microsoft.Identity.Abstractions.IAuthorizationHeaderProvider * Microsoft.Identity.Web.MicrosoftIdentityMessageHandlerOptions * Microsoft.Extensions.Logging.ILogger<Microsoft.Identity.Web.MicrosoftIdentityMessageHandler> -> Microsoft.Identity.Web.MicrosoftIdentityMessageHandler

Public Sub New (headerProvider As IAuthorizationHeaderProvider, Optional defaultOptions As MicrosoftIdentityMessageHandlerOptions = Nothing, Optional logger As ILogger(Of MicrosoftIdentityMessageHandler) = Nothing)

Parameter

Ausnahmen

Beispiele

Grundlegende Verwendung mit Standardoptionen:

var handler = new MicrosoftIdentityMessageHandler(
    headerProvider,
    new MicrosoftIdentityMessageHandlerOptions
    {
        Scopes = { "https://api.example.com/.default" }
    });

Verwendung ohne Standardoptionen (pro Anforderungskonfiguration erforderlich):

var handler = new MicrosoftIdentityMessageHandler(headerProvider);

// Each request must specify options
var request = new HttpRequestMessage(HttpMethod.Get, "/api/data")
    .WithAuthenticationOptions(options =>
        options.Scopes.Add("custom.scope"));

Verwendung mit Protokollierung:

var logger = serviceProvider.GetService<ILogger<MicrosoftIdentityMessageHandler>>();
var handler = new MicrosoftIdentityMessageHandler(headerProvider, defaultOptions, logger);

Hinweise

Der defaultOptions Parameter bietet eine bequeme Möglichkeit zum Festlegen von Authentifizierungsoptionen, die für alle Anforderungen gelten, die über diese Handlerinstanz ausgeführt werden. Einzelne Anforderungen können diese Standardwerte weiterhin mithilfe der Erweiterungsmethoden überschreiben.

Wenn logger dieser bereitgestellt wird, protokolliert der Handler auf verschiedenen Ebenen:

• Debuggen: Erfolgreiche Autorisierungsheaderzufügung
• Informationen: WWW-Authenticate Erkennung und Behandlung von Herausforderungen
• Warnung: Problembehandlungsfehler
• Fehler: Tokenerwerbsfehler

public MicrosoftIdentityMessageHandler(Microsoft.Identity.Abstractions.IAuthorizationHeaderProvider headerProvider, Microsoft.Identity.Web.MicrosoftIdentityMessageHandlerOptions? defaultOptions, Microsoft.Identity.Client.IMsalMtlsHttpClientFactory? mtlsHttpClientFactory, Microsoft.Extensions.Logging.ILogger<Microsoft.Identity.Web.MicrosoftIdentityMessageHandler>? logger = default);

new Microsoft.Identity.Web.MicrosoftIdentityMessageHandler : Microsoft.Identity.Abstractions.IAuthorizationHeaderProvider * Microsoft.Identity.Web.MicrosoftIdentityMessageHandlerOptions * Microsoft.Identity.Client.IMsalMtlsHttpClientFactory * Microsoft.Extensions.Logging.ILogger<Microsoft.Identity.Web.MicrosoftIdentityMessageHandler> -> Microsoft.Identity.Web.MicrosoftIdentityMessageHandler

Public Sub New (headerProvider As IAuthorizationHeaderProvider, defaultOptions As MicrosoftIdentityMessageHandlerOptions, mtlsHttpClientFactory As IMsalMtlsHttpClientFactory, Optional logger As ILogger(Of MicrosoftIdentityMessageHandler) = Nothing)

Parameter

Ausnahmen

Hinweise

mTLS PoP (Mutual TLS Proof-of-Possession)-Tokenbindung, wie in RFC 8705 beschrieben, bindet kryptografisch Zugriffstoken an ein bestimmtes X.509-Zertifikat. Wenn diese Option aktiviert ist, erhält der Handler ein gebundenes Token mit dem Zertifikatfingerabdruck im cnf Anspruch, erstellt einen MTLS-HTTP-Client mit dem Bindungszertifikat und sendet Anforderungen über den mTLS-Kanal.

Tokenbindung unterstützt derzeit nur Anwendungstoken (nur App-Token). Setze RequestAppToken auf true.

Verwenden Sie lieber die MicrosoftIdentityHttpClientBuilderExtensions Erweiterungsmethoden, um diesen Handler durch Abhängigkeitsinjektion zu konfigurieren, anstatt ihn direkt zu instanziieren.