Failed Scan Status Codes

Troubleshooting with too many potential issues can be a painstaking process. Failed statuses fall into two categories - platform failures and engine failures. Platform failures occur when there is an issue with the Rapid7 Insight Platform. Engine failures occur when there is an issue with the specific Scan Engine that you're attempting to utilize. Status codes help you find a starting point to get your scan back up and running.

If a scan fails to complete, a modal summarizing the potential issue displays the following status codes:

Platform failures:

BOOTSTRAP_AUTHENTICATION_FAILURE
Description: This status code displays when you run a Bootstrap Authentication scan and the file that the user recorded for login is invalid.
Action: Record valid login information.
ENGINE_UNAVAILABLE
Description: The platform is having difficulty identifying the Scan Engine.
Action: Examine your scan engine to discern if it is configured properly.
CANCELED
Description: You have canceled a scan.
Action: If cancelation was not intentional, run again.
CONFIGURATION_INVALID
Description: There is an issue with scan configuration. This most often occurs when there is an issue with a URL.
Action: See the platform log for specific information about why your current configuration is invalid.
LICENSE_INVALID
Description: There is a target/seed URL mismatch.
Action: Check the platform log for additional details and information.
SYSTEM_ERROR
Description: This is a generic status code that displays when the system is responsible for an error.
Action: Re-run the scan.

Engine failures:

BAD_AUTH
Description: Authentication has failed due to improper configuration or from a potential issue with a previously uploaded authentication file. For example a Macro, Traffic, or Selenium file.
DATABASE_TOO_LARGE
Description: The engine database has exceeded maximum size.
Action: Rerun the scan. If this issue reoccurs, contact our support team.
INITIALIZATION_FAILURE
Description: The scan has failed to start. This is typically caused by device or hardware problems.
INSUFFICIENT_DISK_SPACE
Description: You are running out of storage on your machine.
Action: Run smaller scans or increasing the VM size.
INSUFFICIENT_MEMORY
Description: Your machine does not have enough memory to properly run a scan.
Action: Increase the amount of RAM that is allocated to InsightAppSec.
NETWORK_UNAVAILABLE
Description: The site being scanned is offline.
Action: Check your network for potential issues.
REPORT_GENERATION_FAILURE
Description:: A fatal error occurred when creating a report.
Action:: Re-run the scan. If this error persists, contact our support team.
SWAGGER_PARSING_ERROR
Description: There are issues with parsing an attached swagger file.
Action: Review your swagger tools for potential issues. Ensure your files are parseable, as files that are rejected by https://editor.swagger.io/ are not compatible with our engine.
TOO_MANY_THREADS
Description: The thread count is greater than the maximum allowed.
Action: Reduce your thread count. To view thread count parameters, see the error message in additional logs > `operation log`.