Share via

WSFederationAuthenticationModule.CreateSignInRequest Metoda

  • Reference

Definice

Obor názvů:
System.IdentityModel.Services
Sestavení:
System.IdentityModel.Services.dll

Vytvoří zprávu žádosti o přihlášení WS-Federation pomocí parametrů WS-Federation nakonfigurovaných v modulu.

public:
 System::IdentityModel::Services::SignInRequestMessage ^ CreateSignInRequest(System::String ^ uniqueId, System::String ^ returnUrl, bool rememberMeSet);
public System.IdentityModel.Services.SignInRequestMessage CreateSignInRequest (string uniqueId, string returnUrl, bool rememberMeSet);
member this.CreateSignInRequest : string * string * bool -> System.IdentityModel.Services.SignInRequestMessage
Public Function CreateSignInRequest (uniqueId As String, returnUrl As String, rememberMeSet As Boolean) As SignInRequestMessage

Parametry

uniqueId
String

WSFAM uloží tuto hodnotu v parametru wctx v žádosti o přihlášení WS-Federation; modul ho však nepoužívá při zpracování žádostí o přihlášení nebo odpovědí na přihlášení. Můžete ho nastavit na libovolnou hodnotu. Nemusí být jedinečný.

returnUrl
String

Adresa URL, na kterou se má modul vrátit po ověření.

rememberMeSet
Boolean

WSFAM uloží tuto hodnotu v parametru wctx v žádosti o přihlášení WS-Federation; modul ho však nepoužívá při zpracování žádostí o přihlášení nebo odpovědí na přihlášení. Můžete ho nastavit nebo truefalse.

Návraty

SignInRequestMessage

Zpráva WS-Federation žádosti o přihlášení.

Výjimky

InvalidOperationException

Vlastnost Issuer je null nebo prázdný řetězec.

-nebo-

Vlastnost Realm je null nebo prázdný řetězec.

Poznámky

Vytvoří WS-Federation žádost o přihlášení, která je reprezentována objektem SignInRequestMessage . Vlastnosti nového SignInRequestMessage objektu jsou nastaveny takto:

  • Vlastnost Context (parametr wctx) je nastavena na hodnotu vytvořenou pomocí parametrů metody.

  • Vlastnost CurrentTime (parametr wct) je nastavená na aktuální čas.

  • Všechny ostatní vlastnosti jsou nastaveny pomocí ekvivalentních vlastností aktuální instance.

Parametry předané metodě se používají k vytvoření parametru zprávy wctx. Jedná se o řetězec v následujícím formátu: ru=returnUrl&cx=SignInContext&rm=rememberMeSet&id=uniqueId.

  • Hodnota ru je nastavená na hodnotu parametru returnUrl předaného metodě a určuje adresu URL, na kterou by měl modul směrovat prohlížeč po úspěšném ověření. Toto je jediná hodnota uložená v řetězci wctx, kterou používá WSFAM. Modul volá metodu GetReturnUrlFromResponse extrahování této hodnoty z parametru wctx při zpracování WS-Federation přihlašovací odpovědi. Neměl by být zaměňován s parametrem wreply message, který je určen Reply vlastností a který poskytuje adresu na straně poskytovatele prostředků, na kterou by měla služba tokenů zabezpečení směrovat svou odpověď.

  • Parametr cx je nastaven na hodnotu SignInContext vlastnosti. Tato vlastnost je zpřístupněna, abyste mohli nastavit libovolný kontext definovaný aplikací, který by měl být uložen v řetězci wctx; WSFAM však nezpřístupňuje metodu pro extrahování této hodnoty v odpovědi. Pokud vaše aplikace tuto hodnotu potřebuje, musíte zadat kód pro analýzu řetězce wctx a přečíst tuto hodnotu při zpracování odpovědi. Toho můžete dosáhnout přepsáním GetReturnUrlFromResponse metody.

  • rm WSFAM nepoužívá hodnotu, která je nastavená na hodnotu rememberMeSet parametruid, ani parametr, který je nastaven na hodnotu parametruuniqueId. Můžete je nastavit na libovolnou hodnotu.

Metoda CreateSignInRequest je volána z RedirectToIdentityProvider metody.

Platí pro

Viz také