DefaultAuthenticationModule Kelas

Definisi

Ruang nama:

System.Web.Security

Rakitan:

System.Web.dll

Memastikan bahwa objek autentikasi ada dalam konteks. Kelas ini tidak dapat diwariskan.

public ref class DefaultAuthenticationModule sealed : System::Web::IHttpModule

public sealed class DefaultAuthenticationModule : System.Web.IHttpModule

type DefaultAuthenticationModule = class
    interface IHttpModule

Public NotInheritable Class DefaultAuthenticationModule
Implements IHttpModule

Warisan

Object

DefaultAuthenticationModule

Penerapan

IHttpModule

Contoh

Contoh berikut menggunakan peristiwa DefaultAuthentication_OnAuthenticate untuk menguji apakah User properti instans saat ini HttpContext adalah null. User Jika properti adalah null, maka sampel mengatur properti instans User saat ini HttpContext ke GenericPrincipal objek di mana IdentityGenericPrincipal objek adalah GenericIdentity dengan Name nilai "default."

Catatan

Peristiwa DefaultAuthentication_OnAuthenticate dinaikkan sebelum AuthorizeRequest acara. Akibatnya, jika Anda mengatur User properti instans saat ini HttpContext ke identitas kustom, itu dapat memengaruhi perilaku aplikasi Anda. Misalnya, jika Anda menggunakan FormsAuthentication kelas dan Anda menentukan <deny users="?" /> di bagian konfigurasi otorisasi untuk memastikan bahwa hanya pengguna terautentikasi yang memiliki akses ke situs Anda, sampel ini akan menyebabkan elemen tolak diabaikan, karena pengguna akan memiliki nama, yang "default." Sebagai gantinya, Anda akan menentukan <deny users="default" /> untuk memastikan bahwa hanya pengguna terautentikasi yang dapat mengakses situs Anda.

public void DefaultAuthentication_OnAuthenticate(object sender,
                                                 DefaultAuthenticationEventArgs args)
{
  if (args.Context.User == null)
    args.Context.User = 
      new System.Security.Principal.GenericPrincipal(
        new System.Security.Principal.GenericIdentity("default"),
        new String[0]);
}

Public Sub DefaultAuthentication_OnAuthenticate(sender As Object, _
                                                args As DefaultAuthenticationEventArgs)
  If args.Context.User Is Nothing Then
    args.Context.User = _
      new System.Security.Principal.GenericPrincipal( _
        new System.Security.Principal.GenericIdentity("default"), _
        new String(0) {})
  End If
End Sub

Keterangan

DefaultAuthenticationModule memastikan bahwa User properti instans saat ini HttpContext diatur ke IPrincipal objek untuk setiap permintaan. DefaultAuthenticationModule memeriksa User properti setelah AuthenticateRequest peristiwa dan sebelum AuthorizeRequest peristiwa. User Jika properti adalah null, DefaultAuthenticationModule mengatur User properti ke GenericPrincipal objek yang tidak berisi informasi pengguna.

Jika modul autentikasi mengatur StatusCode properti ke 401, DefaultAuthenticationModule akan merender halaman kesalahan yang ditolak aksesnya. Jika nilai StatusCode properti diatur ke nilai yang lebih besar dari 200, DefaultAuthenticationModule objek akan mengakhiri permintaan. Dalam hal ini, hanya modul HTTP yang berlangganan peristiwa yang dipanggil EndRequest sebelum penyelesaian permintaan saat ini.

mengekspos DefaultAuthenticationModule peristiwa Authenticate . Anda dapat menggunakan peristiwa ini untuk menyediakan objek kustom IPrincipal untuk User properti instans saat ini HttpContext . Peristiwa Authenticate ini diakses dengan menentukan peristiwa bernama DefaultAuthentication_OnAuthenticate dalam file Global.asax aplikasi.

Konstruktor

DefaultAuthenticationModule()

Menginisialisasi instans baru kelas DefaultAuthenticationModule.

Metode

Dispose()	Merilis semua sumber daya, selain memori, yang digunakan oleh DefaultAuthenticationModule.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
Init(HttpApplication)	Menginisialisasi objek DefaultAuthenticationModule.
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Acara

Authenticate

Terjadi setelah permintaan diautentikasi.

Lihat juga

• Autentikasi ASP.NET