Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/EISMGard/github-audit-tool
This is a tool for auditing github repos, users, and teams. Good for compliance, security and other stuff.
https://github.com/EISMGard/github-audit-tool
Last synced: 2 months ago
JSON representation
This is a tool for auditing github repos, users, and teams. Good for compliance, security and other stuff.
- Host: GitHub
- URL: https://github.com/EISMGard/github-audit-tool
- Owner: EISMGard
- License: mit
- Created: 2022-08-20T20:54:57.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2023-12-23T23:42:21.000Z (11 months ago)
- Last Synced: 2024-03-22T14:32:56.059Z (8 months ago)
- Language: Python
- Size: 109 KB
- Stars: 187
- Watchers: 5
- Forks: 11
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# GitHub Org Audit Tool
This is a tool for auditing github organizations including their repos, users, and teams. It is useful for compliance, security and auditing.
## Capabilities
* Repo list
* Team list
* Team repo rights list
* User list
* User repo rights list
[LICENSE](./LICENSE)
## Installation
### Permissions
Please note that you'll need your github org name and to create a github token with access to all repo, team, and user info. Here is an example of a fine-grained access token:
### Docker Installation
On your host, you'll need to set your environment variables mentioned above.
```sh
export GITHUB_ORG_NAME=
export GITHUB_TOKEN=
#Build Docker Image
docker build --tag github-audit-tool .
#Run Image
docker run --rm -it -e GITHUB_ORG_NAME -e GITHUB_TOKEN github-audit-tool
```
### Local Installation
```sh
$ git clone https://github.com/EISMGard/github-audit-tool
$ cd github-audit-tool
$ virtualenv -p python3 venv
$ source venv/bin/activate
$ pip install -r requirements.txt
$ export GITHUB_ORG_NAME=
$ export GITHUB_TOKEN=
$ python github_reporting_tool.py
```
## Example Output
```
Repo List:
git://github.com/EISMGard/UnstoppableDevOps.git
git://github.com/EISMGard/onetwotest.git
git://github.com/EISMGard/laughing-pancake.git
git://github.com/EISMGard/potential-octo-computing-machine.git
git://github.com/EISMGard/literate-octo-system.git
git://github.com/EISMGard/github-audit-tool.git
git://github.com/EISMGard/test.git
git://github.com/EISMGard/foo.git
git://github.com/EISMGard/bar.git
git://github.com/EISMGard/baz.git
Team List:
a-team
git://github.com/EISMGard/test.git
b-team
git://github.com/EISMGard/onetwotest.git
git://github.com/EISMGard/UnstoppableDevOps.git
bar team
git://github.com/EISMGard/laughing-pancake.git
foo team
git://github.com/EISMGard/literate-octo-system.git
gorakTeam
git://github.com/EISMGard/onetwotest.git
Team Membership List:
a-team Team Members:
bfrancom
jesse-eismgard
b-team Team Members:
bfrancom
jesse-eismgard
bar team Team Members:
bfrancom
jesse-eismgard
foo team Team Members:
bfrancom
jane-at-eismgard
gorakTeam Team Members:
bfrancom
jane-at-eismgard
Direct Repo Rights:
git://github.com/EISMGard/UnstoppableDevOps.git
bfrancom
jesse-eismgard
jane-at-eismgard
git://github.com/EISMGard/onetwotest.git
bfrancom
jesse-eismgard
jane-at-eismgard
git://github.com/EISMGard/laughing-pancake.git
bfrancom
jesse-eismgard
jane-at-eismgard
git://github.com/EISMGard/potential-octo-computing-machine.git
bfrancom
jesse-eismgard
jane-at-eismgard
git://github.com/EISMGard/literate-octo-system.git
bfrancom
jesse-eismgard
jane-at-eismgard
git://github.com/EISMGard/github-audit-tool.git
bfrancom
jesse-eismgard
jane-at-eismgard
git://github.com/EISMGard/test.git
bfrancom
jesse-eismgard
jane-at-eismgard
git://github.com/EISMGard/foo.git
bfrancom
jesse-eismgard
jane-at-eismgard
git://github.com/EISMGard/bar.git
bfrancom
jesse-eismgard
jane-at-eismgard
git://github.com/EISMGard/baz.git
bfrancom
jesse-eismgard
jane-at-eismgard
```