3 namespace BookStack\Http\Controllers\Auth;
5 use BookStack\Actions\ActivityType;
6 use BookStack\Auth\Access\LoginService;
7 use BookStack\Auth\Access\Mfa\BackupCodeService;
8 use BookStack\Auth\Access\Mfa\MfaSession;
9 use BookStack\Auth\Access\Mfa\MfaValue;
10 use BookStack\Exceptions\NotFoundException;
11 use BookStack\Http\Controllers\Controller;
13 use Illuminate\Http\Request;
14 use Illuminate\Validation\ValidationException;
16 class MfaBackupCodesController extends Controller
18 use HandlesPartialLogins;
20 protected const SETUP_SECRET_SESSION_KEY = 'mfa-setup-backup-codes';
23 * Show a view that generates and displays backup codes
25 public function generate(BackupCodeService $codeService)
27 $codes = $codeService->generateNewSet();
28 session()->put(self::SETUP_SECRET_SESSION_KEY, encrypt($codes));
30 $downloadUrl = 'data:application/octet-stream;base64,' . base64_encode(implode("\n\n", $codes));
32 return view('mfa.backup-codes-generate', [
34 'downloadUrl' => $downloadUrl,
39 * Confirm the setup of backup codes, storing them against the user.
42 public function confirm()
44 if (!session()->has(self::SETUP_SECRET_SESSION_KEY)) {
45 return response('No generated codes found in the session', 500);
48 $codes = decrypt(session()->pull(self::SETUP_SECRET_SESSION_KEY));
49 MfaValue::upsertWithValue($this->currentOrLastAttemptedUser(), MfaValue::METHOD_BACKUP_CODES, json_encode($codes));
51 $this->logActivity(ActivityType::MFA_SETUP_METHOD, 'backup-codes');
52 return redirect('/mfa/setup');
56 * Verify the MFA method submission on check.
57 * @throws NotFoundException
58 * @throws ValidationException
60 public function verify(Request $request, BackupCodeService $codeService, MfaSession $mfaSession, LoginService $loginService)
62 $user = $this->currentOrLastAttemptedUser();
63 $codes = MfaValue::getValueForUser($user, MfaValue::METHOD_BACKUP_CODES) ?? '[]';
65 $this->validate($request, [
69 function ($attribute, $value, $fail) use ($codeService, $codes) {
70 if (!$codeService->inputCodeExistsInSet($value, $codes)) {
71 $fail(trans('validation.backup_codes'));
77 $updatedCodes = $codeService->removeInputCodeFromSet($request->get('code'), $codes);
78 MfaValue::upsertWithValue($user, MfaValue::METHOD_BACKUP_CODES, $updatedCodes);
80 $mfaSession->markVerifiedForUser($user);
81 $loginService->reattemptLoginFor($user, 'mfa-backup_codes');
83 if ($codeService->countCodesInSet($updatedCodes) < 5) {
84 $this->showWarningNotification('You have less than 5 backup codes remaining, Please generate and store a new set before you run out of codes to prevent being locked out of your account.');
87 return redirect()->intended();