Skip to content

Update DAST getting started guide with target url debugging

Hannah Bakerrequested to merge
577996-dast-docs-target-availability-guide into master

What does this MR do and why?

Adds a comprehensive troubleshooting section to the DAST browser-based analyzer documentation to help users diagnose and resolve DAST_TARGET_URL connectivity issues.

Why was this MR needed?

As of the development linked to this issue, DAST scanner output provides detailed error messages when it cannot connect to the target URL (DNS failures, connection refused, HTTP 500+ errors). However, the documentation doesn't explain what these errors mean or how to fix them, leaving users without clear guidance during initial setup.

This documentation update:

  • Explains common connectivity errors in plain language
  • Provides actionable troubleshooting steps
  • Includes command examples for testing connectivity
  • Makes DAST setup more accessible to users with varying technical abilities

Here is an example of what the docs site will look like

References

Linked issue: [Docs] Add target availability connectivity tro... (#577996) • Hannah Baker • 18.6

MR acceptance checklist

Evaluate this MR against the MR acceptance checklist. It helps you analyze changes to reduce risks in quality, performance, reliability, security, and maintainability.

Related to #577996

Edited by Hannah Baker

Merge request reports