Reset Password

PandaBear menyediakan dua guest Page dengan branding Panel:

1. halaman untuk meminta reset link;
2. halaman untuk mengatur password baru.

Kedua Page menggunakan path milik Panel tetapi mengirim form ke endpoint reset password milik Fortify.

Gunakan fitur ini agar user yang lupa password tidak perlu keluar dari visual shell/branding Panel selama recovery flow.

Contoh Minimal

<?php

declare(strict_types=1);

namespace App\Panels\Admin;

use PandaPanel\Core\Panel;
use PandaPanel\Core\PanelProvider;

final class AdminPanelProvider
    extends PanelProvider
{
    public function panel(
        Panel $panel
    ): Panel {
        return $panel
            ->path('admin')
            ->auth()
            ->login()
            ->passwordReset();
    }
}

Routes:

php artisan route:list --name=panel.admin.auth.password

GET  admin/forgot-password
     panel.admin.auth.password.request

GET  admin/reset-password/{token}
     panel.admin.auth.password.reset

Login Page akan menampilkan:

Forgot your password?

API

public function passwordReset(
    bool $passwordReset = true
): self;

public function hasPasswordReset():
    bool;

Contoh:

use PandaPanel\Core\PanelManager;

$panel =
    app(PanelManager::class)
        ->get('admin');

$panel->hasPasswordReset();
// true

Tiga bagian membaca flag:

Reader	Jika false
Route registrar	Kedua Page tidak diregistrasikan
Controller Page	404
Login Page	Tidak menampilkan Forgot Password link

passwordReset() membutuhkan:

login()

Tanpa Login Page, reset Page juga tidak diregistrasikan.

Parameter boolean dapat berupa expression:

$panel->passwordReset(
    ! app()->isProduction()
);

Dua Page

Keduanya merupakan guest route:

base middleware
+
ResolvePanel

tanpa auth.

Forgot Password

public function requestPasswordReset(
    Request $request
): Response {
    abort_unless(
        $this
            ->panel()
            ->hasPasswordReset(),
        404
    );

    return Inertia::render(
        'panel/auth/ForgotPassword',
        [
            'panel' =>
                $this
                    ->panel()
                    ->toSharedArray(),

            'status' =>
                $request
                    ->session()
                    ->get(
                        'status'
                    ),
        ]
    );
}

Props:

Prop	Type	Sumber
panel	PanelDefinition	Panel shared definition
status	string|null	Fortify flash status

Reset Password

public function resetPassword(
    Request $request
): Response {
    abort_unless(
        $this
            ->panel()
            ->hasPasswordReset(),
        404
    );

    return Inertia::render(
        'panel/auth/ResetPassword',
        [
            'panel' =>
                $this
                    ->panel()
                    ->toSharedArray(),

            'email' =>
                $request
                    ->query(
                        'email'
                    ),

            'token' =>
                (string)
                $request
                    ->route(
                        'token'
                    ),

            'passwordRules' =>
                PasswordRules::attribute(),
        ]
    );
}

Props:

Prop	Type	Sumber
panel	PanelDefinition	Panel
email	string|null	Query string
token	string	Route parameter
passwordRules	string	PasswordRules::attribute()

Endpoint Form

Kedua form menggunakan Fortify melalui Wayfinder.

Forgot:

<script setup lang="ts">
import { Form } from '@inertiajs/vue3';
import { email } from '@/routes/password';
</script>

<template>
    <Form
        v-slot="{ errors, processing }"
        v-bind="email.form()"
    >
        <!-- email -->
    </Form>
</template>

Reset:

<script setup lang="ts">
import { Form } from '@inertiajs/vue3';
import { update } from '@/routes/password';
</script>

<template>
    <Form
        v-slot="{ errors, processing }"
        v-bind="update.form()"
    >
        <input
            type="hidden"
            name="token"
            :value="token"
        />

        <!--
            email,
            password,
            password_confirmation
        -->
    </Form>
</template>

Wayfinder	Request	Fortify Route
email	POST /forgot-password	password.email
update	POST /reset-password	password.update

Fortify tetap bertanggung jawab atas:

• throttle;
• token validation;
• PasswordReset event;
• session handling.

Semua Panel menggunakan endpoint yang sama.

Link Kembali ke Login

<TextLink
    :href="`/${panel.path}/login`"
>
    Back to log in
</TextLink>

Path dibangun dari Panel path agar tetap benar jika Panel dipindahkan.

Password Policy

PasswordRules menerjemahkan Laravel Password policy menjadi browser:

passwordrules

API:

public static function attribute(
    ?Illuminate\Validation\Rules\Password $password = null
): string;

Contoh:

PasswordRules::attribute();
// menggunakan Password::defaults()

PasswordRules::attribute(
    Password::min(8)
);
// minlength: 8;

PasswordRules::attribute(
    Password::min(12)
        ->mixedCase()
        ->numbers()
        ->symbols()
);
// minlength: 12;
// required: lower;
// required: upper;
// required: digit;
// required: special;

Attribute tersebut hanya memengaruhi browser password suggestion.

Validation authoritative tetap berada di Fortify ResetUserPassword.

URL pada Email Reset

Ini bagian penting.

Laravel ResetPassword Notification secara default membuat URL berdasarkan application route:

password.reset

bukan route Panel.

Jadi user yang meminta reset dari:

/admin/forgot-password

secara default dapat menerima email yang mengarah ke:

/reset-password/{token}

bukan:

/admin/reset-password/{token}

Untuk mengarahkannya ke Panel:

<?php

declare(strict_types=1);

namespace App\Providers;

use Illuminate\Auth\Notifications\ResetPassword;
use Illuminate\Support\ServiceProvider;
use PandaPanel\Core\PanelManager;

final class AppServiceProvider
    extends ServiceProvider
{
    public function boot(): void
    {
        ResetPassword::createUrlUsing(
            static function (
                object $notifiable,
                string $token
            ): string {
                $panel =
                    app(
                        PanelManager::class
                    )
                        ->get(
                            'admin'
                        );

                return route(
                    $panel
                        ->routeName(
                            'auth.password.reset'
                        ),
                    [
                        'token' =>
                            $token,

                        'email' =>
                            $notifiable
                                ->getEmailForPasswordReset(),
                    ]
                );
            }
        );
    }
}

email query parameter bukan decoration.

Reset Page membacanya dari URL dan Fortify membutuhkan email saat POST update password.

Jika application memiliki beberapa Panel, hanya ada satu ResetPassword notification callback.

Jika tujuan berbeda per account, branch berdasarkan data pada $notifiable, bukan current request karena queued mail tidak memiliki HTTP request context.

Setelah Password Reset

Fortify mengarahkan user ke configured:

password-reset redirect

yang dapat fallback ke application Login Page.

Jika ingin kembali ke Panel Login:

// config/fortify.php

'redirects' => [
    'password-reset'
        => '/admin/login',
],

Login Page Panel membaca status, sehingga success message tetap dapat ditampilkan.

Testing

Forgot Page:

$this
    ->get(
        '/admin/forgot-password'
    )
    ->assertOk()
    ->assertInertia(
        fn (
            AssertableInertia $page
        ) =>
            $page
                ->component(
                    'panel/auth/ForgotPassword'
                )
                ->where(
                    'panel.id',
                    'admin'
                )
    );

Reset Page:

$this
    ->get(
        '/admin/reset-password/the-token?email=ada@example.com'
    )
    ->assertOk()
    ->assertInertia(
        fn (
            AssertableInertia $page
        ) =>
            $page
                ->component(
                    'panel/auth/ResetPassword'
                )
                ->where(
                    'token',
                    'the-token'
                )
                ->where(
                    'email',
                    'ada@example.com'
                )
                ->has(
                    'passwordRules'
                )
    );

Panel yang tidak mengaktifkan fitur:

$this
    ->get(
        '/app/forgot-password'
    )
    ->assertNotFound();

Hal yang Perlu Diperhatikan

• Reset Page tidak memvalidasi token pada GET. Token divalidasi ketika form dikirim ke Fortify.
• Email berasal dari query string, bukan dari token.
• Reset link harus membawa token dan email.
• Fortify feature hanya mengontrol link Login; Page memeriksa Panel flag.
• Jika Fortify feature mati tetapi Panel flag hidup, Page render namun POST route tidak ada.
• canAccess() tetap berjalan pada guest Page melalui ResolvePanel.
• Guest harus diizinkan jika Panel menggunakan restrictive access callback.
• Tidak ada throttle per Panel. Semua menggunakan throttle Fortify.
• Password reset berbeda dari password change. Password change dilakukan di Security Settings.

Lihat Juga

• Login
• Registration
• Email Verification
• Fortify Integration
• Security Settings
• Panel Branding
• Wayfinder