Skip to Content
Open Beta — managed Kubernetes, DNS & more are live.
🔐

Signing in and multi-factor authentication

Updated 2026-11-20
On this page

Signing in and multi-factor authentication

Your account is protected by a password and optional multi-factor authentication (MFA). Turning on MFA adds a one-time code to every sign-in for stronger protection.

You sign in with your email and password. If you ever forget your password, a self-service reset link is emailed to you; it expires after a short time for safety.

MFA adds a second factor on top of your password. Patrii Cloud supports a time-based one-time password (TOTP) from an authenticator app, or a code sent to your email. When you enable TOTP, you also receive backup codes to use if you lose access to your authenticator.

Screenshot — The Security section of the profile menu with the MFA toggle
The Security section of the profile menu with the MFA toggle

Key concepts

MFA — Multi-factor authentication: a second proof of identity in addition to your password.

TOTP — A time-based one-time code generated by an authenticator app, refreshed every 30 seconds.

Backup codes — One-time codes you save in advance to sign in if you lose your authenticator.

Password reset — A self-service flow that emails you a time-limited link to set a new password.

Before you start

  • A verified email address on your account.
  • For TOTP, an authenticator app on your phone or computer.

Step by step

  1. Open Security

    Open your profile menu and go to Security.

    Screenshot — The profile menu open on the Security entry
    The profile menu open on the Security entry
  2. Enable MFA

    Choose Enable MFA and select TOTP or email as the method.

  3. Enroll your authenticator

    For TOTP, scan the QR code with your authenticator app, then enter the six-digit code it shows to confirm setup.

    Screenshot — The MFA enrollment dialog showing the QR code and a field for the verification code
    The MFA enrollment dialog showing the QR code and a field for the verification code
  4. Save your backup codes
    • Copy the backup codes shown after setup.
    • Store them somewhere safe and separate from your authenticator.
  5. Sign in with MFA

    On your next sign-in, enter your password, then the one-time code to finish.

Examples

Check your MFA status (API)
curl -H "Authorization: Bearer $TOKEN" \
  https://api.patrii.cloud/mfa/status
Start a password reset (API)
curl -X POST https://api.patrii.cloud/auth/forgot-password \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com"}'

Limits & specifications

MFA options and recovery:

ItemWhat it does
TOTPOne-time codes from an authenticator app.
Email MFAA one-time code sent to your email.
Backup codesOne-time codes for recovery.
Regenerate backup codesReplace your codes if they run low or are exposed.
Disable MFATurn MFA off; requires your password.

Best practices

  • Turn on MFA, and prefer TOTP over email for the strongest protection.
  • Store your backup codes offline, separate from your phone.
  • Use a unique, strong password that you do not reuse elsewhere.
  • Regenerate your backup codes if you think they were exposed.

FAQ

I lost my authenticator device.
Sign in with one of your backup codes, then disable and re-enable MFA to enroll a new authenticator. Regenerate your backup codes afterward.
My TOTP code is rejected.
TOTP codes are time-based, so make sure your device's clock is accurate. Wait for the next code and try again.
The password reset link doesn't work.
Reset links expire after a short time and can be used once. Request a fresh link and use the newest email.

Learn more

Everything you can do here in the console is also available through the Patrii Cloud API for automation and scripting.

Was this article helpful?
Thank you for your feedback. Still stuck? Contact us