AvantGuard - ConnectSecure icon

AvantGuard - ConnectSecure

AvantGuard - ConnectSecure

Actions223

Overview

This node operation retrieves the users belonging to a specific Active Directory (AD) group. It is useful in scenarios where you need to programmatically access and manage group membership information from an AD environment, such as syncing group members with other systems, auditing user access, or automating user provisioning workflows.

For example, an IT administrator could use this node to fetch all users in a particular security group to verify permissions or to export the list for reporting purposes.

Properties

Name Meaning
Company Id The identifier of the company within which the AD group exists.
Object Guid The unique GUID of the AD group whose users are being retrieved.
X USER ID The user identifier used for authentication or tracking the request.
Additional Query Parameters Optional parameters to refine the query:
- Condition: Filter condition string
- Skip: Number of records to skip
- Limit: Maximum number of records to return
- Order By: Field(s) to order the results by

Output

The output JSON contains the list of users that belong to the specified AD group. Each user entry typically includes user attributes such as username, email, and other relevant directory information depending on the API response.

If binary data were returned (not indicated here), it would represent file attachments or similar content related to the users, but this operation focuses on JSON user data only.

Dependencies

  • Requires an API key credential for authenticating requests to the AvantGuard ConnectSecure service.
  • Needs the base URL of the AvantGuard ConnectSecure API configured in the node credentials.
  • The node uses the @avantguardllc/n8n-openapi-node package and an OpenAPI specification (openapi.json) bundled internally to define its properties and request structure.

Troubleshooting

  • Missing or invalid credentials: Ensure the API key and base URL are correctly set in the node credentials.
  • Invalid Company Id or Object Guid: Verify that the provided company ID and object GUID correspond to existing entities in your Active Directory environment.
  • Permission errors: The user identified by "X USER ID" must have sufficient permissions to query group membership.
  • Query parameter issues: Incorrectly formatted or unsupported query conditions may cause errors; validate these parameters carefully.
  • Network or connectivity problems: Check network access to the AvantGuard ConnectSecure API endpoint.

Links and References

Discussion