Certificate on the device
If a certificate is stored on the Android device, TheFlex uses it to log in as soon as the server asks for it. The user does not have to do anything: no user name, no password, no card.
This fits when each device has one login: because the device belongs to one person, or because one functional user per device is enough, for example on a fixed terminal. If several employees share a device and everyone should work under their own name, login with smartcard is the better way. The comparison is shown in the overview.
Whoever has the device is logged in
The certificate replaces the password. Anyone who picks up the device is logged in with it. So protect the devices with a screen lock or run them in kiosk mode, and treat a lost device like a lost password.
How it works
Whose name is on the booking?
The certificate belongs to a user in the system. Everything that happens on the device runs under this user:
| Device | Certificate of | Consequence |
|---|---|---|
| Belongs to one person | that person | Every booking carries their name, just like with a password login |
| Is shared or permanently installed | a functional user, e.g. FORKLIFT03 in SAP | All bookings run under this user. The system does not show who made them, and everyone at the device has the same permissions |
If it must be traceable who made a booking, or if employees need different permissions, use login with smartcard for shared devices.
Setup at a glance
Usually there is nothing to configure in TheFlex itself: certificate login is switched on out of the box.
Getting the certificate onto the device
The certificate gets onto the device in one of three ways:
| Way | Suitable for | How |
|---|---|---|
| Via MDM (recommended) | Many devices | The MDM puts the certificate into the Android certificate store, as a certificate profile or via SCEP, and allows TheFlex to access it. You tell TheFlex the name of the certificate (alias) with FlxClientCertAlias |
| Import into TheFlex | Individual devices without MDM | Settings > Login > Certificate login > Certificate from file, select a .p12 or .pfx file and enter its password. Android 6 or higher |
| Android settings | Tests, individual devices | Install the certificate in the Android settings. Android requires a screen lock with PIN, pattern or password for this |

A certificate imported into TheFlex is stored encrypted in Android's protected key store. It is not included when the settings are exported.
What is the alias?
The alias is the name under which a certificate is stored in the Android certificate store, for example forklift03. You define it in the certificate profile of your MDM. For manually installed certificates, it is shown in the Android settings under the user credentials. Where exactly depends on the Android version.
Does TheFlex ask for the certificate?
- Via MDM with alias and access granted: never. Login happens without any prompt.
- Otherwise: at the first login to a server, Android shows a selection of certificates once. TheFlex remembers the choice for this server.
- Imported into TheFlex: never, TheFlex always uses the imported certificate.
Test
- On the device, open SAP or the Entra ID login page in TheFlex.
- Logged in without a login screen? Then everything is set up.
- To double-check, see which user is logged in, in the Fiori launchpad for example via the user icon in the top right corner.
If something does not work, see Troubleshooting.
Settings in TheFlex
Under Settings > Login > Certificate login:

| Setting | Meaning |
|---|---|
| Enable certificate selection at login | Use certificates from the Android certificate store. Switched on out of the box. Only applies if smartcard login is off |
| Predefine certificate (alias) | Alias of the certificate that applies to all servers. Leave empty for automatic selection |
| Certificate from file | Import, replace or remove a .p12 or .pfx file |
| Reset certificate selection | Delete the remembered choice per server. You will be asked again at the next login |
Setting it up via MDM
| Key | Type | Default | Value |
|---|---|---|---|
FlxCertChooser | bool | true | Use certificates from the Android certificate store |
FlxClientCertAlias | string | empty | Alias of the certificate TheFlex should use without asking |
FlxUseSmartcard | bool | false | Must stay off, otherwise TheFlex asks for a smartcard |
How to distribute values via MDM is shown in the example for Microsoft Intune.
Day to day
- Certificate expires: from 14 days before expiry, TheFlex shows a notice with the date at login. Distribute a new certificate in good time. After expiry, the server rejects the old one.
- Device lost: revoke the device certificate or lock the mapped user, as with a lost password.
- Device changes owner: remove or replace the certificate via MDM and delete the remembered choice with Reset certificate selection.
Troubleshooting
| Message or behavior | Cause | Solution |
|---|---|---|
| The server requests a client certificate, but certificate login is disabled. | Enable certificate selection at login is off and no certificate is imported | Switch the setting on (FlxCertChooser) or import a certificate |
| No certificate selected - the server requires a client certificate to log in. | Nothing was selected, or there is no suitable certificate on the device | Install or select the certificate, reload the page |
| The imported certificate could not be used - please import it again. | Imported file no longer readable, e.g. after a restore onto another device | Import the certificate again |
| Import failed: wrong password. | Wrong password for the .p12 file | Import again with the correct password |
| The wrong certificate is always used | Remembered choice or fixed alias does not match | Reset certificate selection or check FlxClientCertAlias |
| TheFlex asks for a smartcard instead of using the certificate | Smartcard login is switched on | Switch off FlxUseSmartcard or Enable smart card usage |
| The certificate is used, but the server still shows the login screen | Certificate not mapped to a user | Set up SAP or Set up Entra ID |
Which certificate does TheFlex use?
If there are several options, TheFlex decides in this order:
- Smartcard, if smartcard login is switched on. All other ways are off then.
- Certificate imported into TheFlex.
- Certificate from the Android certificate store: predefined alias, otherwise the remembered choice, otherwise the selection dialog.