Overview
Alvys uses multi-factor authentication (MFA), also called two-factor authentication or 2FA, to add a second layer of protection to your account. In addition to your password, MFA requires you to verify your identity using something you have: a code from an authenticator app, an SMS text message, or a hardware security key. MFA is enforced for all users. You will be prompted to set it up when you sign in if it has not yet been configured on your account. Setting up more than one method is strongly recommended so you always have a backup if one method becomes unavailable.Prerequisites
- You must have an active Alvys account.
- To use an authenticator app, download one before starting: Google Authenticator, Microsoft Authenticator, Authy, 1Password, or any TOTP-compatible app.
- To use SMS, confirm your country is in the supported list in the FAQs section below.
- To use a security key, have your FIDO2/WebAuthn hardware device (such as a YubiKey or Feitian key) ready.
Steps
- Go to the Alvys sign-in screen and enter your username and password.
- After signing in, Alvys will prompt you to set up MFA if it has not been configured. You will be asked to choose at least one verification method.
MFA setup prompt screen shown after sign-in, displaying the three method options - Select one of the three available methods: Authenticator App, Phone (SMS), or Security Key.
Screen showing the method selection step with Authenticator App, Phone (SMS), and Security Key options - Follow the steps for your chosen method below.
Option A — Authenticator app (recommended)
- Select Authenticator App when prompted.
- Open your authenticator app on your phone.
- Scan the QR code displayed in Alvys. If your app does not support scanning, enter the code manually instead.
- Your app will begin generating a 6-digit code that refreshes every 30 seconds.
- Enter the current 6-digit code in Alvys to complete setup.
- On future sign-ins, open your authenticator app and enter the current code when prompted.
QR code scan screen shown during authenticator app setup in Alvys.
Option B — Phone (SMS)
- Select Phone (SMS) when prompted.
- Enter your mobile phone number including the country code.
- Alvys will send a 6-digit code to that number via text message.
- Enter the code in Alvys to complete setup.
Option C — Security key
- Select Security Key when prompted.
- Insert or tap your FIDO2/WebAuthn hardware key (such as a YubiKey or Feitian device).
- Follow the on-screen instructions to register the key.
- On future sign-ins, insert or tap your key when prompted to verify your identity.
Locked out? Lost or changed your phone or device
If you can no longer sign in because you lost your phone, switched to a new device, or can no longer access the number that receives your SMS codes, ask an Admin to reset your MFA from Settings → Organization → Users. If you are a Partner Admin, contact Alvys Support instead.- Contact an Admin on your account and ask them to reset your MFA.
- The Admin opens Settings → Organization → Users, finds your account, and clicks Reset MFA.
- Once the Admin confirms the reset, sign in with your username and password.
- When prompted, set up a new MFA method (Authenticator App recommended). See Steps above.
Troubleshooting
SMS code not received
- Confirm your country is in the supported list (see FAQs below). SMS is not available in all countries.
- Verify you have mobile coverage and that the phone number you entered is correct.
- Click Resend Code on the Alvys screen to request a new code.
- If the issue continues after resending, some carriers delay delivery. Switch to an authenticator app instead, as it does not rely on mobile coverage.
Authenticator app code not accepted
- Check that your phone’s date and time are set to automatic. Authenticator apps require accurate time synchronization; a time drift of more than 30 seconds will produce codes that fail.
- If the time is correct and codes still fail, remove your Alvys account from the authenticator app and add it again using a new QR code from Alvys.
Cannot sign in after losing phone or key
- Try any other MFA method you have configured on your account.
- If you cannot access any configured method, contact an Admin on your account — they can reset your MFA from Settings → Organization → Users. If the reset doesn’t resolve the issue, or if you are a Partner Admin, contact Alvys Support at support@alvys.com.