Connect Secure icon

Connect Secure

Consume Connect Secure API

Actions222

Overview

This node operation, Retrieve Ad Users View, is designed to query and retrieve user information from an Active Directory service. It allows users to specify filtering conditions, pagination controls, and sorting preferences to customize the data retrieval. This operation is beneficial in scenarios where you need to fetch user details for reporting, synchronization with other systems, or auditing purposes.

For example, you might use this node to:

  • Retrieve a list of users who belong to a specific department.
  • Fetch a limited number of user records for batch processing.
  • Sort users by their last login time or username.

Properties

Name Meaning
X USER ID The User Id header value required for authentication or identification in the request.
Condition A query string to filter the users based on specific criteria (e.g., department='Sales').
Skip Number of records to skip, useful for pagination.
Limit Maximum number of user records to return.
Order By Field name(s) to sort the results by (e.g., "username asc", "lastLogin desc").

Output

The output of this operation is a JSON array containing user objects retrieved from the Active Directory. Each object represents a user and includes various attributes as returned by the API, such as user identifiers, names, email addresses, and other directory properties.

If the node supports binary data output, it would typically represent user-related files or attachments; however, based on the provided code and properties, this operation focuses solely on JSON data representing user views.

Dependencies

  • Requires an active connection to an Active Directory service via an API endpoint.
  • Needs an API key or token credential configured in n8n to authenticate requests.
  • The X USER ID header must be supplied to identify the user context for the request.
  • No additional external libraries beyond standard HTTP request handling are indicated.

Troubleshooting

  • Missing or invalid X USER ID: The request will fail if the required X USER ID header is not provided or incorrect. Ensure this property is set correctly.
  • Invalid query condition syntax: If the Condition string is malformed or uses unsupported query syntax, the API may return errors or empty results. Validate the query format according to the Active Directory API documentation.
  • Pagination issues: Setting Skip or Limit incorrectly (e.g., negative numbers) may cause unexpected behavior or errors.
  • Order By field errors: Using invalid or unsupported fields in Order By can result in API errors. Confirm valid sortable fields with the API provider.
  • Authentication failures: Ensure that the API credentials are valid and have sufficient permissions to access user data.

Links and References

Discussion