Für postinstall.sh: liest tuxflotte_agent_commit aus roles/agent/defaults/main.yml
im aktuellen Spiegel-Stand der Stufe des Geräts.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Der Agent meldet seit 54f76f1, ob er den Ansible-Stand als Archiv von
anode, per Git oder per Git-Rückfall bezogen hat. Nur die drei bekannten
Werte werden gespeichert; Gerätelisten liefern das Feld mit.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Hintergrund-Thread spiegelt ansible-content (vorab), -stabil und
provisioning-agent alle 60 s nach data/spiegel, Archiv (tar.gz + SHA-256)
je Stand, die letzten drei je Stufe bleiben abrufbar
- Check-in liefert zusätzlich ansible_stand {commit, sha256}; ansible_repo
bleibt als Rückfall
- GET /api/v1/agent/ansible/<commit>.tar.gz und
/api/v1/agent/fassung/<commit>/<datei> nur mit Agent-Secret
(Authorization + X-Tuxflotte-Geraet), nur zustehende Stände
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Beides war über anode.tuxflotte.de ohne Anmeldung erreichbar (Durchsicht
18.10.2026, ADR-0046 Abschnitt 'Unabhängig davon'). Health-Check des
Deploys läuft seit infra 7c7069b über /health.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Check-in liefert persoenliche_konten (anlegen mit Hash, aktiv, sperren,
entfernen). /api/v1/agent/persoenliche-konten nimmt die Ergebnisse an:
angelegt löscht den Hash und merkt ohne "Bestehenden Zugang behalten" die
übrigen Konten zum Entfernen vor. Ein Code ohne Kästchen sperrt bestehende
Konten sofort. Sperren/Entsperren je Konto. Eine Neuinstallation beendet
alle Personalisierungen des Geräts. Migration 0065 um gesperrt, entfernen,
geraet_meldung und Status fehlgeschlagen ergänzt.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Code je Gerät (7 Tage, nur Hash gespeichert), Einreichen mit Domänen- und
Anmeldenamenprüfung (Passwort kommt nur als SHA-512-crypt), Bestätigung
binnen einer Stunde, verfallene Vorgänge verlieren Hash und Adresse. Die
Platzhalterseite /personalisierung entfällt, das Formular liegt in der
Kundenplattform.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Bauplan Schritt 1 (platform-docs roadmap/veyon-schluesselverteilung-
diskussion-2026-10-14.md). Paar beim ersten Bedarf erzeugt (RSA 4096,
PKCS#8/SPKI-PEM wie veyon-cli), privat Fernet-verschluesselt. Optionen:
veyon_schluesselname, veyon_public_pem, veyon_raum, veyon_lehrer; nur
Lehrergeraete zusaetzlich veyon_private_pem und veyon_rechner
(<hostname>.local, ohne sich selbst). Lehrer = Haekchen veyon_lehrer an
irgendeiner aktiven Gruppe. Fehler brechen den Check-in nicht ab.
Getestet gegen eine Wegwerf-Datenbank mit allen Migrationen.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Ressourcen (Mail, Nextcloud, ownCloud, WebDAV, SMB, Web-Proxy) gehoeren zur
Organisation und wirken fuer die ganze Org, OEs samt Unter-OEs oder
Geraetegruppen. Keine Zugangsdaten: unbekannte Felder werden verworfen.
Der Check-in schickt die fuer das Geraet geltenden Ressourcen (spezifisch
zuerst) als Auftrag org-ressourcen, vorerst nur fuer Organisationen mit
Ausrollstufe vorab (ORG_RESSOURCEN_NUR_VORAB).
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Nachtrag zu ADR-0044: Ob ein Gerät die über die Rolle agent freigegebene
Fassung übernommen hat, war aus der Ferne nicht sichtbar. Ältere Agenten
schicken nichts (Wert bleibt stehen), ungültige Werte werden verworfen
statt den Check-in abzulehnen.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Neue Organisationen bekamen keine Kundengruppe (nur die Rückfüllung in
Migration 0050 hatte sie gesetzt) und sahen dadurch keine Vorlagen mit
Sichtbarkeit kundengruppe. Liste/Detail liefern die Kundengruppe mit,
POST /organizations nimmt sie an, PUT .../kundengruppe ändert sie.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Der Check-in liefert Organisationen mit Stufe "stabil" die Adresse des
freigegebenen Repos (ansible-content-stabil), "vorab" die von main. Neue
Organisationen sind stabil; Default Lab, Liebherr und WLAN-Test vorab.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Vorgabe im Entwurf setzen (Firefox oder ein im Entwurf enthaltener
Browser), wird mit kopiert, faellt beim Entfernen des Browsers zurueck und
steht in der Wirkungsvorschau. Der Check-in liefert sie als eigenen Auftrag
"standardbrowser" (kein Katalog-Merkmal); dessen Rueckmeldung erzeugt keine
Ereigniszeile.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Ohne eigene Hostnamenkonvention übernahm der Server den vom Client
gemeldeten Namen. Der Client ist das Live-System des Boot-Mediums, also
hieß jedes Gerät "debian" (auch das erste Kundengerät). Jetzt vergibt der
Server immer selbst, ohne eigenen Präfix als tuxflotte-<Nummer>. Bekannte
Geräte mit unpassendem Namen bekommen ihn bei der nächsten Neuinstallation.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Nutzung und Loeschsperre zaehlen nur aktive Geraete und gueltige
Installationsmedien. Beim Loeschen werden Zuordnungen archivierter
Geraete und abgelaufene/widerrufene Medien mit entfernt (sonst
blockieren die Fremdschluessel). Anlass: Liebherrs
Entwicklungsprofile hingen nur noch an Altlasten vom 08./09.09.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Die Installer-Uebersicht (25_installation_confirm.sh) zeigte den
Profil-Workspace, wirksam ist aber der der Ziel-OE (Schritt F). Neue
Hilfsfunktion oe_kette_workspace(); gleiche Distro-Regel wie
geraete_basis_herkunft(). Der Installer liest nur den Namen, keine
Installer-Aenderung noetig. GUI-Runde 10/2026 Punkt 8.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
_dashboard_verteilungen(): Geraetezustand ausschliessend (nie gemeldet,
>7 Tage nicht gemeldet, Ressourcen knapp, in Ordnung), Distro und
wirksamer Workspace je Geraet ueber geraete_basis(), Organisationen im
Admin-Dashboard. Hoechstens 5 Teile + 'Weitere', Sonderfaelle (ohne
Installation/Workspace) immer am Ende. GUI-Runde 10/2026 Punkt 6.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Liste liefert Geraete-/Medien-Anzahl, Verschluesselung, Secure Boot. Neue
Endpunkte PUT/DELETE (Loeschen gesperrt solange Geraete oder
Installationsmedien verweisen). backend_id optional - ohne Angabe gilt
die Distro des Workspace (ADR-0038). Pruefung fuer Anlegen und
Bearbeiten in _bereitstellungsvorlage_pruefen(). GUI-Runde 10/2026 Punkt 5.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
fetch_aktivitaeten(): ein Agent-Lauf meldet je Merkmal ein Ereignis (~56,
gleicher Zeitstempel) - hier zu einer Zeile zusammengefasst, Fehler
benannt. Neuer Endpunkt /organizations/{id}/aktivitaeten, beide
Dashboards liefern zusaetzlich 'aktivitaeten'. GUI-Runde 10/2026 Punkt 4.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Migration 0056: bezeichnung, gueltig_bis, verwendet_anzahl,
zuletzt_verwendet (alle optional, bestehende Codes unbegrenzt gueltig).
Abgelaufene Codes werden bei der Aktivierung abgelehnt, erfolgreiche
Aktivierungen gezaehlt. Neue Endpunkte: Status setzen, Loeschen; Anlegen
nimmt optional bezeichnung/gueltig_tage. GUI-Runde 10/2026 Punkt 2.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
get_webapp_icon kannte nur workspace_webapps/gruppen_webapps, Icons von
webapp_templates kamen als application/octet-stream.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Testprofile von Default Lab und WLAN-Test zeigen auf die Vorlagen
Schulcomputer (Mint/Debian/Ubuntu) derselben Distro, die Basis-Workspaces
entfallen (Migration 0054). fetch_workspaces() liefert die Namen der
freigegebenen Kundengruppen/Organisationen fuer Anzeigen wie
"Vorlage fuer Schulen".
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- PUT /api/v1/organisationseinheiten/{id}/workspace: Workspace (sichtbar fuer
die Organisation, mit Distro) an eine OE haengen, automatisch oder auf eine
Version gepinnt.
- distro_konflikte(): simuliert OE-Workspace, OE umhaengen und Geraet
verschieben und blockiert, wenn ein aktives Geraet danach einen Workspace
mit anderer Distro bekaeme (Meldung nennt Geraete und OE).
- Sicherheitsnetz in geraete_basis_herkunft(): passt der OE-Workspace nicht
zur Geraete-Distro, gilt der Workspace der Installation.
- Enrollment-Sessions mit Ziel-OE (geprueft gegen die Profil-Distro);
aktivierte Geraete landen dort, resolve_template liefert die Blueprints der
wirksamen Grundausstattung.
- Profil anlegen prueft, dass Workspace und Profil dieselbe Distro haben.
- OE-Liste mit eigenem und wirksamem (geerbtem) Workspace, Geraeteliste mit
wirksamem Workspace und Distro.
Workspace-Creator neu, Schritt F.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Inhalte aendern sich nur noch im Entwurf (Endpunkte lehnen sonst mit
kein_entwurf ab, Webapps muessen zum Entwurf gehoeren, neue Merkmale zur
Distro passen). Veroeffentlichen prueft die Distro erneut. Neue
Endpunkte: Entwurf anlegen/verwerfen, veroeffentlichen, Versionen,
Nutzung (Profile, OEs, Geraete automatisch vs. gepinnt), Wirkung (Diff
plus Nutzung), Name/Zweck, Vorlage mit Sichtbarkeit, Kopie-Pruefung und
Kopie auf andere Distro (fehlende Merkmale fallen weg und werden
gemeldet), Loeschen nur wenn ungenutzt (raeumt Icons auf),
Kundengruppen. geraete_basis_herkunft() liefert die Herkunft der
Grundausstattung. Workspace-Creator neu, Schritt E.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
POST /api/v1/workspaces/assistent legt Workspace mit Distro, Version 1,
Merkmalen und Webapps aus Vorlagen in einer Transaktion an und lehnt
Merkmale ab, die auf der gewaehlten Distro nicht umgesetzt sind
(Fehlermeldung nennt sie). Key wird aus dem Namen erzeugt und je
Eigentuemer eindeutig gemacht. Workspace-Creator neu, Schritt D.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Liebherrs gepflegter Schulcomputer wird Vorlage je Distro (Kundengruppe
Schule), Liebherr- und Gaissach-Profile zeigen auf die Mint-Variante.
Alter globaler Schulcomputer wird Schulcomputer Basis je Distro fuer die
Bestandsprofile. Gast/fjmfm geloescht, Entwickler bleibt als Entwickler
(Mint) bis nach dem 01.11.2026 (gueltiger Aktivierungszugang).
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
geraete_basis() ermittelt die Grundausstattung eines Geraets: Distro aus
der Installation, Workspace von der naechsten OE mit Workspace (gepinnte
Version oder neueste veroeffentlichte), sonst wie bisher aus der
Installation. Blueprints, Auftragskatalog, Webapps und Profil-Aufloesung
lesen die Version; Gruppen-Webapps ergaenzen. Gruppen tragen keinen
Workspace mehr, Exklusivregel und Endpunkte entfallen. Admin-Bearbeitung
wirkt bis Schritt E auf die Arbeitsversion. Workspace-Liste/-Detail
liefern Distro, Version, Vorlage, Sichtbarkeit; Sichtbarkeit fuer Kunden
nach Eigentum, global, Kundengruppe oder Organisation.
Lokal gegen eine Kopie der Produktionsdaten geprueft: Soll-Zustand aller
21 Geraete und 12 Profile identisch zum alten Code, 19 Szenarien gruen.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Rein additiv mit Rueckfuellung: jeder Workspace bekommt Version 1 mit
seinem bisherigen Inhalt, alle Organisationen die Kundengruppe Schule.
Neu: Sichtbarkeit/Freigaben fuer Vorlagen, Workspace an der OE mit
gepinnter Version und Auto-Haken, Gruppen-Webapps, Org-Berechtigung
darf_eigene_workspaces. Workspace-Creator neu, Schritt C.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
fetch_kategorien() liefert art, Kategorien lassen sich als App oder
Richtlinie anlegen. Webapp-Vorlagen tragen optional eine App-Kategorie,
die beim Aktivieren in den Workspace mitkopiert wird.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
adminandClaude Opus 5.5