WSFederationAuthenticationModule.CreateSignInRequest 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 maakt u een WS-Federation aanmeldingsaanvraagbericht met behulp van de WS-Federation parameters die in de module zijn geconfigureerd.
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.SignInRequestMessagePublic Function CreateSignInRequest (uniqueId As String, returnUrl As String, rememberMeSet As Boolean) As SignInRequestMessageParameters
- 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.
- returnUrl
- String
De URL waarnaar de module moet worden geretourneerd bij verificatie.
- rememberMeSet
- 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.
Retouren
Het WS-Federation aanmeldingsaanvraagbericht.
Uitzonderingen
De Issuer eigenschap is null of een lege tekenreeks.
– of –
De Realm eigenschap is null of een lege tekenreeks.
Opmerkingen
Hiermee maakt u een WS-Federation aanmeldingsaanvraag die wordt vertegenwoordigd door een SignInRequestMessage object. De eigenschappen van het nieuwe SignInRequestMessage object worden als volgt ingesteld:
De Context eigenschap (de wctx-parameter) wordt ingesteld op een waarde die is gemaakt met behulp van de methodeparameters.
De CurrentTime eigenschap (de wct-parameter) is ingesteld op de huidige tijd.
Alle andere eigenschappen worden ingesteld met behulp van de equivalente eigenschappen van het huidige exemplaar.
De parameters die aan de methode worden doorgegeven, worden gebruikt om de wctx-berichtparameter te maken. Dit is een tekenreeks met de volgende indeling: ru=returnUrl&cx=SignInContext&rm=rememberMeSet&id=uniqueId.
De
ruwaarde wordt ingesteld op de waarde van dereturnUrlparameter die is doorgegeven aan de methode en geeft de URL op die door de module moet worden doorgestuurd naar de browser na een geslaagde verificatie. Dit is de enige waarde die is opgeslagen in de wctx-tekenreeks die wordt gebruikt door de WSFAM. De module roept de GetReturnUrlFromResponse methode aan om deze waarde op te halen uit de wctx-parameter bij het verwerken van een WS-Federation aanmeldingsreactie. 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
cxparameter wordt ingesteld op de waarde van de SignInContext eigenschap. Deze eigenschap wordt weergegeven om u in staat te stellen elke toepassingsgedefinieerde context in te stellen die moet worden opgeslagen in de wctx-tekenreeks; WSFAM maakt echter geen methode beschikbaar om deze waarde in het antwoord te extraheren. Als de waarde nodig is voor uw toepassing, moet u de code opgeven om de wctx-tekenreeks te parseren en deze waarde te lezen bij het verwerken van het antwoord. U kunt dit doen door de GetReturnUrlFromResponse methode te overschrijven.Noch de
rmwaarde, die is ingesteld op de waarde van derememberMeSetparameter, noch deidparameter, die is ingesteld op de waarde van deuniqueIdparameter, worden gebruikt door WSFAM. Deze kunnen worden ingesteld op elke waarde.
De CreateSignInRequest methode wordt aangeroepen vanuit de RedirectToIdentityProvider methode.