202101 - Target Device or Group Not Found

Agent error code #202101 indicates that the agent attempted to push a dynamic entry to FortiGates via FortiManager, but the specified device target or group could not be found. FortiManager returned a JSON-RPC status code of -2 (object not found) for the proxy request. This error applies to Passive+ (FortiManager) mode only.

Common causes include:

• A serial number in the Device Targets configuration does not match any device managed by FortiManager
• A device group name in the Device Targets does not exist in the configured ADOM
• The configured ADOM does not contain the expected devices
• A device was recently removed from FortiManager or moved to a different ADOM
• A typo in the Device Targets or ADOM configuration

Steps to Resolve

Verify Device Targets

1. In the Knocknoc admin interface, check the Device Targets configured for the ACL
2. On FortiManager, navigate to Device Manager and verify that each serial number or group name listed in Device Targets exists
3. Serial numbers and group names must match exactly what FortiManager reports
4. If Device Targets is left empty, the push targets All_FortiGate in the configured ADOM — verify this group exists

Verify the ADOM Configuration

1. In Knocknoc, check the ADOM configured for the ACL (defaults to root if left blank)
2. On FortiManager, navigate to the ADOM and verify the target devices are managed within it
3. If devices were recently moved between ADOMs, update the Knocknoc configuration to match

Check FortiManager Device Status

1. On FortiManager, verify the target devices are in a connected and managed state
2. Devices that are offline, unregistered, or in a pending state may not be accessible via the proxy API
3. Navigate to Device Manager and check the connection status of each target device

Still Having Issues?

We can help you out, contact us at support@knocknoc.io.