AvantGuard - CIPP icon

AvantGuard - CIPP

AvantGuard - CIPP

Actions136

Overview

This node interacts with the AvantGuard CIPP API to manage role mappings related to groups. Specifically, the "Retrieve Exec Delete Gdap Role Mapping" operation under the "List" resource allows users to retrieve or delete role mappings associated with a specified group ID. This is useful in scenarios where administrators need to audit, update, or remove role assignments for particular groups within their system.

Practical examples include:

  • Retrieving all role mappings for a given group to review permissions.
  • Deleting outdated or incorrect role mappings from a group to maintain security compliance.

Properties

Name Meaning
Groupid The unique identifier of the group whose GDAP (Granular Delegated Admin Privileges) role mapping you want to retrieve or delete.

Output

The node outputs JSON data representing the role mappings associated with the specified group ID. This typically includes details about roles assigned, their scopes, and any relevant metadata returned by the AvantGuard CIPP API.

If the operation involves deletion, the output will confirm the success or failure of the delete action.

No binary data output is indicated.

Dependencies

  • Requires an API key credential for authenticating with the AvantGuard CIPP API.
  • The base URL for the API is configured via credentials and used as the request base URL.
  • The node depends on the @avantguardllc/n8n-openapi-node package and an OpenAPI specification (openapi.json) bundled with the node for building properties and making requests.

Troubleshooting

  • Missing or invalid Groupid: Since groupid is required, ensure it is provided and correctly formatted; otherwise, the API call will fail.
  • Authentication errors: Verify that the API key credential is valid and has sufficient permissions.
  • API endpoint issues: Confirm that the base URL in credentials points to the correct AvantGuard CIPP API endpoint.
  • Network connectivity: Ensure the n8n instance can reach the API server without firewall or proxy issues.
  • Unexpected API responses: Check if the API schema has changed or if there are rate limits affecting the calls.

Links and References

Discussion