Notifikácie

Všetky notifikácie dedia od AuthenticationNotification a posielajú sa e-mailom. Pre guard ich nahradíte cez notifications.classes.<type> (podtrieda AuthenticationNotification), alebo nastavením na null vypnete:

Upozornenia na riziko

Reakcie na riziko majú vlastné e-maily. deny pošle SignInBlockedNotification (sign_in_blocked) — nikto sa neprihlásil; notify pošle po dokončení prihlásenia UnusualSignInNotification (unusual_sign_in) — jeho relácia je aktívna. Ani jeden netvrdí, že bola nejaká relácia odhlásená: SuspiciousSessionNotification (refresh_token_reuse) sa týka len opätovného použitia refresh tokenu, preto upozornenia na riziko upravíte či vypnete cez sign_in_blocked a unusual_sign_in. Oba sa odošlú vždy, keď risk.assessor guardu vráti úroveň s reakciou deny alebo notify (viď Aktivita a riziko). Publikovaná konfigurácia, ktorá je staršia a ich kľúče v notifications.classes nemá, ich posiela tiež; nastavením kľúča na null jeden vypnete:

'guards' => [
    'users' => [
        'model' => App\Models\User::class,
        'risk' => [
            'assessor' => NewDeviceRisk::class,
            'reactions' => ['elevated' => 'notify', 'high' => 'deny'],
        ],
        'notifications' => [
            'classes' => [
                'sign_in_blocked' => App\Notifications\SignInBlocked::class,   // extends AuthenticationNotification
                'unusual_sign_in' => null,                                        // null switches it off
            ],
        ],
    ],
],

Keď zasiahol administrátor

Štyri typy môže cez kód hostiteľa spôsobiť niekto iný než účet: password_changed (passwords()->set()), two_factor_disabled (twoFactor()->disable()), passkey_removed (passkeys()->remove()) a account_locked (lock()) — NotificationType::actorAware() vráti true práve pre ne. Ak administrátora odovzdáte ako actor:, platí:

• NotificationData::$actor obsahuje ActorData — morph typ a kľúč actora, nikdy model, pretože šifrovaný doručovací job notifikáciu serializuje a atribúty administrátora (hash hesla, 2FA tajomstvo) nepatria do úložiska fronty ani do failed_jobs. ActorData::fromModel() ho vytvorí (neuložený model vyhodí InvalidArgumentException), is($model) porovná a resolve() model znova načíta — null, ak už neexistuje.
• toMail() vezme predmet, úvod a záver z notifications.<type>.by_actor.*; riadky s tlačidlom, kódom a platnosťou zostanú. Text hovorí o „administrátorovi“ a actora nikdy nemenuje.
• Udalosť (PasswordChanged, TwoFactorDisabled, PasskeyRemoved, AccountLocked) nesie model actora ako actor.

Samotný účet sa za actora nepovažuje, takže vlastné toky používateľa, HTTP endpointy aj automatické uzamknutie posielajú vždy základný text; bez actor: sa nič nemení a ostatné typy actora ignorujú. Nové riadky balík dodáva v angličtine a slovenčine:

Hostiteľ, ktorý preklady publikoval ešte pred pridaním týchto kľúčov, ich dostane tiež — Laravel publikovaný súbor zlúči s riadkami balíka; jazyk, ktorý balík nedodáva, sa pre ne vráti k app.fallback_locale, kým ich nedoplníte. Ak ich chcete sformulovať inak, prepíšte authentication::notifications.<type>.by_actor.* v publikovaných prekladoch. Ak má e-mail actora pomenovať, nahraďte triedu (notifications.classes.password_changed) a actora načítajte:

use Illuminate\Notifications\Messages\MailMessage;
use RoundlyConsulting\Auth\Notifications\PasswordChangedNotification;

final class NamedPasswordChangedNotification extends PasswordChangedNotification
{
    public function toMail(object $notifiable): MailMessage
    {
        $mail = parent::toMail($notifiable);
        $admin = $this->data->actor?->resolve();   // null without an actor, or when it was deleted

        return $admin === null ? $mail : $mail->line(__('Changed by :name.', ['name' => $admin->name]));
    }
}

Doručovanie

• after_response (predvolené) — odpoveď pre známy účet nie je merateľne pomalšia než pre neznámy.
• queue — cez šifrovaný job (ShouldBeEncrypted) na notifications.connection / queue, takže odkaz ani kód nikdy neležia čitateľné vo fronte.
• sync — priamo, na vývoj.

Odkazy

Odkazy v e-mailoch sa skladajú len z konfigurácie (žiadne presmerovanie od klienta) so zástupnými symbolmi {frontend}, {app}, {guard}, {email} a {token}. Predvolene je tajomstvo vo fragmente URL (#token=…), takže sa nikdy nedostane do logu servera ani do hlavičky Referer — frontend prečíta location.hash a token pošle POST požiadavkou. Mail driver log mimo vývoja nepoužívajte.

'guards' => [
    'users' => [
        'model' => App\Models\User::class,
        'notifications' => [
            'delivery' => 'queue',       // sync|after_response|queue
            'queue' => 'mail',
            'classes' => [
                'magic_link' => App\Notifications\MagicLink::class,   // extends AuthenticationNotification
                'new_device' => null,                                  // null disables it
            ],
            'frontend_url' => 'https://app.example.com',
            'urls' => [
                'magic_link' => '{frontend}/auth/magic-link?guard={guard}#token={token}',
            ],
        ],
    ],
],

Texty a jazyk

Texty sú v authentication::notifications.* a balík ich dodáva v angličtine a slovenčine (en, sk); ostatné jazyky sa vrátia k app.fallback_locale, kým ich nedoplníte do lang/vendor/authentication/<locale>/. Na úpravu či doplnenie textov publikujte preklady. Účty dostávajú e-maily vo svojom jazyku cez preferredLocale():

php artisan vendor:publish --tag=authentication-translations

Riadok o platnosti sa vykresľuje cez trans_choice() podľa zostávajúcich minút, takže má tvary množného čísla (publikovaná úprava bez | funguje naďalej), a :reason pri opätovnom použití refresh tokenu sa vykreslí z notifications.refresh_token_reuse.reasons.* v jazyku e-mailu.