WSFederationAuthenticationModule.RedirectToIdentityProvider Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt de gebruiker omgeleid naar de beveiligingstokenservice (STS) die is opgegeven door de Issuer eigenschap om een beveiligingstoken te verkrijgen met behulp van het WS-Federation-protocol.
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 -> unitPublic Overridable Sub RedirectToIdentityProvider (uniqueId As String, returnUrl As String, persist As Boolean)Parameters
- uniqueId
- String
De WSFAM slaat deze waarde op in de wctx-parameter in de WS-Federation aanmeldingsaanvraag; De module gebruikt deze echter niet bij het verwerken van aanmeldingsaanvragen of aanmeldingsreacties. U kunt deze instellen op elke waarde. Het hoeft niet uniek te zijn. Zie de CreateSignInRequest(String, String, Boolean) methode voor meer informatie.
- returnUrl
- String
De URL waarnaar de module moet worden geretourneerd bij verificatie.
- persist
- Boolean
De WSFAM slaat deze waarde op in de wctx-parameter in de WS-Federation aanmeldingsaanvraag; De module gebruikt deze echter niet bij het verwerken van aanmeldingsaanvragen of aanmeldingsreacties. U kunt deze true instellen of false.
Uitzonderingen
Issuer is null of een lege tekenreeks.
– of –
Realm is null of een lege tekenreeks.
– of –
De Current eigenschap is null of leeg.
– of –
De Response eigenschap van de context die wordt geretourneerd door Current is null of leeg.
Opmerkingen
De RedirectToIdentityProvider methode wordt aangeroepen vanuit de SignIn methode wanneer de aanvraag wordt uitgegeven vanaf een webpagina die wordt gepresenteerd door de relying party (RP) of van de gemachtigde van de OnEndRequest gebeurtenis-handler om een passieve omleiding naar de id-provider uit te voeren bij autorisatiefout.
De parameters die aan de methode worden doorgegeven, worden gebruikt om de wctx-berichtparameter te maken. De enige significante parameter is de returnUrl parameter. Hiermee geeft u de URL op dat de RP de browser moet doorsturen naar de volgende geslaagde verificatie. Het moet niet worden verward met de wreply message-parameter, die wordt opgegeven door de Reply eigenschap en die het adres opgeeft aan de RP waarnaar de beveiligingstokenservice (STS) de reactie moet leiden.
De methode voert het volgende uit:
Roept de VerifyProperties methode aan om ervoor te zorgen dat een geldige aanmeldingsaanvraag kan worden uitgegeven door de module.
Roept de CreateSignInRequest methode aan om de aanmeldingsaanvraag te maken op basis van de eigenschappen die in de module zijn geconfigureerd.
Roept de OnRedirectingToIdentityProvider methode aan om de RedirectingToIdentityProvider gebeurtenis te genereren. U kunt de omleiding annuleren of het aanmeldingsaanvraagbericht wijzigen in de gebeurtenis-handler voor deze gebeurtenis.