NetExec/README.md

![Supported Python versions](https://img.shields.io/badge/python-3.6+-blue.svg)

# CrackMapExec

<p align="center">
  <img src="https://cloud.githubusercontent.com/assets/5151193/17577511/d312ceb4-5f3b-11e6-8de5-8822246289fd.jpg" alt="cme"/>
</p>

# Acknowledgments
**(These are the people who did the hard stuff)**

This project was originally inspired by:
- [smbmap](https://github.com/ShawnDEvans/smbmap)
- [CredCrack](https://github.com/gojhonny/CredCrack)
- [smbexec](https://github.com/pentestgeek/smbexec)

Unintentional contributors:

- The [Empire](https://github.com/PowerShellEmpire/Empire) project
- @T-S-A's [smbspider](https://github.com/T-S-A/smbspider) script
- @ConsciousHacker's partial Python port of Invoke-obfuscation from the [GreatSCT](https://github.com/GreatSCT/GreatSCT) project

This repository contains the following repositories as submodules:
- [Impacket](https://github.com/CoreSecurity/impacket)
- [Pywinrm](https://github.com/diyan/pywinrm)
- [Pywerview](https://github.com/the-useless-one/pywerview)
- [PowerSploit](https://github.com/PowerShellMafia/PowerSploit)
- [Invoke-Obfuscation](https://github.com/danielbohannon/Invoke-Obfuscation)
- [Invoke-Vnc](https://github.com/artkond/Invoke-Vnc)
- [Mimikittenz](https://github.com/putterpanda/mimikittenz)
- [NetRipper](https://github.com/NytroRST/NetRipper)
- [RandomPS-Scripts](https://github.com/xorrior/RandomPS-Scripts)
- [SessionGopher](https://github.com/fireeye/SessionGopher)
- [Mimipenguin](https://github.com/huntergregal/mimipenguin)
- [RID-Hijacking](https://github.com/r4wd3r/RID-Hijacking)
# Documentation, Tutorials, Examples
See the project's [wiki](https://github.com/byt3bl33d3r/CrackMapExec/wiki) for documentation and usage examples

# Installation
Please see the installation wiki page [here](https://github.com/byt3bl33d3r/CrackMapExec/wiki/Installation).

# How to fund my tea & sushi reserve

If you use CrackMapExec a lot (especially if it's used commercially), please consider donating as a lot of time & effort went into building & maintaining this.

Press the "Sponsor" button on the top of this page to see ways of donating/sponsoring this project.

# To do
- Kerberos support
- ~~0wn everything~~
Migrate function to python3 * --shares -> OK * --sessions -> OK * --disks -> OK * --loggedon-users -> OK * --users -> Not tested * --rid-brute -> OK * --groups -> Not tested * --local-groups -> OK * --pass-pol -> OK 2019-11-11 10:06:39 +00:00			`![Supported Python versions](https://img.shields.io/badge/python-3.6+-blue.svg)`
Update README.md 2017-04-25 22:13:58 +00:00
Update README.md 2017-04-25 22:16:50 +00:00			`# CrackMapExec`

Update README.md 2017-04-25 21:53:33 +00:00			`<p align="center">`
			`<img src="https://cloud.githubusercontent.com/assets/5151193/17577511/d312ceb4-5f3b-11e6-8de5-8822246289fd.jpg" alt="cme"/>`
			`</p>`
Made README.md decent 2015-08-19 17:17:54 +00:00
Readme fix 2017-03-27 21:12:20 +00:00			`# Acknowledgments`
Initial 4.0 pre-release 2017-03-27 21:09:36 +00:00			`(These are the people who did the hard stuff)`
Made README.md decent 2015-08-19 17:17:54 +00:00
Initial 4.0 pre-release 2017-03-27 21:09:36 +00:00			`This project was originally inspired by:`
			`- [smbmap](https://github.com/ShawnDEvans/smbmap)`
			`- [CredCrack](https://github.com/gojhonny/CredCrack)`
			`- [smbexec](https://github.com/pentestgeek/smbexec)`
Made README.md decent 2015-08-19 17:17:54 +00:00
Changed README again 2016-03-28 06:25:19 +00:00			`Unintentional contributors:`

			`- The [Empire](https://github.com/PowerShellEmpire/Empire) project`
Initial 4.0 pre-release 2017-03-27 21:09:36 +00:00			`- @T-S-A's [smbspider](https://github.com/T-S-A/smbspider) script`
Updated README.md 2017-10-25 07:02:55 +00:00			`- @ConsciousHacker's partial Python port of Invoke-obfuscation from the [GreatSCT](https://github.com/GreatSCT/GreatSCT) project`
Made README.md decent 2015-08-19 17:17:54 +00:00
Initial 4.0 pre-release 2017-03-27 21:09:36 +00:00			`This repository contains the following repositories as submodules:`
			`- [Impacket](https://github.com/CoreSecurity/impacket)`
Updated README.md 2017-10-25 07:02:55 +00:00			`- [Pywinrm](https://github.com/diyan/pywinrm)`
Initial 4.0 pre-release 2017-03-27 21:09:36 +00:00			`- [Pywerview](https://github.com/the-useless-one/pywerview)`
			`- [PowerSploit](https://github.com/PowerShellMafia/PowerSploit)`
			`- [Invoke-Obfuscation](https://github.com/danielbohannon/Invoke-Obfuscation)`
			`- [Invoke-Vnc](https://github.com/artkond/Invoke-Vnc)`
			`- [Mimikittenz](https://github.com/putterpanda/mimikittenz)`
			`- [NetRipper](https://github.com/NytroRST/NetRipper)`
			`- [RandomPS-Scripts](https://github.com/xorrior/RandomPS-Scripts)`
Updated README.md 2017-10-25 07:02:55 +00:00			`- [SessionGopher](https://github.com/fireeye/SessionGopher)`
			`- [Mimipenguin](https://github.com/huntergregal/mimipenguin)`
Add rid_hijack documentation to README 2019-02-25 01:52:44 +00:00			`- [RID-Hijacking](https://github.com/r4wd3r/RID-Hijacking)`
Readme fix 2017-03-27 21:12:20 +00:00			`# Documentation, Tutorials, Examples`
Update README.md 2016-08-14 05:02:20 +00:00			`See the project's [wiki](https://github.com/byt3bl33d3r/CrackMapExec/wiki) for documentation and usage examples`

Readme fix 2017-03-27 21:12:20 +00:00			`# Installation`
Update README.md 2017-04-25 21:53:33 +00:00			`Please see the installation wiki page [here](https://github.com/byt3bl33d3r/CrackMapExec/wiki/Installation).`
Updated README with better install instructions 2016-06-04 08:12:04 +00:00
Updated README 2017-12-21 00:43:54 +00:00			`# How to fund my tea & sushi reserve`

Fixed dependency hell, added Github actions workflow - Got rid of netaddr in favor of built in ipaddress module - cme/cmedb binaries are now built with shiv - Removed http protocol as it was basically useless and added another dependency 2020-04-20 16:19:55 +00:00			`If you use CrackMapExec a lot (especially if it's used commercially), please consider donating as a lot of time & effort went into building & maintaining this.`
Updated README 2017-12-21 00:43:54 +00:00
Fixed dependency hell, added Github actions workflow - Got rid of netaddr in favor of built in ipaddress module - cme/cmedb binaries are now built with shiv - Removed http protocol as it was basically useless and added another dependency 2020-04-20 16:19:55 +00:00			`Press the "Sponsor" button on the top of this page to see ways of donating/sponsoring this project.`
Updated README 2017-12-21 00:43:54 +00:00
Readme fix 2017-03-27 21:12:20 +00:00			`# To do`
Initial v3.0 commit to master Quick re-cap on the new features: * Credentials and hosts are now stored in a database, the cme_db.py script can be used to query it * Module system has been implemented allowing anyone to create payloads * All underlying powershell code has been ported to a module * The HTTP/HTTPS server now tracks connections: no more guessing when to CTRL-C * All around better code quality, error handling and logging 2016-03-27 21:17:18 +00:00			`- Kerberos support`
Update README.md 2017-04-25 21:53:33 +00:00			`- ~~0wn everything~~`