gitrecon

OSINT tool to get information from a Github or Gitlab profile and find user's email addresses leaked on commits.

📚 How does this work?

GitHub uses the email address associated with a GitHub account to link commits and other activity to a GitHub profile. When a user makes commits to public repos their email address is usually published in the commit and becomes publicly accessible, if you know where to look.

GitHub provide some instructions on how to prevent this from happening, but it seems that most GitHub users either don't know or don't care that their email address may be exposed.

Finding a GitHub user's email address is often as simple as looking at their recent events via the GitHub API.

Idea and text from Nick Drewe.

Source: https://thedatapack.com/tools/find-github-user-email/

❗ Disclaimer

As @pielco11 warned, emails and other data can be spoofed in commits.

✔️ Prerequisites

Python 3

🛠️ Installation

git clone https://github.com/GONZOsint/gitrecon.git
cd gitrecon/
python3 -m pip install -r requirements.txt

It is possible to use a Github access token by editing line 3 of the modules/github_recon.py file. This will prevent a possible API ban.

It is possible to use a Gitlab access token by editing line 3 of the modules/gitlab_recon.py file. This will prevent a possible API ban.

token = '<Access token here>'

🔎 Usage

usage: gitrecon.py [-h] -s {github,gitlab} [-a] [-o] username

positional arguments:
  username

optional arguments:
  -h, --help          show this help message and exit
  -s {github,gitlab}  sites selection
  -a, --avatar        download avatar pic
  -o, --output        save output

Results are saved in results/<username>/ path.

⚔️ Features

Gitlab and Github leaked emails on commits
Gitlab and Github SSH keys

Github SSH keys | Gitlab SSH keys ------------ | ------------- ID | ❌ ❌ | Tittle ❌ | Created at ❌ | Expires at Key | Key

Gitlab and Github profile info

Github profile info | Gitlab profile info ------------ | ------------- Username | Username Name | Name User ID | User ID ❌ | State ❌ | Status Avatar url | Avatar url Email | Email Location | Location Bio | Bio Company | Organization Organizations | ❌ ❌ | Job title ❌ | Work information Blog | Web Gravatar ID | ❌ Twitter | Twitter ❌ | Skype ❌ | Linkedin Followers | Followers Following | Following Created at | Created at Updated at | ❌

🔒 Prevention

Configurations on Github:

Settings url: https://github.com/settings/emails
- ✔️ Keep my email addresses private
- ✔️ Block command line pushes that expose my email

Configurations on Gitlab:

Settings url: https://gitlab.com/-/profile
- ✔️ Public email: do not show on profile
- ✔️ Commit email: use a private email

Gitrecon

Install / Use

README