E-Mail & Projektdaten
Original-E-Mails, Access, Projektordner, Kunden und Projektnummern bleiben vollständig im Büro.
Verstehen + recherchieren
Lokales LLM kennt echten Projektkontext, KNP-Wiki und – lizenzabhängig – Normen/Fachliteratur.
Agenten + Rechenleistung
Ein von KNP administrierter Linux-Server im Rechenzentrum: dort laufen Codex/Claude Code, Python, Geometrie, FEM, Wärmebrücken und Reporting auf pseudonymisierten Tickets.
Kein Weg ins KNP-LAN
Nur KNP-Komponenten bauen definierte ausgehende Verbindungen auf. Die Agentenzone erhält weder eine Route ins Firmennetz noch KNP-Credentials.
Grundbegriffe: vom Chat zum Agenten
Der wichtigste Sicherheitsunterschied ist nicht das verwendete KI-Modell, sondern welche technischen Rechte der laufende Prozess besitzt.
Antwortet mit Text
Wie beim bekannten ChatGPT-Chat: Die KI schlägt z. B. ein Skript vor. Ein Mensch kopiert es, prüft es und startet es selbst. Der Chat hat dadurch nicht automatisch Zugriff auf KNP-Rechner oder Dateien.
Kann selbst handeln
Codex oder Claude Code läuft als Programm auf einem Linux-Rechner. Je nach Freigabe kann der Agent Dateien lesen und ändern, Shell-Befehle starten, Programme ausführen und Netzwerkdienste ansprechen. Sicherheitstechnisch ist er deshalb eher ein automatisierter Linux-Benutzer als ein reiner Chat.
Stellt benannte Werkzeuge bereit
MCP kann dem Agenten enge Funktionen wie run_fem oder generate_report geben, statt freien SSH-Zugriff. Das begrenzt die Oberfläche – aber nur, wenn die Tools selbst eng sind und Betriebssystem sowie Netzwerk ebenfalls begrenzt bleiben.
Kein fertiger Cloud-Dienst
Gemeint ist ein normaler gemieteter Linux-Server in einem Rechenzentrum, den KNP selbst administriert. KNP bestimmt Betriebssystem, Firewall, Container, Arbeitsverzeichnisse, Tools, Secrets und Regeln der Codex-/Claude-Code-Sessions.
1. Zwei typische Arbeitsabläufe
Die Grafik zeigt bewusst nicht nur Technik, sondern zwei konkrete Aufgaben aus dem Büroalltag.
Lesart: Workflow A bleibt komplett im KNP-Büro. Workflow B überschreitet die Grenze nur mit pseudonymisierten Technikdaten. Normen- und Wiki-Recherche wird intern ausgeführt und als schlankes Evidence Packet zurückgegeben.
2. Systemaufteilung
Das Referenz-Zielbild trennt die vertrauliche KNP-Welt von einer untrusted Agenten-/Rechenzone. Der physische Standort eines Rechners ist dabei zweitrangig; entscheidend sind Netzwerkroute, Rechte und Daten.
Vertrauenswürdige Zone
Datenserver/Access/E-Mail, lokales LLM, interne Task-Zuordnung, KNP-Wiki, Normen/Fachliteratur, Human Gates, deterministische Write Worker, KNP Document Factory und der ausgehende Connector.
Agentensteuerung + Rechenzone
Web-App, API/Auth, Datenbank, Job Queue, Object Storage, Agent-Orchestrator, Codex/Claude Code, MCP-Rechentools, Tool Registry, Sandboxes und Reporting. Diese Zone wird auch dann als untrusted behandelt, wenn KNP den Server vollständig selbst administriert.
3. Architekturvarianten
Es gibt mehrere sinnvolle Betriebsformen. Für die Sicherheit zählt vor allem, ob ein Agenten-/Rechenrechner eine technische Route in das KNP-LAN besitzt.
| Variante | Aufbau | Sicherheitswirkung | Einordnung |
|---|---|---|---|
| A · Agent + Compute extern | Codex/Claude Code und Rechentools laufen auf dem gemieteten Server. KNP übergibt nur pseudonymisierte Pakete und holt Ergebnisse ab. | Klare Trennung; selbst eine kompromittierte Agentenzone hat keine Route und keine Credentials ins KNP-LAN. | Referenz-Zielbild |
| B · Agent extern, Compute-PC im Büro isoliert | Agenten laufen auf dem gemieteten Server. Ein separater Rechen-PC steht physisch bei KNP, aber in einem eigenen Netz/VLAN ohne Route zum KNP-LAN. Ein kleiner Worker auf dem Rechen-PC holt über ausgehendes HTTPS freigegebene Rechenjobs und liefert Ergebnisse zurück. MCP kann lokal hinter diesem Worker liegen. | Eigene CPU/GPU bleibt nutzbar, ohne dem Agenten einen direkten Weg ins Firmennetz zu geben. Der externe Agent spricht nicht direkt mit einer internen IP und öffnet keinen Remote-Shell-Zugang. | Sichere Hybridoption |
| C · Agent + Compute direkt im KNP-LAN | Codex/Claude Code läuft auf einem normalen Büro-Rechner mit erreichbaren Fileservern, Druckern, Datenbanken oder anderen internen Diensten. | Ein Fehler, eine bösartige Eingabe oder eine kompromittierte Abhängigkeit kann den Agenten-Rechner als Sprungbrett zu erreichbaren internen Systemen benutzen. | Kein Produktions-Zielbild |
4. Kommunikation über die Grenze
„Empfangen“ im Büro braucht keinen offenen Port: KNP-Komponenten bauen die Verbindung selbst nach außen auf und holen definierte Nachrichten oder Jobs ab.
5. MCP als Tool-Schicht
MCP ist eine standardisierte Art, einem Agenten benannte Werkzeuge bereitzustellen. Es ist nützlich für Rechtebegrenzung, ersetzt aber keine Netzwerk- oder Betriebssystem-Isolation.
| Zone | Beispiel-Tools | Zweck |
|---|---|---|
| KNP intern | search_knp_wiki, search_norms, classify_email, prepare_document | Lokales LLM arbeitet mit vertraulichen Quellen und festen internen Diensten. |
| Externe Agentenzone | calculate_u_value, run_fem, thermal_bridge, generate_plot, generate_report | Agenten verwenden versionierte, eng definierte Rechentools statt freien Zugriff auf Fachlogik und Infrastruktur. |
| Isolierter Rechen-PC | optional lokales MCP hinter dem Rechen-Worker | Der Worker kann intern ein MCP-Tool aufrufen. Der MCP-Port selbst muss dafür nicht vom gemieteten Server oder aus dem Internet erreichbar sein. |
| KNP-Grenze | kein direktes MCP | Nur Task Packages, Research Requests, Evidence Packets, Result Packages und Status über die Broker-/Connector-Schnittstelle. |
run_command(command) wäre praktisch wieder eine freie Shell. Ein Tool run_thermal_bridge(case_id) mit validiertem Eingabeschema ist wesentlich enger. Zusätzlich bleiben Netzwerkregeln, OS-Rechte, Container und Dateifreigaben notwendig.6. Research Proxy: DIN + KNP-Wiki
Öffentliche Agenten können Fachfragen stellen, ohne Zugriff auf geschützte Quellen oder Unternehmensdaten zu erhalten.
7. Schriftstücke und Präsentationen
Inhalt kann extern vorbereitet werden; echte Projektidentität und KNP-Layout werden intern ergänzt.
Inhalt vorbereiten
Technischer Bericht, Tabellen, Diagramme, Gliederung oder Präsentationsentwurf aus pseudonymisierten Ergebnissen.
Document Factory
KNP-Briefkopf, DOCX/PDF/PPTX-Master, Projektnummer, Auftraggeber, interne Vorlagen und freigegebene Textbausteine.
Prüfen + ablegen
Fachliche Freigabe, ggf. Versand und deterministische Ablage im richtigen Projekt.
8. Rechenkern – vorhandener Stand
Der bestehende PoC liefert bereits wesentliche Vorstufen; vollständige produktive Fach-Calculation-Engines bleiben ein eigener Entwicklungsstrang.
Dokument + Geometrie
PDF-Inventar, Vektor-/Raster-Pfade, Räume/Flächen, thermische Hülle, Öffnungen, Cross-View-/Geschoss-/Scope-Logik, Evidence und Review.
Bauteile + U-Werte
Schichtenkatalog, Materialdaten, Zuweisungen, Öffnungsabzug, U-Wert nur bei vollständigen Eingaben, JSON/CSV/HTML-Ausgaben.
Fachrechenkerne
Validierte Wärmebrücken-/FEM-, GEG-/18599-, Schall- und weitere Engines mit Referenzfällen, Toleranzen und reproduzierbaren Runs.
9. Sicherheitsmodell – anschaulich
Die Agentenzone wird so behandelt, als könnte eine Session, ein Modell-Input oder eine Software-Abhängigkeit irgendwann kompromittiert werden. Die Architektur soll dann trotzdem verhindern, dass daraus Zugriff auf KNP-Projektdaten entsteht.
Shell + Netzwerk = möglicher Seitwärtsweg
Ein Coding-Agent kann – soweit sein Linux-Benutzer es darf – Programme starten und Netzwerkverbindungen herstellen. Befindet sich dieser Rechner im normalen Firmennetz, sind interne Dienste technisch erreichbar. Ein Fehler oder kompromittierter Agent könnte dann versuchen, erreichbare Systeme oder gespeicherte Zugangsdaten zu missbrauchen. Dass der Prompt so etwas verbietet, ist keine harte Sicherheitsgrenze.
Die Verbindung existiert technisch nicht
Agenten- und Rechenzonen erhalten keine Route zum KNP-LAN, keine KNP-Credentials und keine gemounteten Projektlaufwerke. KNP startet nur eng definierte ausgehende Verbindungen. Selbst ein vollständig übernommener Agenten-Workspace sieht dadurch nur die pseudonymisierten Daten seines Auftrags.
| Regel | Umsetzung |
|---|---|
| Keine Route nach KNP | Kein Site-to-Site-VPN, kein SMB/SSH/DB-Zugang, kein interner DNS und keine KNP-Credentials in der Agentenzone. Ein lokaler Rechen-PC der Hybridvariante steht in einem getrennten Netz ohne Route zum KNP-LAN. |
| Nur definierte Austauschobjekte | Schema-validierte Task-, Research-, Evidence-, Result- und Status-Pakete; technische Ticket-ID statt Kundenname/Projektnummer. |
| Rückgaben sind untrusted | Keine Shell-/SQL-/Access-Anweisungen aus externen Paketen ausführen; Dateien, HTML und Freitext werden validiert bzw. sanitisiert, bevor interne Systeme sie übernehmen. |
| Produktives Schreiben | Nur feste interne Worker nach Human Gate; keine freien Agentenrechte auf Access, Mail, Projektordner oder Dokumentenablage. |
| Agent-Isolation | Pro Ticket separater Workspace/Container; nur explizit freigegebene Dateien, Netzwerkziele und Tools. |
| Rechen-PC-Hybrid | Der Rechen-Worker baut selbst ausgehendes HTTPS auf. Kein direkter eingehender Agentenzugriff, kein offener Remote-MCP-Port als Brücke ins Büro. |
| Secrets | Agenten erhalten nur die für ihre Zone benötigten Tokens. Interne KNP-Zugangsdaten werden weder in Prompts noch in Workspaces oder Umgebungsvariablen der externen Agenten gespeichert. |
10. MVP
Der erste Vertical Slice testet bereits fast alle Architekturgrenzen, ohne direkt das gesamte Bauphysiksystem fertigstellen zu müssen.
11. Roadmap
Erst die sichere Verbindung und ein kleiner vollständiger End-to-End-Fall, dann schrittweise mehr Automatisierung.
| Phase | KNP intern | Externe Agenten-/Rechenzone | Ergebnis |
|---|---|---|---|
| 0 · Bestand | Server, Access, Mail, Ordner, Wiki, Vorlagen, Normrechte erfassen | — | klare Integrationspunkte |
| 1 · Security Foundation | Connector, interne Task-ID↔Ticket-Map, lokale Web-/LLM-Dienste | Next.js, API, Auth, DB, Queue, Storage, Agent-Sandbox | sicherer Pakettransport |
| 2 · MVP Bauphysik | Task anlegen, Research beantworten, Ergebnis importieren | Agent + erstes KNP-validiertes Tool + Report | erster E2E-Nachweis |
| 3 · Office | Document Factory, KNP-Layouts, Human Gate | Inhalts-/Diagrammerzeugung | Schriftstücke/PPT |
| 4 · E-Mail/Access | Write Worker + Audit/Backup + Freigabe-UI | nicht erforderlich | kontrollierte Ablage |
| 5 · Fachkerne | fachliche Validierung/Freigabe | FEM/Wärmebrücke/weitere Engines + Benchmarking | zunehmend produktive Automation |