AvantGuard - ConnectSecure icon

AvantGuard - ConnectSecure

AvantGuard - ConnectSecure

Actions223

Overview

This node interacts with an Active Directory service to retrieve basic information about Active Directory entries. It is designed to query the Active Directory API by sending specific parameters such as company ID, source, and user identification headers. This node is useful in scenarios where you need to fetch user or organizational data from an Active Directory system for further processing, reporting, or integration with other systems.

Practical examples include:

  • Retrieving user details for identity verification.
  • Fetching organizational unit information for access control.
  • Querying directory entries with filtering, pagination, and sorting options.

Properties

Name Meaning
Company Id The unique identifier of the company within the Active Directory context (required).
Source The source identifier or name from which to retrieve the Active Directory information (required).
X USER ID The user ID header value used for authentication or tracking purposes (required).
Additional Query Parameters Optional parameters to refine the query:
- Condition: Filter condition string.
- Skip: Number of records to skip (pagination).
- Limit: Maximum number of records to return.
- Order By: Field(s) to order the results by.

Output

The node outputs JSON data representing the retrieved Active Directory basic information. The structure typically includes user or entity attributes as returned by the Active Directory API based on the query parameters.

If binary data were involved (e.g., profile pictures), it would be included in a binary field, but this node focuses on JSON responses only.

Dependencies

  • Requires an API key credential for authenticating requests to the Active Directory service.
  • Needs proper configuration of the base URL for the Active Directory API endpoint.
  • The node depends on the external Active Directory API being accessible and responsive.

Troubleshooting

  • Common issues:

    • Missing or incorrect API credentials leading to authentication failures.
    • Invalid or missing required parameters such as Company Id, Source, or X USER ID.
    • Network connectivity problems preventing access to the Active Directory API.
    • Improperly formatted additional query parameters causing API errors.
  • Error messages and resolutions:

    • 401 Unauthorized: Check that the API key or authentication token is correctly configured.
    • 400 Bad Request: Verify that all required parameters are provided and correctly formatted.
    • Timeout or Network Error: Ensure network connectivity and that the API endpoint URL is correct.
    • Empty or unexpected response: Confirm that the query conditions match existing data in Active Directory.

Links and References

Discussion