Workflows & Troubleshooting

Common Workflows

Team Collaboration Workflow

  1. Admin creates a new session for an engagement
  2. Admin grants access to team members
  3. Team members log in and access the shared session
  4. Each team member adds hosts, services, and findings
  5. Team reviews findings collaboratively
  6. Lead generates final report for client delivery

Data Import Workflow

  1. Run external security scanners (Nmap, Nessus, etc.)
  2. Use Data Creator to upload scan results
  3. Server parses and imports hosts/services
  4. Review imported data in Hosts/Services views
  5. Create findings based on discovered vulnerabilities

Report Generation Workflow

  1. Complete security testing and document all findings
  2. Review findings for accuracy and completeness
  3. Configure finding sections in Admin settings
  4. Generate PDF report from Findings page
  5. Review generated report
  6. Export and deliver to client

Troubleshooting

Cannot Access Server

  • Verify the server is running and listening on the correct port
  • Check firewall rules allow access to the port
  • Ensure HTTPS certificate is configured correctly (if using TLS)

Database Errors

  • Check database file permissions (SQLite)
  • Verify PostgreSQL connection string (if using PostgreSQL)
  • Ensure database migrations have been applied

Authentication Issues

  • Clear browser cookies and try again
  • Verify user account exists and is active
  • Check JWT configuration in appsettings.json
  • Ensure session timeout settings are appropriate

Report Generation Fails

  • Check QuestPDF license is configured (Community license is free)
  • Verify finding data is complete
  • Review system logs for specific error messages
  • Ensure sufficient disk space for temporary files