# Set up two-factor authentication

> Protect your qutee account with a code from an authenticator app, manage trusted devices and, as an admin, set the rules.

Source: https://docs.qutee.ai/en/einstellungen/zwei-faktor-authentifizierung/

With two-factor authentication (2FA), you need a 6-digit code in addition to your password when you sign in. The code comes from an authenticator app on your smartphone. That way, nobody who only knows your password can get into your account.

## Before you start

- You have an authenticator app on your smartphone, for example Google Authenticator, Microsoft Authenticator or a similar app.
- You know your qutee password. The app asks for it again for security.
- Your company allows 2FA. If it's turned off, **My details** shows "Not available for your organization".

## Set up an authenticator app

1. In the sidebar, click your name and choose **My details** under **Manage account**.
2. In the **Two-factor authentication** section, click **Set up**.
3. If the app asks for your password, enter it and click **Confirm password**.
4. Scan the QR code with your authenticator app. If you can't scan it, copy the key under **Manual setup key** with **Copy key** and enter it in the authenticator app.
5. Enter the 6-digit code from the authenticator app under **Authentication code**.
6. Click **Activate**.

> **Caution:** Don't reload the page during setup. Otherwise a QR code you've already scanned becomes invalid, and you have to scan the new code.

If your company requires 2FA, you land on **Set up two-factor authentication** automatically after signing in and go through the same steps before you can use the app.

## Sign in with 2FA

1. Sign in as usual with your email address and password.
2. Open your authenticator app and enter the current 6-digit code.
3. Optional: Tick **Remember this device for … days**. The app then doesn't ask for the code in this browser for that period. Your company sets how many days that is.
4. Click **Verify**.

### Code by email instead of an authenticator app

If your company allows an email code as an alternative, you can click **Send a code by email instead** when signing in. The code goes to your confirmed email address and is only valid for a short time. Click **Send a new code** to request a new one. If you haven't set up an authenticator app, the app sends the email code automatically.

## Manage trusted devices

Under **My details** > **Two-factor authentication**, the **Trusted devices** area lists all browsers you've chosen to remember, with **Last used**, **Expires** and **IP address**. The browser you're currently using is marked **This device**.

- **Remove** in a row makes that browser ask for a code again at the next sign-in.
- **Remove all** does this for all remembered browsers. That's useful if you've lost a device.

## New smartphone or lost app

- **You can still get into the app**: Open **My details** and click **Reset 2FA**. Confirm with your password and then set up the authenticator app again on the new smartphone.
- **You can no longer get into the app**: Ask a **Company Admin** to choose **Reset authenticator app** in your row under **Users**. You then set up the app again at your next sign-in.

If 2FA is optional at your company, you can also turn it off again under **My details** with **Remove**.

## For admins: set 2FA for the whole company

As a **Company Admin**, you set the rules that apply to everyone in your company under **Manage account** > **Customer settings** in the **Security** section.

| Setting | What it does |
| --- | --- |
| **Allow two-factor authentication** | If unticked, nobody can set up 2FA, and the other settings are locked. Default: on. |
| **Require two-factor authentication** | Everyone must complete a second step before using the app. Anyone who doesn't have an authenticator app yet sets it up at their next sign-in. Default: off. |
| **Allow email code as an alternative** | Only with required 2FA. A code sent to the confirmed email address is then enough instead of the authenticator app. Default: off. |
| **Require authentication code** | Only with required 2FA. How often a code is needed: **Every sign-in**, **At least every 7 days**, **At least every 14 days** or **At least every 30 days**. This also sets how long a browser can be remembered. |

After making changes, click **Save** at the bottom of the page.

> **Note:** An email code is less secure than an authenticator app: anyone with access to the mailbox can often reset the password too. Only allow the alternative if an authenticator app isn't workable for your team.

If you turn the requirement off again, authenticator apps already set up stay active. These people keep signing in with a code until they remove 2FA themselves.

## Check that it works

Under **My details**, the **Two-factor authentication** section shows the status **Active** or **Active (required by your organization)**. Sign out and back in as a test: the app asks for the code.

## Common problems

**"That code is incorrect."**: Check that you're using the code from the right entry in the authenticator app and that the time on your smartphone is set automatically.

**"This account already has an authenticator app set up."**: First reset the existing app with **Reset 2FA**, or ask a **Company Admin** to do it.

**No email code arrived**: Check your spam folder and request a new one with **Send a new code**. After too many requests, you have to wait a moment.

## Next steps

- [Manage users and roles](https://docs.qutee.ai/en/einstellungen/benutzer-und-rollen/)
- [Accept your invite and sign in](https://docs.qutee.ai/en/erste-schritte/einladung-annehmen/)
- [Limits and security](https://docs.qutee.ai/en/einstellungen/limits-und-sicherheit/)
