Skip to content
Sandbox evasion modules written in PowerShell, Python, Go, Ruby, C, C#, Perl, and Rust.
Go Rust Python PowerShell Ruby C Other
Branch: master
Clone or download
Arvanaghi Merge pull request #7 from ahhh/master
Create checkplease.go
Latest commit 8a452cf Oct 1, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
C# Restructured folders Aug 5, 2017
C Restructured folders Aug 5, 2017
Go Create checkplease.go Aug 17, 2018
Multi-Language Support/Delay-Analysis Restructured folders Aug 5, 2017
Perl Restructured folders Aug 5, 2017
PowerShell Restructured folders Aug 5, 2017
Python Fix typo in Aug 17, 2018
Ruby Restructured folders Aug 5, 2017
Rust file name hash and mac address checks Sep 27, 2017
LICENSE Initial commit Mar 13, 2017 Update Nov 5, 2017


Implant-Security Modules in PowerShell, Python, Go, Ruby, Perl, C, C#, and Rust.

Written by Brandon Arvanaghi (@arvanaghi) and Chris Truncer (@ChrisTruncer).

Slides from BSides Las Vegas 2017.

CheckPlease is the go-to repository for the newest implant security modules. Every module functions as a standalone "check." All checks can be run with command-line arguments, like so:

<module> <optional arguments>

This repository is for defenders to harden their sandboxes and AV tools, malware researchers to discover new techniques, and red teamers to get serious about their payloads.

For an explanation of every cheeck in this repository, see the CheckPlease wiki.


PowerShell: Ensure user activity by making the user click a pop-up prompt before executing your payload:

.\user_prompt.ps1 "Security Update" "Your system has been updated successfully."

PowerShell: Confirm that the parent process of your payload was WinWord.exe:

PS arvanaghi: .\parent_process.ps1 WinWord

Python: Make the user click 6 times before executing your payload to ensure it is not being run in an automated environment:

arvanaghi: python 6

Go: Ensure the Registry on the target system is at least 60 MB in size:

arvanaghi: go run registry_size.go 60 

Ruby: Only execute the payload if running as a specific user:

arvanaghi: ruby username.rb "Chris Truncer"

Perl: Make your payload execute on a certain date.

arvanaghi: perl 09/20/2017

You know how to run C and C# code.

Adding to your code

Take the checks in the repository and add them to your own custom code. Add the checks you want into nested if statements. You can, and should, chain more than one together. If the system passes all your checks, your payload will execute.

Example: ensuring the username is as expected, and the time zone is not UTC:

import getpass
import time

expectedUserName = " ".join(sys.argv[1:]).lower()

if getpass.getuser().lower() == expectedUserName:
  if time.tzname[0] != "Coordinated Universal Time" and time.tzname[1] != "Coordinated Universal Time":
    # Your code goes here. If it passed all checks, it will run!

Why every language?

Payloads are more commonly being delivered in languages that are not C. In implementing in every language, we give sandbox and antivirus vendors a broader scope from which to detect. In your red teams, any payload you deliver can now be more targeted.


We encourage contributions to this repository. To make it truly comprehensive, we want the newest techniques added to this repository as soon as possible. If you submit a merge request, I will get it tested within a week.

You can’t perform that action at this time.