Performing health checkups on domain names
Ghostwriter grades a domain's health as Healthy or Burned. Health is based on domain categorization and VirusTotal information.
Domain categories are pulled from VirusTotal, which pulls categorization information from multiple sources. See the VirusTotal configuration for more information.
Categorization data is stored as jsonb in the
categorizationfield. The format is:
This JSON data is displayed as a table under each domain's Health tab:
Example of Domain Health and Categorization Information
Ghostwriter assumes these categories are bad, and any source flagging a domain with one of these categories will trigger the health status to flip to Burned:
- adult/mature content
- malicious outbound data/botnets
- malicious sources
- malicious sources/malnets
- malware repository
- potentially unwanted software
- spyware and malware
- web ads/analytic
You can also track the current DNS records for your domain names. Ghostwriter pulls this information using DNS queries.
Domain update tasks exist in the
tasks.py. These functions can be scheduled or requested manually.
Update All Domains
Update Individual Domains
The Domain Update Control Panel lives at
/shepherd/updateand provides information on when the updates were last run, how long they took to complete, and their exit state (success or error messages).
The Control Panel Under /shepherd/update
Click the Start Update button under the desired check to queue a check for all domains.
To update domain information or DNS records for just a single domain, open the domain's details and expand the Health and Categories or DNS Records panes.
Each of these panes contains a Refresh button. Click this button to queue an update for just the one domain.