Sync

Overview

The Sync page lets you trigger manual ingestion from security tools and view the history of all past syncs. It is the central place to monitor data flow from your connected tools into the AquarisSec platform.

Triggering a Sync

Select a source tool from the dropdown — Snyk, Cycode, Wiz, or Tenable — and click "Start Sync". Triggering a sync requires the analyst or admin role. Syncs are rate-limited to 5 syncs per minute.

The sync runs in the background — you will receive a sync ID and can track progress in the history table below.

Sync Pipeline

When a sync is triggered the following steps are executed:

  1. Authenticate to the security tool using stored credentials.
  2. Fetch all findings — adapters handle pagination and retry with exponential backoff.
  3. Normalize findings into a common schema shared across all tools.
  4. Upsert into the database — findings are deduplicated by source_tool + source_issue_id.
  5. Route via CMDB to determine the correct Jira project and team for each finding.
  6. Create Jira issues for findings matching the configured severity filter.
  7. Record sync history and audit log entries.

Sync History

The history table shows all past syncs. Each row includes the following columns:

  • Tool — the source security tool.
  • Status — a badge showing completed, running, failed, or skipped.
  • Started — timestamp when the sync began.
  • Completed — timestamp when the sync finished.
  • Fetched — total number of findings pulled from the tool.
  • New — count of new findings created.
  • Updated — count of existing findings that were updated.
  • Jira Created — number of new Jira issues created during this sync.
  • Error — error message if the sync failed (hover for the full text).

The page auto-polls every 5 seconds while a sync is in the running state.

Automatic Syncs

Syncs can run on a schedule configured per tool in the Configuration page. The default schedule is every 6 hours. The cron expression follows the standard 5-field format:

# ┌───────── minute (0 - 59)
# │ ┌───────── hour (0 - 23)
# │ │ ┌───────── day of month (1 - 31)
# │ │ │ ┌───────── month (1 - 12)
# │ │ │ │ ┌───────── day of week (0 - 6, Sun = 0)
# │ │ │ │ │
# * * * * *

# Example: every 6 hours
0 */6 * * *

Troubleshooting

If a sync fails, check the following:

  • Verify tool credentials are correct in the Configuration page.
  • Confirm the tool API endpoint is reachable from your network.
  • Check the Logs page for detailed error messages and stack traces.