Skip to Content
V4.8.0Device Onboarding

Device Onboarding

SAMURAI Networks is agentless: each platform connects over its native API or SSH with a read-only / least-privilege account. It never makes configuration changes; it polls and reads. SSH device commands are restricted to show.

PlatformConnectionAccount
Cisco ACI (APIC)HTTPS APIRead-only admin
Nexus Dashboard OrchestratorHTTPS APIRead-only
Cisco FMCHTTPS APIRead-only API user
Cisco FTD / ASASSH (CLISH)Read-only
Cisco ISEERS / OpenAPIRead-only ERS admin
Palo AltoXML APIRead-only
FortiGateREST APIRead-only
Juniper SRXSSH (Junos CLI)Read-only
VMware vCentervSphere APIRead-only
Active DirectoryLDAPBind account (paged read)
Routers / Switches (IOS / IOS-XE / NX-OS / IOS-XR / Junos)SSHPrivileged show access
VyOSHTTPS API or SSHAPI key / read-only account

After adding a device, SAMURAI Networks runs an initial sync and then re-syncs on a schedule (configurable in Settings). For what each platform exposes once connected, see the per-vendor Device Panels.

Network access

All device traffic is outbound from the SAMURAI Networks server: it polls each device over the device’s management API or SSH. Open each platform’s management port from the server to the device. Vendor defaults are shown below; adjust if you have changed them. (Inbound syslog ingestion is also available: enable the syslog listener under Settings → Logging.)

If the server cannot reach a management subnet directly (segmented networks, DMZ hosts), route that traffic through a SOCKS5 gateway instead of opening a direct path; see Outbound Proxy.

PlatformProtocolPort
Cisco ACI (APIC)HTTPSTCP 443
Nexus Dashboard OrchestratorHTTPSTCP 443
Cisco FMCHTTPSTCP 443
Cisco FTD / ASASSHTCP 22
Cisco ISEHTTPS (ERS / OpenAPI)TCP 443 (ERS: 9060)
Palo AltoHTTPS (XML API)TCP 443
FortiGateHTTPS (REST API)TCP 443
Juniper SRXSSHTCP 22
VMware vCenterHTTPS (vSphere API)TCP 443
Active DirectoryLDAP / LDAPSTCP 389 / 636
Routers / SwitchesSSHTCP 22
VyOSHTTPS (API) / SSHTCP 443 / 22

Devices on a non-default SSH port can be added as address:port; the explicit port is also used by the reachability probe.

Credentials are stored encrypted at rest (AES-256-GCM) and used read-only. Grant the account only the access listed above; SAMURAI Networks never needs write or configuration rights.

Last updated on