Enable Mobiilivarmenne in your services
To get started with Mobiilivarmenne through E-Ident, you must have an FTN agreement with Nets. When that is in place, Nets will enable Mobiilivarmenne on your customer setup.
Note: Customers offering identification with Finnish Bank ID and Mobiilivarmenne must use the OIDC protocol with encrypted ID Token.
More information about Mobiilivarmenne:
Test users
Test users are available
here.
Information about the end user
Birth date | birthdate Requires: scope=profile | End user's birth date. |
Distinguished name |
dn Requires: scope=cert | The distinguished name from the end user's certificate. |
Family name | family_name Requires: scope=profile | End user's surname. |
SATU | fi_satu Requires: scope=ssn | Finnish unique identification number (sähköinen asiointitunnus). |
HETU (SSN) | fi_ssn / ssn Requires: scope=ssn | End user's Finnish personal identity code (henkilötunnus).
Read more about SSN handling. |
Given name | given_name Requires: scope=profile | End user's first/given name. |
Full name | name Requires: scope=profile | End user's full name |
Phone number |
phone_number Requires: scope=phone | End user's phone number. |
Handling of SSN
The social security number (SSN) of an end user can be returned if you are allowed to receive this. This will be determined upon registration. The SSN is returned as the
fi_ssn and
ssn claim.
You will always get date of birth in return if it is possible to deduct this from the information from Mobiilivarmenne. This is returned as birthdate.
User experience
The Mobiilivarmenne user dialogue does not support iframe. This means that the user's top level window must be redirected to E-Ident instead of embedding it in an iframe.
Mobiilivarmenne dialogue
Step 1 (enter phone number):
Step 2:
Preset mobile phone number
The mobile phone number can be preset by appending the presetid/login_hint parameter to the identification request. The mobile phone number can either be just phone number in this format ex. 401234567 or with the country code in this format ex. +358401234567. Read more about presetid and login_hint on the OIDC page.
Mobiilivarmenne logo
If needed, the Mobiilivarmenne logo can be downloaded here:
https://mobiilivarmenne.fi/eng/ (see bottom of page).