Elemento authentication (Esquema de configuración de ASP.NET)
[Esta documentación se proporciona solo para fines preliminares y está sujeta a cambios en versiones posteriores. Se incluye temas en blanco como marcadores].
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 próximas secciones 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 valor 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 en un archivo de configuración y contiene elementos de configuración que configuran 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 ASP.NET Authentication.
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 |
|
Miembro de configuración |
|
Ubicaciones configurables |
Machine.config Web.config del nivel raíz Web.config del nivel de aplicaciones |
Requisitos |
Microsoft Internet Information Services (IIS) versión 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
How to: Configure Specific Folders Using Location Settings
How to: Lock ASP.NET Configuration Settings
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)
Conceptos
ASP.NET Configuration File Hierarchy
Otros recursos
Opciones de configuración generales (ASP.NET)
Opciones de configuración de ASP.NET