Security - 7. Password reset

Database Considerations

Überprüfen Sie zu Beginn, ob Ihr App\User-Modell den Illuminate\Verträge\Auth\CanResetPassword-Vertrag implementiert. Das im Framework enthaltene App\User-Modell implementiert diese Schnittstelle bereits und verwendet die Eigenschaft Illuminate\Auth\Passwords\CanResetPassword, um die für die Implementierung der Schnittstelle erforderlichen Methoden einzubinden.

Generating The Reset Token Table Migration

Als nächstes muss eine Tabelle erstellt werden, um die Token für die Kennwortzurücksetzung zu speichern. Die Migration für diese Tabelle ist bei Laravel out of the box enthalten und befindet sich im Verzeichnis database/migrations. Sie müssen also nur noch Ihre Datenbank-Migrationen durchführen:

php artisan migrate

Routing

Laravel enthält die Klassen Auth\ForgotPasswordController und Auth\ResetPasswordController, die die Logik enthalten, die für die E-Mail-Passwort-Reset-Links und das Zurücksetzen von Benutzerpasswörtern erforderlich ist. Alle für das Zurücksetzen von Passwörtern erforderlichen Routen können mit dem Befehl make:auth Artisan generiert werden:

php artisan make:auth

Views

Auch hier erzeugt Laravel alle notwendigen Ansichten für das Zurücksetzen des Passworts, wenn der Befehl make:auth ausgeführt wird. Diese Ansichten werden in ressources/views/auth/passwords platziert. Es steht Ihnen frei, sie nach Bedarf für Ihre Anwendung anzupassen.

After Resetting Passwords

Sobald Sie die Routen und Ansichten zum Zurücksetzen der Passwörter Ihrer Benutzer definiert haben, können Sie die Route in Ihrem Browser unter /password/reset aufrufen. Der im Framework enthaltene ForgotPasswordController enthält bereits die Logik zum Versenden von E-Mails mit dem Link zum Zurücksetzen des Passworts, während der ResetPasswordController die Logik zum Zurücksetzen der Benutzerpasswörter enthält.

Nachdem ein Passwort zurückgesetzt wurde, wird der Benutzer automatisch in die Anwendung eingeloggt und nach /home umgeleitet. Sie können den Umleitungsort für die Umleitung nach der Kennwortrücksetzung anpassen, indem Sie eine redirectTo-Eigenschaft auf dem ResetPasswordController definieren:

protected $redirectTo = '/dashboard';

Customization

Authentication Guard Customization

In Ihrer auth.php-Konfigurationsdatei können Sie mehrere "Wächter" konfigurieren, die zur Definition des Authentifizierungsverhaltens für mehrere Benutzertabellen verwendet werden können. Sie können den mitgelieferten ResetPasswordController so anpassen, dass der Wächter Ihrer Wahl verwendet wird, indem Sie die guard-Methode auf dem Controller außer Kraft setzen. Diese Methode sollte eine guard-Instanz zurückgeben:

use Illuminate\Support\Facades\Auth;

/**
 * Get the guard to be used during password reset.
 *
 * @return \Illuminate\Contracts\Auth\StatefulGuard
 */
protected function guard()
{
    return Auth::guard('guard-name');
}

Password Broker Customization

In Ihrer auth.php-Konfigurationsdatei können Sie mehrere Passwort-"Broker" konfigurieren, die zum Zurücksetzen von Passwörtern auf mehrere Benutzertabellen verwendet werden können. Sie können die mitgelieferten ForgotPasswordController und ResetPasswordController anpassen, um den Broker Ihrer Wahl zu verwenden, indem Sie die Broker-Methode überschreiben:

use Illuminate\Support\Facades\Password;

/**
 * Get the broker to be used during password reset.
 *
 * @return PasswordBroker
 */
public function broker()
{
    return Password::broker('name');
}

Reset Email Customization

Sie können die Benachrichtigungsklasse, mit der der Link zum Zurücksetzen des Passworts an den Benutzer gesendet wird, leicht ändern. Um zu beginnen, überschreiben Sie die sendPasswordResetNotification-Methode auf Ihrem User-Modell. Innerhalb dieser Methode können Sie die Benachrichtigung mit jeder beliebigen Benachrichtigungsklasse senden. Das Passwort reset $token ist das erste Argument, das von der Methode empfangen wird:

/**
 * Send the password reset notification.
 *
 * @param  string  $token
 * @return void
 */
public function sendPasswordResetNotification($token)
{
    $this->notify(new ResetPasswordNotification($token));
}