Compartir a través de


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

Configura el esquema de autenticación de ASP.NET utilizado para identificar usuarios que ven una aplicación ASP.NET.

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

Atributos y elementos

En las secciones siguientes se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo

Descripción

mode

Atributo necesario.

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

ValorDescripción
Windows Especifica la autenticación de Windows como modo de autenticación predeterminado.Este modo se debe utilizar con cualquier forma de autenticación de Microsoft Internet Information Services (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.
Forms Especifica la autenticación ASP.NET basada en formularios como modo de autenticación predeterminado.
Passport Especifica la autenticación de red de Microsoft Passport como modo de autenticación predeterminado.
None No especifica ninguna autenticación.La aplicación espera sólo usuarios anónimos o proporciona su propia autenticación.

El tipo predeterminado es Windows.

Elementos secundarios

Elemento

Descripción

forms

Configura una aplicación ASP.NET para la autenticación basada en formularios personalizados.

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.

Comentarios

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 devuelve la aplicación 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>

Ejemplo

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>

Información de elemento

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

Microsoft Internet Information Services (IIS) 5.0, 5.1 ó 6.0

.NET Framework versión 1.0, 1.1 ó 2.0

Microsoft Visual Studio 2003 o Visual Studio 2005

Vea también

Tareas

Cómo: Configurar directorios concretos mediante la configuración de la ubicación

Cómo: Bloquear los valores de configuración de ASP.NET

Referencia

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

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

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

Elemento configuration (Esquema de configuración general)

System.Configuration

System.Web.Configuration

AuthenticationSection

Conceptos

Jerarquía de archivos y herencia de la configuración de ASP.NET

Proteger la configuración de ASP.NET

Escenarios de configuración de ASP.NET

Otros recursos

Autenticación de ASP.NET

Opciones de configuración generales (ASP.NET)

Opciones de configuración de ASP.NET

Administración de sitios web ASP.NET

Archivos de configuración de ASP.NET

API de configuración de ASP.NET