Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Retrospected/kerbmon
Continuous kerberoast monitor
https://github.com/Retrospected/kerbmon
Last synced: 3 months ago
JSON representation
Continuous kerberoast monitor
- Host: GitHub
- URL: https://github.com/Retrospected/kerbmon
- Owner: Retrospected
- License: bsd-3-clause
- Created: 2021-05-05T22:03:44.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2023-08-24T08:14:11.000Z (about 1 year ago)
- Last Synced: 2024-06-06T20:57:40.820Z (5 months ago)
- Language: Python
- Size: 145 KB
- Stars: 42
- Watchers: 3
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-hacking-lists - Retrospected/kerbmon - Continuous kerberoast monitor (Python)
README
KerbMon
=================
KerbMon pulls the current state of the Service Principal Name (SPN) records and sAMAccounts that have the property 'Do not require Kerberos preauthentication' set (UF_DONT_REQUIRE_PREAUTH). It stores these results in a SQLite3 database.
In a subsequent execution, KerbMon will compare the newly retrieved data with records in the database and checks for newly added SPN's or NP's. It also checks if any of the involved sAMAccounts have their passwords changed since the last run, by comparing the pwdLastSet attribute in LDAP with the entry in the database.
In case any difference has been detected, KerbMon will retrieve the Ticket Granting Service (TGS) ticket(s) (TGS-REQ) of the SPN's or the Ticket Granting Tickets (TGT's) of the NP's and stores it to your disk.
In addition KerbMon has the option to automatically perform a basic dictionary attack based on Hashcat.
For more information regarding the Kerberoast attack refer to [the research](http://www.irongeek.com/i.php?page=videos/derbycon4/t120-attacking-microsoft-kerberos-kicking-the-guard-dog-of-hades-tim-medin) of Tim Medin (@timmedin).
Quick Start
---------------
Clone the master branch, install the requirements and run.
```
git clone https://github.com/Retrospected/kerbmon; cd kerbmon
pip3 install -r requirements
python3 kerbmon.py -h
```
Usage
---------------
```
usage: kerbmon.py [-h] [-credentials CREDENTIALS] [-k] [-aesKey hex key]
[-domainsfile DOMAINSFILE] [-dbfile DBFILE]
[-crack wordlist] [-outputfile OUTPUTFILE] [-debug]
Query domains for SPNs that are configured and for users that have the property
'Do not require Kerberos preauthentication' set (UF_DONT_REQUIRE_PREAUTH).
Monitor for changes and pull latest TGT or TGS tickets.
optional arguments:
-h, --help show this help message and exit
-credentials CREDENTIALS
domain/username[:password]
-k Use Kerberos authentication. Grabs credentials from
ccache file (KRB5CCNAME) based on target parameters.
If valid credentials cannot be found, it will use the
ones specified in the command line
-aesKey hex key AES key to use for Kerberos Authentication (128 or 256
bits)
-domainsfile DOMAINSFILE
File with domains (FQDN) per line to test
-dbfile DBFILE SQLite3 DB file to use as a database
-crack wordlist Automatically attempt to crack the TGS service
ticket(s) using a dictionary attack with the provided
wordlist (using Hashcat)
-outputfile OUTPUTFILE
Output file to write new or changed SPNs to. A date and
timestamp will be appended to the filename as well as
the encryption type ID of the TGS (23=rc4, 18=aes256, etc).
-debug Turn DEBUG output ON
```
Docker
---------------
You can also run the tool within a Docker container. Mount a writeable folder to /data that includes the target domains file, db file and outputfile location.
```
docker build . -t kerbmon
docker run -v /opt/kerbmon/data:/data --rm kerbmon -domainsfile /data/domains.txt -dbfile /data/domains.db -credentials $credentials -outputfile /data/results
```
Credits
==========
- Tim Medin (@timmedin): For [his research](http://www.irongeek.com/i.php?page=videos/derbycon4/t120-attacking-microsoft-kerberos-kicking-the-guard-dog-of-hades-tim-medin) of the kerberoast attack
- Alberto Solino (@agsolino): For building a kerberoast module based on the Impacket framework. This script is heavily based on his work on GetUserSPNs and GetNPUsers
- @skelsec: For his initial https://github.com/skelsec/PyKerberoast project
- SecureAuthCorp: For their work on the [Impacket](https://github.com/SecureAuthCorp/impacket) project