https://github.com/projectdiscovery/subfinder-action

Fast and passive subdomain enumeration.
https://github.com/projectdiscovery/subfinder-action

enumeration osint subdomain

Last synced: 16 days 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 (over 3 years ago)
• Default Branch: main
• Last Pushed: 2022-04-18T12:41:11.000Z (over 2 years ago)
• Last Synced: 2024-12-24T00:09:40.930Z (17 days ago)
• Topics: enumeration, osint, subdomain
• Homepage: https://github.com/projectdiscovery
• Size: 4.88 KB
• Stars: 14
• Watchers: 8
• Forks: 9
• 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    |