Vykreslenie QR kódu

Tento balík nikdy nevykresľuje QR obrázok — odovzdá vám $setup->provisioningUri. Vykreslite ho tam, kde to vášmu stacku vyhovuje; samotný two-factor neobsahuje žiadnu knižnicu na obrázky.

Na serveri (SVG)

Nainštalujte náš natívny qr-for-laravel — len voliteľné odporúčanie, tento balík ho nikdy neinštaluje — a URI vykreslíte jedným volaním:

composer require roundly-consulting/qr-for-laravel

use RoundlyConsulting\Qr\Enums\ErrorCorrection;
use RoundlyConsulting\Qr\Facades\Qr;

$setup = TwoFactor::for($user)->start();

$svg = Qr::otpauth($setup->provisioningUri)
    ->size(240)
    ->errorCorrection(ErrorCorrection::Medium)
    ->title(__('Scan with your authenticator app'))
    ->svg();

// Blade:       {{ $svg }}  — renders the SVG markup; show {{ $setup->issuer }} next to it
// JSON API:    ['qr' => $svg->toDataUri(), 'issuer' => $setup->issuer]
// Controller:  return $svg;  — an image/svg+xml response
// Raw markup:  $svg->toString()

Qr::otpauth() zakóduje URI bez zmeny a zaobchádza s ním ako s tajomstvom: nikdy ho neukladá do pamäte ani cache, odosiela ho s Cache-Control: no-store a bez ETagu. QR kód nesie tajný kľúč TOTP — zobrazte ho len na obrazovke aktivácie; SVG nikdy neukladajte, nezapisujte do logov ani neposielajte e-mailom.

Vo frontende

Odovzdajte $setup->provisioningUri frontendu a vykreslite ho tam (napr. qrcode.js, react-qr-code). Pošlite ho v tej istej autentifikovanej odpovedi ako zvyšok obrazovky aktivácie a po potvrdení aktivácie ho neuchovávajte.