Mikrotik icon

Mikrotik

Consume Mikrotik API (v.0.1.4)

Overview

This node integrates with the Mikrotik API, allowing users to perform various operations on Mikrotik devices. Specifically, the "move" operation under the "Default" resource enables repositioning of a configuration item identified by an ID or named parameter within the device's configuration hierarchy.

Common scenarios for this node include automating network device configurations, such as reordering firewall rules, interfaces, or other Mikrotik settings programmatically. For example, a user might want to move a firewall rule before another to change its priority without manually accessing the Mikrotik router interface.

Properties

Name Meaning
Host The hostname or IP address of the Mikrotik device to connect to.
Ignore SSL Issues Whether to ignore SSL certificate validation errors when connecting (true/false).
Id The identifier or named parameter of the configuration item to move. Examples: "*1", "ether1".
Put Before The target position to place the item before, specified as an identifier or name.

Output

The node outputs JSON data representing the result of the move operation performed on the Mikrotik device. This typically includes confirmation of the action or details about the updated configuration state. The output does not explicitly handle binary data.

Dependencies

  • Requires an API key credential to authenticate with the Mikrotik API.
  • Needs network access to the specified Mikrotik host.
  • Optionally requires configuration to allow ignoring SSL certificate issues if connecting over HTTPS with self-signed or invalid certificates.

Troubleshooting

  • Connection failures: Ensure the Host property is correct and reachable from n8n. Verify network connectivity and firewall settings.
  • Authentication errors: Confirm that the provided API key credential is valid and has sufficient permissions.
  • SSL errors: If connecting over HTTPS and encountering SSL validation errors, enable "Ignore SSL Issues" to bypass certificate checks.
  • Invalid IDs or parameters: Make sure the "Id" and "Put Before" values correspond to existing configuration items on the Mikrotik device; otherwise, the move operation will fail.
  • Operation not supported: If the node throws errors related to unsupported operations, verify that the "move" operation is valid for the targeted resource and Mikrotik API version.

Links and References

Discussion