DefaultAuthenticationModule (Clase)

DefaultAuthenticationModule garantiza que la propiedad User de la instancia de HttpContext actual se establece en un objeto IPrincipal para cada solicitud. DefaultAuthenticationModule examina la propiedad User después del evento AuthenticateRequest y antes del evento AuthorizeRequest. Si la propiedad User es null, DefaultAuthenticationModule establece la propiedad User en un objeto GenericPrincipal que no contiene ninguna información sobre el usuario.

Si el módulo de autenticación establece la propiedad StatusCode en 401, DefaultAuthenticationModule representará una página de error de acceso denegado. Si el valor de la propiedad StatusCode se establece en un valor mayor que 200, el objeto DefaultAuthenticationModule terminará la solicitud. En ese caso, sólo se llama a los módulos HTTP que se suscriben al evento EndRequest antes de la realización de la solicitud actual.

DefaultAuthenticationModule expone un evento Authenticate. Puede utilizar este evento para proporcionar un objeto IPrincipal personalizado para la propiedad User de la instancia de HttpContext actual. Se obtiene acceso al evento Authenticate especificando un evento denominado DefaultAuthentication_OnAuthenticate en el archivo Global.asax de la aplicación.

El ejemplo de código siguiente utiliza el evento DefaultAuthentication_OnAuthenticate para probar si la propiedad User de la instancia de HttpContext actual es null. Si la propiedad User es null, el ejemplo establece la propiedad User de la instancia de HttpContext actual en un objeto GenericPrincipal; la propiedad Identity del objeto GenericPrincipal es un objeto GenericIdentity con el valor "default" como Name.

Nota

El evento DefaultAuthentication_OnAuthenticate tiene lugar antes que el evento AuthorizeRequest. Como resultado, si establece la propiedad User de la instancia de HttpContext actual en una identidad personalizada, puede afectar al comportamiento de la aplicación. Por ejemplo, si utiliza la clase FormsAuthentication y especifica <deny users="?" /> en la sección de configuración authorization para garantizar que sólo los usuarios autenticados tengan acceso al sitio, este ejemplo hará que se pase por alto el elemento deny, ya que el usuario tendrá un nombre que es "predeterminado". En su lugar especificaría <deny users="default" /> para garantizar que sólo los usuarios autenticados pueden tener acceso al sitio.

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]);
}

.NET Framework

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

Referencia

Otros recursos