AsterionDocumentation v0.4.1

Polaris

The central portal: what it stores, how it decides, and every page of the UI.

Polaris is a Laravel application with a MariaDB database. It never scans anything itself — satellites do. Polaris

  • plans: turns test plans, automatic monitoring and the tenant’s targets into a plan bundle per satellite (only the targets that satellite may and can reach),
  • ingests: validates every uploaded result strictly, keeps the raw output and turns it into hosts, services, certificates, DNS records and paths,
  • correlates: merges addresses into hosts and keeps per-satellite observations and history,
  • judges: analyzers and the exposure policy open and resolve findings,
  • tells: notifications, reports, the dashboard and maps,
  • enriches: Certificate Transparency, routing and registry data for public IPs, address lookup for locations.
From a test plan to a finding: what Polaris and Pulsar each do with a scheduled check.
From a test plan to a finding: what Polaris and Pulsar each do with a scheduled check.
Dashboard and maps The overview page and the maps of satellites and hosts. Targets and hosts What you enter, how Polaris turns it into hosts, and what a host page shows. Satellites Managing Pulsar satellites in Polaris: scope, zones, tags, connectivity, status and the web console. Test plans and runs One check per plan, schedules, automatic monitoring, minimum intervals and what a run records. Findings and exposure policy How problems are found, opened and resolved, and how the exposure policy and segmentation judge what is reachable. Domains, DNS and mail DNS monitoring with manipulation detection, Certificate Transparency, and mail server checks. IPs, certificates and software Routing and registry data of public addresses, the certificate store and the software inventory. Notifications and reports Who is told what, when — and the recurring change reports for audits. Tenants, users and roles Multi-tenancy, the five roles, products per tenant, sign-in with password, TOTP or OIDC. System settings What super admins set for the whole installation, and how it relates to the .env defaults. Background jobs What the scheduler and the queue do on their own, and when. Data sources Every external service Asterion talks to, what it sends there, and how to switch it off.