Dvojfaktor a passkeys

Nastavenie faktorov počas prihlásenia popisuje časť Prihlasovacie výzvy. Táto stránka sa venuje prihlásenému účtu, ktorý spravuje vlastné faktory. Samotné ceremoniály patria balíkom two-factor-for-laravel a passkeys-for-laravel; tento balík pridáva režimy guardov, opätovné overenie, invalidáciu, udalosti a notifikácie.

Dvojfaktorové overenie (TOTP + záložné kódy)

Dostupné, ak two_factor.mode guardu nie je off:

Z PHP tie isté kroky spustí podkontext twoFactor() — odovzdajte token volajúceho $current, aby sa jeho zariadenie zachovalo a vrátil sa znovu vydaný pár:

use RoundlyConsulting\Auth\Facades\Authentication;

$twoFactor = Authentication::guard('users')->twoFactor();

$status = $twoFactor->status($user);      // enabled, pending, recoveryCodesRemaining, mode
$setup  = $twoFactor->start($user);       // show $setup->qrSvg / ->secret, store ->recoveryCodes
$tokens = $twoFactor->confirm($user, $code, $current, $context);

$codes  = $twoFactor->regenerateRecoveryCodes($user, $current, $context);   // codes, tokens
$tokens = $twoFactor->disable($user, $current, $context);

• Spustenie pri už zapnutom 2FA vráti two_factor_already_enabled (409); qr_svg je null, ak je two_factor.qr.enabled vypnuté alebo sa vykreslenie nepodarilo.
• Nesprávny alebo zastaraný potvrdzovací kód vráti invalid_code (422); vypnutie v režime required vráti two_factor_required (409).
• Potvrdenie, nové kódy aj vypnutie použijú invalidation.two_factor_changed (predvolene others): všetky ostatné relácie skončia a volajúci dostane nový pár — prejdite naň okamžite.
• Udalosti TwoFactorEnabled, TwoFactorDisabled a RecoveryCodesRegenerated; použitie záložného kódu pri prihlásení spustí RecoveryCodeUsed a pošle e-mail so zostávajúcim počtom.

Passkeys

Dostupné, ak passkeys.mode guardu nie je off:

Z PHP cez podkontext passkeys() — rename() a remove() prijímajú Passkey alebo jeho id a passkey iného účtu je PasskeyNotFound:

use RoundlyConsulting\Auth\Facades\Authentication;

$passkeys = Authentication::guard('users')->passkeys();

$options = $passkeys->registrationOptions($user);                          // ceremonyId + publicKey
$added   = $passkeys->register($user, $response, 'MacBook', $current, $context);   // passkey, tokens

$passkeys->all($user);                                                     // newest first
$passkeys->rename($user, $passkeyId, 'Work laptop');                       // a Passkey or its id
$tokens = $passkeys->remove($user, $passkeyId, $current, $context);

• Neúspešná attestation vráti passkey_registration_failed (422); názvy sa sanitizujú.
• Odstránenie posledného passkey sa odmietne s last_credential (409), ak by účet nemal inú cestu dnu alebo guard passkeys vyžaduje.
• Registrácia aj odstránenie použijú invalidation.passkey_changed (predvolene none, takže tokens je null) a spustia PasskeyAdded / PasskeyRemoved.

Ako sa režimy kombinujú pri prihlásení