Skip to content

Commit

Permalink
Merge pull request #1 from trickest/readme
Browse files Browse the repository at this point in the history
Add README.md and update module name
mhmdiaa authored Jul 25, 2022
2 parents f0202b2 + 4ac433b commit f98bb03
Showing 5 changed files with 168 additions and 406 deletions.
140 changes: 140 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,140 @@
<h1 align="center">enumerepo <a href="https://twitter.com/intent/tweet?text=enumerepo%20-%20Read%20a%20list%20of%20GitHub%20usernames%20and%2For%20organizations%2C%20verify%20their%20existence%2C%20and%20list%20the%20repositories%20owned%20by%20each%20one.%20https%3A%2F%2Fgithub.com%2Ftrickest%2Fenumerepo&hashtags=bugbounty,bugbountytips,infosec"><img src="https://img.shields.io/badge/Tweet--lightgrey?logo=twitter&style=social" alt="Tweet" height="20"/></a></h1>
<h3 align="center">List all public repositories for (valid) GitHub usernames</h3>

![enumerepo](enumerepo.png "enumerepo")

Read a list of GitHub usernames and/or organizations, verify their existence, and list the repositories owned by each one.

# Installation
## Binary
Binaries are available in the [latest release](https://github.com/trickest/enumerepo/releases/latest).

## Docker
```
docker run quay.io/trickest/enumerepo
```

## From source
```
go install github.com/trickest/enumerepo@latest
```

# Usage
```
-adjust-delay
Automatically adjust time delay between requests
-delay int
Time delay after every GraphQL request [ms]
-o string
Output file name
-silent
Don't print output to stdout
-token-file string
File to read Github token from
-token-string string
Github token
-usernames string
File to read usernames from
```

### Example
##### usernames.txt
```
trickest
```

```shell script
$ enumerepo -token-string $GITHUB_TOKEN -usernames usernames.txt -o repositories.json
In progress...
[
{
"user": "https://github.com/trickest",
"repos": [
{
"url": "https://github.com/trickest/trickest-cli",
"ssh_url": "git@github.com:trickest/trickest-cli.git",
"language": "Go"
},
{
"url": "https://github.com/trickest/cve",
"ssh_url": "git@github.com:trickest/cve.git",
"language": ""
},
{
"url": "https://github.com/trickest/find-gh-poc",
"ssh_url": "git@github.com:trickest/find-gh-poc.git",
"language": "Go"
},
{
"url": "https://github.com/trickest/inventory",
"ssh_url": "git@github.com:trickest/inventory.git",
"language": ""
},
{
"url": "https://github.com/trickest/mksub",
"ssh_url": "git@github.com:trickest/mksub.git",
"language": "Go"
},
{
"url": "https://github.com/trickest/mkpath",
"ssh_url": "git@github.com:trickest/mkpath.git",
"language": "Go"
},
{
"url": "https://github.com/trickest/dsieve",
"ssh_url": "git@github.com:trickest/dsieve.git",
"language": "Go"
},
{
"url": "https://github.com/trickest/resolvers",
"ssh_url": "git@github.com:trickest/resolvers.git",
"language": ""
},
{
"url": "https://github.com/trickest/insiders",
"ssh_url": "git@github.com:trickest/insiders.git",
"language": ""
},
{
"url": "https://github.com/trickest/enumerepo",
"ssh_url": "git@github.com:trickest/enumerepo.git",
"language": "Go"
},
{
"url": "https://github.com/trickest/containers",
"ssh_url": "git@github.com:trickest/containers.git",
"language": "Shell"
},
{
"url": "https://github.com/trickest/safe-harbour",
"ssh_url": "git@github.com:trickest/safe-harbour.git",
"language": ""
},
{
"url": "https://github.com/trickest/mgwls",
"ssh_url": "git@github.com:trickest/mgwls.git",
"language": "Go"
},
{
"url": "https://github.com/trickest/log4j",
"ssh_url": "git@github.com:trickest/log4j.git",
"language": ""
},
{
"url": "https://github.com/trickest/action",
"ssh_url": "git@github.com:trickest/action.git",
"language": "Shell"
}
]
}
]
Done! 15 repositories found.
```

# Report Bugs / Feedback
We look forward to any feedback you want to share with us or if you're stuck with a problem you can contact us at [support@trickest.com](mailto:support@trickest.com). You can also create an [Issue](https://github.com/trickest/enumerepo/issues/new) or pull request on the Github repository.

# Where does this fit in your methodology?
Enumerepo is an integral part of the [Insiders](https://github.com/trickest/insiders) workflow many workflows in the Trickest store. Sign up on [trickest.com](https://trickest.com) to get access to these workflows or build your own from scratch!

[<img src="./banner.png" />](https://trickest-access.paperform.co/)
Binary file added banner.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added enumerepo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
25 changes: 9 additions & 16 deletions go.mod
Original file line number Diff line number Diff line change
@@ -1,23 +1,16 @@
module enumerepo
module github.com/trickest/enumerepo

go 1.17
go 1.18

require (
github.com/schollz/progressbar/v3 v3.8.6
github.com/shurcooL/githubv4 v0.0.0-20220115235240-a14260e6f8a2
golang.org/x/oauth2 v0.0.0-20220309155454-6242fa91716a
github.com/shurcooL/githubv4 v0.0.0-20220520033151-0b4e3294ff00
golang.org/x/oauth2 v0.0.0-20220722155238-128564f6959c
)

require (
github.com/golang/protobuf v1.4.2 // indirect
github.com/mattn/go-runewidth v0.0.13 // indirect
github.com/mitchellh/colorstring v0.0.0-20190213212951-d06e56a500db // indirect
github.com/rivo/uniseg v0.2.0 // indirect
github.com/shurcooL/graphql v0.0.0-20200928012149-18c5c3165e3a // indirect
golang.org/x/crypto v0.0.0-20220131195533-30dcbda58838 // indirect
golang.org/x/net v0.0.0-20220127200216-cd36cc0744dd // indirect
golang.org/x/sys v0.0.0-20220128215802-99c3d69c2c27 // indirect
golang.org/x/term v0.0.0-20210927222741-03fcf44c2211 // indirect
google.golang.org/appengine v1.6.6 // indirect
google.golang.org/protobuf v1.25.0 // indirect
github.com/golang/protobuf v1.5.2 // indirect
github.com/shurcooL/graphql v0.0.0-20220606043923-3cf50f8a0a29 // indirect
golang.org/x/net v0.0.0-20220624214902-1bab6f366d9e // indirect
google.golang.org/appengine v1.6.7 // indirect
google.golang.org/protobuf v1.28.0 // indirect
)
409 changes: 19 additions & 390 deletions go.sum

Large diffs are not rendered by default.

0 comments on commit f98bb03

Please sign in to comment.