Configure ADQX

Last Updated: June 05, 2026

Enable and configure the Active Directory Query eXecutor (ADQX) Service Agent to allow PrinterLogic to query your on-premise Active Directory without requiring firewall port exposure.

Key Points

  • Confirm that the Service Agent devices has network access to your on-premise Active Directory server.
  • Administrator credentials for the PrinterLogic Admin Console are required.
  • With Use machine credentials (Windows SSPI) for this domain enabled, this Service Client uses its Windows domain account (SSPI) to bind to this Active Directory domain instead of the stored username and password. Only supported on Windows Service Clients that are joined to this domain.

Enable ADQX

Follow these steps to enable ADQX :

  1. In the Admin Console, go to Print.
  2. Select the desired Service Agent from the tree structure.
  3. Select the ADQX tab.
  4. Select the box for Enable this client to be an ADQX.
  5. In the LDAP Configurations section, select your configured LDAP domain.
    1. (Optional) Use machine credentials (Windows SSPI) for this domain.
  6. Select Save in the upper-right corner.
  7. Allow a couple minutes for the service to start and connect, or Refresh Configurations on the Service Agent device.

ADQX settings and the status notifications as seen on the ADQX Service Client tab.

Once the service starts and connects, AD queries occur between the Service Agent and AD server, without the need for inbound firewall ports. Selecting the Ping button checks the connection and provides the current status.

ADQX Resources

Checks

When ADQX is enabled, the Test Settings button on the LDAP Settings page is unavailable. Use the Ping and Bind buttons on the ADQX tab of the Service Agent to verify your connection and credentials.

Use the Ping button in the Domain DC Connectivity section to manually check the connection.

Use the Bind button in the AD Bind Status section to check the bind username / password validity.

Logs

Use the Download Logs button to directly download a .zip folder with the ADQX logs for troubleshooting.

View AD Queries

The View AD Queries option displays the predefined queries that ADQX runs against your Active Directory, providing full transparency into how Vasion interacts with your directory data. This allows administrators to verify that all queries are handled securely and review any updates to those queries over time.

Section showing the ADQX buttons for downloading the logs and viewing the queries.