Settings reference¶
Everything set up once for the whole organisation lives in System › Settings. Organisation admins change every setting; organisation viewers and Compliance officers read the sections marked Read by viewers. Every change is recorded in the audit log, and Sign-in & security, Keys, VidaiGuard and Guardrails also say who set them last and when.
If someone else saves the same setting while you're editing, saving says so: choose Reload, then make your change again.
Sign-in & security¶
| Setting | What it does | Starts as |
|---|---|---|
| Multi-factor sign-in: who must use it | Not required (each person decides), Admins (organisation and group admins) or Everyone | |
| Give people until | A date until which people it applies to see a reminder; after it, signing in takes them to set it up first | No date |
| People can reset a forgotten password themselves | "Forgot your password?" emails a link. Needs email | |
| Group admins can reset passwords | For people in their teams; off, only organisation admins can |
How to: Require multi-factor sign-in and set password rules.
Single sign-on Enterprise¶
Read by viewers. Your identity provider, its groups mapped to teams and roles, the emergency admin, a test sign-in, and Off, Optional or Required. How to: Connect single sign-on.
Keys¶
| Setting | What it does | Range | Starts as |
|---|---|---|---|
| Send expiry reminders | Emails a key's holder, or an agent's owners, before a key expires | On or off | On |
| Remind this many days before | When the reminders go | Up to five numbers, 1 to 90 | 14, 3 |
| People's keys, requests a minute | The rate limit for people's keys without a limit of their own | 1 or more; blank for none | No limit |
| Agents' keys, requests a minute | The same, for agents' keys | 1 or more; blank for none | No limit |
| Longest grace after a replacement, in days | How long an old secret may keep working after its key is replaced, at most | 1 to 90 | 7 |
| Suspend keys that aren't used | Suspends a key with no call for a set time | On or off | Off |
| Suspend after this many days unused | That time | 7 to 730 | 90 suggested |
How to: Set key defaults.
Email¶
| Setting | What it does | Starts as |
|---|---|---|
| Send email | Lets Vidai email invites, reset links, reminders and alerts | |
| Mail server, port, security | Your SMTP server: STARTTLS (usually 587), TLS (usually 465) or none (only inside your own network) | |
| User name, password | If your server needs them; the password is never shown again | |
| From address, from name, reply-to address | Who emails come from | |
| Accent colour | Buttons and headings in HTML emails, as # and six hex digits | Vidai's blue |
| Default email language | For people who haven't chosen their own | |
| Logo | PNG, JPEG or GIF, up to 200 KB, sent with each HTML email | No logo |
| What Vidai sends | Your own wording for each email, per language | Vidai's wording |
How to: Set up email, Brand your emails. Every email and its placeholders: Email templates.
Email log¶
Nothing to set: what was sent, to whom, and whether it went. See Read the email log.
Defaults for everyone¶
| Setting | What it does | Range | Starts as |
|---|---|---|---|
| Organisation name | Shown beside Control room, on Home and in every email | Up to 120 characters, not blank | Given at first-run setup |
| Organisation's time zone | The zone every day, month and period is counted in: cost periods, budgets, billing locks, review dates, dashboards | Any time zone | UTC |
| Appearance, Colour vision, Contrast, Language, Time zone, Date format | What people see until they choose for themselves; their own choice always wins | Not set: each device follows its own | |
| Days a notice stays | How long a notice on Needs attention stays after anyone first saw it | 1 to 365 days | 30 |
Organisation viewers read the name and how long notices stay. How to: Name your organisation and set its time zone, Set defaults for everyone.
Rate card¶
| Setting | What it does | Starts as |
|---|---|---|
| Address, key | The rate card feed Vidai reads prices from; the key is never shown again | Not connected |
| Sync | How often prices are fetched: every hour, 6 hours, 12 hours, day or week, or off | Every day |
| Hold price changes of | How far a price may move before it waits for a decision; 0 switches holding off | 3 times |
| Default price currency | For rate-card lines published in several currencies; amounts are never converted | US dollars |
How to: Connect the rate card.
VidaiGuard Enterprise, or Guardrails on Community¶
Read by viewers and Compliance officers. On Community this section is Guardrails and holds only the first switch. On Enterprise, VidaiGuard is set up or not set up: the section's state says Not set up, calmly, until the gateway has VidaiGuard's address and a model is chosen, and pattern checks act on their own meanwhile.
| Setting | What it does | Starts as |
|---|---|---|
| Guardrails on | Off: no pattern or VidaiGuard check runs on any call, whatever the policies say | The gateway's own configuration |
| VidaiGuard checks on | VidaiGuard's checks run beside pattern checks; needs at least one model chosen | The gateway's own configuration |
| VidaiGuard models | Which of VidaiGuard's models run | |
| Strict when a check can't run | Strict refuses a call whose check couldn't run; degrade lets it through, marked partly checked. Not offered while VidaiGuard isn't set up | Degrade |
| VidaiGuard's address | Where the gateway reaches VidaiGuard; a new address is tested, then takes over at the gateway's next restart | The gateway's configuration file |
How to: Set up VidaiGuard.
Geography¶
Read by viewers. Areas (Germany is in the European Union, which is in Europe), and which area each provider location is in. Your own areas and mappings sit beside Vidai's; every change is previewed first. How to: Say where a provider runs.
Licence¶
Read by viewers. Nothing to set here: the licence key is set on the gateway by whoever runs your Vidai servers. See See your licence and edition.
Gateway¶
Read by viewers.
| Setting | What it does | Range | Starts as |
|---|---|---|---|
| Stop all AI traffic… | Stops every AI call on every gateway node until released | Off | |
| Gateway address | The gateway's address as your apps reach it, shown to everyone beside their keys | http or https, up to 2,048 characters | Not set |
| Share rate-limit counts every, in seconds | How often gateway instances share how many calls each key made; lower is tighter | 1 to 10 | The gateway's own (1 second) |
| Read new calls every, in seconds | A call shows on Request logs within this many seconds | 1 to 60 | 3 |
How to: Set the gateway address, Stop AI traffic.
Integrations¶
| Setting | What it does | Edition |
|---|---|---|
| BI push: destinations and what's sent | Data files on a schedule to S3-compatible storage, SFTP or a webhook | Enterprise |
| Event webhooks and SIEMs | What happens, as it happens, to your webhook or Splunk | Enterprise |
How to: Send events to a webhook or SIEM, Send data to your BI tools.