ASP.NET Web Pages - WebSecurity-Objekt
Beschreibung
WebSecurity-ObjektBietet Sicherheit und Authentifizierung für ASP.NET Web Pages-Anwendungen.
Über das WebSecurity-Objekt können Sie Benutzerkonten erstellen, Benutzer an- und abmelden, Passwörter zurücksetzen oder ändern und viele andere sicherheitsrelevante Funktionen ausführen.
WebSecurity-Objekt Referenzhandbuch - Eigenschaften
| Eigenschaften | Beschreibung |
|---|---|
| CurrentUserId | Ruft die ID des aktuell angemeldeten Benutzers ab. |
| CurrentUserName | Ruft den Namen des aktuell angemeldeten Benutzers ab. |
| HasUserId | Gibt true zurück, wenn eine aktuelle Benutzer-ID vorhanden ist. |
| IsAuthenticated | Gibt true zurück, wenn der aktuelle Benutzer angemeldet ist. |
WebSecurity-Objekt Referenzhandbuch - Methoden
| Methoden | Beschreibung |
|---|---|
| ChangePassword() | Ändert das Passwort für den angegebenen Benutzer. |
| ConfirmAccount() | Bestätigt ein Konto mithilfe eines Konto-Bestätigungstokens. |
| CreateAccount() | Erstellt ein neues Benutzerkonto. |
| CreateUserAndAccount() | Erstellt ein neues Benutzerkonto. |
| GeneratePasswordResetToken() | Generiert ein Passwort-Zurücksetzungs-Token, das per E-Mail an den Benutzer gesendet werden kann, damit dieser sein Passwort zurücksetzen kann. |
| GetCreateDate() | Ruft den Zeitpunkt ab, zu dem die angegebene Mitgliedschaft erstellt wurde. |
| GetPasswordChangeDate() | Ruft das Datum und die Uhrzeit ab, zu der das Passwort geändert wurde. |
| GetUserId() | Ruft die Benutzer-ID basierend auf dem Benutzernamen ab. |
| InitializeDatabaseConnection() | Initialisiert das WebSecurity-System (Datenbank). |
| IsConfirmed() | Prüft, ob ein Benutzer bestätigt wurde. Gibt true zurück, wenn er bestätigt wurde. (Die Bestätigung kann beispielsweise per E-Mail erfolgen.) |
| IsCurrentUser() | Prüft, ob der Name des aktuellen Benutzers mit dem angegebenen Benutzernamen übereinstimmt. Gibt true zurück, wenn sie übereinstimmen. |
| Login() | Setzt das Authentifizierungstoken und meldet den Benutzer an. |
| Logout() | Entfernt das Authentifizierungstoken und meldet den Benutzer ab. |
| RequireAuthenticatedUser() | Setzt den HTTP-Status auf 401 (Unauthorized), wenn der Benutzer nicht authentifiziert ist. |
| RequireRoles() | Setzt den HTTP-Status auf 401 (Unauthorized), wenn der aktuelle Benutzer kein Mitglied der angegebenen Rolle ist. |
| RequireUser() | Setzt den HTTP-Status auf 401 (Unauthorized), wenn der aktuelle Benutzer nicht der Benutzer mit dem angegebenen Benutzernamen ist. |
| ResetPassword() | Ändert das Passwort des Benutzers in ein neues Passwort, wenn das Passwort-Zurücksetzungs-Token gültig ist. |
| UserExists() | Prüft, ob der angegebene Benutzer existiert. |
Technische Daten
| Name | Wert |
|---|---|
| Klasse | WebMatrix.WebData.WebSecurity |
| Namespace | WebMatrix.WebData |
| Assembly | WebMatrix.WebData.dll |
Initialisieren der WebSecurity-Datenbank
Wenn Sie das WebSecurity-Objekt in Ihrem Code verwenden möchten, müssen Sie zuerst die WebSecurity-Datenbank erstellen oder initialisieren.
Erstellen Sie in Ihrem Stammverzeichnis eine Seite mit dem Namen_AppStart.cshtml(falls die Seite bereits existiert, bearbeiten Sie sie direkt).
Kopieren Sie den folgenden Code in die Datei:
_AppStart.cshtml
WebSecurity.InitializeDatabaseConnection("Users", "UserProfile", "UserId", "Email", true);
}
Der obige Code wird jedes Mal ausgeführt, wenn die Website (Anwendung) startet. Er initialisiert die WebSecurity-Datenbank.
"Users"Ist der Name der WebSecurity-Datenbank (Users.sdf).
"UserProfile"Ist der Name der Datenbanktabelle, die Benutzerprofilinformationen enthält.
"UserId"Ist der Name der Spalte, die die Benutzer-ID (Primärschlüssel) enthält.
"Email"Ist der Name der Spalte, die den Benutzernamen enthält.
Der letzte Parametertrueist ein boolescher Wert, der angibt, dass die Tabellen automatisch erstellt werden, falls das Benutzerprofil und die Mitgliedschaftstabelle nicht existieren. Wenn Sie die Tabellen nicht automatisch erstellen möchten, setzen Sie den Parameter auffalse。
| Obwohltruedie automatische Erstellung der DatenbankTabellebedeutet, wird die Datenbank nicht automatisch erstellt. Daher muss die Datenbank bereits existieren. |
WebSecurity-Datenbank
UserProfileDie Tabelle erstellt und speichert einen Datensatz für jeden Benutzer mit der Benutzer-ID (Primärschlüssel) und dem Benutzernamen (E-Mail):
| UserId | |
|---|---|
| 1 | john@johnson.net |
| 2 | peter@peterson.com |
| 3 | lars@larson.eut |
MembershipDie Tabelle enthält Mitgliedschaftsinformationen, wie z. B. wann der Benutzer erstellt wurde, ob die Mitgliedschaft bestätigt wurde, wann die Mitgliedschaft bestätigt wurde usw.
Die Details sind wie folgt (einige Spalten werden nicht angezeigt):
| Benutzer Id |
Erstelle Date |
Confirmation Token |
Ist Bestätigt |
Letzte Password Fehler |
Password | Password Änderung |
|---|---|---|---|---|---|---|
| 1 | 12.04.2012 16:12:17 | NULL | True | NULL | AFNQhWfy.... | 12.04.2012 16:12:17 |
Hinweis: Wenn Sie alle Spalten und Inhalte sehen möchten, öffnen Sie die Datenbank und betrachten Sie jede Tabelle darin.
Einfache Mitgliedschaftskonfiguration
Wenn Sie das WebSecurity-Objekt verwenden und Ihre Website nicht für die Verwendung des ASP.NET Web Pages-MitgliedschaftssystemsSimpleMembershipkonfiguriert ist, kann ein Fehler auftreten.
Wenn sich die Konfiguration des Servers des Hosting-Anbieters von der Konfiguration Ihres lokalen Servers unterscheidet, kann ebenfalls ein Fehler auftreten. Um dieses Problem zu lösen, fügen Sie der Web.config-Datei Ihrer Website die folgenden Elemente hinzu:
<add key="enableSimpleMembership" value="true" />
</appSettings>
Weitere Erweiterungen