| Name | cloudcheck JSON |
| Version |
7.2.114
JSON |
| download |
| home_page | None |
| Summary | Check whether an IP address belongs to a cloud provider |
| upload_time | 2025-08-07 16:15:26 |
| 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/aa/67/c39942eca31ba4774cb76472c11485823e3bce80b0c52d85b75b103b36aa/cloudcheck-7.2.114.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.114",
"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": "516c37fb5e8e4d2180d18b8afa562a4513919c19f548e1671b89959de3e56fb8",
"md5": "b79ba168cdae8b838fe6019c04790f23",
"sha256": "0cbdd70739e1f9b55f8eb9f9d578692041061e43c211f4580b6a17406bc369e5"
},
"downloads": -1,
"filename": "cloudcheck-7.2.114-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b79ba168cdae8b838fe6019c04790f23",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.9",
"size": 17394,
"upload_time": "2025-08-07T16:15:25",
"upload_time_iso_8601": "2025-08-07T16:15:25.357404Z",
"url": "https://files.pythonhosted.org/packages/51/6c/37fb5e8e4d2180d18b8afa562a4513919c19f548e1671b89959de3e56fb8/cloudcheck-7.2.114-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "aa67c39942eca31ba4774cb76472c11485823e3bce80b0c52d85b75b103b36aa",
"md5": "d8622131de21be7f0a38bc5eefeec771",
"sha256": "de002853b99efd3e0a5f1462873e4eab3a6e338f692bd7318c9523b07fe5f52e"
},
"downloads": -1,
"filename": "cloudcheck-7.2.114.tar.gz",
"has_sig": false,
"md5_digest": "d8622131de21be7f0a38bc5eefeec771",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.9",
"size": 112016,
"upload_time": "2025-08-07T16:15:26",
"upload_time_iso_8601": "2025-08-07T16:15:26.530213Z",
"url": "https://files.pythonhosted.org/packages/aa/67/c39942eca31ba4774cb76472c11485823e3bce80b0c52d85b75b103b36aa/cloudcheck-7.2.114.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-07 16:15:26",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "blacklanternsecurity",
"github_project": "cloudcheck",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "cloudcheck"
}
