Skip to main content
Login Security
Access & SecuritySourceAPIChangelog

Reference

Settings​

Admin​

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

SettingTypeDefaultWhat it does
Sign out after idle minutesnumber0Sign people out after this many minutes without activity. The server ends the session too, so a copied token stops working. 0 turns it off.
Longest session in hoursnumber0Sessions end after this many hours, even with remember me. 0 means no extra limit.
Allow remember mebooleantrueOff hides remember me at login and ignores devices remembered before, so every login asks for the second factor.
Alert on a new devicebooleantrueSend people an alert when someone signs in to their account from a device it has not seen before. Each person can turn it off for themselves.
Require a second factorselect"off"People without one must set one up after they sign in, before they can use Termix. A passkey sign in with a PIN or fingerprint counts.
Also for single sign-onbooleanfalseAsk for the second factor after SSO and LDAP logins too. Leave it off when your identity provider already asks for one.
Ask for a second factor before connectingselect"off"People enter their second factor when they open a terminal, remote desktop or file manager on a host. Metrics, tunnels and other background work are not asked.
Minutes before asking againnumber60After entering it, a person can connect to any host for this long. Signing out ends it early.

User​

Each person sets these for themselves in Settings.

SettingTypeDefaultWhat it does
Alert me on a new devicebooleantrueGet an alert when someone signs in to your account from a device not seen before.

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
Ask for a second factor before connectingbooleanfalseUsed when Login Security is set to ask on hosts marked for it.

Permissions​

Give these to roles in Settings, Roles.

PermissionWho has it at firstWhat it allows
login-security.manageadminSee the second factor status and change login security settings.

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
auth:policyHighSet sign in rules. It can sign people out when idle, limit session length, turn off remember me and require a second factor.
hosts:connect-policyHighDecide who can connect. Can block or allow every SSH and remote desktop connection to any host.
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.
events:coreMediumWatch everything happening. Including activity from other users, not just yours.
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