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>
Atributos y elementos
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
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 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.
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 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. |
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 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>
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 |
|
Miembro de configuración |
|
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 |
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
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
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)
Otros recursos
Opciones de configuración generales (ASP.NET)
Opciones de configuración de ASP.NET
Administrar sitios web ASP.NET