https://github.com/projectdiscovery/subfinder-action
Fast and passive subdomain enumeration.
https://github.com/projectdiscovery/subfinder-action
enumeration osint subdomain
Last synced: 5 months ago
JSON representation
Fast and passive subdomain enumeration.
- Host: GitHub
- URL: https://github.com/projectdiscovery/subfinder-action
- Owner: projectdiscovery
- License: mit
- Created: 2021-04-16T13:11:24.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2022-04-18T12:41:11.000Z (about 4 years ago)
- Last Synced: 2025-12-17T04:27:46.090Z (7 months ago)
- Topics: enumeration, osint, subdomain
- Homepage: https://github.com/projectdiscovery
- Size: 4.88 KB
- Stars: 18
- Watchers: 5
- Forks: 10
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
SubFinder Action makes it easy to orchestrate SubFinder with GitHub Action.
Example Usage
-----
**GitHub Action running `SubFinder` for single domain**
```yaml
- name: 🔎 SubFinder - DNS Enumeration
uses: projectdiscovery/subfinder-action@main
with:
domain: projectdiscovery.io
```
**GitHub Action running `SubFinder` for multiple domains**
```yaml
- name: 🔎 SubFinder - DNS Enumeration
uses: projectdiscovery/subfinder-action@main
with:
list: domain_list.txt
```
**GitHub Action running `SubFinder` with config file**
```yaml
- name: 🔎 SubFinder - DNS Enumeration
uses: projectdiscovery/subfinder-action@main
with:
list: domain_list.txt
config: subfinder.yaml
```
**Workflow**: `.github/workflows/subfinder.yml`
```yaml
name: 🔎 SubFinder - DNS Enumeration
on:
schedule:
- cron: '0 0 * * *'
workflow_dispatch:
jobs:
subfinder-scan:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- uses: actions/setup-go@v3
with:
go-version: 1.17
- name: SubFinder - DNS Enumeration
uses: projectdiscovery/subfinder-action@main
with:
domain: projectdiscovery.io
- name: GitHub Workflow artifacts
uses: actions/upload-artifact@v2
with:
name: subfinder.log
path: subfinder.log
```
Available Inputs
------
| Key | Description | Required |
|----------|------------------------------------------------------|----------|
| `domain` | Domain to run subdomain enumeration | true |
| `list` | List of domains to run subdomain enumeration | false |
| `config` | Config file to use with subdomain enumeration | false |
| `output` | File to save output result (default - subfinder.log) | false |
| `json` | Write results in JSON format | false |
| `flags` | Additional subfinder CLI flags to use | false |
| `active` | Filter subdomains with no DNS records | false |