# 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 [Bighuge BLS OSINT Tool (BBOT)](https://github.com/blacklanternsecurity/bbot).
## 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": "https://github.com/blacklanternsecurity/cloudcheck",
"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/a4/7c/3779802d55c9a5159acaa314ea82721cd2d619f28fdb5a9d91cae80b4b9e/cloudcheck-7.0.33.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 [Bighuge BLS OSINT Tool (BBOT)](https://github.com/blacklanternsecurity/bbot).\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.0.33",
"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": "",
"digests": {
"blake2b_256": "91cb2109e56f2f924a762a436d4df7a7f7cc0ceed6c33ff08c2d024810f44bf1",
"md5": "0c43785d772d469f409e035db5d3d2eb",
"sha256": "005d6888b3b4526888f98f9514487e801d521d756b48c7ff55daa9a638fda570"
},
"downloads": -1,
"filename": "cloudcheck-7.0.33-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0c43785d772d469f409e035db5d3d2eb",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.9",
"size": 114569,
"upload_time": "2024-12-16T13:23:20",
"upload_time_iso_8601": "2024-12-16T13:23:20.562548Z",
"url": "https://files.pythonhosted.org/packages/91/cb/2109e56f2f924a762a436d4df7a7f7cc0ceed6c33ff08c2d024810f44bf1/cloudcheck-7.0.33-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a47c3779802d55c9a5159acaa314ea82721cd2d619f28fdb5a9d91cae80b4b9e",
"md5": "26d9c04f3c3d450077f7bfe1629b827a",
"sha256": "36699d3868ffcdd3ac36e761e3c074a69d32120c787013d36820f6766ab73543"
},
"downloads": -1,
"filename": "cloudcheck-7.0.33.tar.gz",
"has_sig": false,
"md5_digest": "26d9c04f3c3d450077f7bfe1629b827a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.9",
"size": 106057,
"upload_time": "2024-12-16T13:23:23",
"upload_time_iso_8601": "2024-12-16T13:23:23.053043Z",
"url": "https://files.pythonhosted.org/packages/a4/7c/3779802d55c9a5159acaa314ea82721cd2d619f28fdb5a9d91cae80b4b9e/cloudcheck-7.0.33.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-16 13:23:23",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "blacklanternsecurity",
"github_project": "cloudcheck",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "cloudcheck"
}
JSON
