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。
| 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 | |
|---|---|
| 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:
<add key="enableSimpleMembership" value="true" />
</appSettings>
Otras extensiones