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.
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
- Open Security
Open your profile menu and go to Security.
Screenshot — The profile menu open on the Security entryThe profile menu open on the Security entry - Enable MFA
Choose Enable MFA and select TOTP or email as the method.
- 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 codeThe MFA enrollment dialog showing the QR code and a field for the verification code - Save your backup codes
- Copy the backup codes shown after setup.
- Store them somewhere safe and separate from your authenticator.
- Sign in with MFA
On your next sign-in, enter your password, then the one-time code to finish.
Examples
curl -H "Authorization: Bearer $TOKEN" \ https://api.patrii.cloud/mfa/status
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:
| Item | What it does |
|---|---|
TOTP | One-time codes from an authenticator app. |
Email MFA | A one-time code sent to your email. |
Backup codes | One-time codes for recovery. |
Regenerate backup codes | Replace your codes if they run low or are exposed. |
Disable MFA | Turn 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.
My TOTP code is rejected.
The password reset link doesn't work.
Learn more
Everything you can do here in the console is also available through the Patrii Cloud API for automation and scripting.