Share via

WSFederationAuthenticationModule.CreateSignInRequest Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.IdentityModel.Services
Bütünleştirilmiş Kod:
System.IdentityModel.Services.dll

Modülde yapılandırılan WS-Federation parametrelerini kullanarak bir WS-Federation oturum açma isteği iletisi oluşturur.

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

Parametreler

uniqueId
String

WSFAM bu değeri WS-Federation oturum açma isteğindeki wctx parametresine kaydeder; ancak modül, oturum açma isteklerini veya oturum açma yanıtlarını işlerken bunu kullanmaz. Bunu herhangi bir değere ayarlayabilirsiniz. Benzersiz olması gerekmez.

returnUrl
String

Modülün kimlik doğrulamasından sonra döndürmesi gereken URL.

rememberMeSet
Boolean

WSFAM bu değeri WS-Federation oturum açma isteğindeki wctx parametresine kaydeder; ancak modül, oturum açma isteklerini veya oturum açma yanıtlarını işlerken bunu kullanmaz. Ya da truefalseayarlayabilirsiniz.

Döndürülenler

SignInRequestMessage

oturum açma isteği iletisi WS-Federation.

Özel durumlar

InvalidOperationException

Issuer özelliği veya boş bir dizedirnull.

-veya-

Realm özelliği veya boş bir dizedirnull.

Açıklamalar

Bir nesneyle SignInRequestMessage temsil edilen bir WS-Federation oturum açma isteği oluşturur. Yeni SignInRequestMessage nesnenin özellikleri aşağıdaki gibi ayarlanır:

  • Context özelliği (wctx parametresi), yöntem parametreleri kullanılarak oluşturulan bir değere ayarlanır.

  • CurrentTime özelliği (wct parametresi) geçerli saate ayarlanır.

  • Diğer tüm özellikler, geçerli örneğin eşdeğer özellikleri kullanılarak ayarlanır.

yöntemine geçirilen parametreler, wctx ileti parametresini oluşturmak için kullanılır. Bu, şu biçime sahip bir dizedir: ru=returnUrl&cx=SignInContext&rm=rememberMeSet&id=uniqueId.

  • ru değeri yöntemine geçirilen parametrenin returnUrl değerine ayarlanır ve modülün tarayıcıyı başarılı kimlik doğrulamasını takip etmeye yönlendirmesi gereken URL'yi belirtir. Bu, WSFAM tarafından kullanılan wctx dizesinde depolanan tek değerdir. Modül, WS-Federation oturum açma yanıtını işlerken bu değeri wctx parametresinden ayıklamak için yöntemini çağırır GetReturnUrlFromResponse . Özelliği tarafından Reply belirtilen ve güvenlik belirteci hizmetinin (STS) yanıtını yönlendirmesi gereken RP'de adresi sağlayan kötü ileti parametresiyle karıştırılmamalıdır.

  • cx parametresi özelliğinin SignInContext değerine ayarlanır. Bu özellik, wctx dizesinde depolanması gereken uygulama tanımlı bağlamı ayarlamanıza olanak tanımak için kullanıma sunulur; ancak WSFAM yanıttaki bu değeri ayıklamak için bir yöntem sunmaz. Değer uygulamanız için gerekliyse, wctx dizesini ayrıştıracak kodu sağlamanız ve yanıtı işlerken bu değeri okumanız gerekir. Yöntemini geçersiz kılarak GetReturnUrlFromResponse bunu gerçekleştirebilirsiniz.

  • Ne parametrenin rm değerine ayarlanan değer ne de id parametrenin değerine rememberMeSetuniqueId ayarlanan parametre WSFAM tarafından kullanılmaz. Bunlar herhangi bir değere ayarlanabilir.

CreateSignInRequest yöntemi yönteminden çağrılırRedirectToIdentityProvider.

Şunlara uygulanır

Ayrıca bkz.