powershell-pro-obfuscator 1.0.0__py3-none-any.whl

examples/PowerShellProObfuscatorExample.py

@@ -0,0 +1,236 @@
+#!/usr/bin/env python
+
+###############################################################################
+#
+# PowerShell Pro Obfuscator WebApi interface usage example.
+#
+# In this example we will obfuscate sample source with custom options.
+#
+# Version        : v1.0.0
+# Language       : Python
+# Author         : Bartosz Wójcik
+# Web page       : https://www.pelock.com
+#
+###############################################################################
+
+#
+# include PowerShell Pro Obfuscator module
+#
+from powershellproobfuscator import PowerShellProObfuscator
+
+#
+# if you don't want to use Python module, you can import directly from the file
+#
+#from pelock.powershellproobfuscator import PowerShellProObfuscator
+
+#
+# create PowerShell Pro Obfuscator class instance (we are using our activation key)
+#
+myPowerShellProObfuscator = PowerShellProObfuscator("ABCD-ABCD-ABCD-ABCD")
+
+#
+# should the source code be compressed (both input & compressed)
+#
+myPowerShellProObfuscator.enableCompression = False
+
+#
+# global obfuscation options
+#
+# you can disable a particular obfuscation strategy globally if it
+# fails or you don't want to use it without modifying the source codes
+#
+# by default all obfuscation strategies are enabled
+#
+
+#
+# protection against tampering with protected code (integrity verification)
+#
+myPowerShellProObfuscator.selfDefending = True
+
+#
+# protection linker (decoy call graph)
+#
+myPowerShellProObfuscator.protectionLinker = True
+
+#
+# rename variable names to random string values
+#
+myPowerShellProObfuscator.renameVariables = True
+
+#
+# rename parameter names to random string values
+#
+myPowerShellProObfuscator.renameParameters = True
+
+#
+# rename function names to random string values
+#
+myPowerShellProObfuscator.renameFunctions = True
+
+#
+# shuffle function order in the output source
+#
+myPowerShellProObfuscator.shuffleFunctions = True
+
+#
+# change linear code execution flow via control-flow flattening
+#
+myPowerShellProObfuscator.controlFlowFlatten = True
+
+#
+# rewrite statement blocks into finite-state automata (state-machine obfuscation)
+#
+myPowerShellProObfuscator.stateMachine = True
+
+#
+# lift selected statements into a VM engine (virtualized statements)
+#
+myPowerShellProObfuscator.vmStrategy = True
+
+#
+# encrypt integers
+#
+myPowerShellProObfuscator.encryptIntegers = True
+
+#
+# split strings into concatenated chunks
+#
+myPowerShellProObfuscator.splitStrings = True
+
+#
+# encrypt strings using randomly generated polymorphic encryption algorithms
+#
+myPowerShellProObfuscator.encryptStrings = True
+
+#
+# move integers to arrays
+#
+myPowerShellProObfuscator.integersToArrays = True
+
+#
+# move floats to arrays
+#
+myPowerShellProObfuscator.floatsToArrays = True
+
+#
+# insert dead code
+#
+myPowerShellProObfuscator.insertDeadCode = True
+
+#
+# replace boolean conditions with equivalent complex expressions
+#
+myPowerShellProObfuscator.complexifyBooleans = True
+
+#
+# represent integers via floating-point math
+#
+myPowerShellProObfuscator.integersToFloating = True
+
+#
+# encrypt floating point numbers
+#
+myPowerShellProObfuscator.encryptFloating = True
+
+#
+# insert decoy functions
+#
+myPowerShellProObfuscator.decoyFunctions = True
+
+#
+# insert anti-debugging detections
+#
+myPowerShellProObfuscator.detectDebugger = True
+
+#
+# insert fake dot-source comment markers
+#
+myPowerShellProObfuscator.fakeDotSourceMarkers = True
+
+#
+# insert opaque predicate branches
+#
+myPowerShellProObfuscator.opaqueBranches = True
+
+#
+# insert scriptblock decoys
+#
+myPowerShellProObfuscator.scriptblockDecoys = True
+
+#
+# insert here-string padding
+#
+myPowerShellProObfuscator.literalPadding = True
+
+#
+# use indirect command invocation
+#
+myPowerShellProObfuscator.reflectInvokeCommands = True
+
+#
+# store string fragments in char-code array vaults
+#
+myPowerShellProObfuscator.stringCharArrayVault = True
+
+#
+# wrap code in try/finally blocks with dead noise
+#
+myPowerShellProObfuscator.tryFinallyNoise = True
+
+#
+# apply redundant xor / affine integer masks
+#
+myPowerShellProObfuscator.affineIntegerMask = True
+
+#
+# insert dead event/timer stubs
+#
+myPowerShellProObfuscator.eventStub = True
+
+#
+# strip comments from the output source
+#
+myPowerShellProObfuscator.removeComments = True
+
+#
+# source code in PowerShell format
+#
+scriptSourceCode = """function Get-Greeting {
+    param([string]$Name)
+    Write-Host "Hello World from $Name!"
+}
+Get-Greeting "PowerShell Pro Obfuscator\""""
+
+#
+# by default all obfuscation options are enabled, so we can just simply call
+#
+result = myPowerShellProObfuscator.obfuscate_script_source(scriptSourceCode)
+
+#
+# it's also possible to pass a PowerShell script file path instead of a string with the source e.g.
+#
+# result = myPowerShellProObfuscator.obfuscate_script_file("/path/to/project/script.ps1")
+
+#
+# result[] array holds the obfuscation results as well as other information
+#
+# result["error"]         - error code
+# result["output"]        - obfuscated code
+# result["demo"]          - was it used in demo mode (invalid or empty activation key was used)
+# result["credits_left"]  - usage credits left after this operation
+# result["credits_total"] - total number of credits for this activation code
+# result["expired"]       - if this was the last usage credit for the activation key it will be set to True
+#
+if result and "error" in result:
+
+    # display obfuscated code
+    if result["error"] == PowerShellProObfuscator.ERROR_SUCCESS:
+
+        # format output code for HTML display
+        print(result["output"])
+
+    else:
+        print(f'An error occurred, error code: {result["error"]}')
+
+else:
+    print("Something unexpected happen while trying to obfuscate the code.")

examples/PowerShellProObfuscatorExampleIsDemo.py

@@ -0,0 +1,52 @@
+#!/usr/bin/env python
+
+###############################################################################
+#
+# PowerShell Pro Obfuscator WebApi interface usage example.
+#
+# In this example we will verify our activation key status.
+#
+# Version        : v1.0.0
+# Language       : Python
+# Author         : Bartosz Wójcik
+# Web page       : https://www.pelock.com
+#
+###############################################################################
+
+#
+# include PowerShell Pro Obfuscator module
+#
+from powershellproobfuscator import PowerShellProObfuscator
+
+#
+# if you don't want to use Python module, you can import directly from the file
+#
+#from pelock.powershellproobfuscator import PowerShellProObfuscator
+
+#
+# create PowerShell Pro Obfuscator class instance (we are using our activation key)
+#
+myPowerShellProObfuscator = PowerShellProObfuscator("ABCD-ABCD-ABCD-ABCD")
+
+#
+# login to the service
+#
+result = myPowerShellProObfuscator.login()
+
+#
+# result[] array holds the information about the license
+#
+# result["demo"]          - is it a demo mode (invalid or empty activation key was used)
+# result["credits_left"]  - usage credits left after this operation
+# result["credits_total"] - total number of credits for this activation code
+# result["string_limit"]  - max. source code size allowed (it's 1000 bytes for demo mode)
+#
+if result:
+
+    print(f'Demo version status - {"True" if result["demo"] else "False"}')
+    print(f'Usage credits left - {result["credits_left"]}')
+    print(f'Total usage credits - {result["credits_total"]}')
+    print(f'Max. source code size - {result["string_limit"]}')
+
+else:
+    print("Something unexpected happen while trying to login to the service.")

examples/PowerShellProObfuscatorExampleSimple.py

@@ -0,0 +1,72 @@
+#!/usr/bin/env python
+
+###############################################################################
+#
+# PowerShell Pro Obfuscator WebApi interface usage example.
+#
+# In this example we will obfuscate sample source with default options.
+#
+# Version        : v1.0.0
+# Language       : Python
+# Author         : Bartosz Wójcik
+# Web page       : https://www.pelock.com
+#
+###############################################################################
+
+#
+# include PowerShell Pro Obfuscator module
+#
+from powershellproobfuscator import PowerShellProObfuscator
+
+#
+# if you don't want to use Python module, you can import directly from the file
+#
+#from pelock.powershellproobfuscator import PowerShellProObfuscator
+
+#
+# create PowerShell Pro Obfuscator class instance (we are using our activation key)
+#
+myPowerShellProObfuscator = PowerShellProObfuscator("ABCD-ABCD-ABCD-ABCD")
+
+#
+# source code in PowerShell format
+#
+scriptSourceCode = """function Get-Greeting {
+    param([string]$Name)
+    Write-Host "Hello World from $Name!"
+}
+Get-Greeting "PowerShell Pro Obfuscator\""""
+
+#
+# by default all obfuscation options are enabled, so we can just simply call
+#
+result = myPowerShellProObfuscator.obfuscate_script_source(scriptSourceCode)
+
+#
+# it's also possible to pass a PowerShell script file path instead of a string with the source e.g.
+#
+# result = myPowerShellProObfuscator.obfuscate_script_file("/path/to/project/script.ps1")
+
+#
+# result[] array holds the obfuscation results as well as other information
+#
+# result["error"]         - error code
+# result["output"]        - obfuscated code
+# result["demo"]          - was it used in demo mode (invalid or empty activation key was used)
+# result["credits_left"]  - usage credits left after this operation
+# result["credits_total"] - total number of credits for this activation code
+# result["expired"]       - if this was the last usage credit for the activation key it will be set to True
+#
+if result and "error" in result:
+
+    # display obfuscated code
+    if result["error"] == PowerShellProObfuscator.ERROR_SUCCESS:
+
+        # format output code for HTML display
+        print(result["output"])
+
+    else:
+        print(f'An error occurred, error code: {result["error"]}')
+
+else:
+    print("Something unexpected happen while trying to obfuscate the code.")