WSFederationAuthenticationModule.RedirectToIdentityProvider Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Omdirigerar användaren till den säkerhetstokentjänst (STS) som anges av Issuer egenskapen för att hämta en säkerhetstoken med hjälp av protokollet 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 -> unitPublic Overridable Sub RedirectToIdentityProvider (uniqueId As String, returnUrl As String, persist As Boolean)Parametrar
- uniqueId
- String
WSFAM sparar det här värdet i wctx-parametern i WS-Federation inloggningsbegäran. Modulen använder den dock inte när du bearbetar inloggningsbegäranden eller inloggningssvar. Du kan ange det till valfritt värde. Det behöver inte vara unikt. Mer information finns i CreateSignInRequest(String, String, Boolean)-metoden.
- returnUrl
- String
Den URL som modulen ska returneras till vid autentisering.
- persist
- Boolean
WSFAM sparar det här värdet i wctx-parametern i WS-Federation inloggningsbegäran. Modulen använder den dock inte när du bearbetar inloggningsbegäranden eller inloggningssvar. Du kan ange antingen true eller false.
Undantag
Issuer är null eller en tom sträng.
-eller-
Realm är null eller en tom sträng.
-eller-
Egenskapen Current är null eller tom.
-eller-
Egenskapen Response för kontexten som returneras av Current är null eller tom.
Kommentarer
Metoden RedirectToIdentityProvider anropas från SignIn metoden när begäran utfärdas från en webbsida som presenteras av den förlitande parten (RP) eller från händelsehanterardelegaten OnEndRequest för att utföra en passiv omdirigering till identitetsprovidern vid auktoriseringsfel.
Parametrarna som skickas till metoden används för att skapa wctx-meddelandeparametern. Den enda signifikanta parametern är parametern returnUrl . Detta anger den URL som RP ska dirigera webbläsaren till efter lyckad autentisering. Det bör inte förväxlas med parametern wreply message, som anges av Reply egenskapen och som tillhandahåller adressen på den RP som säkerhetstokentjänsten (STS) ska dirigera sitt svar till.
Metoden utför följande:
Anropar VerifyProperties metoden för att säkerställa att en giltig inloggningsbegäran kan utfärdas av modulen.
Anropar CreateSignInRequest metoden för att skapa inloggningsbegäran från egenskaperna som konfigurerats i modulen.
Anropar OnRedirectingToIdentityProvider metoden för att skapa RedirectingToIdentityProvider händelsen. Du kan avbryta omdirigeringen eller ändra meddelandet för inloggningsbegäran i händelsehanteraren för den här händelsen.
