hfinder

Name	hfinder JSON
Version	1.0.3 JSON
	download
home_page	https://github.com/cosad3s/hfinder
Summary	hfinder
upload_time	2024-10-25 19:31:57
maintainer	None
docs_url	None
author	Sébastien Copin
requires_python	None
license	GPL-3.0 License
keywords	hostnames cidr asn network discovery osint bugbounty
VCS
bugtrack_url
requirements	No requirements were recorded.
Travis-CI	No Travis.
coveralls test coverage	No coveralls.

            # 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 Driver ([https://github.com/SergeyPirogov/webdriver_manager/issues/649](https://github.com/SergeyPirogov/webdriver_manager/issues/649)) *pre-installed on your system: `sudo apt install chromium-driver`*

```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": null,
    "docs_url": null,
    "requires_python": null,
    "maintainer_email": null,
    "keywords": "hostnames, cidr, asn, network, discovery, osint, bugbounty",
    "author": "S\u00e9bastien Copin",
    "author_email": "cosad3s@outlook.com",
    "download_url": "https://files.pythonhosted.org/packages/7f/69/ff77c8620b5179d4ef9d7f12d9e33951fe762e3540e00e69f9c663b42e6a/hfinder-1.0.3.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 Driver ([https://github.com/SergeyPirogov/webdriver_manager/issues/649](https://github.com/SergeyPirogov/webdriver_manager/issues/649)) *pre-installed on your system: `sudo apt install chromium-driver`*\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.3",
    "project_urls": {
        "Homepage": "https://github.com/cosad3s/hfinder"
    },
    "split_keywords": [
        "hostnames",
        " cidr",
        " asn",
        " network",
        " discovery",
        " osint",
        " bugbounty"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "7f69ff77c8620b5179d4ef9d7f12d9e33951fe762e3540e00e69f9c663b42e6a",
                "md5": "8c9c0bf42707ee83bc84ea428cd7db5a",
                "sha256": "ffbcb0b9ae1ff401846ec490573247b63de76359013871a49fde26a6f5d55651"
            },
            "downloads": -1,
            "filename": "hfinder-1.0.3.tar.gz",
            "has_sig": false,
            "md5_digest": "8c9c0bf42707ee83bc84ea428cd7db5a",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 17229,
            "upload_time": "2024-10-25T19:31:57",
            "upload_time_iso_8601": "2024-10-25T19:31:57.463611Z",
            "url": "https://files.pythonhosted.org/packages/7f/69/ff77c8620b5179d4ef9d7f12d9e33951fe762e3540e00e69f9c663b42e6a/hfinder-1.0.3.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-10-25 19:31:57",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "cosad3s",
    "github_project": "hfinder",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "hfinder"
}