dev-mitm-proxy

Develop and maintain Capsem's MITM proxy for TLS traffic inspection.

68|10|Updated Sep 26, 2025
One-click install
npx skills add https://github.com/google/capsem --skill dev-mitm-proxy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dev-mitm-proxy
Source: https://github.com/google/capsem/tree/main/skills/dev-mitm-proxy
Command: npx skills add https://github.com/google/capsem --skill dev-mitm-proxy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill consolidates development, debugging, and testing of Capsem's air-gapped MITM proxy, which intercepts TLS traffic, applies policy, and records per-session telemetry.

Core Features & Use Cases

  • Pipeline orchestration for TLS termination, HTTP inspection, domain policy checks, and telemetry capture.
  • Per-domain certificate minting and CA management, with on-demand cert generation and caching.
  • Content-encoding handling and SSE parsing to ensure reliable telemetry even on compressed streams.
  • Use Case: Debug TLS termination or policy logic inside the Capsem environment, simulate guest VM traffic, and validate end-to-end flow.

Quick Start

Load the Capsem in-VM development environment and run the MITM proxy diagnostics to validate TLS termination, policy checks, and telemetry capture.

Frequently Asked Questions about dev-mitm-proxy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I intercept and inspect TLS-enabled traffic in an air-gapped environment?

It intercepts TLS traffic through a MITM proxy pipeline that performs TLS termination, HTTP inspection, and telemetry recording. The proxy handles per-domain certificate minting and content-encoding decompression to capture reliable per-session data.

How do I handle SSE parsing and content decompression for HTTP inspection?

For HTTP inspection, the proxy pipeline handles content-encoding decompression and Server-Sent Events (SSE) parsing. This ensures reliable telemetry recording even on compressed streams passing through the TLS termination proxy.

Can I use this MITM proxy to debug network issues and simulate guest VM traffic?

Yes, you can debug network issues and simulate guest VM traffic by loading the in-VM development environment and running MITM proxy diagnostics. This validates TLS termination, domain policy enforcement, and end-to-end telemetry capture.

What's the best way to manage CA certificates and mint per-domain certificates for a proxy?

The best way to manage certificates for a proxy is using on-demand per-domain certificate minting with caching. The pipeline handles CA management automatically, generating certificates as needed for TLS termination.

Why does TLS termination fail when domain policy checks block my proxy traffic?

TLS termination and domain policy enforcement operate within a pipeline that routes traffic based on policy rules. If policy checks block traffic, the proxy enforces these routing constraints before completing the TLS handshake and HTTP inspection.