ASP.NET Web Pages - Objeto WebSecurity


Descripción

Objeto WebSecurityProporciona seguridad y autenticación para aplicaciones ASP.NET Web Pages.

Mediante el objeto WebSecurity, puede crear cuentas de usuario, iniciar y cerrar sesión de usuarios, restablecer o cambiar contraseñas, y muchas otras funciones relacionadas con la seguridad.


Manual de referencia del objeto WebSecurity - Propiedades

Propiedades Descripción
CurrentUserId Obtiene el ID del usuario que ha iniciado sesión actualmente.
CurrentUserName Obtiene el nombre del usuario que ha iniciado sesión actualmente.
HasUserId Devuelve true si hay un ID de usuario actualmente.
IsAuthenticated Devuelve true si el usuario actual ha iniciado sesión.

Manual de referencia del objeto WebSecurity - Métodos

Métodos Descripción
ChangePassword() Cambia la contraseña del usuario especificado.
ConfirmAccount() Confirma la cuenta mediante un token de confirmación de cuenta.
CreateAccount() Crea una nueva cuenta de usuario.
CreateUserAndAccount() Crea una nueva cuenta de usuario.
GeneratePasswordResetToken() Genera un token de restablecimiento de contraseña que puede enviarse al usuario por correo electrónico para que pueda restablecer su contraseña.
GetCreateDate() Obtiene la hora en que se creó la membresía especificada.
GetPasswordChangeDate() Obtiene la fecha y hora del cambio de contraseña.
GetUserId() Obtiene el ID de usuario según el nombre de usuario.
InitializeDatabaseConnection() Inicializa el sistema (base de datos) de WebSecurity.
IsConfirmed() Comprueba si el usuario ha sido confirmado. Si ha sido confirmado, devuelve true. (Por ejemplo, puede confirmarse mediante correo electrónico).
IsCurrentUser() Comprueba si el nombre del usuario actual coincide con el nombre de usuario especificado. Si coincide, devuelve true.
Login() Establece el token de autenticación e inicia la sesión del usuario.
Logout() Elimina el token de autenticación y cierra la sesión del usuario.
RequireAuthenticatedUser() Si el usuario no está autenticado, establece el estado HTTP en 401 (No autorizado).
RequireRoles() Si el usuario actual no es miembro del rol especificado, establece el estado HTTP en 401 (No autorizado).
RequireUser() Si el usuario actual no es el usuario con el nombre de usuario especificado, establece el estado HTTP en 401 (No autorizado).
ResetPassword() Si el token de restablecimiento de contraseña es válido, cambia la contraseña del usuario por la nueva contraseña.
UserExists() Comprueba si el usuario especificado existe.


Datos técnicos

Nombre Valor
Class WebMatrix.WebData.WebSecurity
Namespace WebMatrix.WebData
Assembly WebMatrix.WebData.dll


Inicializar la base de datos de WebSecurity

Si desea utilizar el objeto WebSecurity en su código, primero debe crear o inicializar la base de datos de WebSecurity.

En el directorio raíz de su sitio web, cree una página llamada_AppStart.cshtml(si ya existe, simplemente edite la página).

Copie el siguiente código en el archivo:

_AppStart.cshtml

@{
WebSecurity.InitializeDatabaseConnection("Users", "UserProfile", "UserId", "Email", true);
}

El código anterior se ejecutará cada vez que se inicie el sitio web (aplicación). Inicializa la base de datos de WebSecurity.

"Users"es el nombre de la base de datos de WebSecurity (Users.sdf).

"UserProfile"es el nombre de la tabla de la base de datos que contiene la información del perfil de usuario.

"UserId"es el nombre de la columna que contiene el ID de usuario (clave principal).

"Email"es el nombre de la columna que contiene el nombre de usuario.

El último parámetrotruees un valor booleano que indica que, si la tabla de perfiles de usuario y la tabla de membresía no existen, las tablas se crearán automáticamente. Si no desea crear tablas automáticamente, debe establecer el parámetro enfalse。

lamp Aunquetrueindica la creación automática de la base de datostabla, la base de datos no se creará automáticamente. Por lo tanto, la base de datos debe existir.


Base de datos de WebSecurity

UserProfileLa tabla crea y guarda un registro para cada usuario: ID de usuario (clave principal) y nombre de usuario (correo electrónico):

UserId Email
1 john@johnson.net
2 peter@peterson.com
3 lars@larson.eut

MembershipLa tabla contiene información de membresía, como cuándo se creó el usuario, si la membresía ha sido confirmada, cuándo fue confirmada, etc.

Como se muestra a continuación (algunas columnas no se muestran):

User
Id
Create
Date
Confirmation
Token
Is
Confirmed
Last
Password
Failure
Password Password
Change
1 12.04.2012 16:12:17 NULL True NULL AFNQhWfy.... 12.04.2012 16:12:17

Nota: Si desea ver todas las columnas y el contenido, abra la base de datos y revise cada tabla.


Configuración simple de membresía

Al utilizar el objeto WebSecurity, si su sitio no está configurado para usar el sistema de membresía de ASP.NET Web PagesSimpleMembership, puede producirse un error.

Si la configuración del servidor del proveedor de alojamiento es diferente de la configuración de su servidor local, también puede producirse un error. Para resolver este problema, agregue los siguientes elementos al archivo Web.config del sitio web:

<appSettings>
<add key="enableSimpleMembership" value="true" />
</appSettings>


Otras extensiones