Skip to main content

Application server penetration testing tool (Penterep tool)

Project description

penterepTools

PTSRVTESTER - Server Penetration Testing Tool

Installation

pip install ptsrvtester

Adding to PATH

If you're unable to invoke the script from your terminal, it's likely because it's not included in your PATH. You can resolve this issue by executing the following commands, depending on the shell you're using:

For Bash Users

echo "export PATH=\"`python3 -m site --user-base`/bin:\$PATH\"" >> ~/.bashrc
source ~/.bashrc

For ZSH Users

echo "export PATH=\"`python3 -m site --user-base`/bin:\$PATH\"" >> ~/.zshrc
source ~/.zshrc

Usage examples

ptsrvtester snmp detection --ip 192.168.1.1
ptsrvtester dns whois -d example.com
ptsrvtester ldap banner -ip 192.168.1.1
ptsrvtester dhcp info --interface eth0
ptsrvtester xrdp bruteforce --target 192.168.1.1 --username admin --wordlist passwords.txt
ptsrvtester <module> -h     for help for module use

Available Modules:

   <module>                     Select module to use
                         snmp   SNMP testing module
                         dns    DNS testing module
                         ldap   LDAP testing module
                         msrpc  MSRPC testing module
                         ftp    FTP testing module
                         ssh    SSH testing module
                         smtp   SMTP testing module
                         pop3   POP3 testing module
                         imap   IMAP testing module
                         dhcp   DHCP testing module
                         xrdp   XRDP testing module

   -v        --version          Show script version and exit
   -h        --help             Show this help message and exit
   -j        --json             Output in JSON format
             --debug            Enable debug messages

Module Descriptions:

SNMP Module

  • Version detection (SNMPv1, SNMPv2c, SNMPv3)
  • SNMPv2 community string brute-force
  • SNMPv3 user enumeration and credential brute-force
  • Write permission testing
  • MIB walking (SNMPv2/SNMPv3)

DNS Module

  • DNS server information retrieval
  • Reverse DNS lookup
  • Zone transfer attempts
  • DNS record lookup
  • WHOIS queries
  • Subdomain brute-forcing
  • DNSSEC verification
  • Zone walking (NSEC/NSEC3)

LDAP Module

  • Server banner retrieval
  • LDAP search queries
  • User enumeration
  • Credential brute-force
  • Write permission testing

MSRPC Module

  • Endpoint mapper enumeration
  • MGMT interface enumeration
  • Named pipe brute-force
  • SMB/TCP/HTTP credential brute-force
  • Anonymous SMB access testing
  • Named pipe enumeration

FTP Module

  • Banner and Service Identification
  • Anonymous authentication testing
  • Read/write access testing
  • Credential brute-force
  • FTP bounce attack testing

SSH Module

  • Banner, Service Identification and host key retrieval
  • Authentication method detection
  • Bad public key detection
  • SSH audit (CVE identification)
  • Credential and private key brute-force

SMTP Module

  • Banner and Service Identification
  • Server information gathering
  • Encryption testing (plaintext, STARTTLS, TLS); port 465 implicit TLS
  • User enumeration (VRFY, EXPN, RCPT)
  • NTLM information disclosure
  • Open relay testing
  • Catch-all mailbox detection
  • RCPT TO limit test (per-message recipient limit; expects 452/421 or similar)
  • Credential brute-force
  • Blacklist testing

POP3 Module

  • Banner, Service Identification and capabilities retrieval
  • Encryption testing (plaintext, STLS, TLS); port 995 implicit TLS
  • Anonymous authentication testing
  • NTLM authentication inspection
  • Credential brute-force

IMAP Module

  • Banner, Service Identification and capabilities retrieval
  • Anonymous authentication testing
  • NTLM authentication inspection
  • Credential brute-force

DHCP Module

  • DHCP server information retrieval
  • DHCP starvation attack testing
  • DHCP DoS/flood attack testing
  • Network interface based testing

XRDP Module

  • XRDP server brute-force testing
  • Credential testing via GUI automation
  • Multi-threaded password testing
  • CVE-2024-39917 exploitation (no rate limiting)
  • Requires Linux with Xorg, xfreerdp3, and wmctrl

## Dependencies

cryptography>=42.0.8 dnspython>=2.7.0 impacket>=0.12.0 ldap3>=2.9.1 ptlibs>=1.0.20,<2 pysnmp>=7.1.20 python-whois>=0.9.5 paramiko>=4.0.0 beautifulsoup4>=4.14.0 httpx>=0.28.0 h2>=4.3.0 lxml>=6.0.0 ssh_audit>=3.3.0 ntlm-auth>=1.5.0 scapy>=2.6.1 dhcppython>=0.1.4 pillow>=12.0.0 python-xlib>=0.33 pynput>=1.8.0 XWindows>=0.0.7


### Additional System Requirements

For DHCP module:
- Root/sudo privileges (for network packet manipulation)

For XRDP module:
- Linux with Xorg (not Wayland)
- `xfreerdp3` command available
- `wmctrl` command available
- Disable screen saver/lock during use


## License

Copyright (c) 2024 Penterep Security s.r.o.

ptsrvtester is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

ptsrvtester is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with ptsrvtester. If not, see https://www.gnu.org/licenses/.

## Warning

You are only allowed to run the tool against the servers and systems which
you have been given permission to pentest. We do not accept any
responsibility for any damage/harm that this application causes to your
computer, or your network. Penterep is not responsible for any illegal
or malicious use of this code. Be Ethical!

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

ptsrvtester-1.0.5.tar.gz (111.9 kB view details)

Uploaded Source

Built Distribution

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

ptsrvtester-1.0.5-py3-none-any.whl (121.1 kB view details)

Uploaded Python 3

File details

Details for the file ptsrvtester-1.0.5.tar.gz.

File metadata

  • Download URL: ptsrvtester-1.0.5.tar.gz
  • Upload date:
  • Size: 111.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.11

File hashes

Hashes for ptsrvtester-1.0.5.tar.gz
Algorithm Hash digest
SHA256 37e1d58564b1fcc609db6d9c7531f5b5baaabaa69a8f4f13a739a39345598467
MD5 f1b51534e6f91e69abbf5be8e05c4e01
BLAKE2b-256 8b1e661154096e3706d23b787595f5f06c8713cf99766f2d9a6f2e8ce9726779

See more details on using hashes here.

File details

Details for the file ptsrvtester-1.0.5-py3-none-any.whl.

File metadata

  • Download URL: ptsrvtester-1.0.5-py3-none-any.whl
  • Upload date:
  • Size: 121.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.11

File hashes

Hashes for ptsrvtester-1.0.5-py3-none-any.whl
Algorithm Hash digest
SHA256 9c5b75542525ae8d7c717278c948f94cbe858f995f0f765a4df5a45637fc21e4
MD5 93747712770866b4773346cee4976166
BLAKE2b-256 cb13f4d51a3bb5dc69537563106cc15f6b7261d729f822556e3e5a07bc9e6729

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