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
Select Credentials in the sidebar, then Add Credential.
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 never shown again after saving — only the name, type, and description appear in the list. Editing lets you replace a secret but not view it.
- 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.