Skip to content
Esc
↑↓navigate↵open⌘Jpreview
On this page

Set eID, onboarding and two-factor for a role

How to set the eID card, onboarding steps and two-factor rules for a role.

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.

Open the role and click the eID tab.

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

Choose what the card shows, using the settings below.

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.

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.

Open the role and click the Onboarding tab.

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

Click Show Preview to check the email.

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.

Open the role and click the Security tab.

Switch on Require two-factor authentication.

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

To require or stop two-factor for individual people instead of a whole role, see 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.

Last updated on

Was this page helpful?