Browse documentation
Adding your first credentials
Credentials are the logins JOATOS uses to reach your devices and servers — SNMP community strings, SSH keys, WinRM passwords, and vendor API keys. You store them once, and discovery and polling reuse them. Every secret is encrypted at rest.
Opening the Credentials page
Open Settings and select Credentials, then Add Credential. (There is no Credentials entry in the top bar.)
Filling in the form
- Name — a label you'll recognise, e.g. Office SNMP.
- Type — pick the credential type (see below). The type can't be changed after the credential is created.
- Description (optional) — a note about where it's used.
- Fill in the type-specific fields, then select Create Credential.
Credential types
| Type | Main fields |
|---|---|
| SNMP v2c | Community string |
| SNMP v3 | Username, auth protocol + key, privacy protocol + key |
| UniFi Controller | Controller URL, API key, site ID |
| Aruba CX | Username, password |
| MikroTik | Username, password, REST API port, verify-SSL option |
| SSH (Linux/Unix) | Username, port, password or private key (+ passphrase) |
| WMI (Windows) | Username, password, domain, HTTPS option, verify-SSL option |
| Proxmox VE | Host, API token ID, API token secret, port |
Notes & tips
- SNMP credentials are used to poll network devices (switches, routers, firewalls, APs, UPSs).
- SSH and WMI credentials are used to collect from Linux and Windows servers.
- Vendor API credentials (UniFi, Aruba CX, MikroTik, Proxmox) unlock richer data than SNMP alone.
- Secrets are encrypted at rest and never appear in the credentials list — only the name, type, and description do. Administrators can still read a stored secret back by opening the credential's edit form, which is pre-filled with it; non-admins cannot. See Adding a credential § Who can see a stored secret.
- For MikroTik and WMI with self-signed certificates, leave Verify SSL certificate unchecked.
Where credentials are used next
- Discovery — a scan can use a saved credential to authenticate to a subnet or controller.
- Device and server polling — the scanning profile on a device or server points at the credential to use.