La description
L'objet WebSecurity assure la sécurité et l' authentification pour les applications ASP.NET Web Pages.
Avec l'objet WebSecurity vous pouvez créer des comptes utilisateurs, connexion et les utilisateurs de déconnexion, réinitialiser les mots de passe ou changer, et plus encore.
WebSecurity Objet Référence - Propriétés
| Propriétés | La description |
|---|---|
| CurrentUserId | Obtient l'ID de l'utilisateur en cours |
| CurrentUserName | Obtient le nom de l'utilisateur actuel |
| HasUserId | Renvoie true si le courant a un ID utilisateur |
| IsAuthenticated | Renvoie true si l'utilisateur est connecté actuel |
WebSecurity Objet Référence - Méthodes
| méthode | La description |
|---|---|
| ChangePassword() | Modifie le mot de passe pour un utilisateur |
| ConfirmAccount() | Confirme un compte en utilisant un jeton de confirmation |
| CreateAccount() | Crée un nouveau compte utilisateur |
| CreateUserAndAccount() | Crée un nouveau compte utilisateur |
| GeneratePasswordResetToken() | Génère un jeton qui peut être envoyé à l'utilisateur comme par email |
| GetCreateDate() | Obtient le temps la composition spécifiée a été créé |
| GetPasswordChangeDate() | Obtient la date et l'heure de mot de passe a été changé |
| GetUserId() | Obtient un ID utilisateur d'un nom d'utilisateur |
| InitializeDatabaseConnection() | Initialise le système de WebSecurity (database) |
| IsConfirmed() | Vérifie si un utilisateur est confirmé |
| IsCurrentUser() | Vérifie si l'utilisateur actuel correspond à un nom d'utilisateur |
| Login() | L'utilisateur ouvre une session en définissant un jeton dans le cookie |
| Logout() | Déconnecte l'utilisateur en supprimant le cookie jeton |
| RequireAuthenticatedUser() | Permet de quitter la page si l'utilisateur n'est pas un utilisateur authentifié |
| RequireRoles() | Permet de quitter la page si l'utilisateur ne fait pas partie des rôles spécifiés |
| RequireUser() | Permet de quitter la page si l'utilisateur n'est pas l'utilisateur spécifié |
| ResetPassword() | Modifie le mot de passe d'un utilisateur en utilisant un jeton |
| UserExists() | Vérifie s'il existe un utilisateur donné |
données techniques
| prénom | Valeur |
|---|---|
| Classe | WebMatrix.WebData.WebSecurity |
| namespace | WebMatrix.WebData |
| Assemblée | WebMatrix.WebData.dll |
Initialisation la base de données de WebSecurity
Vous devez créer ou initialiser une base de données de WebSecurity avant de pouvoir utiliser l'objet WebSecurity dans votre code.
Dans la racine de votre web, créer une page (or edit the page ) nommé _AppStart.cshtml.
Placez le code suivant dans le fichier:
_AppStart.cshtml
@{
WebSecurity.InitializeDatabaseConnection("Users", "UserProfile",
"UserId", "Email", true);
}
Le code ci - dessus fonctionnera chaque fois que le site web (application) démarre. Il initialise la base de données WebSecurity.
« Les utilisateurs » est le nom de la base de données WebSecurity (Users.sdf) .
« UserProfile » est le nom de la table de base de données qui contient les informations de profil d'utilisateur.
« UserID » est le nom de la colonne qui contient les ID utilisateur (primary key) .
« Email » est le nom de la colonne qui contient les noms d'utilisateur.
Le dernier paramètre vrai est une valeur booléenne indiquant que le profil de l' utilisateur et les tables d'adhésion doivent être créées automatiquement si elles n'existent pas, sinon faux.
Bien vrai indique la création automatique des tables de base de données, la base de données elle - même ne sera pas créé automatiquement. Il doit exister.
La base de données de WebSecurity
La table UserProfile contient un enregistrement pour chaque utilisateur, avec un ID utilisateur (primary key) et le nom de l'utilisateur (email) - (email) :
| Identifiant d'utilisateur | |
|---|---|
| 1 | [email protected] |
| 2 | [email protected] |
| 3 | [email protected] |
Le tableau d'adhésion contiendra des informations d'adhésion quand l'utilisateur a été créé et si (and when) l'adhésion a été confirmée.
Tout comme cela (some columns are not shown) :
| Utilisateur ça | Créer Rendez-vous amoureux | Confirmation Jeton | Est Confirmé | Dernier Mot de passe Échec | Mot de passe | Mot de passe Changement |
|---|---|---|---|---|---|---|
| 1 | 12.04.2012 16:12:17 | NUL | Vrai | NUL | AFNQhWfy .... | 12.04.2012 16:12:17 |
Remarque: Si vous voulez voir toutes les colonnes et tout le contenu, ouvrez la base de données avec WebMatrix et regarder à l'intérieur de chaque table.
Configuration d'adhésion simple
Vous pouvez obtenir des erreurs en utilisant l'objet WebSecurity, si votre site n'est pas configuré pour utiliser le système d'abonnement Pages Web ASP.NET SimpleMembership.
Cela peut se produire si un serveur de fournisseur d'hébergement est configuré différemment que votre serveur local. Pour résoudre ce problème, ajoutez l'élément suivant au fichier web.config du site:
<appSettings>
<add key="enableSimpleMembership" value="true" />
</appSettings>