Security
On the page Security, organizers and the team decide how they sign in. This is also where they connect the fepli app to their account.
You open the page from the account menu > Security. It is a tab of My account. How signing in itself works is described under Sign-in page.
An empty section keeps its place; a line stands there instead of the list. Connected apps appears only once a fepli app is connected to the account.
Anyone signed in as somebody else (Sign in as) sees here only how the account is set up. They cannot change anything: only the account holder changes the passkeys, password, sign-in link and API tokens.
Sign-in methods
At least one method has to stay. Each row shows how the method is currently set.
| Method | State | Action |
|---|---|---|
| Passkey | Not set up, or how many passkeys there are | Set up or Manage leads to Passkeys. |
| Password | Set, or sign-in with passkey only | With a password: Change and Remove. Without a password: Set |
| Sign-in link by email | Switched on or off | Switch off or Switch on. For admins it shows off as long as your instance allows admins no sign-in link. |
| Action | Effect |
|---|---|
| Change | Asks for the current and the new password. The new one applies from the next sign-in. |
| Set | Sets a password. With it you can sign in without a passkey too. |
| Remove | Removes the password. Afterwards you sign in with a passkey. Possible only if the account has at least one passkey. |
| Switch off | Switches the sign-in link off for your account. Possible only if the account has a password or a passkey. |
A password always has at least 8 characters.
Passkeys
A passkey is a key that your device keeps for you. You sign in with it by fingerprint, face or device PIN. An account can have any number of passkeys, e.g. one each on a laptop and a phone.
The section Passkeys, in front the dialog after Add passkey.
| Element | Meaning |
|---|---|
| Without a passkey | Add passkey |
| List | For each passkey its name and since when it has existed |
| Trash can | Removes the passkey from fepli. It stays in the device's password manager until you delete it there. |
| Add passkey, Add another passkey | Opens Name passkey. |
| Name | A name by which you recognise the passkey, e.g. “work laptop”. Optional |
| Create passkey | Afterwards the device asks for fingerprint, face or PIN. |
You cannot remove the last passkey of an account without a password.
Connected apps
The fepli app on the phones in this list signs in without a password. A phone joins the list when you connect it through Connect the app or sign in within the app.
| Element | Meaning |
|---|---|
| List | For each phone its name, iOS or Android, when it was connected and when it was last used. The most recently used comes first. |
| Remove app | The app on this phone no longer signs in afterwards. |
API tokens
API tokens are keys for programs, e.g. a script or a report. A program uses one to work through fepli's interface for programs, with the same permissions as you. How programs use that interface is described in fepli developers.
The section API tokens, in front the dialog after Create token.
| Element | Meaning |
|---|---|
| Without a key | Create token |
| List | For each key its label, its beginning, when it was created, its access and until when it is valid |
| Trash can | Revokes the key. Programs that use it lose access immediately. |
| Create token | Opens the dialog Create API token. |
| Label | A name by which you recognise the key. Optional |
| Access | Read only fetches data. Read and write may also create, change and delete. Default: Read |
| Valid until | The last day on which the key is valid. Empty means unlimited. Default: empty |
| Create API token in the dialog | Creates the key and shows it with Copy. It is visible only at this moment. |
For programs that do not belong to a person, super admins manage access of their own under Settings > Integrations (Settings: Integrations).
Connect the app
Connect the app in the account menu connects the fepli app on your phone to your account. The entry is missing during Sign in as and for global admins.
| Step | What happens |
|---|---|
| Code | The dialog shows a QR code. It works for 5 minutes and only once. A new code makes the previous one invalid. |
| Comparing symbols | Once the app has read the code, the dialog shows the name of the phone and 4 emojis. They match connects the app, They don't match makes the code invalid. |
| Connected | The QR code disappears. The phone then appears under Connected apps. |
| Code no longer works | Show a new code shows a new code in the same dialog. |
| Done | Closes the dialog. |
- The dialog updates itself until the app is connected or the code no longer works.
- Only the account that created the code sees and confirms the emojis.
- On an instance with encryption, the app is a new device. It receives its keys like any new device (Connect a new device).
Messages
| Message | Meaning |
|---|---|
| “The old password is incorrect.” | Under Change, the current password is wrong. |
| “Add a passkey first” | Remove works only once the account has a passkey. |
| “Set a password or a passkey first.” | The sign-in link can be switched off only once the account has a password or passkey. |
| “Your only passkey. Without a password it cannot be removed.” | Set a password first or add another passkey. |
| “You are signed in as somebody else. Only the account holder changes its passkeys, password, sign-in link and API tokens.” | You see the page during Sign in as. |
| “The code no longer works.” | The QR code has expired, been used or been cancelled. Have a new one created with Show a new code. |
| “Too many codes in the last hour. Please try again later.” | You have created too many codes in a short time. |