WSFederationAuthenticationModule.RedirectToIdentityProvider Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
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:
Memanggil VerifyProperties metode untuk memastikan bahwa permintaan masuk yang valid dapat dikeluarkan oleh modul.
CreateSignInRequest Memanggil metode untuk membuat permintaan masuk dari properti yang dikonfigurasi pada modul.
OnRedirectingToIdentityProvider Memanggil metode untuk menaikkan RedirectingToIdentityProvider peristiwa. Anda dapat membatalkan pengalihan atau mengubah pesan permintaan masuk di penanganan aktivitas untuk peristiwa ini.