AvantGuard - CIPP icon

AvantGuard - CIPP

AvantGuard - CIPP

Actions136

Overview

This node interacts with the AvantGuard CIPP API, specifically targeting the "List" resource and the "Retrieve Exec Add Spn" operation. It is designed to send a query parameter named "enable" to retrieve or manipulate data related to service principal names (SPNs) in an execution context. This node would be beneficial in scenarios where users need to programmatically manage or query SPN-related configurations or statuses within the AvantGuard system.

Practical examples include:

  • Enabling or disabling certain SPN features by toggling the "enable" parameter.
  • Retrieving current SPN execution settings filtered by the "enable" state.

Properties

Name Meaning
Enable A string value sent as a query parameter named "enable". It controls or filters the retrieval of SPN execution data. The exact accepted values depend on the API but typically could be "true", "false", or other status indicators.

Output

The node outputs JSON data returned from the AvantGuard CIPP API corresponding to the "Retrieve Exec Add Spn" operation. The structure of this JSON depends on the API response and likely includes details about SPN execution states or configurations filtered by the "enable" parameter.

No binary data output is indicated in the source code.

Dependencies

  • Requires an API key credential for authentication with the AvantGuard CIPP API.
  • Needs the base URL of the AvantGuard resource API configured in credentials.
  • Depends on the @avantguardllc/n8n-openapi-node package for building request properties and handling API communication.
  • Uses an OpenAPI specification (openapi.json) bundled with the node to define available operations and parameters.

Troubleshooting

  • Common issues:

    • Incorrect or missing API credentials will cause authentication failures.
    • Providing invalid values for the "enable" property may result in API errors or empty responses.
    • Network connectivity problems can prevent successful API calls.
  • Error messages:

    • Authentication errors typically indicate invalid or missing API keys; verify credentials configuration.
    • HTTP 4xx or 5xx errors suggest issues with the request or server; check the "enable" parameter value and API availability.
    • Timeout errors may require increasing timeout settings or checking network stability.

Links and References

Discussion