With itsme Identification the customer confirms who they are in the itsme app, and the customer file takes over the name, date and place of birth, gender, nationality, national register number, identity card number and validity, address and (optionally) the eID photo exactly as they are on the card. Nothing is typed, so nothing can be misspelled. It works from the Identity tab on the customer page (/students/:id) and, if allowed, from the customer portal.
How do I switch itsme on?
This is for Belgian schools only and needs an itsme partner contract. An administrator does it under Settings › Academy settings, section Identity verification:
- Switch on Verify identities with itsme.
- Choose the Environment: E2E (sandbox) for testing, Production after the go-live of your itsme contract.
- Fill in the Client ID and Service code itsme gave you.
- Choose the Authentication: Client secret (fill in Client secret) or Key pair (private_key_jwt) (click Generate key, or paste your own key in Private key (PEM)).
- Optionally switch on Also take over the eID photo and Customers can verify themselves from the customer portal, and set Validity of a verification link (days).
- Save, then register the Redirect URI and JWKS URI shown on the screen in the itsme partner portal.
- Click Test the connection to check that itsme can be reached and nothing is missing.
As long as itsme is not set up, the Identity tab does not appear on the customer page.
How do I ask a customer to confirm their identity?
- Open the customer page and the Identity tab.
- Choose one of: - Send link by e-mail: the customer receives an e-mail in their language with a link to the verification page. - Create link: for a customer at the desk. Use Show QR code and let them scan it with their phone, or Copy link to send it another way.
- The customer opens the link, clicks Continue with itsme and confirms in the itsme app.
- When they are done, planners get a notification and the tab shows the result.
A new link cancels any earlier open link. Click Withdraw to cancel an open link yourself.
How can a customer do it themselves?
When Customers can verify themselves from the customer portal is on, the customer sees Confirm with itsme on the overview page of the customer portal. The result appears in the Identity tab like any other verification.
What does the Identity tab show?
- Whether the customer is Confirmed with itsme and when, or Not confirmed yet.
- The National register number, Identity card number and Valid until date (marked expired when it has passed), and the Photo if one was taken over.
- Under Verifications, every request with When, Via (Customer portal or Link), Outcome and what Changed.
Possible outcomes: Waiting for the customer, Confirmed, Someone else's itsme, Failed, Expired, Withdrawn.
Good to know
- Someone else's itsme protects the file: when the customer file already has a national register number or date of birth and itsme returns a different one, nothing is changed. The tab only shows which fields differed ("Differs on: …"), never the other person's data.
- The identity fields (names, birth data, gender, nationality, national register number, identity card, address) are overwritten with the itsme values. E-mail and phone are only filled in when the file has none: the school's own contact details win.
- Send link by e-mail needs an e-mail address on the customer. Without one, use Create link and the QR code.
- A link sent by staff is valid for the number of days in Validity of a verification link (days) (1 to 60). A link that was used, withdrawn or expired can no longer be used; create a new one.
- If the customer cancels in the itsme app or something goes wrong, nothing is changed and the outcome is Failed. That link is then used up: create a new link, or let the customer start again from the portal.
- The eID photo is only stored when Also take over the eID photo is on.
Not possible (yet)
- Using itsme for customers who do not exist yet: a verification is always for an existing customer, and the online registration wizard does not start from itsme.
- Signing in to the customer portal or the back office with itsme.
- Other identity providers than itsme, or itsme for schools outside Belgium.
Did not find what you were looking for?
Submit a ticket