Operator & Administrator Guide

How to use Vaultris

Vaultris brokers and records privileged access to servers, desktops, web consoles and network devices. Nobody connects to a target directly — every session goes through the gateway, which injects the credential, records what happens, and seals the recording into an append-only ledger.

01Getting started

Sign in with your username and password, then the six-digit code from your authenticator app. Multi-factor is required — there is no way to turn it off for an individual account.

Your first sign-in forces a password change and walks you through enrolling MFA. After that you land on the workspace matching your role: operators see My Access, administrators land on the Admin dashboard.

The Vaultris administrator dashboard
The administrator dashboard: credentials held, privilege exposure, session volume and evidence integrity at a glance.

The four buttons at the top left switch workspace:

WorkspaceWhat lives there
My AccessQuick Connect, your sessions, your access requests
AdminUsers, groups, assets, accounts, authorizations
VaultStored credentials and credential risk
AuditThe ledger, session history and reports

02Connecting to a target

Quick Connect lists everything you are cleared to reach. If a machine is not here, you have not been granted it — that is the whole list.

Quick Connect asset list
Quick Connect. Filter by name, platform or region; the button on the right says which kind of session you will get.
  1. Find the target. Use the filter box, the platform chips, or the region selector.
  2. Check the Signs in as column — that is the account Vaultris will use. An amber privileged tag means it has full administrative rights on the target.
  3. Click Connect. The session opens in the browser; nothing is installed and you never see the password.
ButtonWhat opens
Connect · TerminalAn SSH shell in the browser
Connect · DesktopAn RDP desktop in the browser
Connect · BrowserA throwaway browser on the gateway, pointed at the target's web console and filmed
FilesSFTP transfer, if your grant allows it
You never learn the password. Vaultris holds the credential encrypted and injects it into the session. That is deliberate: an operator who does not know a password cannot reuse it, write it down, or take it with them when they leave.

SSH from your own terminal

If you prefer a real terminal to the browser one, the gateway also speaks SSH:

ssh -p 2200 yourname@gateway.example.com

You get a menu of the same targets. The session is brokered and recorded exactly as it is in the browser.

03Sessions and playback

Every session ever brokered appears here, live ones included. Administrators see all sessions; operators see their own.

Session history
Session history, filterable by protocol and outcome. Each row shows who, what, how long, and how much evidence was captured.

Replaying a session

Replay reconstructs the session as it happened.

Session typeWhat playback shows
Terminal (SSH)The full scrollback, replayed at recorded speed with a scrubber. Every keystroke and every line of output.
Desktop (RDP)The screen as the operator saw it, with mouse movement and window activity.
BrowserThe recorded browser session, filmed on the gateway.

Commands, next to Replay on terminal sessions, lists every command that was run with its risk score — quicker than watching a replay when you only need to know what was typed.

Evidence integrity. Every recording is sealed with a SHA-256 digest at close, and the digest goes into a hash-chained ledger. The replay header shows verified — digest matches when the file is byte-for-byte what was recorded. If it ever says otherwise, the recording has been altered since.

04Requesting access

Some targets require an approver to agree before a session can open. When you click Connect on one, Vaultris asks why you need it rather than simply refusing.

Approvals queue
The approvals queue. Operators see their own requests; administrators see everything waiting on a decision.

Declaring intent

You pick a reason, and the reason carries its own time limit:

ReasonMaximumWhen to use it
Troubleshooting120 minSomething is broken and you are diagnosing it
Planned maintenance240 minScheduled work in a known window
Deployment120 minShipping a change
Investigation120 minLooking at data or behaviour, changing nothing
Customer support60 minActing on a customer report
Emergency30 minProduction is down and it cannot wait

Write a real reason. It is what the approver decides on, and it is recorded in the ledger against your name permanently.

What an approver grants

Approving is not a simple yes. The approver ticks exactly what the session may do — file upload, file download, clipboard — and sets the duration. Anything not ticked is not granted, even if your underlying permission would normally allow it.

  • An approval is single use. It covers the session it was granted for, not every session until it expires.
  • It expires on the clock the approver set.
  • Nobody can approve their own request.

05Adding people

Creating an account

Go to Admin › Users › Add user. Only a username and a bootstrap password are required; everything else can be filled in later.

FieldWhat it does
UsernameFixed once created — sessions and the audit ledger reference it, so it can never be renamed
Bootstrap passwordOne-time. They are forced to replace it at first sign-in
Email them the passwordOff by default. A password in an inbox gets archived, forwarded and occasionally breached — hand it over another way unless you have a reason
AdministratorFull access to every page and every asset. Grant it sparingly
GroupsWhat they can actually reach. An account in no group can sign in and see nothing

Multi-factor is not optional. Whoever you create will enrol an authenticator at first sign-in and cannot skip it.

Access comes from groups, not from the account. Creating a user grants nothing on its own. Add them to a group that already has an authorization, or nothing will be reachable.

Giving access for a limited time

There are three separate time limits, and they answer different questions. Setting the wrong one is the usual reason access does not expire when somebody expected it to.

WhereLimitsUse it when
On the user account
(Add or edit user)
When the account may sign in at allA contractor for one week, a visitor for 24 hours, a new starter from Monday
On group membership
(Groups page)
How long they stay in that groupThey keep their account but should drop out of one team’s access
On the authorization
(Authorizations page)
How long that grant is valid, for everyone it coversA project that ends, a temporary change window

On the account, choose one of three shapes:

  • No time limit — a permanent member of staff. The default.
  • One-off window — pick a start and an end. “From now, for 24 hours” is a single click.
  • A recurring pattern — for example Monday to Friday, working hours, enforced by a login rule under ACLs.
Every limit is enforced on each request, not only at sign-in. When a window closes, an operator who is already signed in is stopped at their next action — they do not keep working until the tab is closed.

When the invitation does not arrive

Open the user and choose Resend invitation. If the original password was never received, use Resend with a new password — the old one cannot be read back, only replaced.

If they have lost their authenticator, use Reset MFA on the users list; they enrol a new one at their next sign-in.

06Groups and authorizations

Access is granted to groups, never to a person directly. A person gets access by being a member of a group that has been granted something.

Groups page
Pick a group on the left; its members and everything it can reach are on the right. Click a name to move it between the two lists.

An authorization answers four questions at once: who it is for, what they may reach, which account they sign in as, and what they may do there.

Authorizations list
Every grant in one list. Search it, filter by group or state, or narrow to grants the policy checker has flagged. Click any row to open it.
Read the flags. A grant marked high risk reaches wider than it needs to — usually because it grants all accounts on its targets, so any credential vaulted there in future is handed over silently. reaches nothing means the opposite: the grant names a protocol none of its targets offer, so it looks permissive but grants nothing at all.

07Assets and regions

An asset is a thing you connect to. Each carries its address, its platform, the protocols it offers, and the accounts Vaultris holds for it.

Asset inventory
The asset inventory. Reachable by shows which groups can get to each one — an asset nobody can reach never appears in Quick Connect.

Assets can be filed under a region, which lets you filter both the catalogue and every report to one location.

08The Vault

The Vault workspace reports on every credential the gateway holds and how exposed each one is. Secrets are write-only: the gateway injects them into sessions, but no path returns one — not even to an administrator.

Vault overview with privilege exposure and asset coverage
The Vault overview: privilege exposure, asset coverage, and every asset reached with a privileged account — named.

Risk detection reads the vault's own records and ranks what it finds. It never reads a secret back, so there is no password-strength check — the checks are about hygiene the metadata can prove:

CheckWhat it catches
Stale privilegedA full-admin secret that has never been rotated
No secret storedAn account the gateway cannot inject — every session attempt will fail
Widely grantedA credential reachable by more people than it needs to be
DormantA credential nobody has used in months
Vault risk detection findings ranked by severity
Risk detection: findings ranked high to low, each naming the account and asset it concerns.
Note Rotating a secret here replaces the value the gateway injects. It does not change the password on the target machine — that is a separate capability, and Vaultris is honest about not having it.

09Network devices

For Cisco IOS and MikroTik RouterOS, Vaultris does more than proxy bytes. A router is a configuration, so the gateway reads that configuration before and after every session and shows you what changed.

  • Capture — reads the running configuration and stores it, with passwords and community strings masked out first.
  • Baseline — mark a capture as the approved reference.
  • Drift — how the device differs from that baseline now, ignoring timestamps and counters so only real change shows.
  • Roll back — put a stored configuration back.
Rollback writes to live equipment. It is never automatic — no timer, nothing on session end. Every rollback needs your password re-entered, the device name typed out, a written reason, and an explicit acceptance of responsibility, all recorded against your name. Before you commit, a pre-flight check warns if the configuration you are restoring drops the management address, the account the gateway signs in with, the management service or the default route.

10Host health

Before you open a session, you can see what the machine is actually doing. Press Health on any row in Quick Connect.

Nothing is installed on the target. The gateway asks it over SNMP and ICMP and reports what comes back — CPU, memory, filesystems, uptime, how many people are signed in, and what is crossing each network card.

Host health panel for a server
The panel appears in a few seconds. Throughput takes longer and fills in afterwards, with a progress bar, because a network rate can only be measured as the difference between two readings taken seconds apart.

Reading the score

The score is plain arithmetic — deductions from 100 for high CPU, memory, disk, latency, packet loss or a saturated link. It is deliberately simple so anyone can reconstruct it by hand. A machine that answers the network but not SNMP shows no score at all rather than a made-up one.

What it saysWhat it means
Good / Needs watching / DegradedTelemetry arrived and was scored
No telemetryThe host answers the network but not SNMP — usually the community string, or the SNMP service is not running
UnreachableNothing answered at all. A different problem entirely, which is why it is reported separately

What changed since last time

Every reading is kept, so the panel also draws the machine’s history — CPU, memory and health score on one chart, bandwidth on its own. A snapshot is taken automatically as each session opens and closes.

Snapshot history charts
Hover any point for the figures at that moment. Readings taken around a session are counted separately, so you can see the machine as an operator found it and as they left it.
Figures that move during a session are correlation, not proof. The gateway says numbers changed while somebody was connected; it never claims they caused it.

11Audit and reports

Every action on the gateway lands in an append-only, hash-chained ledger. Each entry's hash covers the one before it, so removing or altering any past record breaks the chain from that point onward — visibly.

Audit ledger
The ledger, in plain sentences rather than raw fields. Filter by actor, action, outcome or date.
Reports
Five report types over any date range, filterable by region, exportable to CSV or print.
ReportAnswers
Session activityWho connected to what, for how long, with how much evidence
Access reviewWho can reach what, as which account — the one to hand an auditor
Evidence integrityWhether every recording still matches its sealed digest
File transfersEvery file moved, with its hash — including refused attempts
CommandsEvery command run, with risk score and whether it was blocked

Running a report is itself written into the ledger.

Reporting on one person

Choose User activity and pick a name. You get every session that person opened, and — where the machine could be measured — its health and bandwidth immediately before and immediately after each one.

User activity report with an expanded row
Select any row to open the readings for that session: CPU, memory, health score, latency, disk and bandwidth, each shown before beside after.

Taking it out of the building

Download CSV gives every column at full precision. Print / PDF produces a document meant to be read by someone who has never seen this portal: a cover page, a plain-language explanation of what the report shows, the figures and charts, the detail table, and a glossary of every term used. Expanded rows print with their charts.

Leave Background graphics switched on in the print dialog, or the charts and status labels come out blank.

12Notifications

The bell reports things the gateway currently wants looked at. Alerts are recomputed from live state, so one disappears when the problem behind it is fixed — there is nothing to tidy up.

Notifications page
Every check the gateway runs, and whether it is clear. An empty page means "checked and fine", not "nothing is watching".

Administrators can configure email delivery on the same page, so drift, failed sessions, policy findings and access requests reach people who are not looking at the portal.

13Keeping it locked down

Three administrator settings, all on the Settings page.

The certificate

The gateway shows what it is presenting to browsers and how long it has left, with a warning well before it lapses. An expired certificate stops every browser reaching the portal — including yours — so this is worth glancing at.

Certificate settings
Both certificates are listed: the public one browsers see, and the internal one used on the private listener.

Renewal runs on the host, not from the portal. The page carries the exact two commands with a copy button. That boundary is deliberate: letting a web application rewrite the gateway’s own TLS identity and reload the proxy would be a far larger privilege than the convenience is worth. Storing DNS-API credentials makes renewal unattended, and the secret is encrypted like a vaulted password.

Allowed source addresses

You can restrict which public addresses may reach the gateway at all. Requests from anywhere else are refused before sign-in, so a stolen password is only useful from an address you have already agreed to — and every refusal is written to the ledger.

Loopback and the internal networks are always allowed; those are the gateway talking to itself. The page shows the address you are connecting from and will refuse to save a list that does not include it, because a list that locks out its own author takes effect immediately and leaves nowhere to fix it from.

This is a lock on the front door, not a wall around the building. It does not replace a firewall and cannot stop traffic reaching the machine itself.

Resending an invitation

Welcome messages get filtered, lost, or sent before the mailbox existed. Open the user under Users and choose Resend invitation. Resend with a new password also issues a fresh temporary password and requires them to change it at first sign-in — use it when the original was never received, since the old password cannot be read back, only replaced.

14Where you reach it

Every deployment publishes the same portal on the addresses that make sense for its network. A typical layout:

FromAddressNotes
On the local networkhttps://10.20.4.90/Internal certificate — trust it once and the warning stops
Over the VPNhttps://10.20.9.3/Same portal, same certificate
By namehttps://gateway.example.com/Publicly trusted certificate, no warning
SSH gatewayssh -p 2200 you@gateway.example.comMenu-driven, brokered and recorded
Sessions expire when idle, not while you work. The portal signs you out after an hour of inactivity, with a hard limit of twelve hours from sign-in. Working keeps it alive; walking away does not.

If something will not connect

  • The target is not in Quick Connect — you have not been granted it. Ask an administrator to add you to the right group.
  • "This asset needs an approver to agree first" — the request form opens automatically. Fill it in and it goes to the approvers.
  • The session opens and closes immediately — the target refused the credential, or is unreachable. The Sessions list shows the reason on that row.
  • A command was blocked — a command rule matched it. The block and the rule that caused it are both in the ledger.

Screenshots use invented asset names, people and documentation addresses. No real infrastructure is shown. Addresses above are examples — your deployment has its own.

Next Step

Want this discipline over your own network?

We will walk your current access paths and show exactly where the gateway sits.