LOLBAS/README.md

69 lines
3.1 KiB
Markdown
Raw Normal View History

2018-06-09 00:15:06 +02:00
# Living Off The Land Binaries and Scripts (and now also Libraries)
<img src="https://github.com/api0cradle/LOLBAS/raw/master/Logo/LOLBAS.png" height="250">
All the different files can be found behind a fancy frontend here: https://lolbas-project.github.io (thanks @ConsciousHacker for this bit of eyecandy and the team over at https://gtfobins.github.io/).
This repo serves as a place where we maintain the YML files that are used by the fancy frontend.
2018-06-09 00:15:06 +02:00
2018-09-18 16:31:27 +02:00
## Goal
2018-10-04 04:25:25 +02:00
The goal of the LOLBAS project is to document every binary, script, and library that can be used for Living Off The Land techniques.
## Criteria
A LOLBin/Lib/Script must:
* Be a Microsoft-signed file, either native to the OS or downloaded from Microsoft.
* Have extra "unexpected" functionality. It is not interesting to document intended use cases.
* Exceptions are application whitelisting bypasses
* Have functionality that would be useful to an APT or red team
Interesting functionality can include:
* Executing code
* Arbitrary code execution
* Pass-through execution of other programs (unsigned) or scripts (via a LOLBin)
* Compiling code
* File operations
* Downloading
* Upload
* Copy
* Persistence
* Pass-through persistence utilizing existing LOLBin
* Persistence (e.g. hide data in ADS, execute at logon)
* UAC bypass
* Credential theft
* Dumping process memory
* Surveillance (e.g. keylogger, network trace)
* Log evasion/modification
* DLL side-loading/hijacking without being relocated elsewhere in the filesystem.
2018-09-18 16:31:27 +02:00
## Contributing
If you have found a new LOLBin or LOLScript that you would like to contribute, please review the contributing guidelines located here: https://github.com/LOLBAS-Project/LOLBAS/blob/master/CONTRIBUTING.md
A template for the required format has been provided here: https://github.com/LOLBAS-Project/LOLBAS/blob/master/YML-Template.yml
2018-10-04 04:25:25 +02:00
## The History of the LOLBin
2018-06-09 00:15:06 +02:00
2018-10-04 04:25:25 +02:00
The phrase "Living off the land" was coined by Christopher Campbell (@obscuresec) & Matt Graeber (@mattifestation) at [DerbyCon 3](https://www.youtube.com/watch?v=j-r6UonEkUw).
2018-06-09 00:15:06 +02:00
2018-10-04 04:25:25 +02:00
The term LOLBins came from a Twitter discussion on what to call binaries that can be used by an attacker to perform actions beyond their original purpose. Philip Goh (@MathCasualty) [proposed LOLBins](https://twitter.com/MathCasualty/status/969174982579273728). A highly scientific internet poll ensued, and after a general consensus (69%) was reached, the name was [made official](https://twitter.com/Oddvarmoe/status/985432848961343488). Jimmy (@bohops) [followed up with LOLScripts](https://twitter.com/bohops/status/984828803120881665). No poll was taken.
2018-06-09 00:15:06 +02:00
Common hashtags for these files are:
2018-10-04 04:25:25 +02:00
* #LOLBin
* #LOLBins
* #LOLScript
* #LOLScripts
* #LOLLib
* #LOLLibs
## Thanks
As with many open-source projects, this one is the product of a community and we would like to thank ours:
* The domain http://lolbins.com has been registered by an unknown individual and redirected it to the old version of this project.
2018-10-04 04:25:25 +02:00
* The domain http://lolbas-project.com has been registered by Jimmy (@bohops).
* The logos for the project were created by Adam Nadrowski (@_sup_mane). We #@&!!@#! love them.