Prox-Ez: Das Schweizer Taschenmesser der HTTP-Authentifizierung

Dieser HTTP-Proxy übernimmt alle HTTP-Authentifizierungen für Sie.

Er unterstützt NTLM EPA (Channel Binding und Service Binding), Kerberos, Pass-the-Hash, Overpass-the-Hash (Pass-the-Key) und Pass-the-Ticket (TGT und TGS).

Verwandte Artikel:

Installation

Installiere die Abhängigkeiten

$ # In a venv
$ python3 -m venv venv
$ source venv/bin/activate
$ python3 -m pip install -r requirements.txt

Oder du kannst pip/pipx verwenden, um das Projekt direkt zu installieren

$ # With pip
$ pip3 install git+https://github.com/synacktiv/Prox-Ez

$ # With pipx
$ pipx install git+https://github.com/synacktiv/Prox-Ez

Viel Spaß.

Verwendung

Schnellstart

Führe es einfach so aus, es versucht, sich mit den Anmeldedaten mydomain/myusername:mypassword auf jeder Website zu authentifizieren, die eine Authentifizierung erfordert:

python3 proxy.py -dc mydomain/myusername:mypassword

Dasselbe, aber mit NT-Hash anstelle des Passworts:

python3 proxy.py -dc mydomain/myusername --hashes :31d6cfe0d16ae931b73c59d7e0c089c0

Mit BurpSuite

Damit es mit BurpSuite funktioniert:

Deaktiviere die HTTP/2-Unterstützung: Project options -> HTTP -> HTTP/2 -> deaktiviere Enable HTTP/2
Deaktiviere Set response header "Connection: close", da NTLM eine TCP-Verbindung authentifiziert: Proxy -> Options -> Miscellaneous -> deaktiviere Set response header "Connection: close".
Deaktiviere Set "Connection" header on incoming requests when using HTTP/1: Proxy -> Options -> Miscellaneous -> deaktiviere Set "Connection" header on incoming requests when using HTTP/1

Danach musst du nur noch einen Upstream-Proxy in Burp angeben, damit dieser Proxy für den Host verwendet wird, bei dem du dich nicht authentifizieren kannst:

In Project options -> Connections -> Upstream Proxy Servers -> klicke auf Add -> gib den Remote-Hostnamen an, der Probleme mit der NTLM-Authentifizierung verursacht, sowie den im Tool konfigurierten Proxy-Host und -Port, und lasse den Authentication type auf None.
Möglicherweise musst du auch den SOCKS-Proxy deaktivieren, falls er aktiviert ist.

Hilfe

$ python3 proxy.py -h
usage: proxy.py [-h] [--listen-address LISTEN_ADDRESS] [--listen-port LISTEN_PORT] [--cacert CACERT] [--cakey CAKEY] [--cakey-pass CAKEY_PASS] [--certsdir CERTSDIR] [--singleprocess] [--debug] [--dump-keys DUMP_KEYS] [--creds CREDS]
                [--default-creds DEFAULT_CREDS] [--hashes HASHES] [--kerberos] [--dcip DCIP] [--spn SPN] [--spn-force-fqdn] [--no-epa]

Prox-Ez: The Swiss Army Knife of HTTP auth.

optional arguments:
  -h, --help            show this help message and exit
  --listen-address LISTEN_ADDRESS, -l LISTEN_ADDRESS
                        Address the proxy will be listening on, defaults to 127.0.0.1.
  --listen-port LISTEN_PORT, -p LISTEN_PORT
                        Port the proxy will be listening on, defaults to 3128.
  --cacert CACERT       Filepath to the CA certificate, defaults to ./cacert.pem. Will be created if it does not exists.
  --cakey CAKEY         Filepath to the CA private key, defaults to ./cakey.pem. Will be created if it does not exists.
  --cakey-pass CAKEY_PASS
                        CA private key passphrase.
  --certsdir CERTSDIR   Path to the directory the generated certificates will be stored in, defaults to /tmp/Prox-Ez. Will be created if it does not exists.
  --singleprocess, -sp  Do you want to be slowwwww ?! Actually useful during debug.
  --debug, -d           Increase debug output.
  --dump-keys DUMP_KEYS, -dk DUMP_KEYS
                        File to dump the SSL/TLS keys to. Useful when trying to debug. When this option is specified, --singleprocess is implied.
  --creds CREDS         Path to the credentials file, for instance: { "my.hostname.com": { "creds": "domain/user:password", "spn": "HTTP/anothername" }, "my.second.hostname.com": { "creds": "domain1/user1", "hashes": ":nthash1" } }
  --default-creds DEFAULT_CREDS, -dc DEFAULT_CREDS
                        Default credentials that will be used to authenticate.
  --hashes HASHES       Could be used instead of password. It is associated with the domain and username given via --default_creds. format: lmhash:nthash or :nthash.
  --kerberos, -k        Enable kerberos authentication instead of NTLM.
  --dcip DCIP           IP Address of the domain controller (only for kerberos).
  --spn SPN             Use the provided SPN when an SPN is needed. More details in the article.
  --spn-force-fqdn      Force the usage of the FQDN as the SPN instead of what was specified in the URL.
  --no-epa              Deactivate the NTLM EPA feature.

Bekannte Probleme

Keine Unterstützung für WebSocket. Es führt zu Assertion-Fehlern wie zum Beispiel:

DEBUG:Proxy.ProxyToServerHelper:Our state: MIGHT_SWITCH_PROTOCOL; their state: SEND_RESPONSE
[...]
    assert self.conn.our_state in [h11.DONE, h11.MUST_CLOSE, h11.CLOSED] and self.conn.their_state is h11.SEND_RESPONSE
AssertionError

Prox-Ez

Beliebteste