Skip to main content

Linux

Overview​

ITOSS manages Linux systems through the SSH instrumentation, the standard protocol for managing Linux and Unix systems. No agent needs to be installed on the target server: the ITOSS Collector connects remotely, executes monitoring commands, and processes the results.

+----------------------+
| ITOSS |
| Collector |
+----------+-----------+
|
| SSH (TCP 22)
| Key, certificate, or password authentication
v
+----------------------+
| Target Linux Server |
| Dedicated user itoss |
+----------------------+

Supported Authentication Methods​

MethodRecommended ForGuide
SSH Private KeyProduction and unattended automation (preferred)SSH Private Key Authentication
SSH Private Key with PassphraseWhen policy requires private keys to be protected by a passphraseSSH Private Key with Passphrase Authentication
SSH CertificateWhen policy requires SSH logins to use a certificate signed by a trusted CASSH Certificate Authentication
Username and PasswordOnly when no key or certificate is availableSSH Password Authentication

Setup

Requirements​

  • Linux server with OpenSSH Server installed and the SSH service enabled.
  • Administrative access to the target server (required only during setup).
  • Network connectivity from the ITOSS Collector to the target server on the SSH port (default 22).
  • A dedicated service account for ITOSS (for example itoss). Never use root or personal accounts.
  • Shell access for the service account (/bin/bash).
  • ITOSS credential repository available.

Verify the SSH service status:

sudo systemctl status sshd

or, on Debian/Ubuntu:

sudo systemctl status ssh

Registering a Linux Server in ITOSS

Complete the SSH connection fields. These are the same for every authentication type:

FieldParameterValue
targetssh_targetHostname or IP address (e.g. 8.243.164.21)
userssh_userService account (e.g. itoss)
portssh_port22

The remaining fields depend on the authentication type:

FieldParameterPasswordPrivate KeyPrivate Key with PassphraseCertificate
authenticationtypessh_authenticationTypePASSWORDPRIVATE_KEYPRIVATE_KEY_PASSPHRASECERTIFICATE
passwordssh_passwordService account passwordN/APrivate key passphrasePrivate key passphrase, or N/A if the key has no passphrase
identityfilessh_identityFileN/APrivate key file name (e.g. srv-web-01.key)Private key file name (e.g. srv-db-02.key)Private key file name (e.g. srv-erp-01.key)

For the key and certificate types, place the private key in the ssh-keys folder of the ITOSS installation. ssh_identityFile holds only the file name, without the folder.

  • Private Key and Private Key with Passphrase: install the matching public key in ~/.ssh/authorized_keys of the service account on the target server.
  • Certificate: place the certificate next to the private key (e.g. srv-erp-01.key-cert.pub). It has no field of its own. The target server must trust the signing CA through TrustedUserCAKeys.

See the guide for each method under Supported Authentication Methods for the full procedure.