ai-tools/private-proxy-mcp
Watch
2
0
Fork
You've already forked private-proxy-mcp
 0
Code Issues 2 Pull requests 1 Projects Releases 5 Packages 2 Wiki Activity Actions

Reverse-Connector-Listener mit Shared-Key-Upgrade auf Port 9335 implementieren #5

New issue
Closed
opened 2026-07-17 09:05:49 +02:00 by frank · 2 comments
frank commented 2026-07-17 09:05:49 +02:00
Owner
Copy link

Teil von #1. Blockiert durch die Protokollspezifikation.

Ziel

Der MCP-Server akzeptiert auf Port 9335 authentisierte HTTP/1.1-Upgrade-Verbindungen privater Proxies.

Scope

  • Separater net/http-Listener, Default 0.0.0.0:9335.
  • Nur die definierte Connector-Route und HTTP/1.1 Upgrade akzeptieren.
  • Shared Key in einem Authorization-Schema oder eindeutig benannten Header übertragen; nicht in URL oder Query.
  • Vergleich mit crypto/subtle in konstanter Zeit.
  • Fehlende oder falsche Authentisierung vor dem Upgrade ablehnen.
  • Erfolgreich mit 101 Switching Protocols und exakt ausgehandeltem Upgrade-Token wechseln.
  • Handshake-Timeout, Headergrößenlimit und maximale gleichzeitige Handshakes konfigurieren.
  • Shared Key aus Secret-Datei oder Environment laden; niemals loggen.
  • Optional mehrere Keys mit stabiler key_id unterstützen, um Rotation ohne Downtime vorzubereiten.
  • Rate-Limit beziehungsweise Backoff für fehlgeschlagene Authentisierungen.
  • TLS-Konfiguration ermöglichen und Klartextbetrieb außerhalb Loopback deutlich warnen.

Akzeptanzkriterien

  • Default-Port ist 9335.
  • Nur HTTP/1.1 mit korrektem Connection-/Upgrade-Header und gültigem Shared Key erhält 101.
  • Fehlerfälle liefern 400, 401, 405 oder 426 ohne Secret-Leak.
  • Unit-/Integrationstests prüfen gültigen Handshake, falschen Key, falsche Version, HTTP/2-Versuch, Timeout und Rotation.
  • Authentisierungsfehler werden sicher und rate-limited geloggt.

Referenzen

Teil von #1. Blockiert durch die Protokollspezifikation. ## Ziel Der MCP-Server akzeptiert auf Port 9335 authentisierte HTTP/1.1-Upgrade-Verbindungen privater Proxies. ## Scope - Separater net/http-Listener, Default 0.0.0.0:9335. - Nur die definierte Connector-Route und HTTP/1.1 Upgrade akzeptieren. - Shared Key in einem Authorization-Schema oder eindeutig benannten Header übertragen; nicht in URL oder Query. - Vergleich mit crypto/subtle in konstanter Zeit. - Fehlende oder falsche Authentisierung vor dem Upgrade ablehnen. - Erfolgreich mit 101 Switching Protocols und exakt ausgehandeltem Upgrade-Token wechseln. - Handshake-Timeout, Headergrößenlimit und maximale gleichzeitige Handshakes konfigurieren. - Shared Key aus Secret-Datei oder Environment laden; niemals loggen. - Optional mehrere Keys mit stabiler key_id unterstützen, um Rotation ohne Downtime vorzubereiten. - Rate-Limit beziehungsweise Backoff für fehlgeschlagene Authentisierungen. - TLS-Konfiguration ermöglichen und Klartextbetrieb außerhalb Loopback deutlich warnen. ## Akzeptanzkriterien - Default-Port ist 9335. - Nur HTTP/1.1 mit korrektem Connection-/Upgrade-Header und gültigem Shared Key erhält 101. - Fehlerfälle liefern 400, 401, 405 oder 426 ohne Secret-Leak. - Unit-/Integrationstests prüfen gültigen Handshake, falschen Key, falsche Version, HTTP/2-Versuch, Timeout und Rotation. - Authentisierungsfehler werden sicher und rate-limited geloggt. ## Referenzen - RFC 9110 Upgrade: https://www.rfc-editor.org/rfc/rfc9110.html#name-upgrade - Go crypto/subtle: https://pkg.go.dev/crypto/subtle - Go net/http: https://pkg.go.dev/net/http
frank commented 2026-07-17 10:40:58 +02:00
Author
Owner
Copy link

🤖 forge agent started

  • Agent: codex
  • Model: gpt-5.6-sol
  • Mode: pr
  • Trigger: assignee=agent|+5 mapped

Reverse-Connector-Listener mit Shared-Key-Upgrade auf Port 9335 implementieren — Teil von #1. Blockiert durch die Protokollspezifikation.

🤖 **forge agent started** - Agent: `codex` - Model: `gpt-5.6-sol` - Mode: `pr` - Trigger: `assignee=agent|+5 mapped` Reverse-Connector-Listener mit Shared-Key-Upgrade auf Port 9335 implementieren — Teil von #1. Blockiert durch die Protokollspezifikation.
frank commented 2026-07-17 10:42:02 +02:00
Author
Owner
Copy link

❌ forge agent failed

agent branch has no commits ahead of main (empty PR); dirty work must be committed before finish
❌ **forge agent failed** ``` agent branch has no commits ahead of main (empty PR); dirty work must be committed before finish ```
frank closed this issue 2026-07-17 11:58:08 +02:00
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
agent/issue-39-websuche-capability-web-search-über-duc
agent/issue-14-architektur-konfiguration-und-betrieb-im
agent/issue-13-teststrategie-und-forgejo-actions-ci-auf
agent/issue-22-yt-dlp-medien-und-youtube-transcript-too
v1.2.0
v1.1.2
v1.1.1
v1.1.0
v1.0.0
Labels
Clear labels   
agent:done
Managed by forge agent

  
agent:ready
Managed by forge agent

  
agent:working
Managed by forge agent

  
area/browser
Browser-Automation und Browser-Sessions

  
area/cli
CLI und Konfiguration

  
area/http
HTTP-Request-Ausführung und Antwortverarbeitung

  
area/mcp
Model Context Protocol und MCP-Endpunkt

  
area/media
Medien-Downloads und Transkripte

  
area/observability
Logging und Health und Lifecycle

  
area/proxy
Private-Proxy-Prozess und Verbindung

  
area/security
Authentisierung und Sicherheitsrichtlinien

  
area/testing
Tests und Fuzzing und CI

  
area/tunnel
Reverse Connector und Tunnelprotokoll

  
priority/P0
MVP-kritisch oder blockiert den Kernpfad

  
priority/P1
Wichtig für ein belastbares MVP

  
priority/P2
Nachgelagertes Folgefeature

  
type/chore
Engineering und Wartungsaufgabe

  
type/design
Architektur- oder Protokollentscheidung vor Implementierung

  
type/docs
Dokumentation und Wiki

  
type/epic
Übergeordnetes Sammel- oder Lieferumfangs-Issue

  
type/feature
Neue oder erweiterte Produktfunktion

No labels
agent:done
agent:ready
agent:working
area/browser
area/cli
area/http
area/mcp
area/media
area/observability
area/proxy
area/security
area/testing
area/tunnel
priority/P0
priority/P1
priority/P2
type/chore
type/design
type/docs
type/epic
type/feature
Milestone
Clear milestone
No items
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
codex
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Blocks
#1 MVP: Private Proxy MCP – Basisfunktionen und Lieferumfang
ai-tools/private-proxy-mcp
#6 Tunnel-Framing, Multiplexing und Request-Lifecycle implementieren
ai-tools/private-proxy-mcp
Depends on
#2 Go-Projekt und Cobra/Viper-CLI grundlegend aufsetzen
ai-tools/private-proxy-mcp
#3 Connector- und Tunnelprotokoll v1 spezifizieren
ai-tools/private-proxy-mcp
Reference
ai-tools/private-proxy-mcp#5
No description provided.