Scout Dokumentation Zur Anwendung
Schnittstellen / Betreiberprüfung

MCP, Originale und Artikeldeeplinks: Prüfstand

Stand: 22. Oktober 2026. Dies ist ein Arbeitsversionsnachweis, keine Produktionsfreischaltung und kein Nachweis einer realen externen Clientverbindung.

CHM-OAuth-Abnahme#

Störungsprüfung am 20. November 2026#

Status: Origin-Korrektur hinterlegt, Zugang noch nicht wiederhergestellt, externe Abnahme offen. Nach gesonderter Betreiberfreigabe wurde ausschließlich SCOUT_PUBLIC_ORIGIN im Deployment-Variablenbereich production auf https://hugoscout.chm.stg.sternwald.cloud gesetzt und zurückgelesen. Dieser Variablenbereich gehört hier zum STAGE-Launcher, nicht zu einer Kunden-PROD-App. Keine gemeinsamen Dienste gestartet oder neu geladen, keine Veröffentlichung und keine Änderung von Freigaben/Schlüsseln.

Der Betreiber hat diesen Vorbereitungs- und Konfigurationsstand am 20. November 2026 ausdrücklich zum Zusammenführen und Abschließen angenommen. Dieser Abschluss ist keine Bestätigung der Wiederherstellung am laufenden CHM-Host. Übernahme in laufende Worker und reale externe Clientabnahme bleiben gesonderte Betriebs- und Prüfschritte.

Öffentliche, nicht authentifizierte HTTPS-Proben am festen CHM-Host am 20. November 2026 um 07:46 UTC:

Pfad Tatsächliche Antwort
/.well-known/oauth-protected-resource 503, temporarily_unavailable
/.well-known/oauth-protected-resource/mcp 503, temporarily_unavailable
/.well-known/oauth-authorization-server 503, temporarily_unavailable
/mcp (GET ohne Credential) 401, WWW-Authenticate: Bearer ohne resource_metadata

Die Bereitstellungsmetadaten bestätigen eine öffentliche VM mit erfolgreichem Build und https://hugoscout.chm.stg.sternwald.cloud als primärem Host. Die lesende Betriebsuntersuchung fand am 20. November zwischen 07:36:36 und 07:40:28 UTC sieben SDK-Meldungen Invalid Host header für genau den CHM-Host; entsprechende Meldungen gab es schon vor dem jüngsten erfolgreichen Build. Damit ist die Hostablehnung auch in Betriebslogs belegt. Kein erneuter authentifizierter Live-Aufruf wurde in dieser Aufgabe ausgeführt.

Die anfängliche gefilterte Projektabfrage für SCOUT_PUBLIC_ORIGIN lieferte keinen hinterlegten Umgebungswert und keinen Secret-Eintrag. Das ist ein Konfigurationshinweis, kein Auslesen des laufenden Worker-Umfelds. Eine fehlende/ungültige Origin ist die stärkste Hypothese: Im aktuellen Code erklärt sie alle drei Discovery-Fehler, die verkürzte Challenge und die Hostablehnung ohne Datenbank- oder Loginanbieterzugriff. Der identische SDK-Fehler ist lokal mit fehlender Origin reproduziert.

Nicht verfügbar waren eine Shell im tatsächlichen Deployment, der Konfigurationszustand je Worker, ein unabhängiger Fingerabdruck des ausgelieferten App-Codes und rohe Proxy-/Backend-Hostwerte. Gemischte Workerstände und Proxyweitergabe sind deshalb nicht abschließend geprüft. Ein erfolgreicher Build allein belegt keinen aktuellen Code- oder Konfigurationsstand jedes Workers.

Vorbereitet ist die nebenwirkungsfreie Origin-Prüfung. Der Betreiber muss sie im tatsächlichen STAGE-Prozesskontext ausführen und die hinterlegte Konfiguration kontrolliert in die betroffenen Worker übernehmen. Eine gespeicherte Deployment-Einstellung allein ist kein Betriebsnachweis. Erneute öffentliche Proben um 07:51:57–07:51:58 UTC nach der Variablenkorrektur lieferten weiterhin dreimal Discovery 503 und eine 401-Challenge ohne resource_metadata. Eine Übernahme in die laufenden Prozesse ist damit nicht nachgewiesen; der Zugang bleibt gestört. Nach bestätigter Übernahme die unten aufgeführten externen Schritte durchführen.

Isolierte Prüfungen dieser Ergänzung (keine gemeinsame STAGE-App/DB):

  • python -m unittest discover -s tests -p test_mcp_config.py -v: drei erfolgreiche Prüfgruppen, darunter CLI ohne site-packages, Exitcodes, fehlender/ungültiger/falscher Zielwert und keine Ausgabe eingelesener Werte.
  • python -m unittest discover -s tests -p test_mcp_oauth.py -v: 30 erfolgreiche Prüfungen einschließlich echter SQL-/SDK-Verträge und synthetischer Chromium-Zustimmung. Neu abgesichert: Discovery ohne DB bei ungültiger Origin, keine Rettung durch Forwarded-Header, fehlende Origin mit authentifiziertem 421, korrekte Challenge sowie Host-/Port-/Transport-Origin-Ablehnungen einschließlich https://claude.ai. REST/stdio bleiben Key-only; bestehende eingeschränkte Schlüssel bleiben eingeschränkt.

Noch nicht nachgewiesen: Discovery 200 und vollständige Live-Challenge, autorisierte externe Initialisierung/Werkzeugliste/Recherche, geschützter Ergebnislink, echte Claude-Version und URL-only-OAuth mit Anbieterlogin, Browserzustimmung, Refresh und Widerruf. Kein autorisierter externer Client und keine interaktive Claude-Sitzung wurden verwendet. Es liegt hier kein bestätigter Nachweis einer Schlüsseloffenlegung vor; bei Bestätigung kontrollierte Rotation durch den Betreiber veranlassen, ohne den alten Schlüssel erneut anzufordern, zu speichern oder eigenmächtig zu widerrufen.

Ergänzung vom 19. November 2026. Der Code enthält nun einen eigenen MCP-OAuth-Authorization-Server mit PKCE S256, Zustimmung, kontogebundener Dienstfreigabe und rotierenden Refresh-Tokens. Eine MAD-/V6.0.a-Quelle war im Workspace und verfügbaren Git-Verlauf nicht zugänglich; es wurde keine Übernahme eines solchen Servers behauptet. Vorhandene ausgehende Archiv-OAuth- Komponenten sind kein eingehender Authorization-Server und bleiben unverändert.

Lokale Nachweise#

python -m unittest discover -s tests -p test_mcp_oauth.py -v startet nur eine wegwerfbare PostgreSQL-Instanz mit privatem Unix-Socket und isolierte Flask- Testanwendungen. Keine Remote-DB-Umgebungsvariable wird verwendet, kein Import des Dashboards, keine STAGE-DDL und kein Scout-/Import-Workflow-Start. Fehlende lokale PostgreSQL-Binaries lassen die Prüfung explizit fehlschlagen; es gibt keinen Rückfall auf eine andere oder gemeinsame Datenbank.

Abgedeckt sind die exakten Discovery-Verträge, andere/fehlende Origin, öffentliche Registrierung und deren Grenzen, exakte Callback-URI, Login- Rückkehr und Cookiebindung, Zustimmung/Ablehnung, CSRF/Kontowechsel, S256, Code-/Refresh-Replay einschließlich persistiertem Familienwiderruf, Code-/Token-/Freigabeablauf, parallele Austausche mit unabhängigen Datenbankverbindungen, Rollensperre/Kontolöschung, gespeicherte Gemeinde-/Datumsgrenzen, Widerruf über die bestehende Dienstverwaltung, erneute Rechteprüfung nach Arbeit und unveränderte Key-only-REST-/stdio-Policy. Der echte MCP-SDK wird mit CHM-Host, API-Key und OAuth für initialize, Werkzeugliste und Werkzeugaufruf geprüft; fremde Hosts/Ports liefern 421. Fehlende/ungültige Authentifizierung liefert die geforderte 401-Challenge; Limits und technische Fehler werden nicht als Loginfehler ausgegeben.

Zusätzliche Regressionen: test_scout_public.py, test_service_key_admin.py, test_public_docs.py, test_cognito_auth.py, test_clerk_auth.py und der Editor-Test client/src/utils/scoutNavigation.test.ts. Die Anbieterprüfungen verwenden die echten Cognito-/Clerk-Hooks mit isolierten Identitätsnachweisen. Sie belegen keinen echten Anbieter-Login. Die Zustimmungsseite wurde zusätzlich mit dem tatsächlichen Jinja-Template auf einem kurzlebigen, datenbanklosen Testserver bei 390 Pixeln geprüft; Kontobezeichnung, Berechtigungsbeschreibung und beide Entscheidungsschaltflächen sind sichtbar, die lange Ressourcenadresse bricht um. Das ist kein Nachweis der angemeldeten Oberfläche im echten CHM-Deployment. Ein zusätzlicher Chromium-Test sendet die tatsächlichen nativen Formulare für Zustimmung und Ablehnung ab und prüft die Navigation zum festen Claude-Callback ohne CSP-Verletzung. Die echten Flask-Routen, Cookie-/CSRF-Prüfungen und PostgreSQL-Freigaben werden verwendet; ausschließlich die Anbieteridentität ist synthetisch. Die Callback-Anfrage wird vor dem Netzwerk abgefangen, sodass kein Testcode und keine Daten an Claude gelangen. Geprüft sind auch die Callback-Freigabe in form-action und same-origin statt no-referrer für den Origin-Nachweis des Formular-POSTs. Diese Browserprüfung ist Bestandteil von test_mcp_oauth.py und benötigt Chromium sowie Node mit WebSocket-Unterstützung.

Der vollständige Editor-Lauf enthielt zusätzlich fünf bereits im Ausgangsstand veraltete Testannahmen: ungewollte ungefilterte Startsuche und frühere abgeschnittene Favoritentitel. Nur diese Testfixtures/-erwartungen wurden an das bereits implementierte Verhalten angepasst; Dashboard-/Workbench-Produktcode und CSS wurden dafür nicht geändert.

Offene externe Betreiberabnahme#

Nicht durchgeführt: Veröffentlichung, Anwendung der Migration auf CHM, echter CHM-Anbieterlogin, Claude-Connect mit sichtbaren Tools, erste freigegebene Recherche und Refresh mit einem von Claude gehaltenen Token. Es fehlen die gesonderte STAGE-Bereitstellungsfreigabe und der interaktive Betreiber-/Claude-Zugang. Lokale Vertragsprüfungen sind dafür kein Ersatz.

Nach Freigabe durch den Betreiber:

  1. Diesen Stand übernehmen; die bestehende Schema-Bootstrap-Ausführung erst im freigegebenen Startvorlauf gegen die richtige Scout-STAGE-Datenbank durchführen. Keine separate Datenbank, kein Providerwechsel, kein PROD-Start.
  2. SCOUT_PUBLIC_ORIGIN=https://hugoscout.chm.stg.sternwald.cloud und die vorhandene aktive Login-Konfiguration einschließlich exakter CHM-Origin, Anbieter-Callbacks und stabiler SESSION_SECRET prüfen. Konfiguration und Laufzeiten. Proxy-Zugriffslogs dürfen keine OAuth-Queries oder Credential-Header/-Bodies speichern.
  3. Alle drei Discovery-URLs am festen CHM-Host abrufen und gegen die hier spezifizierten JSON-Verträge vergleichen. Nicht authentifiziertes /mcp muss 401 mit der ressourcenspezifischen WWW-Authenticate-Challenge liefern. Mit einem separat freigegebenen API-Key initialize prüfen: 200, kein 421. Keine echten Zugangsdaten in Prüfdateien oder Chat übernehmen.
  4. In claude.ai nur https://hugoscout.chm.stg.sternwald.cloud/mcp als Custom-Connector-URL eintragen. Normalen Scout-Login abschließen, Kontobezeichnung prüfen und der eigenständigen Dienstfreigabe zustimmen. Vier Tools sichtbar bestätigen und zuerst list_municipalities, danach eine freigegebene Recherche und deren Originalbeleg abrufen.
  5. Nach mindestens 15 Minuten erneut recherchieren und die tatsächliche erfolgreiche Token-Erneuerung bestätigen. Die isolierten Tests belegen die Serverrotation; dieser Schritt muss zusätzlich das Clientverhalten belegen.
  6. Die entsprechende OAuth · Claude · Konto …-Freigabe in Verwaltung → API & MCP widerrufen: weitere Zugriffe und Erneuerung müssen scheitern, bestehende API-Keys aber weiter funktionieren.
  7. Datum, tatsächlich bereitgestellten Stand, Clientversion, HTTP-Status, sichtbare Toolnamen und Ergebnis der Erneuerung/Widerrufsprüfung notieren. Keine Codes, Token, Cookies, vollständigen Redirect-URLs oder Recherche- Inhalte ins Abnahmeprotokoll kopieren.

Ergänzende Prüfung der Anschlussanleitungen (28. Oktober 2026)#

  • python -m unittest discover -s tests -p test_public_docs.py -v: formatierte Überschriften/Absätze/Listen/Tabellen/Code, sichere Linkauflösung, inertes HTML und unverändertes maschinenlesbares OpenAPI.
  • node --test static/service_keys.test.mjs: Beispiele mit bestätigter Origin bzw. markiertem Domain-Platzhalter, getrennte Kopierfelder mit demselben Schlüssel, Kopier-Fallback, Bereinigung und Invalidierung verspäteter Antworten.
  • Bestehende Regressionen test_service_key_admin.py, test_scout_public.py, static/article-deeplink.test.mjs und editor-app/scripts/article-detail-shared-path.test.mjs erfolgreich.
  • scripts/verify-service-keys-browser.mjs prüft in Chromium die wirklich ausgelieferte Scout-Seite und den geladenen Skriptstand (Hash der Antwortbytes). Dienst- und Sitzungsantworten sind dabei isolierte synthetische Fixtures: keine reale Clerk-Anmeldung und keine echten Dienstschlüssel. Geprüft sind Kopieraktionen/Fallback, Navigation/Rechteverlust/Abmeldung, verspätete Anlage, bestätigte Origin/Platzhalter und 390 Pixel breite Ansichten. Die öffentlichen Dokumentationsseiten werden dagegen tatsächlich vom Server geladen; Formatierung, funktionierende Querverweise und schmale Ansichten sind geprüft.
  • Keine Veröffentlichung, keine Produktionskonfiguration, keine reale Claude-Verbindung und keine Zusage bestimmter Client-Versionen.

Gestaltungsprüfung der Dokumentation (28. Oktober 2026)#

REST-Anleitung, MCP-Schnellstart und diese Betreiberreferenz verwenden denselben Scout-Dokumentationsrahmen. Die Markdown-Dateien bleiben die einzige Inhaltsquelle; OpenAPI JSON und YAML bleiben unveränderte technische Downloads.

  • python -m unittest discover -s tests -p test_public_docs.py -v prüft zusätzlich aktive Seitennavigation, Inhaltsverzeichnisse aus allen Abschnittsüberschriften, eindeutige deutsche/mehrfache/formatierte Abschnittsanker, Direktziele, Tastaturziele und die weiterhin sichere Markdown-Verarbeitung.
  • scripts/verify-public-docs-browser.mjs BASE_URL PLAYWRIGHT_MODULE CHROMIUM prüft in Chromium alle drei HTTP-Seiten bei 1440, 390 und 320 Pixeln: tatsächliche HTML-Antworten mit aktuellem CSS, Inhaltsverzeichnis und Querverweise, Skip-Link, sichtbaren Tastaturfokus, native auf-/zuklappbare Navigation, Abschnittssprung samt Neuladen, lokale Code-/Tabellenüberläufe und maschinenlesbare Downloads. Screenshots und sichere Prüfzusammenfassung: /tmp/scout-public-docs/.
  • Dieser neue Browserlauf verwendete die echten Flask-Routen des gemeinsamen Public-Blueprints in einem isolierten HTTP-Testserver ohne Datenanbindung, keine HTML-Kopien und keine abgefangenen Dokumentationsantworten. Die Links der Dienstverwaltung wurden anhand des ausgelieferten Templates zugeordnet, nicht in einer real angemeldeten Verwaltungsansicht angeklickt.
  • Die vollständige lokale Scout-Vorschau war zunächst erreichbar und lieferte bereits vor der Gestaltung HTML statt rohem Markdown. Die gemeldete Rohtextausgabe ist damit lokal nicht reproduziert; ein veralteter fremder Serverstand ist dadurch nicht nachgewiesen. Nach den Änderungen blockierte der normale App-Start bei Datenbank-Startarbeit; auch der vorhandene Modus zum Überspringen bereits erledigter Startarbeit stellte die vollständige Vorschau nicht wieder her. Der ursprüngliche Workflow wurde wiederhergestellt. Eine erneute Prüfung am vollständigen Scout-Server steht deshalb noch aus.
  • Keine Änderung an Anmeldung, Dienstfreigaben, technischen Beispielen oder Produktionskonfiguration; keine Veröffentlichung und keine externe MCP-Abnahme.

Aktueller Anmeldestand#

Die bestehende Scout-Browseranmeldung verwendet den konfigurierten Anbieter Cognito oder Clerk. Dienstzugänge bleiben davon unabhängig: separate API-Keys und zusätzliche MCP-OAuth-Freigaben nach expliziter Zustimmung, keine automatische Umstellung von Sitzungscookies auf Diensttoken. Frühere Aussagen „kein OAuth“ beschreiben nur den damaligen Stand. Dieses Dokument belegt weder eine Entra-Abnahme noch einen Produktions-Cutover.

Anwender beginnen mit dem MCP-Schnellstart oder der REST-Anleitung. Die folgenden Prüfdetails richten sich an Betreiber.

Durchgeführt#

Gemeinsamer Backend-, Sicherheits- und Transportvertrag#

Ausführbar ohne zusätzliche Testabhängigkeit:

python -m unittest discover -s tests -p test_scout_public.py -v

21 Prüfgruppen mit Unterfällen, erfolgreich:

  • Eingaben, Boolean-/String-/Float-IDs, Wertebereiche, Datum/Datumsreihenfolge, unbekannte Felder/Parameter und sichere Suchpaginierung.
  • Authentifizierung vor Recherche/Original/Antwort/Verzeichnis, Trennung von Browsercookie und Dienstschlüssel, Gemeinde-/Datumsscope, unbekannte/ungültige Veröffentlichungsdaten, entfernte Artikel, Widerruf und Widerruf während Arbeit.
  • Exakte/eindeutige Teilnamen nur im freigegebenen Verzeichnis, keine breite Ersatzsuche bei unbekannten/mehrdeutigen Namen.
  • Hybride deduplizierte Kandidaten, beide ID-Komponenten, Seitenzahl/has_more, Ausfallhinweise, Projektion nur strukturiert, weiterhin lesbare Quellen.
  • Origin-/Hostunabhängigkeit, sichere HTTP(S)-Quellen, konservative Queryregeln, Markdown-/HTML-Metadaten, keine zusätzliche technische ID-Liste.
  • Gespeicherte Originale statt KI-Zusammenfassung, unabhängige Text- und Anhangfortsetzung (105 Referenzen), Unicode-Zeichenoffsets.
  • An Artikel gebundene Selektoren, fremde Selektoren, lokale Pfade, Datei-/Verzeichnissymlinks, FIFO, Dateigröße und fehlende Dateien.
  • Tatsächliche PDF-Extraktion aus synthetischer zweitseitiger PDF, Fortsetzung innerhalb einer Seite/zur nächsten Seite, echte textlose Seite, Seiten-/ Offsetfehler, fehlerhafte PDF, Parser-Zeitlimitsteuerung und parallele Belegung.
  • Legacy-Text ohne Seitenprovenienz, Dateilesefehler und sichere Inhaltsstatus.
  • Per-Schlüssel-/Worker- und Authentifizierungsbudgets, Worker-Auslastung, strenge stdio-Schlüsseldateiberechtigungen, Betreiberanlage/Widerruf ohne Klartextschlüssel in DB oder Terminalausgabe.
  • OpenAPI in JSON/YAML und Erfolgs-Ausgabeschemas; Veröffentlichung von Schemas und Dokumentation ohne Artikeldaten.
  • Browserrouten und Login-Decorator als extrahierte echte Flask-Funktionen: kein Artikeldatenabruf bei ungültigen IDs oder fehlender Browsersitzung. Auch Listen, Suchdelegation und Suchanreicherung verlangen eine Browsersitzung; ein externer Dienstschlüssel ersetzt diese nicht. Editorinterne Quellensuche/-details verwenden stattdessen ausschließlich die bestehenden geteilten Dienst-Token an getrennten internen Routen und begründen keine Browsersitzung.
  • ECHTE SDK-Clientverbindungen über HTTP→WSGI→ASGI und einen stdio-Unterprozess: Initialisierung, Toolmetadaten und alle vier Werkzeuge mit gleichem Text, structuredContent und isError. Widerruf sperrt nach früherer Initialisierung.

Die Daten sind synthetische Testfixtures. Providerantworten und Such-Embeddings sind kontrolliert ersetzt; kein realer kostenpflichtiger KI-Aufruf und keine reale Dienstfreigabe wurden für diesen Nachweis benötigt. Das Timeout wird durch den killbaren subprocess.run(timeout=10)-Pfad und den automatisierten Timeoutfall geprüft, nicht durch eine absichtlich zehn Sekunden lang schädliche PDF im Produktionsbestand.

UI-Komponenten und bestehender Detailpfad#

node --test static/article-deeplink.test.mjs \
  editor-app/scripts/article-detail-shared-path.test.mjs

16 Prüfungen erfolgreich: Direktzielparser, Loginbootstrap/erneuter Login, Direkt-/Listenmodus, deaktivierte Navigation und editierbare Eingaben, Schließen/Logout bei ausstehenden Requests einschließlich noch nicht beantwortetem Logout, Cacheinvalidierung, Lade-/Nicht-verfügbar-/Fehlertexte, Dialogname, Fokusbindung/-rückgabe, oberster Escape-Dialog (auch bei gleicher Ebene), Dokumentdialoge ohne bestehende Rollen, Bereinigung gestapelter Dokumentansichten bei Abmeldung und kompakte CSS-Regeln.

Diese Prüfungen verwenden jsdom/VM und Produktionsfunktionen. Sie ersetzen KEINE tatsächliche visuelle 320-Pixel-/200%-Zoom-Prüfung im Browser. node --check static/app.js, Python-Kompilierung und git diff --check wurden ebenfalls durchgeführt.

Regressionen#

  • Der konfigurierte Workflow editor-tests lief erfolgreich: 355 Tests. Die ergänzte Token-Fail-Closed-Prüfung erweitert diesen Bestand um einen Test.
  • 68 vorhandene Prüfungen aus test_public_api_auth, test_auth_bruteforce, test_rag_pipeline, test_resource_limits, test_pool_wait und test_media_restore wurden mit einem flüchtigen In-Memory-pytest-Kompatibilitätsadapter ausgeführt und bestanden. Keine zusätzliche pytest-Abhängigkeit und kein Adapter im Projekt. Der bestehende Fallbacktest wurde ohne reale Providerzugänge isoliert.
  • 15 dashboardabhängige Medienflussprüfungen wurden in der zunächst blockierten Prüfphase ausdrücklich NICHT ausgeführt und nach Wiederherstellung des Tunnels nicht als bestanden ausgegeben. Datenbankabhängige test_storage-Integrationstests wurden nicht als bestanden ausgegeben. Es erfolgte kein Wechsel auf eine Ersatzdatenbank.

Ergänzende Live-Prüfung nach wiederhergestelltem Tunnel#

Der zunächst blockierende Stage-Tailscale-Zugang wurde am 22. Oktober 2026 vom Betreiber wiederhergestellt. Die App ist erreichbar; der vorherige Verbindungsfehler ist kein aktueller Abnahmeblocker mehr. Zugangsdaten, Datenbankziel und Cutover-Gates wurden für diese Aufgabe nicht verändert.

Am laufenden Stage-System wurden bereits nachgewiesen:

  • Idempotente Anlage der Dienstfreigaben-Tabelle durch den regulären App-Start.
  • Betreiberanlage einer kurzlebigen Testfreigabe für genau eine Gemeinde und einen Veröffentlichungstag; private Schlüsseldatei außerhalb des Projekts.
  • Verzeichnis auf genau diese Gemeinde begrenzt, Originalabruf entspricht gespeichertem Lead/Absätzen, fremde Gemeinde und falscher Tag liefern 404.
  • Tatsächlicher Rechercheaufruf liefert einen Treffer im erlaubten Umfang. Die semantische Suche meldet derzeit einen Verbindungsfehler des bestehenden Embedding-Providers; Stichwortergebnisse bleiben mit Hinweis verfügbar.
  • Die Live-Prüfung fand eine Unverträglichkeit roher JSON-Medienfelder mit dem gemeinsamen RAG-Renderer. Der Dienst übergibt jetzt pro Quelle höchstens 12.000 Zeichen gespeicherten Originaltext, echte Gemeindenamen und nummerierte Referenzen. Bei Kürzung wird dies im Modellkontext ausdrücklich markiert. Keine KI-Zusammenfassungen, Bilddeutungen oder Legacy-PDF-Texte werden als Originalkontext übernommen. Der konfigurierte Systemprompt bleibt erhalten. Der Regressionstest verwendet nun JSON-kodierte Medienfelder.
  • Nach der Korrektur und einem regulären Workflow-Neustart: tatsächliche HTTP-Antworterzeugung mit dem vorhandenen Modell/Provider und genau einer autorisierten, nummerierten Quelle liefert 200. Betreiberwiderruf sperrt den nächsten HTTP-Verzeichnisaufruf mit 403.
  • 50 vorhandene PDF-Pfade wurden über denselben sicheren Dateiresolver geprüft: alle 50 liegen zugreifbar innerhalb der zugehörigen Gemeindeverzeichnisse.

Alle dafür ausgegebenen Testschlüssel wurden auch bei einem fehlgeschlagenen Prüfschritt im Aufräumpfad widerrufen; Klartextschlüssel wurden nicht in Terminal, URLs, Logs oder Projektdateien ausgegeben.

Die erfolgreiche Aufnahme der geschützten Direktroute bei 320 CSS-Pixeln zeigt die vorhandene Loginmaske, keine Artikelinhalte. Die detaillierten interaktiven Browsernachweise werden separat unten erfasst.

Tatsächlich im Chromium-Browser geprüft#

Der Browser meldete sich über das sichtbare Formular mit der vorhandenen opt-in Development-Testkennung an; keine Sitzungsinjektion und keine Änderung an Anmeldung, Rollen oder Artikeldaten.

  • Frischer, abgemeldeter Browser am gültigen Direktlink zeigt nur Login; Detailabruf ohne Browsercookie liefert 401.
  • Eine Fehlanmeldung und danach richtige Anmeldung erhalten denselben internen Direktlink. Exakt der adressierte Artikel erscheint.
  • Reload, Schließen, Escape, Hintergrundklick und erneute Anmeldung am selben Link; Reload öffnet das adressierte Ziel erneut.
  • Direktmodus, deaktivierte Vor-/Zurück-Schaltflächen, keine Treffernavigation durch Pfeiltasten; Eingabefelder behalten ihre normale Bedienung.
  • Benannter Dialog, initialer Schließen-Fokus und Tab-Fokusbindung.
  • Nicht vorhandene numerische IDs zeigen die vereinbarten Nicht-verfügbar-Texte; ungültige IDs lösen keinen Detailrequest aus.
  • Simulierter 401-Detailabruf zeigt einen geschützten Fehler statt Inhalt.
  • Verzögerte Detailantworten nach Schließen und Abmeldung öffnen nichts erneut und befüllen den zuvor geleerten Zustand nicht wieder.
  • Tatsächlicher 320-CSS-Pixel-Viewport: Inhalt scrollbar, Schließen und Artikelaktionen erreichbar. Angemeldete Ansicht visuell geprüft.

Screenshot-Evidenz der Browserprüfung liegt temporär unter /tmp/scout-deeplink-e2e/direct-detail.png und /tmp/scout-deeplink-e2e/viewport-320css.png; keine Bilder mit Artikeldaten oder Browserzustände werden ins Repository übernommen.

In einer gezielten Ergänzungsprüfung wurden zwei echte, über die angemeldete Listen-API geladene Artikel in den vorhandenen Listenrenderer eingesetzt (kontrollierte Listeninitialisierung, keine erfundenen Artikel und keine Datenbankänderung). Die tatsächlichen Vor-/Zurück-Schaltflächen wechselten zwischen diesen IDs; Schließen gab den Fokus an die auslösende Listenzeile zurück. Im Direktmodus blieben Schaltflächen und Pfeiltastennavigation deaktiviert; der Fokus kehrte nach Schließen zum App-Hauptbereich zurück.

Der vorhandene Textviewer wurde mit einem ausdrücklich synthetischen, harmlosen, im Browser abgefangenen Dokumentinhalt geöffnet. Dialogname und Tab-Fokusbindung waren korrekt; Pfeiltasten bewegten nicht den darunter liegenden Artikel. Escape schloss nur den obersten Dokumentdialog. Dies ist ein echter Browsernachweis der Bedienung, kein Nachweis eines bestimmten gespeicherten PDF-Anhangs.

Auch tatsächlicher 200-%-Chromium-Browserzoom wurde verifiziert, nicht bloß Pinch-Zoom oder HiDPI emuliert: Eine ausschließlich temporäre Browsererweiterung setzte den Tab-Zoom über chrome.tabs.setZoom; getZoom bestätigte den Wert 2. Am angemeldeten realen Artikel-Direktlink betrug der CSS-Viewport 320 Pixel bei DPR 2. Dialog/Inhalt waren sichtbar, das Schließen lag innerhalb der Viewportgrenzen und der Artikelinhalt ließ sich vertikal scrollen. Screenshot-Evidenz: /tmp/scout-focused-followup/screenshots/browser-zoom-article-200percent.png. Keine Browsererweiterung wird in der App installiert oder mitveröffentlicht.

Die gezielte Browserdiagnose erfasste keine fehlgeschlagenen Netzwerkanfragen und ausschließlich die bereits beim abgemeldeten Bootstrap auftretenden 401 /api/crawler-prompts/rag_system als Fehlerantworten. Diese werden nicht als fehlgeschlagene Artikelanmeldung ausgegeben.

Wiederholbarer optionaler Browsertest#

Die Abschlussprüfung fand zusätzlich den anonymen Zugriff auf Original-Leads über alte Listen-/Suchrouten. Listen, Suchdelegation und Suchanreicherung verlangen jetzt die vorhandene Browsersitzung. Die serverseitige Editor-Quellensuche wurde auf den bestehenden Token-geschützten internen Dienstkanal umgestellt, nicht auf eine Ausnahme im Browser-Login. Zusätzliche Backend- und Editor-Regressionsprüfungen decken beide Grenzen ab.

Nach dieser Korrektur und der Reparatur falsch platzierter JavaScript-Deklarationen wurde im echten Browser gezielt erneut geprüft: alle vier anonymen Listen-/Suchaufrufe liefern 401; nach sichtbarer Anmeldung liefern Liste und Suche 200. Artikel-Direktlink und Reload, Vor-/Zurück mit zwei echten Artikeln und Fokusrückgabe funktionieren weiterhin; keine JavaScript-Seitenfehler. Der interne Dienstkanal wurde zusätzlich real mit 403 ohne Token bzw. 200 mit gültigem Token geprüft und erzeugt keine Browsersitzung. Die bereits erfolgreichen Zoom-/Raceprüfungen wurden nicht unnötig vollständig wiederholt.

tests/browser/scout-deeplink.cjs enthält den zusammengeführten Playwright-Ablauf einschließlich echter Listenartikel, Detail-Fehler-/ Racefällen, Modaldialogen und schmaler Ansicht. Playwright wird nicht in den Anwendungs-Abhängigkeitsbaum aufgenommen. Beispiel mit bereits bereitgestellter isolierter Testinstallation:

NODE_PATH=/path/to/playwright/node_modules node tests/browser/scout-deeplink.cjs

Die vorhandenen Development-Testzugangswerte müssen sicher in der Umgebung konfiguriert sein, nicht in Shell-History oder Skripttext eingesetzt werden. Die Basis-URL verwendet SCOUT_BROWSER_BASE_URL oder die vorhandene Development-Domain. Eine alternative Chromium-Datei kann über SCOUT_BROWSER_CHROMIUM_EXECUTABLE vorgegeben werden. Profile, temporäre Zoom-Erweiterung und Screenshots bleiben standardmäßig unter /tmp. Der Lauf gibt nur sichere Prüfnamen/IDs aus und endet bei Fehlern ungleich null.

Die oben genannten Browserabläufe wurden tatsächlich als Entwicklungs- Prüfskripte ausgeführt. Die daraus zusammengeführte portable Datei wurde syntaktisch geprüft; es erfolgte kein unnötiger vollständiger zweiter Durchlauf unveränderter Abläufe nur wegen ihrer Übernahme ins Repository.

Browserbasierte Dienstverwaltung: Entwicklungsnachweis#

Die Verwaltung API & MCP wurde mit sichtbarer Scout-Anmeldung und eigener Admin-Kennwortbestätigung im echten Chromium geprüft. Wiederholbarer Ablauf:

NODE_PATH=/path/to/playwright/node_modules node tests/browser/service-keys.cjs

Das Skript verwendet ausschließlich die bereits sicher konfigurierten Development-Testzugangswerte. Klartextschlüssel werden weder ausgegeben noch in Dateien oder Screenshots übernommen. Angelegte Testfreigaben werden am Ende widerrufen; Screenshots ohne Schlüssel bleiben unter /tmp.

Erfolgreich geprüft:

  • Anonyme Verwaltung wird mit 401 und no-store abgewiesen; eine normale Nutzerrolle erhält keinen Navigationseintrag.
  • Leere Gemeindeauswahl wird abgewiesen; Anlage mit expliziter Gemeinde und Veröffentlichungsdatumsgrenzen zeigt den Schlüssel genau einmal.
  • Explizite Kopieraktion sowie gezielt verweigerte Zwischenablage mit markiertem manuellen Fallback; Schließen löscht den Klartext.
  • Widerrufsbestätigung abbrechen und annehmen; anschließend REST 403 statt 200.
  • Ein zurückgehaltener Anlageabschluss nach Navigation mit Wiedereintritt bzw. nach bestätigter Abmeldung bringt keinen Schlüssel zurück.
  • Simulierter Anlagefehler löst keinen automatischen zweiten POST aus; Listenfehler und bewusster Wiederholungsabruf funktionieren.
  • Formular und Aktionen sind bei 420 Pixeln nach Einklappen des vorhandenen Drawers bedienbar; Metadaten werden als Text dargestellt.

Automatisierte Ergänzungen: python -m unittest discover -s tests -p test_service_key_admin.py -v prüft aktuelle Rollen einschließlich Entzug, CSRF, Validierung, Hash-only- Persistenz, einmalige Antwort, Geheimnisredaktion, CLI-Bestandsmetadaten und REST-/MCP-Widerruf während eine echte SDK-Verbindung initialisiert bleibt. node --test static/service_keys.test.mjs prüft veraltete Antworten, Wiedereintritt, Scope-Neuladung, Kopierfallback und fehlende Browserpersistenz. Die bisherigen 21 Public-Service-, 16 Direktlink-/Editor-Vertrags-, 24 Anmelde-/Routenschutz- und 356 Editor-Prüfungen bestanden ebenfalls. Die pytest-artigen Auth-Prüfungen liefen ohne neue Projektabhängigkeit über einen temporären Läufer und eine isolierte PostgreSQL-Tabelle.

Verwaltungsantworten erneuern keine Sitzungscookies: Ein verspäteter Schreibabschluss darf kein altes Anmeldecookie ausliefern. Der Browserlauf zeigte zusätzlich, dass andere bereits bestehende Dashboard-/Pollingantworten eine Abmeldung mit alten Cookies überschreiben können. Dieses allgemeine Sitzungsproblem ist getrennt zu beheben; der erfolgreiche Nachweis oben gilt für das Löschen und Nichtwiederanzeigen des Dienstschlüssels, nicht für eine vollständige Reparatur aller bisherigen Sitzungspfade.

Noch separat an der veröffentlichten Installation zu prüfen#

  • Bestätigte tatsächliche kanonische HTTPS-Origin je Installation konfigurieren; hier wurde kein DEV-/PROD-Wert erfunden oder gesetzt.
  • Dienstschlüssel über den vertrauenswürdigen Betreiberweg ausgeben, realen Gemeindebestand/Datumsumfang prüfen und Widerruf von einem anderen Worker aus testen. Lokale Quoten niemals als installationsweite Quote ausgeben.
  • Externen API-Key-fähigen MCP-Client verbinden, Tool-Metadaten erneuern und in neuem Chat rohen MCP-Text und structuredContent kontrollieren.
  • Reale öffentliche Dokumentation/OpenAPI und geschützte Links mit/ohne Browsersitzung gemeinsam prüfen. Schlüssel/Signaturen dürfen weder URLs noch Logs/Antworten enthalten.
  • Bei langen KI-Aufrufen die vorhandenen Proxy-/Gunicorn-Fristen prüfen. Automatische Loginführung nach Sitzungsablauf bleibt eine offene, nicht stillschweigend entschiedene Produktfrage.