Allowlist, Add, and Manage Targets
CRC Advanced Only
This functionality is only included in the CRC Advanced offering.
Targets are domains that you add to the allowlist so that you can include them in apps and scans. InsightAppSec targets the domain for the attacks in the scan configuration to test for vulnerabilities.
To add apps and configure and run scans, you must add targets to the allowlist. To keep the allowlist clean and the list of active targets up to date, manage existing targets.
Removing targets
To make it easier to find relevant targets, keep your allowlist clean by removing targets that you don't need anymore. You can archive and disable previously scanned (used) targets and delete and disable unused targets.
Check out our FAQ for more information on allowlists and targets.
Add a target to the allowlist
Allowlisting target domains is a critical step for creating a scan config. Only the domain is required for adding to the allowlist. Protocols and subdirectories will be removed during scanning.
- On the Targets page, click Add Targets.
- When the Add Targets page appears, input one or more target domains you want to allowlist.
- Enter a domain in URL format:
protocol://subdomain.domain.com/subdirectory
- To bulk add multiple target domains, enter each domain on a new line.
- Enter a domain in URL format:
- Click Add Targets.
All newly allowlisted target domains are enabled by default, unless configured otherwise.
Manage existing targets
When you're not using a target domain anymore and want it excluded from scans, you can disable and enable or archive as needed. If you attempt to add a disabled or archived target domain, you will be prompted to allowlist it. If you have a target domain that hasn't been scanned, you can delete it.
View the allowlist
On the left navigation menu, click Targets. The page that displays is the allowlist.
In each target row, you can disable, enable, archive, and delete targets.
Disable or enable targets
- On the Targets page, select the target you want to edit.
- To disable the target, toggle the Enable button off.
- To enable the target, toggle the Enable button on.
Archive used targets
- On the Targets page, select the target you want to edit.
- To archive previously scanned targets, click the Archive icon in the Enabled column.
- In the confirmation window, click Archive Target.
Unarchive targets
- On the Settings page, in the Scan Options section, click Manage next to Archived Targets.
- Select the target you want to unarchive.
- In the Total Scans column, click the Unarchive icon.
Delete unused targets
You can only delete target domains that have not been scanned. Disable or archive scanned targets instead.
- On the Targets page, select the target you want to delete.
- In the selected target row, click Delete.
Check scan configs
If you are disabling or archiving a target domain, existing scan configs that use it may be affected. Check your scan configs to ensure that the target domains can be taken offline.
Frequently asked questions:
What's an allowlist?
An allowlist is the list of IP addresses that you allow InsightAppSec to interact with. You may have also heard this element called "whitelist," which is an outdated term.
Which IP addresses do I need to add to my allowlist?
Some firewalls may block attack traffic and prevent InsightAppSec from testing your application for vulnerabilities. In such cases, you must allowlist the IP addresses of the InsightAppSec cloud engines to scan your web applications. The following table provides the IP addresses of the InsightAppSec engines based on the region where your platform account is hosted. When you log in to InsightAppSec, the region is the first sub-domain in the URL. For example, if the url is https://us2.appsec.insight.rapid7.com
then your region is US-East-2.
Is your Rapid7 product subscription provisioned for the United States? Check your region code first!
As of April 12th, 2021, all new customers subscribing to Rapid7 Insight products that elect to store their data in the United States will be provisioned for one of three data centers. Since these data centers have unique endpoints, any firewall rules you configure must correspond to the data center your organization is assigned to. Follow these steps to determine which United States data center your organization is part of:
- Go to insight.rapid7.com and sign in with your Insight account email address and password.
- Navigate to the Platform Home page.
- If you are not taken to this page by default, expand the product dropdown in the upper left and click My Account.
- Look for the Data Storage Region tag in the upper right corner of the page below your account name. Your United States region tag will show one of the following data centers:
- United States - 1
- United States - 2
- United States - 3
Consult the following table to determine which IPs must be allowlisted according to your region.
Region | IPs to allowlist |
---|---|
US-1 | 34.205.208.125 34.192.183.106 34.224.19.93 34.227.121.223 |
US-2 | 52.14.12.25 52.14.88.11 3.22.113.166 |
US-3 | 52.36.241.148 52.36.245.161 44.228.9.4 |
EU | 35.158.144.37 35.156.166.245 172.104.153.232 |
CA | 52.60.149.201 52.60.191.46 172.104.11.18 |
AU | 52.63.190.180 52.62.83.29 139.162.25.220 |
AP/Tokyo | 172.104.83.134 52.68.0.155 54.64.21.140 |
How does InsightAppSec use the targets in the allowlist?
When you create an app, you select one or more targets. The targets in the selection are pulled from the allowlist.
How do I clean up my allowlist?
If you have a lot of targets in your allowlist, you can archive the ones you have scanned previously, but no longer need. Archiving removes used targets from the target selection list when creating an app or scan config, but allows you to unarchive the targets whenever necessary.
What do I do with targets that I don't need right now, but may need later?
You can clean up your allowlist so that when you select targets, only active targets appear. The easiest way to do this is to archive used targets and delete unused targets.
Can I delete targets that I've already scanned?
No, you cannot delete targets that have been included in a previous scan. Instead of deleting, you can disable or archive scanned targets.
You can only delete unused targets.