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. The "find" operation under the "Default" resource enables searching for specific properties on a Mikrotik device by specifying key-value pairs as search criteria.

Common scenarios include:

  • Querying a Mikrotik router or device to retrieve configuration or status information based on certain property filters.
  • Automating network management tasks by dynamically searching for device attributes.
  • Integrating Mikrotik device data into workflows for monitoring or reporting purposes.

For example, a user might want to find all interfaces with a particular name or IP address by providing those as properties to search.

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).
Properties A collection of key-value pairs representing the properties to search for in the device. Each item has:
- Param Name: The name of the property to filter by.
- Param Value: The value of the property to match.

Output

The node outputs JSON data containing the results of the search operation. This typically includes an array of objects matching the specified property filters from the Mikrotik device.

If the node supports binary data output, it would represent any binary content returned by the Mikrotik API, but this is not indicated in the provided code or properties.

Dependencies

  • Requires an API key credential for authenticating with the Mikrotik API.
  • Needs network access to the specified Mikrotik host.
  • Supports ignoring SSL certificate issues if enabled.
  • Uses internal client and state management classes to handle API communication and operation execution.

Troubleshooting

  • Connection failures: Ensure the "Host" property is correctly set and reachable from the n8n instance.
  • SSL errors: If connecting over HTTPS and encountering SSL validation errors, enable "Ignore SSL Issues" to bypass certificate checks.
  • Authentication errors: Verify that the API key credential is valid and has sufficient permissions.
  • Empty or no results: Check that the property names and values used in the search are correct and exist on the Mikrotik device.
  • Operation not supported: Confirm that the "find" operation is available for the selected resource.

Links and References

Discussion