AvantGuard - ConnectSecure icon

AvantGuard - ConnectSecure

AvantGuard - ConnectSecure
Join our community

Actions223

Overview

This node operation retrieves detailed information about Active Directory roles based on specified identifiers. It is useful in scenarios where you need to fetch role details for a particular object within an Active Directory environment, such as user roles or group roles, by providing the company context and object GUID.

Practical examples include:

  • Fetching role details of a specific user or group in an enterprise Active Directory.
  • Integrating role information into workflows that manage permissions or audit access.
  • Automating reporting on Active Directory roles for compliance or security reviews.

Properties

Name Meaning
Company Id The numeric identifier of the company within which the Active Directory roles are queried.
Object Guid The unique string identifier (GUID) of the Active Directory object whose roles are retrieved.
X USER ID The user identifier used for authentication or tracking purposes in the request header.
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 detailed information about the Active Directory roles associated with the specified object GUID under the given company. This typically includes role names, descriptions, permissions, and other metadata relevant to each role.

If binary data were involved (not indicated here), it would represent attachments or files related to the roles, but this operation focuses on JSON data only.

Dependencies

  • Requires an API key credential for authenticating requests to the backend service managing Active Directory data.
  • The node expects a base URL configured in credentials pointing to the Active Directory service endpoint.
  • Proper network access to the Active Directory API is necessary.

Troubleshooting

  • Missing or invalid Company Id/Object Guid: Ensure these required fields are correctly provided; otherwise, the API will likely return errors or empty results.
  • Authentication errors: If the X USER ID header or API credentials are incorrect or missing, the request will fail with authorization errors.
  • Query parameter misuse: Invalid values in additional query parameters like limit or order_by may cause the API to reject the request.
  • Network issues: Connectivity problems to the Active Directory API endpoint can cause timeouts or failures.

To resolve common errors:

  • Double-check all required input properties.
  • Verify API credentials and user ID headers.
  • Review optional query parameters for correctness.
  • Confirm network connectivity and endpoint availability.

Links and References

Discussion