Esta documentación está archivada y no tiene mantenimiento.

Elemento authentication (Esquema de configuración de ASP.NET)

Actualización: noviembre 2007

Configura el esquema de autenticación de ASP.NET que se usa para identificar a los usuarios que se enfrentan a una aplicación ASP.NET.

Elemento configuration (Esquema de configuración general)
  Elemento system.web (Esquema de configuración de ASP.NET)
    Elemento authentication (Esquema de configuración de ASP.NET)

<authentication 
   mode="[Windows|Forms|Passport|None]"
> 
   <forms>...</forms>
   <passport/>
</authentication>

Las siguientes secciones describen atributos, elementos secundarios y elementos primarios.

Atributos

Atributo

Descripción

mode

Atributo requerido.

Especifica el modo de autenticación predeterminado de una aplicación. Este atributo puede tener uno de los siguientes valores.

ValorDescripción
WindowsEspecifica la autenticación de Windows como modo de autenticación predeterminado. Este modo se debe utilizar con cualquier forma de autenticación de Servicios de Microsoft Internet Information Server (IIS): básica, implícita, integrada de Windows (NTLM o Kerberos) o certificados. En este caso, su aplicación delega la responsabilidad de la autenticación al servidor IIS subyacente.
FormsEspecifica la autenticación ASP.NET basada en formularios como modo de autenticación predeterminado.
PassportEspecifica la autenticación de red de Microsoft Passport como modo de autenticación predeterminado.
NoneNo especifica ninguna autenticación. La aplicación espera sólo usuarios anónimos o proporciona su propia autenticación.

El valor predeterminado es Windows.

Elementos secundarios

Elemento

Descripción

forms

Configura una aplicación ASP.NET para que utilice una autenticación basada en formularios personalizada.

passport

Especifica la página de redireccionamiento si la página requiere autenticación y el usuario no ha iniciado sesión mediante la autenticación de red de Microsoft Passport.

Elementos primarios

Elemento

Descripción

configuration

Especifica el elemento raíz necesario de cada archivo de configuración que utilizan las aplicaciones basadas en Common Language Runtime y .NET Framework.

system.web

Especifica el elemento raíz de los valores de configuración de ASP.NET de un archivo de configuración y contiene elementos de configuración que configuran las aplicaciones Web ASP.NET y controlan el comportamiento de las aplicaciones.

El elemento authentication configura el esquema de autenticación de ASP.NET para una aplicación ASP.NET. El esquema de autenticación determina cómo identificar los usuarios que desean ver la aplicación ASP.NET. El atributo mode especifica el esquema de autenticación. Para obtener más información sobre los esquemas de autenticación disponibles, vea Autenticación de ASP.NET.

Configuración predeterminada

El siguiente elemento authentication predeterminado no se configura explícitamente en el archivo Machine.config o en el archivo Web.config raíz. Sin embargo, es la configuración predeterminada que la aplicación devuelve en .NET Framework 2.0.

<authentication mode="Windows">
   <forms 
      name=".ASPXAUTH" 
      loginUrl="login.aspx" 
      defaultUrl="default.aspx" 
      protection="All" 
      timeout="30" 
      path="/" 
      requireSSL="false" 
      slidingExpiration="true" 
      cookieless="UseDeviceProfile" domain="" 
      enableCrossAppRedirects="false">
      <credentials passwordFormat="SHA1" />
   </forms>
   <passport redirectUrl="internal" />
</authentication>

En .NET Framework 1.1, el siguiente elemento authentication predeterminado se configura en el archivo Machine.config.

<authentication mode="Windows">
   <forms 
      name=".ASPXAUTH" 
      loginUrl="login.aspx" 
      protection="All"  
      timeout="30" 
      path="/" 
      requireSSL="false" 
      slidingExpiration="true">
      <credentials passwordFormat="SHA1"></credentials>
   </forms>
   <passport redirectUrl="internal" />
</authentication>

En .NET Framework 1.0, el siguiente elemento authentication predeterminado se configura en el archivo Machine.config.

<authentication mode="Windows">
   <forms 
      name=".ASPXAUTH" 
      loginUrl="login.aspx" 
      protection="All"  
      timeout="30" 
      path="/" >
      <credentials passwordFormat="SHA1"></credentials>
   </forms>
   <passport redirectUrl="internal" />
</authentication>

En el ejemplo de código siguiente se muestra cómo configurar un sitio para la autenticación basada en formularios, especificar el nombre de la cookie que transmite la información de inicio de sesión desde el cliente y especificar el nombre de la página de inicio de sesión que debe utilizarse si se produce un error en la autenticación inicial. Es necesario incluir una sección autorización para exigir la autenticación de formularios a todos los usuarios y denegar el acceso al sitio a los usuarios anónimos.

<configuration>
   <system.web>
      <authentication mode="Forms">
         <forms name="401kApp" loginUrl="/login.aspx"/>
      </authentication>
      <authorization>
         <deny users="?"/>
      </authorization>
   </system.web>
</configuration>

Controlador de la sección de configuración

AuthenticationSection

Miembro de configuración

AuthenticationMode

Ubicaciones configurables

Machine.config

Web.config del nivel raíz

Web.config del nivel de aplicaciones

Requisitos   

Servicios de Microsoft Internet Information Server (IIS) 5.0, 5.1 ó 6.0

.NET Framework 1.0, 1.1 ó 2.0

Microsoft Visual Studio 2003 o Visual Studio 2005

Mostrar: