explaingit

ridter/relayx

Analysis updated 2026-08-04 · repo last pushed 2025-06-26

195PythonAudience · ops devopsComplexity · 4/5StaleSetup · hard

TLDR

Relayx is a Python-based security testing tool that automates NTLM relay attacks against Windows corporate networks, bundling multiple attack paths for privilege escalation during authorized penetration tests.

Mindmap

mindmap
  root((relayx))
    What it does
      Automates NTLM relay attacks
      Captures Windows auth traffic
      Bundles multiple attack paths
    Attack methods
      Printer bug trigger
      PetitPotam trigger
      Shadow credentials
      Fraudulent certificates
    Tech stack
      Python
      Impacket library
      Windows network protocols
    Use cases
      Exchange server attacks
      Interactive shell access
      Domain-wide privilege escalation
    Audience
      Penetration testers
      Red team operators
      Security professionals

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Escalate from a single user account to domain-wide control during an authorized penetration test.

USE CASE 2

Relay authentication to an Exchange server and extract password hashes from the domain controller.

USE CASE 3

Gain an interactive shell on a target server using resource-based constrained delegation.

USE CASE 4

Request fraudulent certificates from Active Directory Certificate Services to pivot access.

What is it built with?

PythonImpacket

How does it compare?

ridter/relayxrougier/braincraftcvlab-kaist/gld
Stars195195196
LanguagePythonPythonPython
Last pushed2025-06-262026-03-04
MaintenanceStaleMaintained
Setup difficultyhardhardhard
Complexity4/54/55/5
Audienceops devopsresearcherresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires Python with Impacket, a foothold in a Windows Active Directory network, and specific Windows vulnerabilities or server versions depending on the chosen attack path.

No license information is provided in the repository documentation.

In plain English

Relayx is a security testing tool designed for penetration testers working inside Windows corporate networks (Active Directory environments). It automates a technique called "NTLM relay," which is a way to intercept authentication traffic between Windows machines and redirect it to gain elevated access. The tool bundles several relay-based attacks into one package so testers can move faster during an engagement without juggling multiple separate tools. At a high level, the tool works by tricking a Windows machine into authenticating against the tester's machine instead of (or in addition to) a legitimate server. It can trigger this authentication automatically using known Windows bugs like the "printer bug" or PetitPotam. Once the authentication is captured and relayed, the tool pivots into one of several attack paths depending on what the target is. For example, if the target is an Exchange server, it leverages Exchange's default permissions to grant the tester the ability to extract password hashes from the domain controller. If the target is a regular server, it sets up a technique called resource-based constrained delegation to give the tester an interactive shell on that machine. The primary audience is security professionals conducting authorized penetration tests or red team engagements against Windows domains. Someone might use this when they already have a foothold inside a corporate network and want to escalate their privileges, for instance, turning access to one regular user account into domain-wide control. The tool also supports attacking Active Directory Certificate Services (AD CS) by requesting fraudulent certificates, and a method called "shadow credentials" that works on Windows Server 2016 and newer. The project is built in Python and relies heavily on the Impacket library, which is a standard toolkit for working with Windows network protocols. The README notes that one of the attack paths requires a specific vulnerability (CVE-2019-1040) to be present, and certain methods only work on newer Windows Server versions. The developer states the tool is intended for learning and should not be used illegally.

Copy-paste prompts

Prompt 1
I'm setting up relayx for an authorized penetration test in an Active Directory environment. Walk me through the prerequisites and how to configure it with Impacket to perform an NTLM relay attack against an Exchange server.
Prompt 2
Help me understand the different attack paths relayx supports (Exchange, RBCD, AD CS, shadow credentials) and how to choose the right one based on what I've discovered during recon in a Windows domain.
Prompt 3
I have relayx running and captured NTLM authentication from a target using the printer bug. How do I pivot this into resource-based constrained delegation to get an interactive shell on the target server?
Prompt 4
Explain how relayx uses PetitPotam to trigger authentication and how I can chain that with an AD CS attack to request fraudulent certificates for privilege escalation.
Prompt 5
I'm hitting issues with relayx where the relay fails on a target. What are common reasons relay attacks fail, and how do CVE-2019-1040 requirements and Windows Server version restrictions affect which attack paths are available?

Frequently asked questions

What is relayx?

Relayx is a Python-based security testing tool that automates NTLM relay attacks against Windows corporate networks, bundling multiple attack paths for privilege escalation during authorized penetration tests.

What language is relayx written in?

Mainly Python. The stack also includes Python, Impacket.

Is relayx actively maintained?

Stale — no commits in 1-2 years (last push 2025-06-26).

What license does relayx use?

No license information is provided in the repository documentation.

How hard is relayx to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is relayx for?

Mainly ops devops.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.