Skip to content

Commit b814627

Browse files
committed
Merge remote-tracking branch 'origin'
2 parents 8983cf8 + c8b7d31 commit b814627

35 files changed

+431
-383
lines changed

.github/workflows/build-test.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ jobs:
2424
- name: Set up Go
2525
uses: actions/setup-go@v4
2626
with:
27-
go-version: 1.20.x
27+
go-version: 1.21.x
2828

2929
- name: Check out code
3030
uses: actions/checkout@v3

.github/workflows/lint-test.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ jobs:
1515
- uses: actions/checkout@v3
1616
- uses: actions/setup-go@v4
1717
with:
18-
go-version: 1.20.x
18+
go-version: 1.21.x
1919
- name: Run golangci-lint
2020
uses: golangci/[email protected]
2121
with:

.github/workflows/release-binary.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ jobs:
1818
- name: "Set up Go"
1919
uses: actions/setup-go@v4
2020
with:
21-
go-version: 1.20.x
21+
go-version: 1.21.x
2222

2323
- name: "Create release on GitHub"
2424
uses: goreleaser/goreleaser-action@v3

.github/workflows/release-test.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ jobs:
1919
- name: Set up Go
2020
uses: actions/setup-go@v4
2121
with:
22-
go-version: 1.20.x
22+
go-version: 1.21.x
2323

2424
- name: release test
2525
uses: goreleaser/goreleaser-action@v4

README.md

+7-132
Original file line numberDiff line numberDiff line change
@@ -89,8 +89,8 @@ OUTPUT:
8989
-oI, -ip include host IP in output (-active only)
9090

9191
CONFIGURATION:
92-
-config string flag config file (default "$HOME/.config/subfinder/config.yaml")
93-
-pc, -provider-config string provider config file (default "$HOME/.config/subfinder/provider-config.yaml")
92+
-config string flag config file (default "$CONFIG/subfinder/config.yaml")
93+
-pc, -provider-config string provider config file (default "$CONFIG/subfinder/provider-config.yaml")
9494
-r string[] comma separated list of resolvers to use
9595
-rL, -rlist string file containing list of resolvers to use
9696
-nW, -active display active subdomains only
@@ -117,140 +117,15 @@ OPTIMIZATION:
117117
go install -v github.com/projectdiscovery/subfinder/v2/cmd/subfinder@latest
118118
```
119119

120-
## Post Installation Instructions
121-
122-
`subfinder` can be used right after the installation, however the following services require configuring API keys to work:
123-
124-
[BeVigil](https://bevigil.com/osint-api), [BinaryEdge](https://binaryedge.io), [BufferOver](https://tls.bufferover.run), [C99](https://api.c99.nl/), [Censys](https://censys.io), [CertSpotter](https://sslmate.com/certspotter/api/), [Chaos](https://chaos.projectdiscovery.io), [Chinaz](http://my.chinaz.com/ChinazAPI/DataCenter/MyDataApi), [DnsDB](https://api.dnsdb.info), [Fofa](https://fofa.info/static_pages/api_help), [FullHunt](https://fullhunt.io), [GitHub](https://github.com), [Intelx](https://intelx.io), [PassiveTotal](http://passivetotal.org), [quake](https://quake.360.cn), [Robtex](https://www.robtex.com/api/), [SecurityTrails](http://securitytrails.com), [Shodan](https://shodan.io), [ThreatBook](https://x.threatbook.cn/en), [VirusTotal](https://www.virustotal.com), [WhoisXML API](https://whoisxmlapi.com/), [ZoomEye](https://www.zoomeye.org), [ZoomEye API](https://api.zoomeye.org), [dnsrepo](https://dnsrepo.noc.org), [Hunter](https://hunter.qianxin.com/), [Facebook](https://developers.facebook.com), [BuiltWith](https://api.builtwith.com/domain-api)
125-
126-
You can also use the `subfinder -ls` command to display all the available sources.
127-
128-
These values are stored in the `$HOME/.config/subfinder/provider-config.yaml` file which will be created when you run the tool for the first time. The configuration file uses the YAML format. Multiple API keys
129-
can be specified for each of these services from which one of them will be used for enumeration.
130-
131-
Composite keys for sources like, `Censys`, `PassiveTotal`, `Fofa`, `Intellix` and `360quake`, need to be separated with a colon (`:`).
132-
133-
An example provider config file:
134-
135-
```yaml
136-
binaryedge:
137-
- 0bf8919b-aab9-42e4-9574-d3b639324597
138-
- ac244e2f-b635-4581-878a-33f4e79a2c13
139-
censys:
140-
- ac244e2f-b635-4581-878a-33f4e79a2c13:dd510d6e-1b6e-4655-83f6-f347b363def9
141-
certspotter: []
142-
passivetotal:
143-
- [email protected]:sample_password
144-
redhuntlabs:
145-
- ENDPOINT:API_TOKEN
146-
- https://reconapi.redhuntlabs.com/community/v1/domains/subdomains:joEPzJJp2AuOCw7teAj63HYrPGnsxuPQ
147-
securitytrails: []
148-
shodan:
149-
- AAAAClP1bJJSRMEYJazgwhJKrggRwKA
150-
github:
151-
- ghp_lkyJGU3jv1xmwk4SDXavrLDJ4dl2pSJMzj4X
152-
- ghp_gkUuhkIYdQPj13ifH4KA3cXRn8JD2lqir2d4
153-
zoomeyeapi:
154-
- 4f73021d-ff95-4f53-937f-83d6db719eec
155-
quake:
156-
- 0cb9030c-0a40-48a3-b8c4-fca28e466ba3
157-
facebook:
158-
- APP_ID:APP_SECRET
159-
intelx:
160-
- HOST:API_KEY
161-
- 2.intelx.io:s4324-b98b-41b2-220e8-3320f6a1284d
162-
```
163-
164-
Note: RedHunt Labs's [Attack Surface Recon API](https://devportal.redhuntlabs.com/) has different API endpoints depending on the user's subscription. Make sure to add the appropriate endpoint before running any scans.
165-
166-
# Running Subfinder
167-
168-
To run the tool on a target, just use the following command.
169-
170-
```console
171-
subfinder -d hackerone.com
172-
173-
__ _____ __
174-
_______ __/ /_ / __(_)___ ____/ /__ _____
175-
/ ___/ / / / __ \/ /_/ / __ \/ __ / _ \/ ___/
176-
(__ ) /_/ / /_/ / __/ / / / / /_/ / __/ /
177-
/____/\__,_/_.___/_/ /_/_/ /_/\__,_/\___/_/ v2.4.9
178-
179-
projectdiscovery.io
180-
181-
Use with caution. You are responsible for your actions
182-
Developers assume no liability and are not responsible for any misuse or damage.
183-
By using subfinder, you also agree to the terms of the APIs used.
184-
185-
[INF] Enumerating subdomains for hackerone.com
186-
187-
www.hackerone.com
188-
support.hackerone.com
189-
links.hackerone.com
190-
api.hackerone.com
191-
o1.email.hackerone.com
192-
go.hackerone.com
193-
3d.hackerone.com
194-
resources.hackerone.com
195-
a.ns.hackerone.com
196-
b.ns.hackerone.com
197-
mta-sts.hackerone.com
198-
docs.hackerone.com
199-
mta-sts.forwarding.hackerone.com
200-
gslink.hackerone.com
201-
hackerone.com
202-
info.hackerone.com
203-
mta-sts.managed.hackerone.com
204-
events.hackerone.com
205-
206-
[INF] Found 18 subdomains for hackerone.com in 3 seconds 672 milliseconds
207-
```
208-
209-
The subdomains discovered can be piped to other tools too. For example, you can pipe the discovered subdomains to [`httpx`](https://github.com/projectdiscovery/httpx) which will then find
210-
running HTTP servers on the host.
211-
212-
```console
213-
echo hackerone.com | subfinder -silent | httpx -silent
214-
215-
http://hackerone.com
216-
http://www.hackerone.com
217-
http://docs.hackerone.com
218-
http://api.hackerone.com
219-
https://docs.hackerone.com
220-
http://mta-sts.managed.hackerone.com
221-
```
120+
Learn about more ways to install subfinder here: https://docs.projectdiscovery.io/tools/subfinder/install.
222121

223-
<table>
224-
<tr>
225-
<td>
226-
227-
## Subfinder with docker
228-
229-
Pull the latest tagged [subfinder](https://hub.docker.com/r/projectdiscovery/subfinder) docker image:
230-
231-
```sh
232-
docker pull projectdiscovery/subfinder:latest
233-
```
234-
235-
Running `subfinder` using the docker image:
236-
237-
```sh
238-
docker run projectdiscovery/subfinder:latest -d hackerone.com
239-
```
240-
241-
Running `subfinder` using the docker image, with a local config file:
122+
## Post Installation Instructions
242123

243-
```sh
244-
docker run -v $HOME/.config/subfinder:/root/.config/subfinder -t projectdiscovery/subfinder -d hackerone.com
245-
```
124+
`subfinder` can be used right after the installation, however many sources required API keys to work. Learn more here: https://docs.projectdiscovery.io/tools/subfinder/install#post-install-configuration.
246125

247-
</td>
248-
</tr>
249-
</table>
126+
## Running Subfinder
250127

251-
<table>
252-
<tr>
253-
<td>
128+
Learn about how to run Subfinder here: https://docs.projectdiscovery.io/tools/subfinder/running.
254129

255130
## Subfinder Go library
256131

v2/go.mod

+28-26
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,19 @@
11
module github.com/projectdiscovery/subfinder/v2
22

3-
go 1.20
3+
go 1.21
44

55
require (
66
github.com/corpix/uarand v0.2.0
77
github.com/hako/durafmt v0.0.0-20210316092057-3a2c319c1acd
88
github.com/json-iterator/go v1.1.12
99
github.com/lib/pq v1.10.9
1010
github.com/projectdiscovery/chaos-client v0.5.1
11-
github.com/projectdiscovery/dnsx v1.1.4
11+
github.com/projectdiscovery/dnsx v1.1.6
1212
github.com/projectdiscovery/fdmax v0.0.4
13-
github.com/projectdiscovery/gologger v1.1.11
14-
github.com/projectdiscovery/ratelimit v0.0.9
15-
github.com/projectdiscovery/retryablehttp-go v1.0.26
16-
github.com/projectdiscovery/utils v0.0.54
13+
github.com/projectdiscovery/gologger v1.1.12
14+
github.com/projectdiscovery/ratelimit v0.0.23
15+
github.com/projectdiscovery/retryablehttp-go v1.0.42
16+
github.com/projectdiscovery/utils v0.0.72
1717
github.com/rs/xid v1.5.0
1818
github.com/stretchr/testify v1.8.4
1919
github.com/tomnomnom/linkheader v0.0.0-20180905144013-02ca5825eb80
@@ -28,16 +28,17 @@ require (
2828
github.com/VividCortex/ewma v1.2.0 // indirect
2929
github.com/akrylysov/pogreb v0.10.1 // indirect
3030
github.com/alecthomas/chroma v0.10.0 // indirect
31-
github.com/andybalholm/brotli v1.0.5 // indirect
31+
github.com/andybalholm/brotli v1.0.6 // indirect
3232
github.com/asaskevich/govalidator v0.0.0-20230301143203-a9d515a09cc2 // indirect
3333
github.com/aymanbagabas/go-osc52/v2 v2.0.1 // indirect
3434
github.com/aymerick/douceur v0.2.0 // indirect
3535
github.com/charmbracelet/glamour v0.6.0 // indirect
3636
github.com/cheggaaa/pb/v3 v3.1.4 // indirect
37-
github.com/cloudflare/circl v1.3.3 // indirect
37+
github.com/cloudflare/circl v1.3.7 // indirect
38+
github.com/denisbrodbeck/machineid v1.0.1 // indirect
3839
github.com/dimchansky/utfbom v1.1.1 // indirect
3940
github.com/dlclark/regexp2 v1.8.1 // indirect
40-
github.com/dsnet/compress v0.0.1 // indirect
41+
github.com/dsnet/compress v0.0.2-0.20210315054119-f66993602bf5 // indirect
4142
github.com/fatih/color v1.15.0 // indirect
4243
github.com/gaukas/godicttls v0.0.4 // indirect
4344
github.com/golang/protobuf v1.5.3 // indirect
@@ -46,35 +47,36 @@ require (
4647
github.com/google/go-querystring v1.1.0 // indirect
4748
github.com/gorilla/css v1.0.0 // indirect
4849
github.com/klauspost/compress v1.16.7 // indirect
50+
github.com/klauspost/pgzip v1.2.5 // indirect
4951
github.com/kr/pretty v0.3.1 // indirect
5052
github.com/lucasb-eyer/go-colorful v1.2.0 // indirect
5153
github.com/mattn/go-colorable v0.1.13 // indirect
5254
github.com/mattn/go-isatty v0.0.19 // indirect
5355
github.com/mattn/go-runewidth v0.0.14 // indirect
54-
github.com/mholt/archiver v3.1.1+incompatible // indirect
56+
github.com/mholt/archiver/v3 v3.5.1 // indirect
5557
github.com/microcosm-cc/bluemonday v1.0.25 // indirect
5658
github.com/minio/selfupdate v0.6.1-0.20230907112617-f11e74f84ca7 // indirect
5759
github.com/muesli/reflow v0.3.0 // indirect
5860
github.com/muesli/termenv v0.15.1 // indirect
5961
github.com/nwaples/rardecode v1.1.3 // indirect
6062
github.com/olekukonko/tablewriter v0.0.5 // indirect
61-
github.com/pierrec/lz4 v2.6.1+incompatible // indirect
63+
github.com/pierrec/lz4/v4 v4.1.2 // indirect
6264
github.com/projectdiscovery/blackrock v0.0.1 // indirect
63-
github.com/projectdiscovery/cdncheck v1.0.1 // indirect
64-
github.com/projectdiscovery/fastdialer v0.0.37 // indirect
65-
github.com/projectdiscovery/hmap v0.0.18 // indirect
65+
github.com/projectdiscovery/cdncheck v1.0.9 // indirect
66+
github.com/projectdiscovery/fastdialer v0.0.51 // indirect
67+
github.com/projectdiscovery/hmap v0.0.33 // indirect
6668
github.com/projectdiscovery/networkpolicy v0.0.6 // indirect
67-
github.com/quic-go/quic-go v0.37.4 // indirect
68-
github.com/refraction-networking/utls v1.5.2 // indirect
69+
github.com/quic-go/quic-go v0.37.7 // indirect
70+
github.com/refraction-networking/utls v1.5.4 // indirect
6971
github.com/rivo/uniseg v0.4.4 // indirect
7072
github.com/saintfish/chardet v0.0.0-20230101081208-5e3ef4b5456d // indirect
7173
github.com/syndtr/goleveldb v1.0.0 // indirect
72-
github.com/tidwall/btree v1.4.3 // indirect
74+
github.com/tidwall/btree v1.6.0 // indirect
7375
github.com/tidwall/buntdb v1.3.0 // indirect
74-
github.com/tidwall/gjson v1.14.3 // indirect
76+
github.com/tidwall/gjson v1.14.4 // indirect
7577
github.com/tidwall/grect v0.1.4 // indirect
7678
github.com/tidwall/match v1.1.1 // indirect
77-
github.com/tidwall/pretty v1.2.0 // indirect
79+
github.com/tidwall/pretty v1.2.1 // indirect
7880
github.com/tidwall/rtred v0.1.2 // indirect
7981
github.com/tidwall/tinyqueue v0.1.1 // indirect
8082
github.com/ulikunitz/xz v0.5.11 // indirect
@@ -88,11 +90,11 @@ require (
8890
github.com/zmap/zcrypto v0.0.0-20230422215203-9a665e1e9968 // indirect
8991
go.etcd.io/bbolt v1.3.7 // indirect
9092
go.uber.org/multierr v1.11.0 // indirect
91-
golang.org/x/crypto v0.14.0 // indirect
93+
golang.org/x/crypto v0.17.0 // indirect
9294
golang.org/x/mod v0.12.0 // indirect
9395
golang.org/x/oauth2 v0.11.0 // indirect
94-
golang.org/x/text v0.13.0 // indirect
95-
golang.org/x/tools v0.11.0 // indirect
96+
golang.org/x/text v0.14.0 // indirect
97+
golang.org/x/tools v0.13.0 // indirect
9698
google.golang.org/appengine v1.6.7 // indirect
9799
google.golang.org/protobuf v1.31.0 // indirect
98100
gopkg.in/djherbis/times.v1 v1.3.0 // indirect
@@ -102,13 +104,13 @@ require (
102104
github.com/cnf/structhash v0.0.0-20201127153200-e1b16c1ebc08 // indirect
103105
github.com/davecgh/go-spew v1.1.1 // indirect
104106
github.com/logrusorgru/aurora v2.0.3+incompatible // indirect
105-
github.com/miekg/dns v1.1.55 // indirect
107+
github.com/miekg/dns v1.1.56 // indirect
106108
github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd // indirect
107109
github.com/modern-go/reflect2 v1.0.2 // indirect
108110
github.com/pkg/errors v0.9.1
109111
github.com/pmezard/go-difflib v1.0.0 // indirect
110-
github.com/projectdiscovery/goflags v0.1.20
111-
github.com/projectdiscovery/retryabledns v1.0.35 // indirect
112+
github.com/projectdiscovery/goflags v0.1.34
113+
github.com/projectdiscovery/retryabledns v1.0.50 // indirect
112114
golang.org/x/net v0.17.0 // indirect
113-
golang.org/x/sys v0.13.0 // indirect
115+
golang.org/x/sys v0.15.0 // indirect
114116
)

0 commit comments

Comments
 (0)