Add IP to Network Group

Overview

This node adds a specified IP address to a network group by making an API call to a firewall management service. It is useful in scenarios where you need to programmatically manage network groups and their associated IPs, such as automating firewall configurations or dynamically updating access control lists.

For example, if you have a list of IP addresses that need to be grouped for security policies, this node can automate adding each IP to the correct network group without manual intervention.

Properties

Output

The node outputs JSON data for each input item processed. Each output item contains:

• success: Boolean indicating whether the operation succeeded.
• message: A success message from the API or a default confirmation string.
• groupId: The ID of the network group targeted.
• ipId: The ID of the IP added.
• response: The full response object returned by the API on success.

If the operation fails and the node is set to continue on failure, the output includes:

• success: false
• error: The error message.
• statusCode: HTTP status code of the failure.
• response: The error response body or text from the API.
• groupId and ipId: The IDs involved in the failed request.

The node does not output binary data.

Dependencies

• Requires an API key credential for authenticating with the firewall management API.
• The API base URL is retrieved from the credentials.
• The node makes HTTP POST requests to the endpoint /api/pt/ip/group/add on the configured API server.
• The request uses JSON content type and sets the "Accept-Language" header to Vietnamese (vi).

Troubleshooting

• Common issues:

  • Invalid or missing Group ID or IP ID parameters will cause the API call to fail.
  • Incorrect or expired API credentials will result in authentication errors.
  • Network connectivity problems to the API server may cause timeouts or connection errors.
  • API rate limits or permission restrictions could block the addition of IPs to groups.

• Error messages:

  • Errors include detailed messages, HTTP status codes, and API response bodies when available.
  • If the node is not set to continue on failure, it throws an error with context including the URL, group ID, and IP ID.
  • To resolve errors, verify the correctness of input IDs, ensure valid API credentials, and check API server availability.

Links and References

• Refer to your firewall management API documentation for details on the /api/pt/ip/group/add endpoint.
• n8n documentation on HTTP Request node for understanding underlying HTTP calls.
• General best practices for managing network groups and IP whitelisting in firewall systems.