Common Crawling Issues
Questions about crawling? Check out the top questions we've received from customers below:
Does InsightAppSec Crawl SWF/Flash Files?
Yes, InsightAppSec can test the client and server traffic crated by Flash. You'll need to record the traffic in the Rapid7 AppSec Traffic Recorder or through a 3rd-party tool. InsightAppSec supports the following formats:
- AppSec toolkit Traffic Files (*.trec)
- Burp Files (*.xml)
- Paros Files (*.txt)
- WebScarab Files (conversationlog)
- HAR (HTTP Archive) Files (*.har)
- Fiddler Files (*.saz)
You can upload a traffic file to InsightAppSec by going to Scan Scope > Macro, Traffic & Selenium > Add Traffic File(s).
How Can I Increase Scan Speed?
In many cases, InsightAppSec will scan duplicate content to avoid missing anything. In some cases, this can create scans that are long. You can modify the following settings in the Advanced Options screen to reduce scan times.
MaxPerDirCrawlResults = 100
MaxPerLinkCrawlResults = 10
MaxPerDirChildNodes = 100
MaxAttackFeedbackLinksCount = 10
MaxPerFileNameCrawlResults = 100
ParameterToAttackBeforeLimitingAttacks = 1
LinksToAttackBeforLimitingAttacks = 1
MaxSameNameParameterAttackPoints = 5
MaxSameCookieParameterAttackPoints = 5
MaxSameNameParameterAttackPointsPerLink = 1
How do I record specific sequences and execute them in the same order?
Let's say that you want to record an exact sequence of events, such as filling out the shipping page during the checkout process, and attack that sequence. You can use the Use Sequence option that is available in [the Macros section](doc:scan-scope to record and replay events in sequential order.
The Use Sequence option allows you to attack the last pages within a sequence. However, if you enable this option, it can cause the scan to progress more slowly. It is advisable that you limit the scan to the macro only.
How do I scan certain parts of a web application, but exclude others?
InsightAppSec has extensive capabilities to allow users to crawl certain parts of an application and not others. You can use whitelists and blacklists to control the parts of the application that you scan. This includes capabilities with wildcards and regular expressions.
You can also use Macro, Traffic, and Selenium files to restrict your scan to a specific set of actions on your application. You can read more about this capability in the Scan Scope documentation.
What are the limitations on scanning REST interfaces?
Here are some key things we currently support:
- Formats - We support most of the popular formats used by REST interfaces, including Classic Name=Value, XML, JSON, CSV, and GwT.
- Authentication and session management - We support HTTP_AUTH, Cookies, and OAuth. We also provide interfaces for custom solutions.
- Discovery - To understand what methods and inputs are available, you must provide recorded traffic between a client of the REST interface and the REST interface. We support Swagger Documents and URLs.
Here are a couple of key limitations when performing large scale scanning:
- Authentication and session management - If you are using a scheme we currently do not support, then code must be written for each scheme.
- Discovery - Although we can automatically scan Swagger based Documents and URLs, we do not have support for RAML and API Blueprint for discovery. These technologies rely on the manual process of generating and recording traffic between the client and REST interface.
What is the difference between the acme.com/* literal match and acme.com/* wildcard?
* is a wildcard but it only works as a wildcard if the match type is wildcard, otherwise it is considered a literal.
What is the difference between the browser macro and recorded traffic?
The Browser Macro records user actions and can be replayed over and over. For example, if you enter "John" in a form field and hit enter, the requests are generated from these actions at runtime. Whereas recorded traffic records raw requests and the traffic is used as is unless session cookies are replaced.
Both have their advantages, except that macros have the potential of failing on each step, so the fewer steps there are, the less likely you are to run into issues. It is recommended that macros do not contain more than 10 steps. If you intend to perform longer recordings, you should use a traffic recording.
Traffic recording works well when there isn't any special functionality implemented on the website to prevent traffic replay, such as one time tokens. It is impossible to replay a request that has one time token. Flash is also not supported in macros, so if you want to test AMF traffic, you need to create traffic recording.
What level of failed requests is a cause for concern?
5% or more is a good rule of thumb. InsightAppSec monitors server responsiveness and slows down or increases its speeds if it looks like InsightAppSec is DOSsing the site.
You can manually change InsightAppSec concurrent threads and delays between requests in the GUI while a scan is running to slow InsightAppSec down.
Sometimes, sections of a website, such as database queries, can be slower than other sections of a website which will be more CPU intensive for the server hosting the website. So InsightAppSec may be able to scan one section of a site with no problems, but then encounter an area of the site that is slower and causes more failed requests.
Will InsightAppSec test pages that are linked to from the website being tested?
No, it will not. InsightAppSec follows the guidelines set in the Crawl Restrictions and will not test any pages that you do not configure it to test.