Język

MicrosoftIdentityMessageHandlerOptions Klasa

Definicja

Przestrzeń nazw:
Microsoft.Identity.Web
Zestaw:
Microsoft.Identity.Web.TokenAcquisition.dll
Pakiet:
Microsoft.Identity.Web.TokenAcquisition v4.16.1

Opcje MicrosoftIdentityMessageHandler konfiguracji uwierzytelniania. Dziedziczy z AuthorizationHeaderProviderOptions , aby włączyć zgodność z istniejącymi metodami rozszerzenia, takimi jak WithAgentIdentity() i WithUserAgentIdentity().

public class MicrosoftIdentityMessageHandlerOptions : Microsoft.Identity.Abstractions.AuthorizationHeaderProviderOptions
type MicrosoftIdentityMessageHandlerOptions = class
    inherit AuthorizationHeaderProviderOptions
Public Class MicrosoftIdentityMessageHandlerOptions
Inherits AuthorizationHeaderProviderOptions
Dziedziczenie
Object
AuthorizationHeaderProviderOptions
MicrosoftIdentityMessageHandlerOptions

Przykłady

Podstawowe użycie z zakresami:

var options = new MicrosoftIdentityMessageHandlerOptions
{
    Scopes = { "https://graph.microsoft.com/.default" }
};

Użycie przy użyciu metod rozszerzeń:

var options = new MicrosoftIdentityMessageHandlerOptions
{
    Scopes = { "api://myapi/.default" }
};
options.WithAgentIdentity("agent-guid");

Konstruktory

Nazwisko Opis
MicrosoftIdentityMessageHandlerOptions()

Inicjuje nowe wystąpienie klasy MicrosoftIdentityMessageHandlerOptions.
MicrosoftIdentityMessageHandlerOptions(MicrosoftIdentityMessageHandlerOptions)

Inicjuje nowe wystąpienie MicrosoftIdentityMessageHandlerOptions klasy, kopiując wartości z istniejącego wystąpienia.

Właściwości

Nazwisko Opis
AcquireTokenOptions

Opcje związane z pozyskiwaniem tokenu.

(Odziedziczone po AuthorizationHeaderProviderOptions)
BaseUrl

Podstawowy adres URL dla wywoływanego podrzędnego internetowego interfejsu API. Na przykład "https://graph.microsoft.com/beta/".

(Odziedziczone po AuthorizationHeaderProviderOptions)
CustomizeHttpRequestMessage

Zapewnia możliwość dostosowania funkcji HttpRequestMessage przez aplikację wywołującą. Aby na przykład dostosować nagłówki. Jest to wywoływane po utworzeniu komunikatu, w tym nagłówek autoryzacji i tuż przed wysłaniem wiadomości.

(Odziedziczone po AuthorizationHeaderProviderOptions)
HttpMethod

Metoda HTTP używana do wywoływania tego podrzędnego internetowego interfejsu API (domyślnie Pobierz).

(Odziedziczone po AuthorizationHeaderProviderOptions)
OnAfterAuthHeaderCreation

Zapewnia możliwość dostosowania HttpRequestMessage aplikacji wywołującej po ustawieniu nagłówka autoryzacji (w tym Authorization nagłówka) i tuż przed wysłaniem komunikatu — punkt, w którym można odczytać lub dostosować sfinalizowane żądanie. Podana na potrzeby nazewnictwa symetrii OnBeforeAuthHeaderCreationza pomocą parametru ; udostępnia ten czas ze wstępnie istniejącym CustomizeHttpRequestMessageelementem , który nadal jest wywoływany w celu zapewnienia zgodności z poprzednimi wersjami. Gdy oba są ustawione, są uruchamiane w tym samym momencie, więc osoby wywołujące nie powinny zależeć od ich względnej kolejności. W tym miejscu nie należy modyfikować materiału powiązanego za pomocą protokołu wiązania żądań (SHRq//hb), ponieważ jest on uruchamiany po podpisaniu; użyj OnBeforeAuthHeaderCreation go do tego.

(Odziedziczone po AuthorizationHeaderProviderOptions)
OnBeforeAuthHeaderCreation

Zapewnia możliwość dostosowania HttpRequestMessage aplikacji wywołującej przed utworzeniem nagłówka autoryzacji. W tym momencie nagłówek Authorization nie jest jeszcze obecny. Służy do kształtowania żądania, które podpisuje protokół powiązania żądania — na przykład SignedHttpRequest (SHR), który wiąże zapytanie, nagłówki lub treść (q//hboświadczenia) z tokenem — więc podpis obejmuje sfinalizowane żądanie. Aby obserwować lub dostosowywać żądanie po utworzeniu nagłówka, użyj polecenia OnAfterAuthHeaderCreation (lub CustomizeHttpRequestMessage).

(Odziedziczone po AuthorizationHeaderProviderOptions)
ProtocolScheme

Nazwa schematu protokołu użytego do utworzenia nagłówka autoryzacji. Domyślnie: "Bearer".

(Odziedziczone po AuthorizationHeaderProviderOptions)
RelativePath

Ścieżka względem BaseUrl wartości (na przykład "me").

(Odziedziczone po AuthorizationHeaderProviderOptions)
RequestAppToken

Opisuje, czy interfejs API podrzędnego jest wywoływany w imieniu samej usługi wywołującej (token aplikacji) lub w imieniu użytkownika przetworzonego przez usługę (token użytkownika). Jeśli truetoken jest żądany w imieniu aplikacji. W przeciwnym razie jest on w imieniu użytkownika.

(Odziedziczone po AuthorizationHeaderProviderOptions)
Scopes

Pobiera lub ustawia zakresy na żądanie tokenu.

Metody

Nazwisko Opis
Clone()

Sklonuj opcje (aby móc je zastąpić).

(Odziedziczone po AuthorizationHeaderProviderOptions)
CloneInternal()

Sklonuj opcje (aby móc je zastąpić).

(Odziedziczone po AuthorizationHeaderProviderOptions)
GetApiUrl()

Zwróć adres URL podrzędnego internetowego interfejsu API.

(Odziedziczone po AuthorizationHeaderProviderOptions)

Dotyczy

Zobacz też