Used by BBOT and BBOT Server.

CLI Usage

# installation
cargo install cloudcheck
lookup command
cloudcheck lookup 8.8.8.8
output:
[
  {
    "name": "Google",
    "tags": ["cloud"],
    "short_description": "A suite of cloud computing services provided by Google",
    "long_description": "Google Cloud Platform provides infrastructure, platform, and software services for businesses and developers"
  }
]
cloudcheck lookup asdf.amazon.com 
output:
 [   {     "name": "Amazon",     "tags": ["cloud"],     "short_description": "A comprehensive cloud computing platform provided by Amazon",     "long_description": "Amazon Web Services offers infrastructure services, storage, and computing power"   } ]

serve command - start REST API server
cloudcheck serve
Server listening on http://127.0.0.1:8080
Swagger UI available at http://127.0.0.1:8080/swagger-ui
OpenAPI spec available at http://127.0.0.1:8080/api-docs/openapi.json
serve with custom host and port
cloudcheck serve --host 0.0.0.0 --port 3000

REST API

curl http://127.0.0.1:8080/8.8.8.8

Python Library Usage

# installation
pip install cloudcheck

import asyncio
from cloudcheck import CloudCheck
async def main():     cloudcheck = CloudCheck()     results = await cloudcheck.lookup("8.8.8.8")     print(results) # [{'name': 'Google', 'tags': ['cloud']}]
asyncio.run(main())

Error Handling

import asyncio
from cloudcheck import CloudCheck, CloudCheckError
async def main():     cloudcheck = CloudCheck()     try:         results = await cloudcheck.lookup("8.8.8.8")         print(results)     except CloudCheckError as e:         print(f"Error: {e}")
asyncio.run(main())

Configuration

import asyncio
from cloudcheck import CloudCheck
async def main():     # Custom configuration     cloudcheck = CloudCheck(         signature_url="https://example.com/custom.json",  # Custom signature URL         max_retries=5,                                     # Max retry attempts (default: 10)         retrydelayseconds=2,                             # Delay between retries (default: 1)         force_refresh=True                                 # Force fresh fetch (default: False)     )     results = await cloudcheck.lookup("8.8.8.8")     print(results)
asyncio.run(main())

Rust Library Usage

# Add to Cargo.toml
[dependencies]
cloudcheck = "8.0"
tokio = { version = "1", features = ["full"] }

use cloudcheck::CloudCheck;
#[tokio::main] async fn main() {     let cloudcheck = CloudCheck::new();     let results = cloudcheck.lookup("8.8.8.8").await.unwrap();     println!("{:?}", results); // [CloudProvider { name: "Google", tags: ["cloud"] }] }

Error Handling

use cloudcheck::CloudCheck;
#[tokio::main] async fn main() {     let cloudcheck = CloudCheck::new();     match cloudcheck.lookup("8.8.8.8").await {         Ok(results) => println!("{:?}", results),         Err(e) => eprintln!("Error: {}", e),     } }

Configuration

use cloudcheck::CloudCheck;
#[tokio::main] async fn main() {     // Custom configuration     let cloudcheck = CloudCheck::with_config(         Some("https://example.com/custom.json".to_string()), // Custom signature URL         Some(5),                                              // Max retry attempts (default: 10)         Some(2),                                              // Delay between retries in seconds (default: 1)         Some(true)                                            // Force fresh fetch (default: false)     );          match cloudcheck.lookup("8.8.8.8").await {         Ok(results) => println!("{:?}", results),         Err(e) => eprintln!("Error: {}", e),     } }

Update the JSON database

export BBOTIOAPI_KEY=<your-api-key>
uv sync uv run cloudcheck_update/cli.py

Adding a new cloud provider

When adding a new cloud provider:

• Create a new file in the cloudcheck/providers directory and name it whatever you want, e.g. amazon.py.
• Inside that file, create a new class that inherits from BaseProvider.
• Inside that class, fill out any of the following attributes that are relevant to your provider:

Cloud Providers (60)

| Name | Description | Tags | Domains | Subnets | |------|-------------|------|---------|----------| | Akamai | A content delivery network and cloud services provider that delivers web and internet security services. | cloud | 81 | 6296 | | Alibaba Cloud | A Chinese cloud computing company and subsidiary of Alibaba Group, providing cloud services and infrastructure. | cloud | 445 | 98 | | Amazon Web Services | A comprehensive cloud computing platform provided by Amazon, offering infrastructure services, storage, and computing power. | cloud | 246 | 14719 | | Arvancloud | An Iranian cloud computing and content delivery network provider offering cloud infrastructure and CDN services. | cdn | 1 | 23 | | Backblaze | A cloud storage and backup service provider offering data backup and cloud storage solutions. | cloud | 2 | 26 | | Baidu Cloud Acceleration (百度云加速) | A Chinese content delivery network and cloud acceleration service provided by Baidu. | cdn | 136 | 0 | | Bunny CDN | A global content delivery network and edge platform. | cdn | 0 | 27 | | CacheFly | A content delivery network provider offering global CDN services. | cdn | 0 | 79 | | CDNetworks (씨디네트웍스) | A Korean content delivery network provider offering CDN and cloud services. | cdn | 0 | 3 | | Cisco | A multinational technology corporation that designs, manufactures, and sells networking hardware, software, and telecommunications equipment. | cloud | 121 | 662 | | Cloudflare | A web infrastructure and security company providing content delivery network services, DDoS mitigation, and web security solutions. | waf | 74 | 2724 | | Amazon CloudFront | A content delivery network service provided by Amazon Web Services that delivers data, videos, applications, and APIs to customers globally. | cdn | 0 | 179 | | DDoS Guard | A DDoS protection and content delivery network service provider. | cdn | 0 | 16 | | Dell | A multinational technology company that develops, sells, repairs, and supports computers and related products and services. | cloud | 236 | 94 | | DigitalOcean | A cloud infrastructure provider offering virtual private servers, managed databases, and other cloud services for developers and businesses. | cloud | 6 | 203 | | Department of Defense | A U.S. government agency responsible for coordinating and supervising all agencies and functions of the government directly related to national security and the United States Armed Forces. | gov | 3 | 9013 | | Federal Bureau of Investigation | A U.S. government agency that serves as the domestic intelligence and security service, responsible for investigating federal crimes and protecting national security. | gov | 3 | 23 | | Fastly | A content delivery network and edge cloud platform that provides edge computing, security, and performance services. | cdn | 8 | 1170 | | Gabia (가비아) | A Korean cloud hosting and infrastructure provider. | cloud | 0 | 48 | | G-Core Labs | A content delivery network and cloud infrastructure provider offering CDN, cloud computing, and edge services. | cdn | 0 | 1424 | | GitHub | A web-based platform for version control and collaboration using Git, providing hosting for software development and code repositories. | cdn | 63 | 5600 | | GoCache | A Brazilian content delivery network provider offering CDN services. | cdn | 0 | 25 | | Google Cloud | A suite of cloud computing services provided by Google, including infrastructure, platform, and software services for businesses and developers. | cloud | 1082 | 1948 | | Hewlett Packard Enterprise | A multinational enterprise information technology company that provides servers, storage, networking, and cloud services. | cloud | 16 | 41 | | Heroku | A cloud platform as a service that enables developers to build, run, and operate applications entirely in the cloud. | cloud | 12 | 0 | | Hetzner | A German cloud hosting provider offering dedicated servers, cloud instances, and storage solutions. | cloud | 15 | 118 | | Hostway (호스트웨이) | A Korean cloud hosting and infrastructure provider. | cloud | 0 | 59 | | Huawei | A Chinese multinational technology corporation that designs, develops, and sells telecommunications equipment, consumer electronics, and cloud services. | cloud | 345 | 264 | | IBM | A multinational technology corporation that provides hardware, software, cloud computing, and consulting services. | cloud | 20 | 401 | | iboss | A cloud security company providing secure web gateway, CASB, and zero trust network access services. | security | 0 | 72 | | Imperva | A cybersecurity company that provides web application firewall, DDoS protection, and data security solutions. | waf | 1 | 375 | | Kamatera | A cloud infrastructure provider offering virtual private servers, cloud servers, and managed cloud services. | cloud | 1 | 166 | | KINX (한국인터넷인프라) | A Korean content delivery network and cloud infrastructure provider. | cdn | 0 | 147 | | KT Cloud (KT클라우드) | A Korean cloud computing service provided by KT Corporation. | cloud | 0 | 18 | | Leaseweb | A global hosting and cloud infrastructure provider offering dedicated servers, cloud hosting, and CDN services. | cloud | 0 | 1444 | | LG U+ (LG유플러스) | A Korean telecommunications company offering CDN services. | cdn | 0 | 180 | | Microsoft | A multinational technology corporation that develops, manufactures, licenses, supports and sells computer software, consumer electronics and personal computers. Known for products like Windows, Office, Azure cloud services, and Xbox. | cloud | 751 | 40822 | | Microsoft 365 | A cloud-based productivity suite provided by Microsoft, including Office applications and cloud services. | cloud | 185 | 82 | | Naver Cloud Platform (네이버 클라우드 플랫폼) | A Korean cloud computing platform provided by Naver Corporation. | cloud | 0 | 71 | | NHN Cloud (NHN클라우드) | A Korean cloud computing platform provided by NHN Corporation. | cloud | 0 | 124 | | OVHcloud | A French cloud computing company that provides web hosting, dedicated servers, and cloud infrastructure services. | cloud | 3 | 603 | | Oracle | A multinational technology corporation that provides database software, cloud engineering systems, and enterprise software products. | cloud | 19 | 2644 | | Qrator | A DDoS protection and content delivery network service provider. | cdn | 0 | 23 | | Quic.cloud | A content delivery network and edge computing platform providing CDN services. | cdn | 0 | 154 | | Russian Federal Security Service | A Russian federal executive body responsible for counterintelligence, internal and border security, counterterrorism, and surveillance. | gov | 0 | 17 | | Rackspace | A managed cloud computing company that provides hosting, cloud services, and managed infrastructure solutions. | cloud | 1 | 215 | | Salesforce | A cloud-based software company that provides customer relationship management services and enterprise cloud computing solutions. | cloud | 41 | 48 | | Scaleway | A French cloud computing company that provides virtual private servers, bare metal servers, and cloud infrastructure services. | cloud | 1 | 45 | | SK Broadband (SK브로드밴드) | A Korean telecommunications company offering CDN services. | cdn | 0 | 22 | | StormWall | A DDoS protection and web application firewall service provider. | cdn | 0 | 18 | | Sucuri | A website security and web application firewall service provider. | waf | 0 | 20 | | Tencent Cloud (腾讯云) | A Chinese cloud computing service provider and subsidiary of Tencent, offering cloud infrastructure and platform services. | cloud | 692 | 369 | | United Kingdom Ministry of Defence | A U.K. government department responsible for implementing the defence policy of the United Kingdom and managing the British Armed Forces. | gov | 1 | 0 | | UpCloud | A Finnish cloud infrastructure provider offering high-performance cloud servers. | cloud | 0 | 52 | | Vultr | A global cloud hosting provider offering SSD-based cloud compute, bare metal, and managed Kubernetes. | cloud | 0 | 889 | | Wasabi | A cloud storage provider offering hot cloud storage services with high performance and low cost. | cloud | 1 | 19 | | X4B | A DDoS protection and content delivery network service provider. | cdn | 0 | 3 | | Yandex Cloud | Russian cloud computing and internet services provider, offering infrastructure, storage, and various digital services. | cloud | 130 | 95 | | Zoho | An Indian software company that provides cloud-based business software and productivity tools including CRM, email, and office suites. | cloud | 13 | 90 | | Zscaler | A cloud security company providing secure internet access, cloud security, and zero trust network access services. | cloud | 0 | 0 |

Development

Python

Setup

uv sync
uv run maturin develop --release

Running Tests

# python tests
uv run pytest test_cloudcheck.py -v
docker tests
python test_docker.py

Linting

# Check for linting issues
uv run ruff check && uv run ruff format .

Rust

Running Tests

cargo test --verbose --all-features

Formatting

cargo fmt --all
cargo clippy --all-targets --all-features -- -D warnings