| Name | cloudcheck JSON |
| Version |
7.2.149
JSON |
| download |
| home_page | None |
| Summary | Check whether an IP address belongs to a cloud provider |
| upload_time | 2025-09-08 13:50:38 |
| maintainer | None |
| docs_url | None |
| author | TheTechromancer |
| requires_python | <4.0,>=3.9 |
| license | GPL-3.0 |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# CloudCheck
A simple Python utility to check whether an IP address or hostname belongs to a cloud provider.
`cloud_providers.json` contains lists of domains and up-to-date CIDRs for each cloud provider (updated daily via CI/CD).
Used by [BBOT](https://github.com/blacklanternsecurity/bbot) and [BBOT Server](https://github.com/blacklanternsecurity/bbot-server).
## Installation
~~~bash
pip install cloudcheck
~~~
## Usage - CLI
~~~bash
$ cloudcheck 168.62.20.37
168.62.20.37 belongs to Azure (cloud) (168.62.0.0/19)
$ cloudcheck test.evilcorp.azurewebsites.net
test.evilcorp.azurewebsites.net belongs to Azure (cloud) (azurewebsites.net)
~~~
## Usage - Python
~~~python
import cloudcheck
provider, provider_type, subnet = cloudcheck.check("168.62.20.37")
print(provider) # "Azure"
print(provider_type) # "cloud"
print(subnet) # IPv4Network('168.62.0.0/19')
~~~
## Supported cloud providers
- Akamai ([source](https://techdocs.akamai.com/property-manager/pdfs/akamai_ipv4_ipv6_CIDRs-txt.zip))
- Amazon ([source](https://ip-ranges.amazonaws.com/ip-ranges.json))
- Arvancloud ([source](https://www.arvancloud.ir/en/ips.txt))
- Azure ([source](https://www.microsoft.com/en-us/download/confirmation.aspx?id=56519))
- Cloudflare ([source](https://api.cloudflare.com/client/v4/ips))
- Cloudfront ([source](https://d7uri8nf7uskq.cloudfront.net/tools/list-cloudfront-ips))
- DigitalOcean ([source](http://digitalocean.com/geo/google.csv))
- Fastly ([source](https://api.fastly.com/public-ip-list))
- Github ([source](https://api.github.com/meta))
- Google ([source](https://www.gstatic.com/ipranges/cloud.json))
- Imperva ([source](https://my.imperva.com/api/integration/v1/ips))
- Oracle Cloud ([source](https://docs.cloud.oracle.com/en-us/iaas/tools/public_ip_ranges.json))
- Zoho ([source](https://github.com/blacklanternsecurity/cloudcheck/blob/master/cloudcheck/providers/zoho.py))
Raw data
{
"_id": null,
"home_page": null,
"name": "cloudcheck",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.9",
"maintainer_email": null,
"keywords": null,
"author": "TheTechromancer",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/5b/24/e72b0dc3b219787a61cdd1ae1250d143227b73424c50c6ddfa7258f95914/cloudcheck-7.2.149.tar.gz",
"platform": null,
"description": "# CloudCheck\n\nA simple Python utility to check whether an IP address or hostname belongs to a cloud provider.\n\n`cloud_providers.json` contains lists of domains and up-to-date CIDRs for each cloud provider (updated daily via CI/CD).\n\nUsed by [BBOT](https://github.com/blacklanternsecurity/bbot) and [BBOT Server](https://github.com/blacklanternsecurity/bbot-server).\n\n## Installation\n~~~bash\npip install cloudcheck\n~~~\n\n## Usage - CLI\n~~~bash\n$ cloudcheck 168.62.20.37\n168.62.20.37 belongs to Azure (cloud) (168.62.0.0/19)\n\n$ cloudcheck test.evilcorp.azurewebsites.net\ntest.evilcorp.azurewebsites.net belongs to Azure (cloud) (azurewebsites.net)\n~~~\n\n## Usage - Python\n~~~python\nimport cloudcheck\n\nprovider, provider_type, subnet = cloudcheck.check(\"168.62.20.37\")\nprint(provider) # \"Azure\"\nprint(provider_type) # \"cloud\"\nprint(subnet) # IPv4Network('168.62.0.0/19')\n~~~\n\n## Supported cloud providers\n- Akamai ([source](https://techdocs.akamai.com/property-manager/pdfs/akamai_ipv4_ipv6_CIDRs-txt.zip))\n- Amazon ([source](https://ip-ranges.amazonaws.com/ip-ranges.json))\n- Arvancloud ([source](https://www.arvancloud.ir/en/ips.txt))\n- Azure ([source](https://www.microsoft.com/en-us/download/confirmation.aspx?id=56519))\n- Cloudflare ([source](https://api.cloudflare.com/client/v4/ips))\n- Cloudfront ([source](https://d7uri8nf7uskq.cloudfront.net/tools/list-cloudfront-ips))\n- DigitalOcean ([source](http://digitalocean.com/geo/google.csv))\n- Fastly ([source](https://api.fastly.com/public-ip-list))\n- Github ([source](https://api.github.com/meta))\n- Google ([source](https://www.gstatic.com/ipranges/cloud.json))\n- Imperva ([source](https://my.imperva.com/api/integration/v1/ips))\n- Oracle Cloud ([source](https://docs.cloud.oracle.com/en-us/iaas/tools/public_ip_ranges.json))\n- Zoho ([source](https://github.com/blacklanternsecurity/cloudcheck/blob/master/cloudcheck/providers/zoho.py))\n\n",
"bugtrack_url": null,
"license": "GPL-3.0",
"summary": "Check whether an IP address belongs to a cloud provider",
"version": "7.2.149",
"project_urls": {
"Discord": "https://discord.com/invite/PZqkgxu5SA",
"Homepage": "https://github.com/blacklanternsecurity/cloudcheck",
"PyPi": "https://pypi.org/project/cloudcheck/",
"Repository": "https://github.com/blacklanternsecurity/cloudcheck"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "cfc34e80735deb804519684e14cb38a347fb6477acbc5a5885bbe18e7bf52992",
"md5": "eb6c3ffc53c24fb0ce62d9fab1fa23cd",
"sha256": "5eedd0e5a78596e7aec8a1e344fb16c3066c45ea64642d34a8523df0c9ce4a8f"
},
"downloads": -1,
"filename": "cloudcheck-7.2.149-py3-none-any.whl",
"has_sig": false,
"md5_digest": "eb6c3ffc53c24fb0ce62d9fab1fa23cd",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.9",
"size": 17394,
"upload_time": "2025-09-08T13:50:37",
"upload_time_iso_8601": "2025-09-08T13:50:37.392090Z",
"url": "https://files.pythonhosted.org/packages/cf/c3/4e80735deb804519684e14cb38a347fb6477acbc5a5885bbe18e7bf52992/cloudcheck-7.2.149-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "5b24e72b0dc3b219787a61cdd1ae1250d143227b73424c50c6ddfa7258f95914",
"md5": "2bdc97a3ac8e2cfe2e1e8f3513426afd",
"sha256": "419c549581da2cb3e955f5fe4113724e25639b1678075f3aee56e8a68a865801"
},
"downloads": -1,
"filename": "cloudcheck-7.2.149.tar.gz",
"has_sig": false,
"md5_digest": "2bdc97a3ac8e2cfe2e1e8f3513426afd",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.9",
"size": 127833,
"upload_time": "2025-09-08T13:50:38",
"upload_time_iso_8601": "2025-09-08T13:50:38.794656Z",
"url": "https://files.pythonhosted.org/packages/5b/24/e72b0dc3b219787a61cdd1ae1250d143227b73424c50c6ddfa7258f95914/cloudcheck-7.2.149.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-08 13:50:38",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "blacklanternsecurity",
"github_project": "cloudcheck",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "cloudcheck"
}
