Collectors

Deploy, enroll, secure and troubleshoot AssurIQ collectors.

  1. 1
    Choosing collector placement
    How many collectors a site needs, where to run them, and why one per routed security boundary is the default.
  2. 2
    Windows Collector
    Install and operate the Windows collector service.
  3. 3
    Install the collector on Windows (x64)
    Unattended install of the Windows service build with an enrollment token and control plane URL.
  4. 4
    Linux Collector
    Install the Linux collector as a systemd service on Ubuntu, Debian or RHEL.
  5. 5
    Docker Collector
    Run the collector as a container with host networking.
  6. 6
    Install the collector on Linux (x64, systemd)
    Install the systemd-managed collector service and enroll it from the command line.
  7. 7
    Run the collector in Docker
    Compose or run the collector container with host networking and a secret-backed enrollment token.
  8. 8
    VM Appliance
    Deploy the hardened OVA on VMware or Hyper-V.
  9. 9
    Cloud Connector
    Agentless collection for Microsoft 365, Azure, AWS and Google Workspace.
  10. 10
    Firewall and egress requirements
    The collector is outbound-only. What to allow, on which ports, and why no inbound rules are ever needed.
  11. 11
    Enrollment Tokens
    Create, scope, expire and revoke enrollment tokens.
  12. 12
    Proxy configuration
    Route collector traffic through an explicit or PAC-defined proxy without breaking mTLS.
  13. 13
    Enrollment failures
    Symptom-first guide for AIQ-ENR-001 through AIQ-ENR-004: token, expiry, revocation and connectivity failures during enrollment.
  14. 14
    mTLS and Connectivity
    Outbound-only mutual TLS, endpoints to allow-list, certificate rotation.
  15. 15
    Discovery scope and safety
    CIDRs, exclusions, blocked targets, concurrency and maintenance windows: how scan scope is defined and enforced server-side.
  16. 16
    Proxy Configuration
    Route collector traffic through an explicit or PAC-defined proxy.
  17. 17
    Least-privilege credentials for collectors
    What access a collector actually needs for discovery, SNMP, and credentialed checks — and what to avoid granting.
  18. 18
    Upgrade Collector
    Auto-upgrade rings and manual upgrade steps.
  19. 19
    Update failures
    Symptom-first guide for AIQ-UPD-001 through AIQ-UPD-003: verification failures, maintenance-window blocks and rollbacks.
  20. 20
    Troubleshoot Offline Collector
    Symptom-first guide for AIQ-COL-001 with exact checks in order.
  21. 21
    Uninstall and revoke a collector
    How to retire a collector cleanly: uninstall the host software and revoke its credential so it cannot re-authenticate.
  22. 22
    AssurIQ Endpoint Agent: capability model and EDR-ready foundation
    How the deployed collector evolves into the AssurIQ Endpoint Agent, what each sensor reports today, and why native detection/response stays feature-gated.
  23. 23
    Collector health states explained
    Healthy, Degraded, Offline, Enrollment Pending, Update Required and Revoked — what each state means and what to check.
  24. 24
    Collector architecture and roadmap
    Why the collector is built in Go, the outbound mTLS trust model, its module system, and the phased roadmap.
  25. 25
    What the v0.1 collector does today
    A plain list of what the native v0.1 collector supports right now versus what is designed but not yet active, and what the DEV build badge means.
  26. 26
    Collector API v1 reference
    Request/response shapes for the collector-facing API v1 endpoints: enroll, heartbeat and observations, plus tenant/site binding rules and error codes.
  27. 27
    Collector 0.2.0-dev: what it collects for topology
    The exact topology data the in-development 0.2 collector emits, and what is intentionally not collected yet.