Skip to content

Commit c89e2d3

Browse files
Merge pull request #102 from projectdiscovery/docs/more-improvements
fix typos, navigation, overviews
2 parents 8bf0d54 + 12dd12a commit c89e2d3

12 files changed

+582
-474
lines changed

cloud/assets/adding-assets.mdx

Lines changed: 76 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -1,63 +1,104 @@
11
---
2-
title: "Assets in PDCP"
3-
description: "Adding and managing Assets in ProjectDiscovery Cloud Platform"
2+
title: "Adding Assets"
3+
description: "Learn how to add and manage assets in ProjectDiscovery Cloud Platform"
44
sidebarTitle: "Adding Assets"
55
---
6-
## Summary
7-
Assets are any hosts added to ProjectDiscovery Cloud Platform (PDCP) for scanning. Hosts can be a URL, an IP address, or a CIDR range.
86

9-
Assets can be added through either the Assets tab, or during the creation of a scan. Regardless of the path, adding assets to the Cloud Platform is the first step to running a scan and securing your tech stack against exploitable vulnerabilities.
7+
## Overview
108

11-
<img height="200" src="/images/platform/assetspage.png" />
9+
Assets in ProjectDiscovery Cloud Platform can be any hosts you want to monitor - URLs, IP addresses, or CIDR ranges. There are three primary methods to add assets:
1210

13-
From the Assets tab, there are three methods to add your assets:
14-
- Add New Assets
15-
- Connect Cloud Services
16-
- HttpX Integration
11+
<CardGroup cols={3}>
12+
<Card
13+
title="Asset Discovery"
14+
icon="magnifying-glass"
15+
href="#asset-discovery">
16+
Automatically discover and monitor assets from your root domains
17+
</Card>
18+
<Card
19+
title="Cloud Services"
20+
icon="cloud"
21+
href="/cloud/integrations#cloud-asset-discovery">
22+
Connect cloud providers to import and sync assets automatically
23+
</Card>
24+
<Card
25+
title="API Integration"
26+
icon="code"
27+
href="https://docs.projectdiscovery.io/api-reference/enumerations/create-enumeration">
28+
Programmatically add and manage assets using our REST API
29+
</Card>
30+
</CardGroup>
1731

18-
Each unique path, including those with specified ports will be added as an individual asset for scanning. If you have questions about your specific setup, get in touch with us at [email protected].
32+
## Asset Discovery
1933

20-
## Discover New Assets
34+
The fastest way to get started is through our asset discovery feature:
2135

22-
Discovery is the easiest method of importing assets into PDCP for vulnerability scanning.
36+
1. Navigate to **Assets → Add New Assets**
37+
2. Enter root domains/CIDR/IPs based on your plan:
2338

24-
<img height="200" src="/images/platform/addassets.png" />
39+
<CardGroup cols={3}>
40+
<Card title="Free Plan" icon="star">
41+
✓ Up to 10 root domains only
2542

26-
- **Scope**: manually input your list of up to 10 root domains in the Free plan, or up to 100 root domains in Pro.
43+
✓ Basic subdomain discovery
2744

28-
- Auto Discovery is enabled by default and will automatically discover your assets including subdomains, open ports, and other web technologies. Port scanning and technology detection is available in Pro and Enterprise plans only.
29-
- *Note: Disable Auto Discovery to restrict upload to your specified asset list.*
45+
✓ HTTP probing
3046

31-
- Domain, IP address, or CIDR. For CIDR ranges each individual IP will be added as a single asset.
47+
✓ Basic technology detection
3248

33-
- **Advanced**: Turning off Auto Discovery disables all discovery settings.
49+
✓ Limited cloud asset discovery
50+
</Card>
3451

35-
- Use Advanced to modify individual discovery settings for subdomains, open ports, etc.
36-
- Customize the frequency of Auto Discovery to continuously monitor for new assets.
52+
<Card title="Pro Plan" icon="rocket">
53+
✓ Up to 100 root domains
3754

38-
<img height="200" src="/images/platform/assetsadvanced.png" />
55+
✓ Advanced subdomain enumeration
3956

40-
<Info> Check out [What is exposed?](/cloud/examples/addassets) for an example of adding assets for Discovery or Cloud Integration. </Info>
57+
✓ Port scanning (Top 1000 ports)
4158

42-
## Connect Cloud Services
59+
✓ Deep technology fingerprinting
4360

44-
The **Connect Cloud Services** option connects your PDCP environment to any of our supported cloud providers and pull in assets once configured.
61+
✓ Cloud integration
4562

46-
<img height="200" src="/images/platform/connectcloudservices.png" />
63+
✓ Historical data tracking
4764

48-
Cloud connections can be configured to check for updates to your assets and ensure your information is up to date.
65+
✓ Custom discovery schedules
4966

50-
For the majority of integrations, you only need to provide a name and the token or access details generated by the provider.
67+
✓ CIDR range scanning
5168

52-
## HttpX Integration
69+
✓ IP block discovery
5370

54-
See HttpX Integration [docs](https://docs.projectdiscovery.io/tools/httpx/running#ui-dashboard-pdcp-integration) and [blog](https://blog.projectdiscovery.io/introducing-httpx-dashboard-2/) for more details.
71+
✓ Network perimeter mapping
72+
</Card>
5573

56-
## Managing Assets
74+
<Card title="Enterprise Plan" icon="building">
75+
✓ Custom limits
5776

58-
Once your assets are added successfully they display in the asset list.
77+
✓ Advanced asset enrichment
5978

60-
- Use the context menu to rename, **Update** to add or remove assets, Re-Discover, or Delete.
61-
- Uploaded assets are immediately available to use in scans.
62-
- Assets that are part of an existing scan cannot be deleted.
79+
✓ Advanced cloud correlation
80+
81+
✓ Custom enrichment rules
82+
83+
✓ Dedicated discovery nodes
84+
85+
✓ Priority asset updates
86+
87+
✓ ASN-based discovery
88+
89+
✓ Certificate chain analysis
90+
91+
✓ Subsidiary discovery
92+
93+
✓ Related domain correlation
94+
95+
✓ Company hierarchy mapping
96+
97+
✓ Acquisition tracking
98+
</Card>
99+
</CardGroup>
100+
101+
<Note>
102+
Discovery features can be customized for Enterprise plans. Contact our [sales team](mailto:[email protected]) for custom requirements.
103+
</Note>
63104

cloud/assets/overview.mdx

Lines changed: 55 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -1,55 +1,80 @@
11
---
2-
title: "ProjectDiscovery Cloud Platform Assets"
3-
description: "A high-level overview of the PDCP Asset functionality"
2+
title: "Asset Discovery and Management"
43
sidebarTitle: "Overview"
54
---
65

7-
## Overview
8-
In the ProjectDiscovery Cloud Platform (PDCP), an asset is any host or target for vulnerability scanning. An asset is defined as the combination of a host (subdomain or IP address) and a specific port.
6+
Attack Surface Management (ASM) is the continuous discovery, inventory, classification, and monitoring of your external-facing and internal assets. These assets include any internet-facing systems, cloud resources, or services that could potentially be accessed by attackers.
97

10-
Assets can be discovered via Auto-Discovery from a root domain or specified IP/CIDR range. Note: IP and CIDR range discovery and enrichment are only available on Pro and Enterprise plans.
8+
<CardGroup cols={3}>
9+
<Card
10+
title="Asset Discovery"
11+
icon="magnifying-glass"
12+
href="/cloud/assets/adding-assets#asset-discovery">
13+
Automated discovery and monitoring from root domains
14+
</Card>
15+
<Card
16+
title="Cloud Services"
17+
icon="cloud"
18+
href="/cloud/integrations#cloud-asset-discovery">
19+
Multi-cloud asset discovery and integration
20+
</Card>
21+
<Card
22+
title="API Integration"
23+
icon="code"
24+
href="https://docs.projectdiscovery.io/api-reference/enumerations/create-enumeration">
25+
Programmatic asset management via REST API
26+
</Card>
27+
</CardGroup>
1128

12-
Assets can also be imported through our cloud integrations or direct upload through a .txt file.
29+
## Our Approach
1330

14-
Once assets are added to PDCP, they can be selected as targets in a vulnerability scan.
31+
ProjectDiscovery combines battle-tested open-source tools with cloud-native capabilities:
1532

16-
![Assets](/images/platform/assetspage.png)
33+
<CardGroup cols={2}>
34+
<Card title="Open Source Foundation" icon="github">
35+
[Subfinder](https://github.com/projectdiscovery/subfinder) for subdomain discovery
1736

18-
## FAQ
37+
[Naabu](https://github.com/projectdiscovery/naabu) for port scanning
1938

20-
### General
21-
**Is there a limitation to how many root domains I can run auto-discovery on?**
39+
[Httpx](https://github.com/projectdiscovery/httpx) for HTTP probing
2240

23-
The Free tier supports up to 10 root domain discoveries per month, while Pro supports 100 domains per month and Enterprise offers custom limits.
41+
[Cloudlist](https://github.com/projectdiscovery/cloudlist) for cloud assets
2442

25-
**What kind of Assets are supported?**
43+
[TLSx](https://github.com/projectdiscovery/tlsx) for certificate analysis
2644

27-
Assets or hosts can be a URL, an IP address, a root domain, or a CIDR range.
45+
[Uncover](https://github.com/projectdiscovery/uncover) for exposed asset search
46+
</Card>
47+
<Card title="Cloud Platform Features" icon="cloud">
48+
✓ Advanced subdomain enumeration
2849

29-
**Can everyone in my team see all the Assets that were added to my environment?**
50+
✓ Port scanning (1-65535)
3051

31-
Yes, all assets in your environment are shared across your team.
52+
✓ Deep technology fingerprinting
3253

33-
### Assets and Scans
54+
✓ Cloud asset discovery
3455

35-
**Can I exempt specific assets from a scan?**
56+
✓ ASN-based discovery
3657

37-
Building a new scan requires you to choose assets as part of the scan configuration, so yes, scans will apply to whatever assets you include in the scan.
58+
✓ Certificate chain analysis
3859

39-
### Adding and Modifying Assets
60+
</Card>
61+
</CardGroup>
4062

41-
**What's the difference between Add Assets, cloud integration?**
63+
## Getting Started
4264

43-
- Add allows you to choose a list of individual assets or root domains to add as a list or TXT file.
44-
45-
- Enabling **Auto Discovery** automatically enumerates associated subdomains and open ports. Each subdomain or unique path identified is added as individual asset.
65+
Choose your preferred method to start building your asset inventory:
4666

47-
- Cloud Integrations connect your cloud service provider and import any assets identified.
67+
<Steps>
68+
1. **Asset Discovery**
69+
Start with root domains and let our platform discover your assets automatically. [Learn more →](/cloud/assets/adding-assets#asset-discovery)
4870

49-
**Can I edit existing Assets?**
71+
2. **Cloud Integration**
72+
Connect your cloud providers for automated asset sync. [View providers →](/cloud/integrations#cloud-asset-discovery)
5073

51-
Yes! Assets that are added to PDCP can be renamed.
74+
3. **API Integration**
75+
Programmatically manage assets using our REST API. [API docs →](https://docs.projectdiscovery.io/api-reference/enumerations/create-enumeration)
76+
</Steps>
5277

53-
**Can I delete Assets?**
54-
55-
You can delete any assets, however assets that are included in a scan will generate an error.
78+
<Note>
79+
Need help getting started? Contact our [support team](mailto:[email protected]) or join our [Discord community](https://discord.gg/projectdiscovery).
80+
</Note>

cloud/integrations.mdx

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,7 @@
22
title: "Platform Integrations"
33
description: "Technical guide for configuring third-party integrations for cloud assets, vulnerability scanning, alerts, and ticketing"
44
sidebarTitle: "Integrations"
5+
icon: "plug-circle-plus"
56
---
67

78
## Summary

cloud/introduction.mdx

Lines changed: 55 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
---
22
title: "Introducing ProjectDiscovery Cloud Platform"
33
sidebarTitle: "Introduction"
4+
icon: "book-open"
45
---
56

67
<Tip>
@@ -9,14 +10,31 @@ Sign up for [ProjectDiscovery Cloud Platform](https://cloud.projectdiscovery.io/
910
Have a complex company use case? Get [Enterprise grade assistance](https://projectdiscovery.io/request-demo)
1011
</Tip>
1112

12-
## What is ProjectDiscovery Cloud Platform?
13+
ProjectDiscovery Cloud Platform combines real-world attack detection with comprehensive vulnerability management. By leveraging our battle-tested open-source security tools used by over 100,000 security professionals worldwide, our platform helps organizations focus on what matters most - truly exploitable security risks.
1314

14-
ProjectDiscovery Cloud Platform combines real-world attack detection with comprehensive vulnerability management. By leveraging our battle-tested open-source security tools used by over 100,000 security professionals worldwide, our platform helps organizations focus on what matters most - truly exploitable security risks:
15+
While traditional VM tools focus on CVE matching and version scanning, ProjectDiscovery Cloud takes an attacker's perspective:
1516

16-
- **Detect Real Threats**: Stay ahead of trending internet attacks with community-powered security templates
17-
- **Validate Exploitability**: Focus only on vulnerabilities that attackers can actually exploit
18-
- **Streamline Security**: Transform traditional vulnerability management into a risk-based program
19-
- **Accelerate Response**: Quickly validate and remediate exploitable threats with clear proof of concepts
17+
<CardGroup cols={2}>
18+
<Card title="Actual Exploitability" icon="check-double">
19+
Validate vulnerabilities through real exploitation attempts instead of version checks
20+
</Card>
21+
22+
<Card title="Beyond CVEs" icon="shield-exclamation">
23+
Detect exploitable misconfigurations and security gaps that traditional scanners miss
24+
</Card>
25+
26+
<Card title="Proof of Concept" icon="microscope">
27+
Every finding includes clear evidence and reproduction steps
28+
</Card>
29+
30+
<Card title="AI-Powered Detection" icon="robot">
31+
Write custom vulnerability detections with AI assistance and knowledge sharing
32+
</Card>
33+
34+
<Card title="Community-Powered" icon="users">
35+
Leverage our global open-source community to rapidly detect emerging threats
36+
</Card>
37+
</CardGroup>
2038

2139
Our platform uniquely combines Vulnerability Management, Attack Surface Management, and Continuous Threat Exposure Management into a single, exploitability-focused solution with zero setup overhead - helping you manage security risks the way attackers see them, right from day one.
2240

@@ -30,43 +48,41 @@ Our platform uniquely combines Vulnerability Management, Attack Surface Manageme
3048
allowfullscreen
3149
></iframe>
3250

33-
## Why ProjectDiscovery Cloud Platform?
34-
35-
### Beyond Traditional Vulnerability Management
36-
37-
While traditional VM tools focus on CVE matching and version scanning, ProjectDiscovery Cloud takes an attacker's perspective by:
38-
- Validating actual exploitability instead of relying on version checks
39-
- Detecting misconfigurations and security gaps beyond CVEs
40-
- Providing clear proof of concept for each finding
41-
- Enabling custom security checks for your unique attack surface
42-
43-
### Continuous Asset Discovery
44-
45-
ProjectDiscovery Cloud provides comprehensive visibility across your entire attack surface:
46-
- Multi-cloud asset discovery powered by our Cloudlist technology
47-
- Infrastructure and platform service monitoring
48-
- Continuous DNS and subdomain enumeration
49-
- Application and API endpoint discovery
50-
51-
### Zero False Positives
52-
53-
Our modern vulnerability detection engine powered by Nuclei ensures:
54-
- Every finding is validated through actual exploitation attempts
55-
- Clear proof of concept with each vulnerability
56-
- Custom templates that match your security requirements
57-
- Rapid detection of new threats through our community
58-
59-
### Complete Transparency
6051

61-
Unlike black-box security tools, ProjectDiscovery Cloud provides:
62-
- Full visibility into detection methods through Nuclei templates
63-
- Custom template creation for your specific needs
64-
- Clear remediation steps for each finding
65-
- Integration with your existing security workflow
52+
## Getting Started
53+
54+
<CardGroup cols={2}>
55+
<Card
56+
title="Asset Discovery & Management"
57+
icon="radar"
58+
href="/cloud/assets/overview">
59+
Continuous discovery and monitoring of your attack surface across multi-cloud environments, domains, and infrastructure. Powered by our battle-tested open-source tools and cloud-native capabilities for comprehensive asset visibility.
60+
</Card>
61+
62+
<Card
63+
title="External Vulnerability Scanning"
64+
icon="globe"
65+
href="/cloud/scanning/createscans">
66+
Automated and precise external scanning with zero false positives. Every finding includes proof of concept and clear remediation steps. Supports both automated continuous monitoring and targeted assessments.
67+
</Card>
68+
69+
<Card
70+
title="Internal Network Scanning"
71+
icon="network-wired"
72+
href="/cloud/scanning/nuclei-scan">
73+
Secure internal vulnerability assessment through local scanning or cloud-managed TunnelX. Identify critical internal vulnerabilities before attackers can exploit them for lateral movement.
74+
</Card>
75+
76+
<Card
77+
title="Integrations"
78+
icon="puzzle-piece"
79+
href="/cloud/integrations">
80+
Seamless integration with your security stack including Slack, Teams, JIRA, GitHub, and custom webhooks. Automate vulnerability management and streamline your security operations.
81+
</Card>
82+
</CardGroup>
6683

6784
If you're new to ProjectDiscovery:
6885
- Get started with a [free ProjectDiscovery Cloud account](cloud.projectdiscovery.io)
69-
- Learn about the [key benefits](/cloud/features) of Cloud
7086
- Explore our [open source tools](/tools/index)
7187
- Join our [Discord community](https://discord.com/invite/projectdiscovery)
7288

0 commit comments

Comments
 (0)