Skip to main content
Certificates
Access & SecuritySourceAPIChangelog

Reference

Settings​

User​

Each person sets these for themselves in Settings.

SettingTypeDefaultWhat it does
Open the certificates panel with new terminalsbooleanfalseShow the certificates panel beside every SSH terminal that has Certificates on. You can still open and close it from the button on the right edge.
Certificates panel sideselect"right"Where the certificates panel sits next to a terminal.
Certificates panel sizenumber380Width in pixels, or height when it is at the bottom. You can also drag its edge.
Show the panel buttonbooleantrueShow a small button on the right edge of a terminal that opens the certificates panel.

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
CertificatesbooleanfalseManage TLS certificates on this host from the Certificates tab.
Use sudobooleantrueUse sudo to read and change certificates. Turn off if the login is root.
Read onlybooleanfalseShow certificates but never change them on this host.
Warn before expirynumber14Certificates with this many days or fewer left show as expiring and send an alert.
Show certificates panel in terminalsbooleantrueLet the certificates panel open beside this host's SSH terminal.

Permissions​

Give these to roles in Settings, Roles.

PermissionWho has it at firstWhat it allows
certificates.useadmin, userSee certificates on hosts you can reach, and change them on hosts you can edit.

Actions​

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

ActionRuns onRiskInputs
certificates.list
List certificates
A hostRead only
certificates.expiring
Certificates expiring
A hostRead only
certificates.renew
Renew certificate
One item on a hostChanges
certificates.renew-all
Renew all certificates
A hostChanges
certificates.revoke
Revoke certificate
One item on a hostDestructive

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
credentials:readCriticalSee your passwords and keys. It can read the stored secret for any host you can reach.
ssh:connectHighRun commands on your servers. Any command, on hosts you connect it to, with your access.
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.
credentials:useMediumConnect to your servers. It cannot see your passwords or keys.
network:serveMediumAccept connections. It opens a port on the Termix server.
operations:provideMediumOffer actions. Its actions can be run from Automations, the CLI, the phone app and other places, by people allowed to use them.
notify:sendMediumSend alerts. To you or other users, and through the channels they set up.
hosts:readLowSee your host list. Names and addresses for hosts you can already see.
ui:surfaceLowAdd its own screens. Tabs, panels and settings you can hide later.
kv:ownLowRemember small settings. Kept separate from other plugins.

API​

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

Platforms​

Linux, Windows, macOS