Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

Perform miscellaneous operations on A remote computer with Enhanced PsExec

Project description

!!!!!!!!!! Use "help(PsPc)" This will show you the available methods. (This usage form will contain it, but it is yet to be completed.) !!!!!!!!!!

About

epsexec (Enhanced psexec) uses Microsoft's Sysinternals PsExec utility that uses SMB to execute programs on remote systems. PsExec is a light-weight telnet replacement.
If you find any bugs, PLEASE report to EpsexecNoReply@gmail.com

Installation

Run the following to install:

pip install Enhanced-PsExec

Requirements

Attacker Machine:

  1. You MUST have psexec installed
    If you have A 32-bit installation, install psexec to C:\windows\sysWOW64.
    Else, to C:\windows\system32
    Recommended:
    The PsPc class has a static method download_psexec that can automate the process for you.
    Run: PsPc.download_psexec()
  2. You MUST run python as administrator (Ctrl+Esc, type "python", Ctrl+Shift+Enter,Alt-Y).

The Remote PC:
The remote pc (The pc that you are attacking) have very few requirements;

  1. SMBv2 needs to be up and running on the Windows port. Run this CMD script on the remote computer: powershell.exe Set-SmbServerConfiguration -EnableSMB2Protocol $true

  2. The ADMIN$ share to be enabled with read/write access of the user configured.
    Unless the machine already has an administrator user with password, I recommend making Another user that is administrator.
    CMD:
    net user /add usernameToHack passToBeUsed
    To enable administrator:
    net localgroup administrators usernameToHack /add

  3. You'll need to add A registry key.
    This is because UAC is set up to deny connections like this, so you will get an ACCESS_IS_DENIED error when attempting to connect.
    Fix: run CMD as administrator and run:
    reg add HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\system /v LocalAccountTokenFilterPolicy /t REG_DWORD /d 1 /f

  4. RECOMMENDED: Disable firewall on the remote machine.
    This will allow for a faster experience while connecting.
    There is also A method to do this, so you dont need to go to the remote PC NOW.
    you can do it remotely using: pc.firewallChange(state="rule")
    Or, run on this on the remote machine in administrator CMD:
    netsh advfirewall firewall set rule name="File and Printer Sharing (SMB-In)" dir=in new enable=Yes
    Or, you can just disable the firewall entirely administrator CMD:
    netsh advfirewall set allprofiles state off

  5. Restart the system.

Import

To import the package, use from epsexec import PsPc.

Usage

  1. Create a PsPc class instance.
pc1 = PsPc(ip="IPv4", username="username", password="password")   

Or, if you want to import from a file:

pc1 = PsPc(file="name_of_file.txt")

General settings:

delay_before --- This pauses the operation {delay_before} millisecond before starting the operation. (Default 100)
run_as_admin --- If true, it will run the operation in administrative privileges. (default True)

firewallChange

This is probably the most important method. why?
Well, because firewall makes the psexec process extremely slow (It takes about 12 seconds instead of 1).
So, it becomes very frustrating.
Modes:

  1. "on" to enable firewall on the remote machine.
  2. "off" to disable firewall on the remote machine.
  3. "smb" to add a SMB-only rule. This will allow connections from port 445 (smb)
  4. "rdp" to add a remote desktop rule to make connections from remote desktop easier.

download_nir

NirCMD is A windows command-line utility that allows you to do useful tasks without displaying any user interface.
Unfortunately, NirCMD is NOT installed by default on windows systems.
Thats why this method exists. all this method do, is download NirCMD on the remote PC using powershell.
Nircmd is required for the following methods:

  1. beep
  2. sendScreenshot
  3. set_volume
  4. textToSpeech

beep

Requires Nircmd
The beep method takes frequency(hz) and duration(millisecond) parameters.
Then it plays A sound at the given frequency and duration.

getShell

The getShell method is the most basic method.
It takes A shell to open as and administration privileges. (default "cmd.exe",True)
This is your everyday remote shell on another PC.
You can also choose powershell instead of cmd

set_by_config_file

This method is to takes a file name which includes a pre-made list of computers infomation.
This text file is the same as the one used by openurl to get a list of
pre-made urls except, this is for computers.
Example:

config:
    IP USERNAME PASSWORD
    10.0.0.15 user p@assword
endconfig

urls:
    name URL
    youtube https://www.youtube.com
endurl

You can also include a delimiter, like , (comma) instead of ' ' (space)

close_process

The close_process method takes A process name or processID, and delay_before to wait before the program closes the process.
Then it uses taskkill (CMD command) to close it.

close_chrome

This method closes every chrome tab on the remote machine.
It takes 2 parameters: runAsAdmin, and delay_before. (Default True)

textToSpeech

Requires Nircmd
The textToSpeech method takes A string to speak, and MaleVoice as a boolean. (default True)
Then it uses NirCMD to speak the text on the remote PC.

set_volume

Requires Nircmd
The set_volume method takes a number from 0 to 100 as the percentage And delay_before.
Then it opens NirCMD in the remote pc and uses "setsysvolume" to set the computer's volume.
If the volume is set to zero, it will mute the remote pc. If the volume is set to 101, it will un-mute the remote pc (A pc can be muted, but the volume is high.)

send_screenshot

Requires Nircmd
The sendScreenshot takes email address and delay_before.
It uses NirCMD to take A screenshot, save it to C:\epsexecScreenshot.png
Then, it uses powershell SMTPClient.send() to send an email to the given Email Address

openurl

This method is the most complicated method.
It can potentially take multiple parameters.
RECOMMENDED: Go to chrome://extensions on the remote machine. then go to your AdBlocker's settings.
Click "Allow in incognito". This will allow your AdBlocker on incognito.
So YouTube songs will not load ads, making for better experience.

I will now explain every parameter:
URL --- This is the URL to be opened in the remote machine. If fromFile parameter is used, it must be: '*://*/*', its default

fromFile --- This parameter is used to take A text file and get every URL and its shotcut name.
See more

delimiter --- This is only if you also specified fromFile - How to seperate each name,url

tabs --- This parameter is responsible for the amount of tabs to open on the remote machine. (Default=1)

delayBeforeOpening --- This parameter decides how much time in millisecond the program should pause before starting the operation. (Default=100)

delayBetweenTabs --- This parameter decides how much time in millisecond the program should pause BETWEEN every time it opens A new tab.

new_window --- This parameter decides whether or not to open the tab(s) in new window each time. (Default=False)

incognito --- This parameter decides if the tab(s) would be opened in Incognito mode. (Default=False)

invisible --- This parameter decides if the tab(s) would be opened invisibly, and not interactive, so the user would not notice its opened, unless the window plays sound (Default=False).

Available class methods:

Help on class PsPc in module epsexec:

class PsPc(builtins.object)
 |  PsPc(**kwargs)
 |
 |  Methods defined here:
 |
 |  __getitem__(self, item)
 |
 |  __init__(self, **kwargs)
 |      Initialize self.  See help(type(self)) for accurate signature.
 |
 |  __repr__(self)
 |      Return repr(self).
 |
 |  __setitem__(self, key, value)
 |
 |  beep(self, frequency, duration_ms, delay_before=0)
 |
 |  close_chrome(self, delay_before=0)
 |
 |  close_process(self, proc_name, delay_before=0)
 |      proc_name --- The process to close (could be either a name, or an ID).
 |      delay_before --- The amount (in milliseconds) to pause before closing the process.
 |
 |  download_nir(self)
 |
 |  enable_remote_desktop(self)
 |
 |  firewallChange(self, state='smb', delay_before=0)
 |      state --- Controls the operation to perform.
 |          off/on - Turn off/on the firewall.
 |          smb - Add a rule to allow smb connections (recommended).
 |          rdp - Add a rule to allow remote desktop connections.
 |
 |      delay_before --- The amount (in milliseconds) to pause before performing the operation.
 |
 |  getShell(self, shell='cmd.exe', run_as_admin=True)
 |      shell --- program to open (default "cmd.exe")
 |      run_as_admin --- Should the shell be ran with administrative privileges (default True)
 |
 |  openurl(self, url='*://*/*', fromFile='fileName.txt', delimiter=' ', tabs=1, new_window=False, delay_before=0, delay_between=10, incognito=False, invisible=False)
 |      URL --- This is the URL to be opened in the remote machine. If `fromFile` parameter is used, it must be: `'*://*/*'`, its default
 |
 |      fromFile --- This parameter is used to take A text file and get every URL and its shotcut name.
 |      See more: https://github.com/orishamir/Epsexec/blob/master/fromFile.md
 |
 |      delimiter --- This is only if you also specified `fromFile` - How to seperate each name,url
 |
 |      tabs --- This parameter is responsible for the amount of tabs to open on the remote machine. (Default=1)
 |
 |
 |
 |
 |      incognito --- This parameter decides if the tab(s) would be opened in Incognito mode. (Default=False)
 |
 |      invisible --- This parameter decides if the tab(s) would be opened invisibly, and not interactive, so the user would not notice its opened, unless the window plays sound (Default=False).
 |
 |  run_command(self, program, arguments, delay_before=0, run_as_admin=True, invisible=False)
 |
 |  send_screenshot(self, email_recipient_addr, delay_before=0)
 |
 |  set_by_config_file(self, file_name, delimiter=' ', extern=False)
 |
 |  set_volume(self, percent, delay_before=0)
 |
 |  startRemoteDesktop(self)
 |
 |  textToSpeech(self, text, male_voice=True, delay_before=0)
 |
 |  ----------------------------------------------------------------------
 |  Static methods defined here:
 |
 |  download_psexec()
 |
 |  ----------------------------------------------------------------------
 |  Data descriptors defined here:
 |
 |  __dict__
 |      dictionary for instance variables (if defined)
 |
 |  __weakref__
 |      list of weak references to the object (if defined)

Credits

Epsexec was created by Ori Shamir.
If you find any bugs, PLEASE report to EpsexecNoReply@gmail.com

Changelog:

0.4.9 - Fixed openurl delayBetweenTabs not working properly.

0.5.1:

  • Added this changelog.
  • Added static method download_psexec. This is to download PsExec on your machine.
  • openurl method now automatically gets the installation folder of google chrome.
  • PEP 8:
    • Changed downloadNirCMD method name to download_nir.
    • Changed sleepBefore parameter name to delay_before.
    • Changed durationMs parameter name to duration_ms in beep method.

0.5.3:

  • Now, openurl saves the installation folder to globals dictionary, so you wont do the search process twice.

0.5.5:

  • get_installation_folder is A nested function inside openurl.
    It gets called if globals() dictionary does NOT contain Chrome installation location.

0.5.6:

  • PEP 8:
    • Changed sendScreenshot method name to send_screenshot.
    • Changed newWindow parameter name to new_window.

0.5.7:

  • Added enable_remote_desktop method.
  • Added value "rdp" to the firewallChange method to allow rdp connections.
  • Change value "rule" to "smb" in the firewallChange method to allow smb connections.
  • PEP 8:
    • When importing, use from epsexec import PsPc
      instead of
      from Epsexec import PsPc.
    • Changed maleVoice parameter name to male_voice in the method textToSpeech.
    • Changed URL parameter name to url in the method openurl.

0.5.9:

  • Enhanced-PsExec Now supports 32-bit version of python
  • Removed runAsAdmin parameter from the close_chrome method
  • PEP 8:
    • Changed isAdmin parameter name to run_as_admin in the method getShell

0.6.0:

  • Added method set_by_config_file.
    This method takes at least one parameter:
    1. file_name - string, The name of the file.
    2. delimiter - character, what to seperate ip,username,password with.
    3. extern - boolean.
      The extern parameter needs to be included with a True value if
      You want to change pc information AFTER initializing the object.
      To Initialize a object with information by a file, do this:
      pc = PsPc(file="file_name.txt")
  • Added a delimiter parameter to the openurl function.

0.6.1:

  • PEP 8:
    • Changed closeProcess method name to close_process.
    • Changed procNameOrID parameter name to proc_name in the close_process method.

0.6.2:

  • PEP 8:
    • Changed closeChrome method name to close_chrome

0.6.3:

  • Added run_command method
  • PEP 8:
    • Chagned setVolume method name to set_volume

0.6.4:

  • Changed class name from psPc to PsPc
  • Changed procNameOrID parameter name to proc_name in the close_process method.
  • Code changes to make the set_by_config_file method better.
  • Added __repr__, __setitem__ and getitem`. How to use:
    from epsexec import PsPc 
    pc = PsPc(i="IP", u="username", p="pass")
    print(pc[0])
    # Output:
    # IP
    pc[0] = "127.0.0.1"
    # Sets the ip to 127.0.0.1
    

TODO:

  1. Add a method to import computers from a config file (like in urls.txt)
    1.1) DONE!
  2. Give me suggestions! at EpsexecNoReply@gmail.com

Project details


Download files

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

Files for Enhanced-PsExec, version 0.6.8
Filename, size File type Python version Upload date Hashes
Filename, size Enhanced_PsExec-0.6.8-py3-none-any.whl (13.1 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size Enhanced PsExec-0.6.8.tar.gz (14.6 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page