---
title: 'Set eID, onboarding and two-factor for a role'
description: 'How to set the eID card, onboarding steps and two-factor rules for a role.'
icon: shield-check
sidebar:
  order: 18
  label: eID & onboarding
  icon: shield-check
---

**The eID, Onboarding and Security tabs of a role set three things for everyone who holds it: the digital ID card, the invitation they receive, and whether they must use two-factor authentication.** All three are per role, so students, staff and administrators can each get their own settings.

Open a role in **Settings → Roles & Permissions** and choose the tab. You need the **Roles & Permissions** permission. Changes in these tabs are saved together with the rest of the role, with **Save** in the unsaved-changes bar.

## eID

**Settings → Roles & Permissions → (open a role) → eID** configures the eID card that people with this role see in the Fuxam mobile app. The card shows a live preview while you edit.

1. Open the role and click the **eID** tab.

2. Switch on **Enable role eID**. Without it, people with this role get no eID card.

3. Choose what the card shows, using the settings below.

4. Click **Save** in the unsaved-changes bar.

| Setting | What it does |
|---|---|
| **Show role** | Shows the person's role as text below their name. |
| **Show physical card disclaimer** | Adds a note that a physical ID card is needed for the eID to be valid. |
| **Custom disclaimer text** | An optional extra line under the disclaimer, for example an instruction for card holders. |
| **Validity** | When the eID expires: **End of current semester**, **End of next semester**, **End of year**, **End of last term user is active (re-registered)** or **Date user gets set to inactive**. The card shows **Valid until** with that date. |
| **Display Data** | Extra data lines on the card. Click **Add** and pick fields such as study program, cohort, user group or your own custom fields. Remove a line with **Remove from display**. The picker has a limit on how many lines fit on the card. |
| **Access Code** | Turns one data field into a scannable code on the card. Choose the **Data field** and the **Code type** (for example **QR-CODE**, **CODE-128** or **EAN-13**), then click **Generate**. **Regenerate code** creates a new one. |

If the data in the chosen field doesn't fit the code type, for example letters in a number-only type, an error explains what the type needs.

:::tip
Use **Access Code** for door readers, library or canteen scanners. Pick a field that is unique for each person, such as a matriculation number.
:::

## Onboarding

**Settings → Roles & Permissions → (open a role) → Onboarding** sets the invitation for this role. These settings override the institution-wide invite defaults for people with this role. If you leave them empty, the institution-level invite is used.

| Setting | What it does |
|---|---|
| **Invites Language** | The language of the invitation email. |
| **Email Subject** | The subject line. If empty, the default subject is used. |
| **Invites Text** | Your own invitation text. Until you type something, the Fuxam default text is used. |
| **Show Preview** / **Hide Preview** | Shows the email as it will be sent. |
| **Intro Video** | An intro video for people with this role. Choose either a URL or a file upload. |

1. Open the role and click the **Onboarding** tab.

2. Pick the **Invites Language** and fill in **Email Subject** and **Invites Text** if you want something different from the default.

3. Click **Show Preview** to check the email.

4. Add an **Intro Video** if you like, then click **Save**.

## Security

**Settings → Roles & Permissions → (open a role) → Security** has one switch, **Require two-factor authentication**.

When it is on, everyone with this role must set up an authenticator app before they can use the dashboard. The requirement applies immediately, but each person finishes the setup themselves the next time they visit. Only authenticator apps (TOTP) are supported, with no SMS and no backup codes.

1. Open the role and click the **Security** tab.

2. Switch on **Require two-factor authentication**.

3. Click **Save**. The message **Two-factor authentication is now required for users with this role** confirms it.

:::warning
The switch can't be turned on while **SSO Alias** is enabled for your institution. You see the message **Two-factor authentication cannot be required for a role while SSO Alias is enabled.**
:::

To require or stop two-factor for individual people instead of a whole role, see [Two-factor authentication](/docs/fuxam-web/base/user-management/two-factor-authentication).

## Common pitfalls

| Pitfall | Why it happens | How to avoid it |
|---|---|---|
| No eID card appears | **Enable role eID** is off, or the person's role has none. | Switch it on for each role that needs a card. |
| The access code shows an error | The data in the field doesn't match the code type. | Pick a code type that fits the field, for example **CODE-128** for letters and numbers. |
| People still get the default invite | The role's **Onboarding** tab is empty. | Fill in subject, text or language for this role. |
| Someone is asked to set up two-factor right away | The requirement applies immediately, and they haven't completed the setup yet. | Tell people in advance. They finish the setup on their next visit. |
| The 2FA switch fails | **SSO Alias** is on for your institution. | Turn **SSO Alias** off first, or don't require two-factor for the role. |
| The preview ignores these tabs | The **Preview** dialog only covers permissions, profile information and dashboard. | Check eID, onboarding and security on the tab itself. They still save with the header. |

## FAQ

**Where do people see their eID?**

In the Fuxam mobile app, on the eID card.

**Can I require two-factor for administrators only?**

Yes. Open the administrator role, go to **Security** and switch on **Require two-factor authentication**. Other roles are not affected.

**Do these tabs work for the Superadmin role?**

Yes. Only the **Permissions** tab is missing on the Superadmin role.

## Related topics

**[Set the profile tabs and dashboard for a role](/docs/fuxam-web/settings/role-profile-and-dashboard)**

The other tabs of a role.

**[Create, edit, copy and delete a role](/docs/fuxam-web/settings/set-up-a-role)**

The role list and the unsaved-changes bar.

**[Two-factor authentication](/docs/fuxam-web/base/user-management/two-factor-authentication)**

How people set up an authenticator app.

**[Preview what a role can access](/docs/fuxam-web/settings/preview-role-access)**

Check pages and tabs before you save.

