Files
Crumb-Core-v.1/docs/crumbforest/sprechende_bruecke.md

2.4 KiB
Raw Blame History

🛤️ Die sprechende Brücke Verbindung im Crumbforest

🌉 Einführung

Die sprechende Brücke ist ein zentrales Symbol und eine funktionale Instanz im Crumbforest-Universum. Sie verbindet symbolisch wie technisch verschiedene Ebenen: Terminal ↔ Web ↔ Shell ↔ Mensch ↔ Maschine.


🔧 Technische Vision

Die Brücke erlaubt sicheren und gezielten Zugriff vom Web (z.B. CakePHP Backend auf Port 8080) zur Terminalwelt (z.B. TTYD auf 7681) ggf. ergänzt um einen Wissens- oder Konfigurationslayer (z.B. DebugKit oder Port 8081 für die Eule).

  • Bei Erstellung eines Users (POST auf /users/add) wird:

    • Ein Eintrag in der users-Tabelle erzeugt.
    • Automatisch ein Token vergeben.
    • Und optional ein Linux-User über create_linux_user.sh angelegt.
  • Authentifizierung kann entweder über CakePHP Sessions (/users/login) oder Token-basierte Checks erfolgen (/terminal/auth).

📡 Sicherheit & Rollen

Jede*r Krümel bekommt:

  • einen Linux-User (TTD)
  • einen Datenbank-User (Kuchen)
  • einen API-Token (Maschine)

Das Konzept der „sprechenden Brücke“ hilft dabei, diese Identitäten zu synchronisieren:

  • User im Kuchen legt realen Nutzer an.
  • Token-Austausch via sicherem Request von TTYD.
  • Optionaler SSH-Zugang über bekannte Ports (z.B. 2222)

🧩 Philosophie

Die Brücke spricht aber nur, wenn man sie fragt.

Sie führt:

  • sicher über Flüsse von Code,
  • durch Schluchten aus Exceptions,
  • zu Lichtungen von Verständnis.

Sie ist geduldig, klar und verlässlich ein Werkzeug der Erkenntnis, kein Tor zur Flucht.


📝 Beispielhafter Ablauf

  1. POST /users/add mit username, email, password
  2. Controller erzeugt Eintrag in DB
  3. Führt aus: create_linux_user.sh <username>
  4. Terminal login nutzt dann diesen Linux-User
  5. API-Zugriffe per api_token

🔗 Quellpfade & Tools

  • UsersController.php → erweitert um Token & Shell-Anlage
  • create_linux_user.sh → Anlage der Shell-Identität
  • session_wrapper.sh → prüft .crumbforest_session
  • login (bash) → sendet Token zur Prüfung an Kuchen
  • TerminalController.php → validiert Token
  • /tmp/token.log → Log der Aktionen

🌲 Abschluss

Die Brücke ist mehr als ein Übergang.
Sie ist ein Symbol der Verständigung.
Ein Bit, das leuchtet.
Ein „Ja“ in einer Welt der Wenns und Abers.

🦉

„Hoooo vergiss nie, du darfst echt sein“