Skip to main content

A Pentester's Powershell Client.

Project description

Devious-WinRM

A Pentester's Powershell Client.

The help screen for Devious-WinRM, showing a variety of flags and options.

Description / Purpose

This tool allows one to access servers running WinRM or Powershell Remoting, with additional tools for capture the flag / pentesting. I created this project to fix a few grievances I have with existing tools (such as the amazing Evil-WinRM) and to contribute to the open-source hacking community.

Under the hood, Devious-WinRM is not directly based on WinRM. It is instead built on the PowerShell Remoting Protocol, which in turn uses WinRM. PSRP was chosen as it seems to require less user permissions than WinRM, at least in a rudementary Active Directory environment.

Features / Planned

  • No-config Kerberos auth
  • Make it pretty
  • Pass the hash support
  • Pass the ticket support
  • File upload/download
  • Syntax highlighting
  • Ctrl+C command interupt
  • Remote path completion
  • In-Memory .NET loader
  • Local logon token upgrader via RunasCs
  • In-Memory Powershell loader
  • Certificate auth
  • SSL auth
  • Logging

Installation

0 - Install Kerberos (Linux only)

sudo apt install gcc python3-dev libkrb5-dev krb5-pkinit

1 - Install Devious-WinRM

uv tool install devious-winrm

or

pipx install devious-winrm

Sample usage:

dwrm ws01.example.com -u 1upbyte -p supersecret123 -k --dc dc01.example.com

Check out the Installation Guide for more technical information along with help for other distros.

Credits

  • Evil-WinRM - This goes without saying, but Evil-WinRM is an incredible tool. It was the primary inspiration for this project.
  • pypsrp - A tremendously well-featured library for Powershell Remote in Python. Super friendly developer as well!
  • evil-winrm-py - Aditya and I had the same idea at almost the exact same time. I would be remissed if I didn't mention his project as well.
  • RunasCs - Used for the local token upgrader. Super useful tool when doing work over WinRM.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

devious_winrm-1.2.0.tar.gz (59.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

devious_winrm-1.2.0-py3-none-any.whl (66.8 kB view details)

Uploaded Python 3

File details

Details for the file devious_winrm-1.2.0.tar.gz.

File metadata

  • Download URL: devious_winrm-1.2.0.tar.gz
  • Upload date:
  • Size: 59.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.8.6

File hashes

Hashes for devious_winrm-1.2.0.tar.gz
Algorithm Hash digest
SHA256 8986a538708fcdd66cd7dbabd02a8007512db1e8d7971b98c00b89af19dd9feb
MD5 948daf053c0f70d81c4323d142651e31
BLAKE2b-256 443a34d45820ee1f384b4fc562f83a7cf1a6e8149be7dc191f026e08221dcfd3

See more details on using hashes here.

File details

Details for the file devious_winrm-1.2.0-py3-none-any.whl.

File metadata

File hashes

Hashes for devious_winrm-1.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 8e82ef70ccc143b376906ff1f87f5d9fd772a57355f45bf96244387678be176d
MD5 8c482d2bb8b9579d61c63bf51e648b8e
BLAKE2b-256 d4ad09663631a0a454b6d6e77a716d1fe3a798d542c14e442cd9175efb781176

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page