# hfinder
![](assets/logo.png)
## Description
**Hosts Finder**
Help recon of hostnames from specific ASN(s) or CIDR(s), thanks to [https://bgp.he.net/](https://bgp.he.net/) and [https://www.robtex.com/](https://www.robtex.com/).
Can generate filtered /etc/hosts file based on the results.
## Installation
*You should have ~~Chromium~~ ([https://github.com/SergeyPirogov/webdriver_manager/issues/649](https://github.com/SergeyPirogov/webdriver_manager/issues/649)) or* ***Google Chrome*** *pre-installed on your system.*
```bash
pip install hfinder
```
*Or:*
```bash
git clone https://github.com/cosad3s/hfinder.git
sudo pip3 install .
```
## Usage
```bash
❯ hfinder -h
usage: hfinder [-h] [-c CIDR] [-a ASN] [--hosts] [--fqdn] [--filter FILTER]
Find hostnames from ASN or CIDR - Robtex x BGP.HE
options:
-h, --help show this help message and exit
-c CIDR CIDR(s) (Single or multiple separated by commas - Ex: 192.168.0.0/24 or 192.168.0.0/24,192.168.1.0/24)
-a ASN ASN(s) (Single or multiple separated by commas - Ex: AS1234 or AS1234,AS4561)
--hosts Generate /etc/hosts like file
--fqdn Only display found FQDN
--filter FILTER Filter FQDN against regex (Ex: ^.*example\.org$)
```
## Examples
Examples:
```bash
❯ hfinder -c 207.231.168.0/21
vpn-west.uberinternal.com:207.231.168.144
itelogs.uberinternal.com:207.231.168.148
backup.uberinternal.com:207.231.168.151
backup.uber.com:207.231.168.151
munki.uberinternal.com:207.231.168.155
team.uber.com:207.231.168.160
team.uberinternal.com:207.231.168.160
jds.uberinternal.com:207.231.168.162
jds-staging.uberinternal.com:207.231.168.163
chef.uberinternal.com:207.231.168.172
scout.uberinternal.com:207.231.168.174
tableau.uberinternal.com:207.231.168.202
vpn-east.uberinternal.com:207.231.169.144
prj.usuppliers.uber.com:207.231.169.199
usuppliers.uber.com:207.231.169.200
vpn-west.uberatc.com:207.231.171.36
...
```
```bash
❯ hfinder -a AS26673
vpn-west.uberinternal.com:207.231.168.144
itelogs.uberinternal.com:207.231.168.148
backup.uberinternal.com:207.231.168.151
backup.uber.com:207.231.168.151
munki.uberinternal.com:207.231.168.155
team.uber.com:207.231.168.160
team.uberinternal.com:207.231.168.160
jds.uberinternal.com:207.231.168.162
jds-staging.uberinternal.com:207.231.168.163
chef.uberinternal.com:207.231.168.172
scout.uberinternal.com:207.231.168.174
tableau.uberinternal.com:207.231.168.202
vpn-east.uberinternal.com:207.231.169.144
prj.usuppliers.uber.com:207.231.169.199
usuppliers.uber.com:207.231.169.200
vpn-west.uberatc.com:207.231.171.36
```
```bash
❯ hfinder -a AS26673 --hosts
207.231.168.144 vpn-west.uberinternal.com
207.231.168.148 itelogs.uberinternal.com
207.231.168.151 backup.uberinternal.com backup.uber.com
207.231.168.155 munki.uberinternal.com
207.231.168.160 team.uberinternal.com team.uber.com
207.231.168.162 jds.uberinternal.com
207.231.168.163 jds-staging.uberinternal.com
207.231.168.172 chef.uberinternal.com
207.231.168.174 scout.uberinternal.com
207.231.168.202 tableau.uberinternal.com
207.231.169.144 vpn-east.uberinternal.com
207.231.169.199 prj.usuppliers.uber.com
207.231.169.200 usuppliers.uber.com
207.231.171.36 vpn-west.uberatc.com
```
```bash
❯ hfinder -a AS26673 --hosts --filter "^.*uber.com$"
207.231.168.151 backup.uber.com
207.231.168.160 team.uber.com
207.231.169.199 prj.usuppliers.uber.com
207.231.169.200 usuppliers.uber.com
```
```bash
❯ hfinder -c 207.231.168.0/21 --fqdn
vpn-west.uberinternal.com
itelogs.uberinternal.com
backup.uberinternal.com
backup.uber.com
munki.uberinternal.com
team.uber.com
team.uberinternal.com
jds.uberinternal.com
jds-staging.uberinternal.com
chef.uberinternal.com
scout.uberinternal.com
tableau.uberinternal.com
vpn-east.uberinternal.com
prj.usuppliers.uber.com
usuppliers.uber.com
vpn-west.uberatc.com
```
```bash
❯ hfinder -a AS63948,AS63943,AS63086,AS399759,AS273797,AS26673,AS203351,AS19934,AS147183,AS136114,AS134981,AS134135 --hosts --filter "^(.*\.uber\.com|.*\.uberinternal\.com|.*\.ubereats\.com)$"
43.231.12.135 cn-pek1.uber.com
104.36.192.131 ussh.uberinternal.com bastion-sjc1.uber.com bastion02-sjc1.prod.uber.com
104.36.197.130 ussh.uberinternal.com bastion-geo.uber.com
104.36.195.187 ussh.uberinternal.com
104.36.195.188 ussh.uberinternal.com
104.36.196.133 ussh.uberinternal.com bastion-phx2.prod.uber.com bastion-geo.uber.com
104.36.192.244 ussh.uberinternal.com bastion-sjc1.uber.com bastion01-sjc1.prod.uber.com
104.36.195.186 ussh.uberinternal.com
104.36.197.131 ussh.uberinternal.com bastion-geo.uber.com
104.36.197.230 ussh.uberinternal.com bastion-geo.uber.com
104.36.197.129 ussh.uberinternal.com bastion-geo.uber.com
104.36.196.134 ussh.uberinternal.com bastion-phx2.prod.uber.com bastion-geo.uber.com
# ...
```
Raw data
{
"_id": null,
"home_page": "https://github.com/cosad3s/hfinder",
"name": "hfinder",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "hostnames,cidr,asn,network,discovery,osint,bugbounty",
"author": "S\u00e9bastien Copin",
"author_email": "cosad3s@outlook.com",
"download_url": "https://files.pythonhosted.org/packages/bf/d4/229d503307628988608bc5d47ade348379d98725d877389747b06109f85b/hfinder-1.0.2.tar.gz",
"platform": null,
"description": "# hfinder\n\n![](assets/logo.png)\n\n## Description\n\n**Hosts Finder**\n\nHelp recon of hostnames from specific ASN(s) or CIDR(s), thanks to [https://bgp.he.net/](https://bgp.he.net/) and [https://www.robtex.com/](https://www.robtex.com/).\n\nCan generate filtered /etc/hosts file based on the results.\n\n## Installation\n\n*You should have ~~Chromium~~ ([https://github.com/SergeyPirogov/webdriver_manager/issues/649](https://github.com/SergeyPirogov/webdriver_manager/issues/649)) or* ***Google Chrome*** *pre-installed on your system.*\n\n```bash\npip install hfinder\n```\n\n*Or:*\n\n```bash\ngit clone https://github.com/cosad3s/hfinder.git\nsudo pip3 install .\n```\n\n## Usage\n\n```bash\n\u276f hfinder -h\nusage: hfinder [-h] [-c CIDR] [-a ASN] [--hosts] [--fqdn] [--filter FILTER]\n\nFind hostnames from ASN or CIDR - Robtex x BGP.HE\n\noptions:\n -h, --help show this help message and exit\n -c CIDR CIDR(s) (Single or multiple separated by commas - Ex: 192.168.0.0/24 or 192.168.0.0/24,192.168.1.0/24)\n -a ASN ASN(s) (Single or multiple separated by commas - Ex: AS1234 or AS1234,AS4561)\n --hosts Generate /etc/hosts like file\n --fqdn Only display found FQDN\n --filter FILTER Filter FQDN against regex (Ex: ^.*example\\.org$)\n```\n\n## Examples\n\nExamples:\n\n```bash\n\u276f hfinder -c 207.231.168.0/21\nvpn-west.uberinternal.com:207.231.168.144\nitelogs.uberinternal.com:207.231.168.148\nbackup.uberinternal.com:207.231.168.151\nbackup.uber.com:207.231.168.151\nmunki.uberinternal.com:207.231.168.155\nteam.uber.com:207.231.168.160\nteam.uberinternal.com:207.231.168.160\njds.uberinternal.com:207.231.168.162\njds-staging.uberinternal.com:207.231.168.163\nchef.uberinternal.com:207.231.168.172\nscout.uberinternal.com:207.231.168.174\ntableau.uberinternal.com:207.231.168.202\nvpn-east.uberinternal.com:207.231.169.144\nprj.usuppliers.uber.com:207.231.169.199\nusuppliers.uber.com:207.231.169.200\nvpn-west.uberatc.com:207.231.171.36\n...\n```\n\n```bash\n\u276f hfinder -a AS26673\nvpn-west.uberinternal.com:207.231.168.144\nitelogs.uberinternal.com:207.231.168.148\nbackup.uberinternal.com:207.231.168.151\nbackup.uber.com:207.231.168.151\nmunki.uberinternal.com:207.231.168.155\nteam.uber.com:207.231.168.160\nteam.uberinternal.com:207.231.168.160\njds.uberinternal.com:207.231.168.162\njds-staging.uberinternal.com:207.231.168.163\nchef.uberinternal.com:207.231.168.172\nscout.uberinternal.com:207.231.168.174\ntableau.uberinternal.com:207.231.168.202\nvpn-east.uberinternal.com:207.231.169.144\nprj.usuppliers.uber.com:207.231.169.199\nusuppliers.uber.com:207.231.169.200\nvpn-west.uberatc.com:207.231.171.36\n```\n\n```bash\n\u276f hfinder -a AS26673 --hosts\n207.231.168.144 vpn-west.uberinternal.com\n207.231.168.148 itelogs.uberinternal.com\n207.231.168.151 backup.uberinternal.com backup.uber.com\n207.231.168.155 munki.uberinternal.com\n207.231.168.160 team.uberinternal.com team.uber.com\n207.231.168.162 jds.uberinternal.com\n207.231.168.163 jds-staging.uberinternal.com\n207.231.168.172 chef.uberinternal.com\n207.231.168.174 scout.uberinternal.com\n207.231.168.202 tableau.uberinternal.com\n207.231.169.144 vpn-east.uberinternal.com\n207.231.169.199 prj.usuppliers.uber.com\n207.231.169.200 usuppliers.uber.com\n207.231.171.36 vpn-west.uberatc.com\n```\n\n```bash\n\u276f hfinder -a AS26673 --hosts --filter \"^.*uber.com$\"\n207.231.168.151 backup.uber.com\n207.231.168.160 team.uber.com\n207.231.169.199 prj.usuppliers.uber.com\n207.231.169.200 usuppliers.uber.com\n```\n\n```bash\n\u276f hfinder -c 207.231.168.0/21 --fqdn\nvpn-west.uberinternal.com\nitelogs.uberinternal.com\nbackup.uberinternal.com\nbackup.uber.com\nmunki.uberinternal.com\nteam.uber.com\nteam.uberinternal.com\njds.uberinternal.com\njds-staging.uberinternal.com\nchef.uberinternal.com\nscout.uberinternal.com\ntableau.uberinternal.com\nvpn-east.uberinternal.com\nprj.usuppliers.uber.com\nusuppliers.uber.com\nvpn-west.uberatc.com\n```\n\n```bash\n\u276f hfinder -a AS63948,AS63943,AS63086,AS399759,AS273797,AS26673,AS203351,AS19934,AS147183,AS136114,AS134981,AS134135 --hosts --filter \"^(.*\\.uber\\.com|.*\\.uberinternal\\.com|.*\\.ubereats\\.com)$\"\n43.231.12.135 cn-pek1.uber.com\n104.36.192.131 ussh.uberinternal.com bastion-sjc1.uber.com bastion02-sjc1.prod.uber.com\n104.36.197.130 ussh.uberinternal.com bastion-geo.uber.com\n104.36.195.187 ussh.uberinternal.com\n104.36.195.188 ussh.uberinternal.com\n104.36.196.133 ussh.uberinternal.com bastion-phx2.prod.uber.com bastion-geo.uber.com\n104.36.192.244 ussh.uberinternal.com bastion-sjc1.uber.com bastion01-sjc1.prod.uber.com\n104.36.195.186 ussh.uberinternal.com\n104.36.197.131 ussh.uberinternal.com bastion-geo.uber.com\n104.36.197.230 ussh.uberinternal.com bastion-geo.uber.com\n104.36.197.129 ussh.uberinternal.com bastion-geo.uber.com\n104.36.196.134 ussh.uberinternal.com bastion-phx2.prod.uber.com bastion-geo.uber.com\n# ...\n```\n",
"bugtrack_url": null,
"license": "GPL-3.0 License",
"summary": "hfinder",
"version": "1.0.2",
"project_urls": {
"Homepage": "https://github.com/cosad3s/hfinder"
},
"split_keywords": [
"hostnames",
"cidr",
"asn",
"network",
"discovery",
"osint",
"bugbounty"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "49cbe335799356403e38ac1ac6d1d3b48f5801f826d53e4a56a3a8b60e03507a",
"md5": "30a09492e7fc4ccc8c18a7a8dab9701b",
"sha256": "86f0cc9567369d6a73c9a4f811a74580efa04930bf5747369809244bc1ad8f45"
},
"downloads": -1,
"filename": "hfinder-1.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "30a09492e7fc4ccc8c18a7a8dab9701b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 17435,
"upload_time": "2024-02-20T09:49:26",
"upload_time_iso_8601": "2024-02-20T09:49:26.771480Z",
"url": "https://files.pythonhosted.org/packages/49/cb/e335799356403e38ac1ac6d1d3b48f5801f826d53e4a56a3a8b60e03507a/hfinder-1.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "bfd4229d503307628988608bc5d47ade348379d98725d877389747b06109f85b",
"md5": "a9ae860f945f722c1dd1965ef92d6c5b",
"sha256": "5c968c45c9308664daf5edeb9ef74d7c8edbe7713ad1a65898ffd3dab45c8214"
},
"downloads": -1,
"filename": "hfinder-1.0.2.tar.gz",
"has_sig": false,
"md5_digest": "a9ae860f945f722c1dd1965ef92d6c5b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 17216,
"upload_time": "2024-02-20T09:49:28",
"upload_time_iso_8601": "2024-02-20T09:49:28.475592Z",
"url": "https://files.pythonhosted.org/packages/bf/d4/229d503307628988608bc5d47ade348379d98725d877389747b06109f85b/hfinder-1.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-20 09:49:28",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "cosad3s",
"github_project": "hfinder",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "hfinder"
}