WSFederationAuthenticationModule.RedirectToIdentityProvider Metoda

Definice

Obor názvů:

System.IdentityModel.Services

Sestavení:

System.IdentityModel.Services.dll

Přesměruje uživatele na službu tokenů zabezpečení (STS) určenou Issuer vlastností k získání tokenu zabezpečení pomocí protokolu WS-Federation.

public:
 virtual void RedirectToIdentityProvider(System::String ^ uniqueId, System::String ^ returnUrl, bool persist);

public virtual void RedirectToIdentityProvider (string uniqueId, string returnUrl, bool persist);

abstract member RedirectToIdentityProvider : string * string * bool -> unit
override this.RedirectToIdentityProvider : string * string * bool -> unit

Public Overridable Sub RedirectToIdentityProvider (uniqueId As String, returnUrl As String, persist As Boolean)

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ý. Další informace najdete v CreateSignInRequest(String, String, Boolean) metodě.

returnUrl

String

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

persist

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.

Výjimky

InvalidOperationException

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

-nebo-

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

-nebo-

Vlastnost Current je nebo je null prázdná.

-nebo-

Vlastnost Response kontextu vrácená uživatelem Current je null nebo je prázdná.

Poznámky

Metoda RedirectToIdentityProvider je volána z SignIn metody, když je požadavek vystaven z webové stránky prezentované předávající stranou (RP) nebo z OnEndRequest delegáta obslužné rutiny události provést pasivní přesměrování na zprostředkovatele identity při selhání autorizace.

Parametry předané metodě se používají k vytvoření parametru zprávy wctx. Jediným významným parametrem returnUrl je parametr . Určuje adresu URL, na kterou by měl poskytovatel prostředků směrovat prohlížeč po úspěšném ověření. 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ěď.

Metoda provede následující:

1. Vyvolá metodu VerifyProperties , aby se zajistilo, že modul může vydat platnou žádost o přihlášení.

2. Vyvolá metodu CreateSignInRequest pro vytvoření žádosti o přihlášení z vlastností nakonfigurovaných v modulu.

3. Vyvolá metodu OnRedirectingToIdentityProvider pro vyvolání RedirectingToIdentityProvider události. Můžete zrušit přesměrování nebo upravit zprávu žádosti o přihlášení v obslužné rutině události pro tuto událost.