AvantGuard - CIPP icon

AvantGuard - CIPP

AvantGuard - CIPP

Actions136

Overview

This node interacts with the AvantGuard CIPP API to retrieve users from a specified list. It is designed to query user data based on various filters such as graph filter, tenant filter, and user ID, optionally including logon details. This functionality is useful in scenarios where you need to programmatically access and manage user lists within an organization's directory or system, for example, syncing user information, auditing user access, or integrating user data into other workflows.

Properties

Name Meaning
Graphfilter A string filter applied to the graph query to narrow down the user search results.
Includelogondetails A string flag indicating whether to include detailed logon information for each user.
Tenantfilter A string filter specifying the tenant scope to limit the user retrieval to a particular tenant.
Userid A string identifier to specify a particular user ID to retrieve from the list.

Output

The node outputs JSON data containing the retrieved user information from the specified list according to the provided filters. The structure of the JSON output corresponds to the user data returned by the AvantGuard CIPP API, which typically includes user attributes and optionally logon details if requested. There is no indication that the node outputs binary data.

Dependencies

  • Requires an API key credential for authenticating with the AvantGuard CIPP API.
  • Needs the base URL of the AvantGuard resource API configured in the credentials.
  • Depends on the @avantguardllc/n8n-openapi-node package and the bundled OpenAPI specification (openapi.json) for request building and execution.

Troubleshooting

  • Common issues:
    • Incorrect or missing API credentials will cause authentication failures.
    • Providing invalid or empty filter values may result in no data being returned.
    • Network connectivity problems can prevent successful API calls.
  • Error messages:
    • Authentication errors typically indicate invalid or expired API keys; verify and update credentials.
    • Validation errors may occur if required properties are missing or malformed; ensure all required inputs are correctly set.
    • Timeout or connection errors suggest network issues; check connectivity and API endpoint availability.

Links and References

Discussion