Security - 4. Email Verification

Einführung

Viele Webanwendungen erfordern, dass Benutzer ihre E-Mail-Adressen vor der Verwendung der Anwendung überprüfen. Anstatt Sie zu zwingen, dies bei jeder Anwendung neu zu implementieren, bietet Laravel bequeme Methoden für das Versenden und Verifizieren von E-Mail-Verifizierungsanfragen.

Model Preparation

Überprüfen Sie zu Beginn, ob Ihr App\User-Modell den Illuminate\Contracts\Auth\MustVerifyEmail-Vertrag implementiert:

<?php

namespace App;

use Illuminate\Contracts\Auth\MustVerifyEmail;
use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Notifications\Notifiable;

class User extends Authenticatable implements MustVerifyEmail
{
    use Notifiable;

    // ...
}

more themes about Security [TaskID] - Click for open

Task

Type Table

Description

Code

Database Considerations

The Email Verification Column

Als nächstes muss Ihre User-Tabelle eine Spalte email_verified_at enthalten, in der Datum und Uhrzeit der Verifizierung der E-Mail-Adresse gespeichert werden. Standardmäßig enthält die im Laravel-Framework enthaltene Benutzertabellenmigration bereits diese Spalte. Sie müssen also nur noch Ihre Datenbank-Migrationen durchführen:

php artisan migrate

Task

Type Table

Description

<h4>Routing</h4>

Laravel enth&auml;lt die Klasse Auth\VerificationController, die die notwendige Logik zum Senden von Verifizierungslinks und zur Verifizierung von E-Mails enth&auml;lt. Um die notwendigen Routen f&uuml;r diesen Controller zu registrieren, &uuml;bergeben Sie die verify-Option an die Auth::routes-Methode:

<pre>
<code>Auth::routes([&#39;verify&#39; =&gt; true]);</code></pre>

<h5>Protecting Routes</h5>

<a href="https://laravel.creative-it.org/websites/36" title="Link to Route Middleware">Route-Middleware</a> kann verwendet werden, um nur verifizierten Benutzern den Zugriff auf eine bestimmte Route zu erm&ouml;glichen. Die Laravel wird mit einer verifizierten Middleware ausgeliefert, die unter Illuminate\Auth\Middleware\EnsureEmailIsVerified definiert ist. Da diese Middleware bereits im HTTP-Kernel Ihrer Anwendung registriert ist, m&uuml;ssen Sie die Middleware nur noch an eine Routendefinition anh&auml;ngen:

<pre>
<code>Route::get(&#39;profile&#39;, function () {
 // Only verified users may enter...
})-&gt;middleware(&#39;verified&#39;);</code></pre>

&nbsp;

Code

Routing

Laravel enthält die Klasse Auth\VerificationController, die die notwendige Logik zum Senden von Verifizierungslinks und zur Verifizierung von E-Mails enthält. Um die notwendigen Routen für diesen Controller zu registrieren, übergeben Sie die verify-Option an die Auth::routes-Methode:

Auth::routes(['verify' => true]);

Protecting Routes

Route-Middleware kann verwendet werden, um nur verifizierten Benutzern den Zugriff auf eine bestimmte Route zu ermöglichen. Die Laravel wird mit einer verifizierten Middleware ausgeliefert, die unter Illuminate\Auth\Middleware\EnsureEmailIsVerified definiert ist. Da diese Middleware bereits im HTTP-Kernel Ihrer Anwendung registriert ist, müssen Sie die Middleware nur noch an eine Routendefinition anhängen:

Route::get('profile', function () {
    // Only verified users may enter...
})->middleware('verified');

Task

Type Table

Description

Code

Views

Um alle notwendigen Ansichten für die E-Mail-Verifizierung zu erzeugen, können Sie das Paket laravel/ui Composer verwenden:

composer require laravel/ui --dev

php artisan ui vue --auth

Die E-Mail-Verifizierungsansicht wird in resources/views/auth/verify.blade.php platziert. Es steht Ihnen frei, diese Ansicht nach Bedarf für Ihre Anwendung anzupassen.

Task

Type Table

Description

Code

After Verifying Emails

Nachdem eine E-Mail-Adresse verifiziert wurde, wird der Benutzer automatisch nach /home weitergeleitet. Sie können den Ort der Umleitung nach der Verifizierung anpassen, indem Sie eine RedirectTo-Methode oder -Eigenschaft auf dem VerificationController definieren:

protected $redirectTo = '/dashboard';

Task

Type Table

Description

Code

Events

Laravel versendet Events während des E-Mail-Verifizierungsprozesses. Sie können Hörer an diese Ereignisse in Ihrem EventServiceProvider anhängen:

/**
 * The event listener mappings for the application.
 *
 * @var array
 */
protected $listen = [
    'Illuminate\Auth\Events\Verified' => [
        'App\Listeners\LogVerifiedUser',
    ],
];