WSFederationAuthenticationModule.RedirectToIdentityProvider Metode

Definisi

Ruang nama:

System.IdentityModel.Services

Rakitan:

System.IdentityModel.Services.dll

Mengalihkan pengguna ke layanan token keamanan (STS) yang ditentukan oleh Issuer properti untuk mendapatkan token keamanan menggunakan protokol 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)

Parameter

uniqueId

String

WSFAM menyimpan nilai ini dalam parameter wctx dalam permintaan masuk WS-Federation; namun, modul tidak menggunakannya saat memproses permintaan masuk atau respons masuk. Anda dapat mengaturnya ke nilai apa pun. Ini tidak harus unik. Untuk informasi lebih lanjut, lihat CreateSignInRequest(String, String, Boolean)metodenya.

returnUrl

String

URL yang harus dikembalikan modul saat autentikasi.

persist

Boolean

WSFAM menyimpan nilai ini dalam parameter wctx dalam permintaan masuk WS-Federation; namun, modul tidak menggunakannya saat memproses permintaan masuk atau respons masuk. Anda dapat mengaturnya baik true atau false.

Pengecualian

InvalidOperationException

Issuer adalah null atau string kosong.

-atau-

Realm adalah null atau string kosong.

-atau-

Properti Current adalah null atau kosong.

-atau-

Properti Response konteks yang dikembalikan oleh Current adalah null atau kosong.

Keterangan

Metode RedirectToIdentityProvider ini dipanggil dari SignIn metode ketika permintaan dikeluarkan dari halaman web yang disajikan oleh pihak yang mengandalkan (RP) atau dari OnEndRequest delegasi penanganan aktivitas untuk melakukan pengalihan pasif ke Penyedia Identitas tentang kegagalan otorisasi.

Parameter yang diteruskan ke metode digunakan untuk membuat parameter pesan wctx. Satu-satunya parameter yang signifikan adalah returnUrl parameter . Ini menentukan URL bahwa RP harus mengarahkan browser untuk mengikuti autentikasi yang berhasil. Ini tidak boleh dikacaukan dengan parameter pesan balasan, yang ditentukan oleh Reply properti dan yang memberikan alamat di RP tempat layanan token keamanan (STS) harus mengarahkan responsnya.

Metode ini melakukan hal berikut:

1. Memanggil VerifyProperties metode untuk memastikan bahwa permintaan masuk yang valid dapat dikeluarkan oleh modul.

2. CreateSignInRequest Memanggil metode untuk membuat permintaan masuk dari properti yang dikonfigurasi pada modul.

3. OnRedirectingToIdentityProvider Memanggil metode untuk menaikkan RedirectingToIdentityProvider peristiwa. Anda dapat membatalkan pengalihan atau mengubah pesan permintaan masuk di penanganan aktivitas untuk peristiwa ini.