Your profile
Every user manages their own account under Profile settings: open the menu under your name in the top bar and select Profile settings. No permission is needed. The page has five cards.
Profile details
| Field | Notes |
|---|---|
| Profile photo | Upload a PNG or JPEG, or Remove to go back to the generated avatar. Saved as soon as it uploads |
| Shown for reference; it cannot be changed | |
| Name | Letters and spaces only, 2 to 64 characters |
| Phone | Free text |
| Location, Job title | Letters, digits, spaces and - . , _ + ', up to 128 characters |
| Language | English is the only option |
Select Save changes to keep the text fields, or Cancel to discard them.
The photo is accepted up to 5 MB by default (a deployment can change it) and at most 4096 pixels per side; the card's hint says 2 MB. The image is re-encoded as PNG when it is stored.
Password
Enter your Current password, the new password and Repeat password, then select Change password. The new password must meet the password policy.
Changing your password signs you out of every other session (other browsers, other devices). The session you are using carries on. Your API tokens keep working.
Two-factor authentication
Two-factor authentication adds a six-digit code from an authenticator app to every sign-in.
Setting it up
- Select Set up MFA.
- Scan the QR code with your authenticator app.
- Enter your Current password and the Verification code the app shows.
Once confirmed, the card shows Enabled and every other session you had is signed out.
Turning it off
Select Turn off, enter your Current password and a current Verification code, then Turn off MFA. Sign-in will need only your password afterwards, and your other sessions are signed out.
If an administrator requires MFA on your account, the card says so and offers no Turn off button. To move to a new phone, turn the factor off and set it up again. If you have lost your authenticator, ask an administrator to reset your MFA.
Wrong codes and wrong passwords on this card count towards the MFA lockout (5 attempts, then 15 minutes by default), see Account security.
API tokens
A personal API token lets a script or an integration call the
Velum Edge API as you, with exactly your permissions. It is
sent as an Authorization: Bearer header; see
API authentication.
Creating a token
- Select Create token.
- Give it a Name that says what it is for (1 to 100 characters).
- Choose Expires in: 30 days, 90 days (preselected), 180 days or 1 year.
- Select Create token.
- Copy the token from Copy your new token and store it where your script reads its secrets, then select Done.
The server keeps only a hash of the token. Once you close the dialog it cannot be shown again. If it is lost, revoke it and create another.
Tokens start with le_. The list shows, for each token, its name, its first
characters, when it was created, when it expires (or Expired) and when it was
last used. Last use is recorded at most once a minute by default.
Limits
| Limit | Default | Setting |
|---|---|---|
| Longest lifetime | 365 days | platformConstants.apiTokenMaxDays |
| Usable tokens per user | 20 (expired and revoked tokens do not count) | platformConstants.apiTokensPerUser |
There is no token that never expires.
Revoking a token
Select the bin icon next to the token, then Revoke token. Anything using it fails from its next request. A revoked token cannot be restored; create a new one instead. Expired tokens stay in the list until you revoke them, so you can tell which script stopped working.
What a token can and cannot do
- It acts as you: every permission and module check is the same as for your signed-in session. If your roles change, the token's access changes with them.
- It stops working while your account is blocked, and for good when your account is deleted.
- It is not revoked when you change your password or turn MFA on or off. Revoke tokens yourself after a suspected compromise.
- It cannot list, create or revoke tokens: managing tokens needs a signed-in session in the console.
Color theme
Choose System (follows your operating system's setting), Light or Dark. The choice applies straight away and is remembered in this browser only; it does not follow you to another browser or device.