Skip to main content
Privileged Access
Access & SecuritySourceAPIChangelog

Reference

Settings​

Admin​

Set by an admin in Settings, under the plugin's name. It applies to everyone.

SettingTypeDefaultWhat it does
Request lifetime (hours)number24A request nobody decides in this time expires.
Alert on break glass accessbooleantrueAlert approvers when someone connects with break glass access.

Host​

Set per host in the host editor, on the plugin's tab. Host defaults can set them for many hosts at once.

SettingTypeDefaultWhat it does
Privileged hostbooleanfalseSSH and remote desktop sessions to this host need approved access.
Approver rolesstringRole names, separated by commas, whose members may approve. Empty lets anyone with the approve permission decide.
Longest access (hours)number4The most hours one request can ask for.
Ask for a reasonbooleantrueA request must say why access is needed.
Ask for a ticketbooleanfalseA request must name a ticket number.
Let background work throughbooleanfalsePolling and other non interactive plugin connections skip the approval. Leave off to block every session without access.

Permissions​

Give these to roles in Settings, Roles.

PermissionWho has it at firstWhat it allows
privileged-access.requestadmin, userAsk for time limited access to privileged hosts.
privileged-access.approveadminDecide other people's access requests, end access early and read the report.
privileged-access.bypassadminConnect to privileged hosts without a request. Every use is audited and alerted.
privileged-access.configureadminMark hosts as privileged and change who approves access to them

Actions​

Run these from Operations Center, Automations, the CLI (termix ops), the phone app or the API. See actions.

ActionRuns onRiskInputs
privileged-access.request
Ask for privileged access
A hostChangeshours, reason, ticket
privileged-access.pending
Access requests to decide
The serverRead only
privileged-access.status
Privileged access
A hostRead only

Events​

Automations can start when one of these happens.

EventWhat it means
privileged-access.requestedSomeone asked for access
privileged-access.approvedAccess was approved
privileged-access.bypassedBreak glass access was used

Capabilities​

What the plugin's code is allowed to do. Termix shows this list before you install it. See capabilities for all of them.

CapabilityRiskWhat it means
hosts:connect-policyHighDecide who can connect. Can block or allow every SSH and remote desktop connection to any host.
db:core-refsHighRead core account tables. Can query users, roles and hosts directly from the database.
users:impersonateHighAct as other users. Runs background work with another user's access, such as scheduled jobs. Every use is written to the audit log.
network:serveMediumAccept connections. It opens a port on the Termix server.
notify:sendMediumSend alerts. To you or other users, and through the channels they set up.
operations:provideMediumOffer actions. Its actions can be run from Automations, the CLI, the phone app and other places, by people allowed to use them.
events:coreMediumWatch everything happening. Including activity from other users, not just yours.
hosts:readLowSee your host list. Names and addresses for hosts you can already see.
db:ownLowStore its own data. Kept in its own tables, separate from other plugins.
ui:surfaceLowAdd its own screens. Tabs, panels and settings you can hide later.

Services​

Services are how plugins call each other. Plugin authors can use these.

ProvidesVersionPermission
privileged-access.hosts1.0.0privileged-access.request
UsesVersionOptional
sessions.live^1.0.0yes

API​

The plugin's HTTP routes are in the API reference.

Platforms​

Linux, Windows, macOS