# AuthRecon Suite

> Works out how a web app's login works and hands back a verified Selenium .side login script for Tenable WAS scans.

- Type: Agent
- Author: AuthRecon
- License: Apache-2.0
- Trust tier: contributed (passed automated validation and a baseline maintainer review)
- Last reviewed: 2026-11-03
- Source repository: https://github.com/AuthRecon/AuthRecon
- Repo state: not archived
- Last push: 2026-11-13T23:16:29Z
- Stars: 0 (a popularity signal, not a safety signal)
- Forks: 0 (a popularity signal, not a safety signal)
- Open issues: 0
- Language: Python
- Health checked at: 2026-11-20T22:23:17.212Z
- Integrations: Tenable
- Domains: application-security
- Tags: tenable-was, authenticated-scanning, dast, selenium, login-automation, self-hosted, mcp
- Date added: 2026-10-26
- Listing page: https://exchange.tenable.com/agents/authrecon-suite
- Source file: https://github.com/tenable/cyberagents-exchange/blob/main/agents/authrecon-suite.md

AuthRecon is a self-hosted Docker stack for the hardest part of authenticated web app scanning: getting the scanner logged in. Give it a login URL and a test account. It works out what kind of login the app uses, logs in the way a scanner would, and hands back a verified Selenium `.side` script plus the exact values to paste into a Tenable Web App Scanning (WAS) scan's Selenium authentication settings. Everything runs locally with no cloud services.

## What it does

- **Detects the login type and automates it:** form logins (including JavaScript-rendered pages), two-step username-then-password, HTTP Basic, and dedicated handlers for Azure AD, Okta, SAML/ADFS, LDAP-style forms and OAuth/OIDC redirects. Kerberos/NTLM and Digest are detected and explained rather than scripted.
- **Tenable WAS setup card:** after a successful run you get the login page, page to verify, regex pattern to verify and a downloadable `.side` file.
- **One-click Verify:** replays the `.side` script in a clean browser the same way WAS does, so you know it works before the scan starts.
- **Scan readiness:** grades how well the login will hold up in a scan (cookie-only session survival, session lifetime, WAF and rate limits) and suggests starting settings such as URLs to exclude and the session cookie.
- **Scan Analyzer (preview):** upload a WAS scan's debug zip or JSON export after a failed or thin scan to see what went wrong (logged out, timeouts, WAF, skipped URLs) and which settings to change. Rule-based, no AI required.
- **Troubleshooting artifacts:** a timeline, step-by-step screenshots, HAR capture, and cookie and security-header findings for logins that won't automate. There's also multi-role runs and manual recording through a live noVNC browser for flows you have to drive by hand.
- **Exports:** HAR, curl, Postman, Burp and ZAP from the captured session.
- **Optional AI via MCP:** connect your own MCP client (for example Claude Code or Claude Desktop) with a per-user API key to launch runs from stored credentials, read timelines, fetch WAS settings, trigger Verify and suggest selectors for stuck form logins. The client never receives passwords or `.side` contents, and an admin has to turn MCP on.
- **LoginLab:** optional built-in practice targets covering each supported login style. Off by default and bound to loopback.

## How it works

A React UI talks to a FastAPI portal that handles sign-in (with optional TOTP MFA and HttpOnly session cookies) and per-user checks. The AuthRecon API queues each run on Redis, and a worker drives a real Chromium with Playwright or Selenium against the target. It records the timeline, screenshots, HAR and `.side` script, encrypted at rest in PostgreSQL and an artifacts volume. Stored credentials are bound to the domains they may be used on, so the worker never types a password on an unexpected site. Targets are checked so a run can't reach cloud metadata or AuthRecon's own services. With browser isolation turned on, the browsers run in a separate container with no secrets and no database access.

Install with `git clone` and `./install.sh`, which generates unique secrets, builds the stack and checks its health. It runs on Linux and on macOS with Docker Desktop, and supports corporate TLS inspection and private package mirrors. Intended for authorized testing only.

This is the Markdown version of one of 148 listings on CyberAgents Exchange. The same listing as JSON: https://exchange.tenable.com/api/agents/authrecon-suite.json. The full index and how to read it: https://exchange.tenable.com/llms.txt
