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。

lamp 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 E-Mail
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:

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


Weitere Erweiterungen