https://github.com/lawndoc/ransim

Ransomware simulation script written in PowerShell. Useful for testing your defenses and backups against real ransomware-like activity in a controlled setting.
https://github.com/lawndoc/ransim

backup backups cryptography cybersecurity decryption encryption powershell ransom ransomware red-teaming script testing

Last synced: 5 days ago
JSON representation

Ransomware simulation script written in PowerShell. Useful for testing your defenses and backups against real ransomware-like activity in a controlled setting.

• Host: GitHub
• URL: https://github.com/lawndoc/ransim
• Owner: lawndoc
• License: mit
• Created: 2021-09-17T15:53:40.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2024-10-14T01:29:16.000Z (3 months ago)
• Last Synced: 2025-01-10T20:14:42.436Z (12 days ago)
• Topics: backup, backups, cryptography, cybersecurity, decryption, encryption, powershell, ransom, ransomware, red-teaming, script, testing
• Language: PowerShell
• Homepage:
• Size: 198 KB
• Stars: 211
• Watchers: 4
• Forks: 31
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
![Logo](RanSim.png)

## Description

RanSim is a ransomware simulation script written in PowerShell. It recurisively encrypts files in the target directory using 256-bit AES encryption. RanSim will not leave any ransom note, it is only meant to perform file encryption.

You can use RanSim to test your defenses and backups against real ransomware-like activity in a controlled setting. The same script can be used to decrypt the files if needed.

## Usage

### Encrypt

```PowerShell

.\RanSim.ps1 -Mode encrypt

```

### Decrypt

```PowerShell

.\RanSim.ps1 -Mode decrypt

```

### Optional Parameters and Defaults

`-TargetPath` -> C:\RanSim

`-Extension` -> .encrypted

`-Key` -> Q5KyUru6wn82hlY9k8xUjJOPIC9da41jgRkpt21jo2L=

### Other Global Variables

`TargetFiles` -> .pdf .xls* .ppt* .doc* .accd* .rtf .txt .csv .jpg .jpeg .png .gif .avi .midi .mov mp3 .mp4 .mpeg .mpeg2 .mpeg3 .mpg .ogg

## Credits

The author of the [FileCryptography.psm1](FileCryptography.psm1) is Tyler Siegrist, and he is also credited in the module's docstring.