HttpRequestMessageAuthenticationExtensions Klasse

Definition

Erweiterungsmethoden zum HttpRequestMessage Konfigurieren der Authentifizierungsoptionen pro Anforderung bei Verwendung MicrosoftIdentityMessageHandler.

public static class HttpRequestMessageAuthenticationExtensions
type HttpRequestMessageAuthenticationExtensions = class
Public Module HttpRequestMessageAuthenticationExtensions
Vererbung
HttpRequestMessageAuthenticationExtensions

Beispiele

Festlegen von Authentifizierungsoptionen mit einem Objekt:

var request = new HttpRequestMessage(HttpMethod.Get, "/api/data")
    .WithAuthenticationOptions(new MicrosoftIdentityMessageHandlerOptions
    {
        Scopes = { "custom.scope" }
    });

Konfigurieren von Authentifizierungsoptionen mit einer Stellvertretung:

var request = new HttpRequestMessage(HttpMethod.Get, "/api/data")
    .WithAuthenticationOptions(options =>
    {
        options.Scopes.Add("https://graph.microsoft.com/.default");
        options.WithAgentIdentity("agent-guid");
        options.RequestAppToken = true;
    });

Hinweise

Diese Erweiterungsmethoden ermöglichen eine flexible Konfiguration für die Authentifizierung pro Anforderung, die die im Nachrichtenhandler konfigurierten Standardoptionen außer Kraft setzen oder ergänzen kann. Die Methoden unterstützen sowohl moderne .NET (mithilfe von HttpRequestMessage.Options) als auch ältere Frameworks (mit HttpRequestMessage.Properties).

Methoden

Name Beschreibung
GetAuthenticationOptions(HttpRequestMessage)

Ruft die Authentifizierungsoptionen ab, die für die HTTP-Anforderung festgelegt wurden.

WithAuthenticationOptions(HttpRequestMessage, Action<MicrosoftIdentityMessageHandlerOptions>)

Konfiguriert Authentifizierungsoptionen für die HTTP-Anforderung mithilfe eines Delegaten.

WithAuthenticationOptions(HttpRequestMessage, MicrosoftIdentityMessageHandlerOptions)

Legt Authentifizierungsoptionen für die HTTP-Anforderung fest.

Gilt für: