Compare commits

..
15 Commits
Author SHA1 Message Date
alientim 0d99760d89 Version 2.8.0: Rechtekonzept -- eine Zeile je Funktion, Administrator heisst Verwaltung 2026-09-12 13:27:45 +02:00
alientim 713ff12db2 Version 2.7.8: die Vorschau haengt an derselben Kante wie die Datei 2026-09-12 11:37:03 +02:00
alientim 2db7e03154 Version 2.7.7: Schriftgroesse der Vorschau wird gerechnet 2026-09-12 01:34:02 +02:00
alientim 5dcb87d6ec Version 2.7.6: die Vorschau der Unterschrift zeigt das Ergebnis 2026-09-12 01:12:05 +02:00
alientim dc94a8e666 Version 2.7.5: jede Aenderung nennt alt und neu 2026-09-12 00:43:09 +02:00
alientim c639f4f507 Version 2.7.5: die Ordnerzeile sagt, was im Ordner liegt 2026-09-12 00:30:34 +02:00
alientim ad0195bab0 Version 2.7.4: Unterschriften in der Sicherung, unterschrieben ist abgeschlossen 2026-09-12 00:26:22 +02:00
alientim ce22239d78 Version 2.7.3: Zeugenvermerk einmal und in den Dokumenteigenschaften 2026-09-11 23:45:17 +02:00
alientim 92c8abb79b Zahlen im Kommentar geradegerueckt 2026-09-11 23:28:28 +02:00
alientim dcb4f57eeb Version 2.7.2: Umlaute in der Oberflaeche, Einbindungen an der Sitzung 2026-09-11 23:24:28 +02:00
alientim 11a55b20f8 Version 2.7.1: Signaturverzeichnis ueberlebt die Archivierung 2026-09-11 21:36:24 +02:00
alientim ed17bce40a Version 2.7.0: Pruefung beim Oeffnen, Unterschrift in menschlichem Mass 2026-09-11 21:23:11 +02:00
alientim 5282cd8f2d Version 2.6.1: die Speichernzeile fuehrt zur Entscheidung 2026-09-11 21:03:24 +02:00
alientim 754cbea6bb Version 2.6.0: Unterschreiben mit dem Finger, Ablage in eine andere Freigabe 2026-09-11 20:41:47 +02:00
alientim 07ae69e3b7 Version 2.5.2: Wartung ist auch in der Rechtematrix ein eigener Bereich 2026-09-11 20:16:37 +02:00
103 changed files with 4244 additions and 1022 deletions

No files matched your search

+1 -1
View File
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
[project]
name = "tesm"
version = "2.5.1"
version = "2.8.0"
description = "TESM -- Verwaltung und Ueberwachung von PoE-Endgeraeten und Aruba-Switchen"
requires-python = ">=3.11"
dependencies = [
+22 -17
View File
@@ -19,7 +19,7 @@ from tesm_core.extension import core
from tesm_core.views import trash as trash_views
from .navigation import NAVIGATION
from .permissions import PERMISSIONS, ROLE_PRESETS
from .permissions import DHCP_PAGE, PERMISSIONS, ROLE_PRESETS
from .schema import TESM_MIGRATIONS
from .settings_spec import TESM_SETTINGS
@@ -164,7 +164,7 @@ def _mount_shares_after_login(conn: Any, user: Any, secret: str, group_dns: tupl
group_dns=group_dns,
)
for message in messages:
current_app.logger.info("Dateifreigabe fuer %s -- %s", user.username, message)
current_app.logger.info("Dateifreigabe für %s | %s", user.username, message)
def _release_shares_on_logout(conn: Any, user: Any) -> None:
@@ -174,14 +174,19 @@ def _release_shares_on_logout(conn: Any, user: Any) -> None:
dem Abmelden bestehen, waere sein Zugriff weiter offen -- bis irgendwann
die Zeitgrenze greift. Das ist zu lange.
"""
from flask import session
from .services import fileshare
extension = core()
# Nur die Einbindungen dieser Sitzung: wer an zwei Geraeten angemeldet ist,
# soll am zweiten weiterarbeiten koennen.
sitzung = str(getattr(session, "sid", "") or "")
with extension.database.transaction(conn):
released = fileshare.release_all_for_user(conn, user.id)
released = fileshare.release_all_for_user(conn, user.id, sitzung)
if released:
current_app.logger.info(
"Dateifreigaben fuer %s geloest: %d", user.username, released
"Dateifreigaben für %s gelöst: %d", user.username, released
)
@@ -200,24 +205,24 @@ def _status_pills(user: Any) -> list[dict[str, str]]:
# Timer bis zum naechsten Durchlauf, mit Knopf fuer "sofort pruefen". Der
# Knopf gehoert in die Pille, weil er genau die Angabe daneben zuruecksetzt.
if user.has_any(("devices.view", "monitoring.view")):
if user.has_any(("devices.read", "monitoring.read")):
intervall = int(extension.settings.get(verbindung, "monitor_interval_seconds") or 300)
faellig = monitor.next_check_at(verbindung, intervall)
if faellig is not None:
eintrag = {
"label": "Naechste Pruefung in",
"label": "Nächste Prüfung in",
"countdown_to": faellig.isoformat(),
"countdown_done": "jetzt",
"css_class": "",
"dot": "1",
"dot_class": "",
"title": f"Der Ueberwachungsdienst prueft alle {intervall} Sekunden.",
"title": f"Der Überwachungsdienst prüft alle {intervall} Sekunden.",
}
if user.has("settings_system.execute"):
from flask import url_for
eintrag["action"] = url_for("settings.run_check_now")
eintrag["action_title"] = "Alle Clients sofort pruefen"
eintrag["action_title"] = "Alle Clients sofort prüfen"
pills.append(eintrag)
counts = monitor.dashboard_counts(verbindung)
@@ -228,11 +233,11 @@ def _status_pills(user: Any) -> list[dict[str, str]]:
"css_class": "status-pill--danger",
"dot": "1",
"dot_class": "status-pill__dot--pulse",
"title": "Geraete, die beim letzten Durchlauf nicht geantwortet haben.",
"title": "Geräte, die beim letzten Durchlauf nicht geantwortet haben.",
}
)
if user.has_any(("dhcp.view", "dhcp.edit")) and extension.license is not None:
if user.has_any(DHCP_PAGE) and extension.license is not None:
if extension.license.module_active("dhcp") and extension.sysops is not None:
state = extension.sysops.service_state(kea.SERVICE_UNIT)
if state["installed"] == "ja":
@@ -265,7 +270,7 @@ def _register_trash_providers(app: Flask) -> None:
conn, "devices", int(ident), unique_column="mac"
),
purge_fn=lambda conn, ident: inventory.purge_row(conn, "devices", int(ident)),
hint="Die MAC-Adresse bleibt reserviert, solange das Geraet hier liegt.",
hint="Die MAC-Adresse bleibt reserviert, solange das Gerät hier liegt.",
)
)
trash_views.register(
@@ -294,7 +299,7 @@ def _register_trash_providers(app: Flask) -> None:
conn, "credentials", int(ident), unique_column="name"
),
purge_fn=lambda conn, ident: inventory.purge_row(conn, "credentials", int(ident)),
hint="Endgueltiges Loeschen entfernt auch das gespeicherte Passwort.",
hint="Endgültiges Löschen entfernt auch das gespeicherte Passwort.",
)
)
@@ -310,7 +315,7 @@ def _startup_tasks(app: Flask) -> None:
extension = core(app)
if not extension.config.web_process:
logger.info(
"Startaufgaben uebersprungen -- dieser Prozess ist nicht als Webprozess markiert."
"Startaufgaben übersprungen – dieser Prozess ist nicht als Webprozess markiert."
)
return
@@ -323,7 +328,7 @@ def _startup_tasks(app: Flask) -> None:
# die Oberflaeche Freigaben, die es nicht gibt.
vergessen = fileshare.forget_all_mounts(conn)
if orphaned:
logger.warning("%s unterbrochene Wartungsauftraege als unklar markiert", orphaned)
logger.warning("%s unterbrochene Wartungsaufträge als unklar markiert", orphaned)
if vergessen:
logger.info(
"%s Freigabe-Einbindungen eines vorherigen Prozesses vergessen "
@@ -361,7 +366,7 @@ def _start_fileshare_sweep(app: Flask) -> None:
with app.app_context():
geloest = fileshare.sweep_expired(core(app).database)
if geloest:
logger.info("%s abgelaufene Freigabe-Einbindungen geloest", geloest)
logger.info("%s abgelaufene Freigabe-Einbindungen gelöst", geloest)
def schleife() -> None:
# Zwei Netze: das innere haelt den Faden am Leben, wenn ein einzelner
@@ -375,9 +380,9 @@ def _start_fileshare_sweep(app: Flask) -> None:
try:
einmal()
except Exception: # noqa: BLE001 - der Webprozess darf nie sterben
logger.exception("Aufraeumen der Dateifreigaben fehlgeschlagen")
logger.exception("Aufräumen der Dateifreigaben fehlgeschlagen")
except BaseException: # noqa: BLE001 - auch ein Abbruch gehoert protokolliert
logger.exception("Der Aufraeumfaden der Dateifreigaben ist beendet")
logger.exception("Der Aufräumfaden der Dateifreigaben ist beendet")
raise
threading.Thread(target=schleife, name="fileshare-sweep", daemon=True).start()
+19 -19
View File
@@ -37,14 +37,14 @@ def _allowed_categories() -> list[transfer.Category]:
for category in transfer.CATEGORIES:
if category.admin_only and not current_user.is_admin:
continue
if category.sensitive and not current_user.has("backup.secrets"):
if category.sensitive and not current_user.has("backup_export.secrets"):
continue
allowed.append(category)
return allowed
@bp.get("/")
@permission_required("backup.view", "backup.export", "backup.execute", mode="any")
@permission_required("backup_export.read", "backup_import.read", mode="any")
def overview():
extension = core()
conn = db()
@@ -72,12 +72,12 @@ def overview():
min_passphrase=transfer.MIN_PASSPHRASE_LENGTH,
preview_ttl=transfer.PREVIEW_TTL_MINUTES,
license_hint=license_hint,
can_secrets=current_user.has("backup.secrets"),
can_secrets=current_user.has("backup_export.secrets"),
)
@bp.post("/export")
@permission_required("backup.export")
@permission_required("backup_export.export")
# Die frische Bestaetigung verlangt das Recht selbst (SENSITIVE_ACTIONS).
def export():
extension = core()
@@ -92,16 +92,16 @@ def export():
allowed = {category.key for category in _allowed_categories()}
chosen = [key for key in request.form.getlist("categories") if key in allowed]
if not chosen:
flash("Es wurde keine Kategorie ausgewaehlt.", "warning")
flash("Es wurde keine Kategorie ausgewählt.", "warning")
return redirect(url_for("backup.overview"))
include_secrets = (
request.form.get("include_secrets") == "1" and current_user.has("backup.secrets")
request.form.get("include_secrets") == "1" and current_user.has("backup_export.secrets")
)
passphrase = request.form.get("passphrase") or ""
repeat = request.form.get("passphrase_repeat") or ""
if passphrase != repeat:
flash("Die beiden Passphrasen stimmen nicht ueberein.", "danger")
flash("Die beiden Passphrasen stimmen nicht überein.", "danger")
return redirect(url_for("backup.overview"))
try:
@@ -130,17 +130,17 @@ def export():
@bp.post("/import/preview")
@permission_required("backup.execute")
@permission_required("backup_import.execute")
@reauth_required
def import_preview():
conn = db()
upload = request.files.get("backup_file")
if upload is None or not upload.filename:
flash("Keine Datei ausgewaehlt.", "danger")
flash("Keine Datei ausgewählt.", "danger")
return redirect(url_for("backup.overview"))
raw = upload.stream.read(MAX_IMPORT_BYTES + 1)
if len(raw) > MAX_IMPORT_BYTES:
flash("Die Datei ist zu gross.", "danger")
flash("Die Datei ist zu groß.", "danger")
return redirect(url_for("backup.overview"))
try:
@@ -154,28 +154,28 @@ def import_preview():
session[PREVIEW_SESSION_KEY] = token
_audit("backup.import_previewed", f"Erstellt {header.get('created_at')}", severity="notice")
flash(
f"Datei geoeffnet. Sie haben {transfer.PREVIEW_TTL_MINUTES} Minuten Zeit, die "
"Uebernahme zu bestaetigen.",
f"Datei geöffnet. Sie haben {transfer.PREVIEW_TTL_MINUTES} Minuten Zeit, die "
"Übernahme zu bestätigen.",
"success",
)
return redirect(url_for("backup.overview"))
@bp.post("/import/apply")
@permission_required("backup.execute")
@permission_required("backup_import.execute")
@reauth_required
def import_apply():
extension = core()
conn = db()
token = session.get(PREVIEW_SESSION_KEY, "")
if not token:
flash("Es liegt keine geoeffnete Sicherung vor.", "danger")
flash("Es liegt keine geöffnete Sicherung vor.", "danger")
return redirect(url_for("backup.overview"))
allowed = {category.key for category in _allowed_categories()}
chosen = [key for key in request.form.getlist("categories") if key in allowed]
if not chosen:
flash("Es wurde keine Kategorie ausgewaehlt.", "warning")
flash("Es wurde keine Kategorie ausgewählt.", "warning")
return redirect(url_for("backup.overview"))
try:
@@ -206,7 +206,7 @@ def import_apply():
action="backup.imported",
detail="; ".join(
f"{key}: {counts['created']} neu, {counts['updated']} aktualisiert, "
f"{counts['skipped']} uebersprungen"
f"{counts['skipped']} übersprungen"
for key, counts in report.items()
),
ip=client_ip(),
@@ -217,16 +217,16 @@ def import_apply():
lines = [
f"{transfer.CATEGORY_BY_KEY[key].label}: {counts['created']} neu, "
f"{counts['updated']} aktualisiert"
+ (f", {counts['skipped']} uebersprungen" if counts["skipped"] else "")
+ (f", {counts['skipped']} übersprungen" if counts["skipped"] else "")
for key, counts in report.items()
if key in transfer.CATEGORY_BY_KEY
]
flash("Uebernahme abgeschlossen. " + " | ".join(lines), "success")
flash("Übernahme abgeschlossen. " + " – ".join(lines), "success")
return redirect(url_for("backup.overview"))
@bp.post("/import/discard")
@permission_required("backup.execute")
@permission_required("backup_import.execute")
def import_discard():
token = session.pop(PREVIEW_SESSION_KEY, "")
if token:
+3 -3
View File
@@ -29,7 +29,7 @@ def _audit(conn: Any, action: str, target: str, detail: str = "", severity: str
@bp.get("/")
@permission_required("credentials.view")
@permission_required("credentials.read")
def overview():
conn = db()
return render_template(
@@ -62,7 +62,7 @@ def create():
@bp.post("/<int:credential_id>")
@permission_required("credentials.edit")
@permission_required("credentials.write")
def update(credential_id: int):
try:
with transaction() as conn:
@@ -85,7 +85,7 @@ def update(credential_id: int):
"; ".join(changes),
severity="notice",
)
flash("Aenderungen gespeichert." if changes else "Keine Aenderungen.", "success" if changes else "info")
flash("Änderungen gespeichert." if changes else "Keine Änderungen.", "success" if changes else "info")
except inventory.ValidationError as exc:
flash(str(exc), "danger")
return redirect(url_for("credentials.overview"))
+8 -4
View File
@@ -43,7 +43,7 @@ def _tiles(*, authenticated: bool) -> dict[str, Any]:
counts = monitor.dashboard_counts(conn)
rows = inventory.list_devices(conn, only_active=not authenticated)
detailed = authenticated and current_user.has("devices.view")
detailed = authenticated and current_user.has("devices.read")
tiles: list[dict[str, Any]] = []
for row in rows:
entry: dict[str, Any] = {
@@ -67,8 +67,12 @@ def _tiles(*, authenticated: bool) -> dict[str, Any]:
"credential_category": str(row["credential_category"] or ""),
# Nicht nur PoE: ein Geraet kann auch ueber SSH oder RPC
# neu startbar sein. Die Kachel zeigt den bevorzugten Weg.
# Mit Rechtefilter: die Kachel zeigt nur Wege, die
# dieser Benutzer auch ausloesen darf.
"restart_methods": restart.available(
row, maintenance_active=_maintenance_active()
row,
maintenance_active=_maintenance_active(),
darf=current_user.has,
),
}
)
@@ -80,7 +84,7 @@ def _tiles(*, authenticated: bool) -> dict[str, Any]:
# erwartbar weg. Wer die Uebersicht ansieht, will genau das zuerst
# wissen -- sonst haelt er einen laufenden Neustart fuer einen Ausfall.
"key": "restarting",
"label": "Neustart laeuft",
"label": "Neustart läuft",
"kind": "warning",
"tiles": [tile for tile in tiles if tile["state"] == "restarting"],
},
@@ -98,7 +102,7 @@ def _tiles(*, authenticated: bool) -> dict[str, Any]:
},
{
"key": "unknown",
"label": "Noch nicht geprueft",
"label": "Noch nicht geprüft",
"kind": "warning",
"tiles": [tile for tile in tiles if tile["state"] == "unknown"],
},
+32 -24
View File
@@ -60,7 +60,7 @@ def _form_values() -> dict[str, Any]:
@bp.get("/")
@permission_required("devices.view")
@permission_required("devices.read")
def overview():
conn = db()
devices = inventory.list_devices(conn)
@@ -100,7 +100,7 @@ def _credential_from_form(conn: Any) -> int | None:
)
name = (request.form.get("new_credential_name") or "").strip()
if not name:
raise inventory.ValidationError("Fuer neue Zugangsdaten wird eine Bezeichnung gebraucht.")
raise inventory.ValidationError("Für neue Zugangsdaten wird eine Bezeichnung gebraucht.")
return inventory.create_credential(
conn,
core().keystore,
@@ -108,7 +108,7 @@ def _credential_from_form(conn: Any) -> int | None:
username=(request.form.get("new_credential_username") or "").strip(),
secret=request.form.get("new_credential_secret") or "",
category=request.form.get("new_credential_category", "linux"),
description="Beim Anlegen eines Geraets erfasst.",
description="Beim Anlegen eines Geräts erfasst.",
actor=current_user.username,
)
@@ -130,7 +130,7 @@ def create():
f"MAC {request.form.get('mac')}, IP {request.form.get('ip')}",
severity="notice",
)
flash("Geraet angelegt.", "success")
flash("Gerät angelegt.", "success")
return redirect(url_for("devices.overview", highlight=device_id))
except inventory.ValidationError as exc:
flash(str(exc), "danger")
@@ -138,7 +138,7 @@ def create():
@bp.post("/<int:device_id>")
@permission_required("devices.edit")
@permission_required("devices.write")
def update(device_id: int):
try:
with transaction() as conn:
@@ -155,14 +155,14 @@ def update(device_id: int):
"; ".join(changes),
severity="notice",
)
flash("Aenderungen gespeichert." if changes else "Keine Aenderungen.", "success" if changes else "info")
flash("Änderungen gespeichert." if changes else "Keine Änderungen.", "success" if changes else "info")
except inventory.ValidationError as exc:
flash(str(exc), "danger")
return redirect(url_for("devices.overview"))
@bp.post("/<int:device_id>/active")
@permission_required("devices.edit")
@permission_required("devices.write")
def toggle_active(device_id: int):
active = request.form.get("active") == "1"
with transaction() as conn:
@@ -176,7 +176,7 @@ def toggle_active(device_id: int):
str(device["name"]),
severity="notice",
)
flash("Geraet aktiviert." if active else "Geraet deaktiviert.", "success")
flash("Gerät aktiviert." if active else "Gerät deaktiviert.", "success")
return redirect(request.referrer or url_for("devices.overview"))
@@ -189,12 +189,17 @@ def delete(device_id: int):
abort(404)
inventory.delete_device(conn, device_id)
_audit(conn, "device.deleted", str(device["name"]), severity="warning")
flash("Geraet in den Papierkorb verschoben.", "success")
flash("Gerät in den Papierkorb verschoben.", "success")
return redirect(url_for("devices.overview"))
@bp.post("/<int:device_id>/restart")
@permission_required("devices.execute")
# Die Seite darf sehen, wer Clients sehen darf; welcher Weg offensteht,
# entscheidet das Recht des Weges -- geprueft in restart.resolve() ueber
# "darf". Ein Weg, den der Benutzer nicht ausloesen darf, existiert fuer ihn
# nicht, und die Antwort ist dieselbe wie bei einem technisch unmoeglichen:
# "dieser Weg steht nicht zur Verfuegung".
@permission_required("devices.read")
def restart_device(device_id: int):
"""Startet ein Geraet neu -- ueber den Weg, der dafuer gewaehlt wurde.
@@ -214,19 +219,22 @@ def restart_device(device_id: int):
dict(device),
(request.form.get("method") or "").strip(),
maintenance_active=maintenance_active,
darf=current_user.has,
)
if method is None:
options = restart.available(dict(device), maintenance_active=maintenance_active)
options = restart.available(
dict(device), maintenance_active=maintenance_active, darf=current_user.has
)
if options:
flash(
"Der gewaehlte Weg steht fuer dieses Geraet nicht zur Verfuegung. "
"Moeglich waere: " + ", ".join(entry.label for entry in options),
"Der gewählte Weg steht für dieses Gerät nicht zur Verfügung. "
"Möglich wäre: " + ", ".join(entry.label for entry in options),
"warning",
)
else:
flash(
f"Fuer {device['name']} ist kein Neustart moeglich: es fehlen Switch und Port "
"fuer den PoE-Weg und passende Zugangsdaten fuer SSH oder RPC.",
f"Für {device['name']} ist kein Neustart möglich: es fehlen Switch und Port "
"für den PoE-Weg und passende Zugangsdaten für SSH oder RPC.",
"warning",
)
return redirect(request.referrer or url_for("devices.overview"))
@@ -262,7 +270,7 @@ def _restart_over_poe(extension: Any, conn: Any, device: Any): # type: ignore[n
return redirect(request.referrer or url_for("devices.overview"))
flash(
f"PoE-Neustart fuer {device['name']} durchgefuehrt."
f"PoE-Neustart für {device['name']} durchgeführt."
if outcome["ok"]
else f"PoE-Neustart fehlgeschlagen: {outcome['message']}",
"success" if outcome["ok"] else "danger",
@@ -319,14 +327,14 @@ def _restart_as_job(extension: Any, conn: Any, device: Any, method: Any): # typ
method=method.key,
)
flash(
f"{method.label} fuer {device['name']} gestartet. Der Verlauf steht unter Wartung.",
f"{method.label} für {device['name']} gestartet. Der Verlauf steht unter Wartung.",
"success",
)
return redirect(request.referrer or url_for("devices.overview"))
@bp.get("/<int:device_id>")
@permission_required("devices.view")
@permission_required("devices.read")
def detail(device_id: int):
conn = db()
device = inventory.get_device(conn, device_id)
@@ -361,7 +369,7 @@ def detail(device_id: int):
@bp.post("/<int:device_id>/host-key/probe")
@permission_required("devices.edit")
@permission_required("devices.write")
def probe_host_key(device_id: int):
"""Liest den Host-Schluessel des Clients, ohne sich anzumelden.
@@ -391,7 +399,7 @@ def probe_host_key(device_id: int):
@bp.post("/<int:device_id>/host-key/trust")
@permission_required("devices.edit")
@permission_required("devices.write")
@reauth_required
def trust_host_key(device_id: int):
conn = db()
@@ -401,7 +409,7 @@ def trust_host_key(device_id: int):
key_type = (request.form.get("key_type") or "").strip()
fingerprint = (request.form.get("fingerprint") or "").strip()
if not key_type or not ssh.valid_fingerprint(fingerprint):
flash("Es wurde kein gueltiger Fingerprint uebergeben.", "danger")
flash("Es wurde kein gültiger Fingerprint übergeben.", "danger")
return redirect(url_for("devices.detail", device_id=device_id))
with transaction():
@@ -420,12 +428,12 @@ def trust_host_key(device_id: int):
f"{key_type} {fingerprint}",
severity="notice",
)
flash("Host-Schluessel freigegeben.", "success")
flash("Host-Schlüssel freigegeben.", "success")
return redirect(url_for("devices.detail", device_id=device_id))
@bp.post("/<int:device_id>/host-key/forget")
@permission_required("devices.edit")
@permission_required("devices.write")
def forget_host_key(device_id: int):
conn = db()
device = inventory.get_device(conn, device_id)
@@ -434,5 +442,5 @@ def forget_host_key(device_id: int):
with transaction():
ssh.forget_key(conn, str(device["ip"]), int(device["ssh_port"] or 22))
_audit(conn, "device.host_key_forgotten", str(device["name"]), severity="warning")
flash("Gespeicherte Host-Schluessel entfernt.", "info")
flash("Gespeicherte Host-Schlüssel entfernt.", "info")
return redirect(url_for("devices.detail", device_id=device_id))
+60 -25
View File
@@ -21,6 +21,7 @@ from tesm_core.db import Database
from tesm_core.extension import core, db, transaction
from ..services import kea
from ..permissions import DHCP_PAGE
bp = Blueprint("dhcp", __name__, url_prefix="/dhcp")
@@ -53,7 +54,7 @@ def _settings_values() -> dict[str, Any]:
@bp.get("/")
@permission_required("dhcp.view", "dhcp.edit", "dhcp.execute", mode="any")
@permission_required(*DHCP_PAGE, mode="any")
def overview():
extension = core()
conn = db()
@@ -106,7 +107,7 @@ def overview():
@bp.post("/settings")
@permission_required("dhcp.edit")
@permission_required("dhcp_subnets.write")
def save_settings():
extension = core()
conn = db()
@@ -118,12 +119,12 @@ def save_settings():
with transaction():
changed = extension.settings.set_many(conn, values, actor=current_user.username)
_audit("dhcp.settings_saved", detail=", ".join(changed), severity="notice")
flash("Einstellungen gespeichert." if changed else "Keine Aenderungen.", "success" if changed else "info")
flash("Einstellungen gespeichert." if changed else "Keine Änderungen.", "success" if changed else "info")
return _write_and_redirect()
@bp.post("/subnet")
@permission_required("dhcp.edit")
@permission_required("dhcp_subnets.create")
def add_subnet():
extension = core()
conn = db()
@@ -159,7 +160,7 @@ def add_subnet():
@bp.post("/subnet/<int:subnet_id>")
@permission_required("dhcp.edit")
@permission_required("dhcp_subnets.write")
def update_subnet(subnet_id: int):
extension = core()
conn = db()
@@ -173,6 +174,9 @@ def update_subnet(subnet_id: int):
flash(problem, "danger")
return redirect(url_for("dhcp.overview"))
# Vor der Aenderung lesen -- danach ist der alte Stand weg, und "Subnetz
# gespeichert" allein sagt nicht, was vorher eingestellt war.
vorher = Database.one(conn, "SELECT * FROM dhcp_subnets WHERE id=?", (subnet_id,))
with transaction():
conn.execute(
"UPDATE dhcp_subnets SET interface=?, range_start=?, range_end=?, gateway=?, dns=?, "
@@ -189,13 +193,32 @@ def update_subnet(subnet_id: int):
subnet_id,
),
)
_audit("dhcp.subnet_updated", str(subnet_id), severity="notice")
nachher = Database.one(conn, "SELECT * FROM dhcp_subnets WHERE id=?", (subnet_id,))
_audit(
"dhcp.subnet_updated",
f"{interface} {start}-{end}",
audit.diff(
vorher,
nachher,
felder=(
("interface", "Schnittstelle"),
("range_start", "Von"),
("range_end", "Bis"),
("gateway", "Gateway"),
("dns", "DNS"),
("comment", "Kommentar"),
("enabled", "Aktiv"),
),
)
or "keine inhaltliche Änderung",
severity="notice",
)
flash("Subnetz gespeichert.", "success")
return _write_and_redirect()
@bp.post("/subnet/<int:subnet_id>/delete")
@permission_required("dhcp.edit")
@permission_required("dhcp_subnets.delete")
def delete_subnet(subnet_id: int):
with transaction() as conn:
conn.execute("DELETE FROM dhcp_subnets WHERE id=?", (subnet_id,))
@@ -210,7 +233,7 @@ def delete_subnet(subnet_id: int):
@bp.post("/option/value")
@permission_required("dhcp.edit")
@permission_required("dhcp_options.write")
def set_option_value():
conn = db()
option_id = int(request.form.get("option_id") or 0)
@@ -249,7 +272,7 @@ def _device_option_values(conn) -> dict[int, list[dict[str, Any]]]: # type: ign
@bp.post("/option/device")
@permission_required("dhcp.edit")
@permission_required("dhcp_options.write")
def set_device_option_value():
"""Setzt eine Option fuer ein einzelnes Geraet.
@@ -289,7 +312,7 @@ def set_device_option_value():
value or "(geleert)",
)
flash(
f"Option {option['name']} fuer {device['name']} "
f"Option {option['name']} für {device['name']} "
f"{'gespeichert' if value else 'entfernt'}.",
"success",
)
@@ -297,7 +320,7 @@ def set_device_option_value():
@bp.post("/option/new")
@permission_required("dhcp.edit")
@permission_required("dhcp_options.write")
def add_custom_option():
conn = db()
try:
@@ -328,7 +351,7 @@ def add_custom_option():
@bp.post("/option/<int:option_id>/delete")
@permission_required("dhcp.edit")
@permission_required("dhcp_options.write")
def delete_custom_option(option_id: int):
conn = db()
option = Database.one(conn, "SELECT * FROM dhcp_options WHERE id=?", (option_id,))
@@ -336,7 +359,7 @@ def delete_custom_option(option_id: int):
abort(404)
if int(option["is_standard"] or 0):
flash(
"Standardoptionen koennen nicht geloescht werden -- nur ihr Wert lasst sich leeren.",
"Standardoptionen können nicht gelöscht werden – nur ihr Wert lässt sich leeren.",
"danger",
)
return redirect(url_for("dhcp.overview"))
@@ -353,13 +376,13 @@ def delete_custom_option(option_id: int):
@bp.post("/reservation")
@permission_required("dhcp.edit")
@permission_required("dhcp_reservations.create")
def add_reservation():
conn = db()
mac = kea.normalize_mac(request.form.get("mac", ""))
ip = (request.form.get("ip") or "").strip()
if not mac:
flash("Die MAC-Adresse ist ungueltig.", "danger")
flash("Die MAC-Adresse ist ungültig.", "danger")
return redirect(url_for("dhcp.overview"))
# Eine Reservierung ausserhalb aller eingerichteten Bereiche liefert Kea nie
@@ -367,7 +390,7 @@ def add_reservation():
# schlechteste der drei Moeglichkeiten -- deshalb hier ablehnen.
if not Database.value(conn, "SELECT COUNT(*) FROM dhcp_subnets WHERE enabled=1"):
flash(
"Es ist noch kein Bereich eingerichtet. Legen Sie zuerst ein Subnetz an -- "
"Es ist noch kein Bereich eingerichtet. Legen Sie zuerst ein Subnetz an – "
"ohne eines wird keine Reservierung ausgeliefert.",
"danger",
)
@@ -380,7 +403,7 @@ def add_reservation():
# keine Reservierung mehr moeglich. Stattdessen benennen, was ungeprueft
# bleibt.
flash(
"Der Bereich konnte nicht geprueft werden -- ohne Systemhelfer ist das Netz "
"Der Bereich konnte nicht geprüft werden – ohne Systemhelfer ist das Netz "
"dieses Servers nicht feststellbar.",
"warning",
)
@@ -390,11 +413,12 @@ def add_reservation():
bereiche = ", ".join(str(netz) for netz in netze)
flash(
f"{ip or 'Diese Adresse'} liegt in keinem eingerichteten Bereich "
f"({bereiche}). Die Reservierung waere ohne Wirkung.",
f"({bereiche}). Die Reservierung wäre ohne Wirkung.",
"danger",
)
return redirect(url_for("dhcp.overview"))
vorher = Database.one(conn, "SELECT * FROM dhcp_reservations WHERE mac=?", (mac,))
with transaction():
conn.execute(
"INSERT INTO dhcp_reservations (mac, ip, hostname, comment, created_at) "
@@ -407,13 +431,24 @@ def add_reservation():
(request.form.get("comment") or "").strip(),
),
)
_audit("dhcp.reservation_saved", f"{mac} -> {ip}", severity="notice")
nachher = Database.one(conn, "SELECT * FROM dhcp_reservations WHERE mac=?", (mac,))
_audit(
"dhcp.reservation_saved",
mac,
audit.diff(
vorher,
nachher,
felder=(("ip", "IP"), ("hostname", "Hostname"), ("comment", "Kommentar")),
)
or f"neu angelegt: {ip}",
severity="notice",
)
flash("Reservierung gespeichert.", "success")
return _write_and_redirect()
@bp.post("/reservation/<int:reservation_id>/delete")
@permission_required("dhcp.edit")
@permission_required("dhcp_reservations.delete")
def delete_reservation(reservation_id: int):
with transaction() as conn:
conn.execute("DELETE FROM dhcp_reservations WHERE id=?", (reservation_id,))
@@ -437,14 +472,14 @@ def _write_config() -> dict[str, Any]:
sysops = extension.sysops
conn = db()
if sysops is None or not sysops.available:
return {"ok": False, "message": "Systemhelfer nicht verfuegbar."}
return {"ok": False, "message": "Systemhelfer nicht verfügbar."}
networks = kea.detect_networks(sysops)
config, warnings = kea.render_config(conn, networks=networks, settings=_settings_values())
if not config["Dhcp4"]["subnet4"]:
return {
"ok": False,
"message": "Es ist kein gueltiges Subnetz konfiguriert -- die Datei wurde nicht geschrieben.",
"message": "Es ist kein gültiges Subnetz konfiguriert – die Datei wurde nicht geschrieben.",
"warnings": warnings,
}
result = sysops.write_kea_config(kea.config_to_text(config))
@@ -481,13 +516,13 @@ def _write_and_redirect():
@bp.post("/write")
@permission_required("dhcp.edit")
@permission_required("dhcp_config.execute")
def write_config():
return _write_and_redirect()
@bp.post("/service/<action>")
@permission_required("dhcp.execute")
@permission_required("dhcp_service.execute")
def service_action(action: str):
allowed = {"install", "start", "stop"}
if action not in allowed:
@@ -495,7 +530,7 @@ def service_action(action: str):
extension = core()
sysops = extension.sysops
if sysops is None or not sysops.available:
flash("Systemaktionen sind in dieser Umgebung nicht verfuegbar.", "warning")
flash("Systemaktionen sind in dieser Umgebung nicht verfügbar.", "warning")
return redirect(url_for("dhcp.overview"))
if action == "install":
+166 -27
View File
@@ -2,7 +2,10 @@
from __future__ import annotations
import hashlib
import io
import json
from datetime import datetime, timezone
from flask import (
Blueprint,
@@ -47,8 +50,33 @@ def _audit(action: str, target: str, detail: str = "", severity: str = "info") -
)
def _unterschriften(roh: str) -> list[str]:
"""Die Namen aus dem Unterschriftsfeld -- Text, keine Struktur.
Was hier ankommt, hat der Browser geschickt und damit der Mensch davor.
Es wird protokolliert, nicht geglaubt: laenge begrenzt, Zeilenumbrueche
raus, mehr passiert damit nicht.
"""
namen: list[str] = []
try:
eintraege = json.loads(roh) if roh else []
except ValueError:
return []
if not isinstance(eintraege, list):
return []
for eintrag in eintraege[:20]:
name = str(eintrag if isinstance(eintrag, str) else eintrag.get("name", ""))
name = " ".join(name.split())[:120]
if name:
namen.append(name)
return namen
def _mount_or_404(token: str) -> service.Mount:
mounts = service.active_mounts(db(), current_user.id)
conn = db()
mounts = service.doppelte_zusammenfassen(
conn, service.active_mounts(conn, current_user.id), service.aktuelle_sitzung()
)
for mount in mounts:
if mount.token == token:
return mount
@@ -56,10 +84,12 @@ def _mount_or_404(token: str) -> service.Mount:
@bp.get("/")
@permission_required("fileshare.view")
@permission_required("fileshare.read")
def browse():
conn = db()
mounts = service.active_mounts(conn, current_user.id)
mounts = service.doppelte_zusammenfassen(
conn, service.active_mounts(conn, current_user.id), service.aktuelle_sitzung()
)
token = request.args.get("share") or (mounts[0].token if mounts else "")
relative = request.args.get("path") or ""
listing = None
@@ -82,6 +112,10 @@ def browse():
max_upload_mb=uploads.limit_mb(conn),
# Vorschlagsliste fuer "Ausgefuellt speichern": wohin darf es gehen?
verzeichnisse=(service.all_directories(mount) if listing else []),
signature_witness=bool(core().settings.get(conn, "signature_witness_enabled")),
# Die Uhr des Servers. Das Datum unter einer Unterschrift soll nicht
# davon abhaengen, wie das Tablet gestellt ist.
serverzeit=datetime.now(timezone.utc).astimezone().isoformat(timespec="seconds"),
)
@@ -114,7 +148,7 @@ def download(token: str):
@bp.get("/<token>/preview")
@permission_required("fileshare.view")
@permission_required("fileshare.read")
def preview(token: str):
mount = _mount_or_404(token)
relative = request.args.get("path") or ""
@@ -159,7 +193,7 @@ def upload(token: str):
relative = request.form.get("path") or ""
files = request.files.getlist("files")
if not files:
flash("Keine Datei ausgewaehlt.", "danger")
flash("Keine Datei ausgewählt.", "danger")
return redirect(url_for("fileshare.browse", share=token, path=relative))
limit = uploads.limit_bytes(db())
@@ -172,7 +206,7 @@ def upload(token: str):
name = service.safe_filename(upload_file.filename)
data = upload_file.stream.read(limit + 1)
if len(data) > limit:
flash(f"{name}: zu gross (Grenze {limit // 1024 // 1024} MB).", "danger")
flash(f"{name}: zu groß (Grenze {limit // 1024 // 1024} MB).", "danger")
continue
(target_dir / name).write_bytes(data)
stored += 1
@@ -186,6 +220,37 @@ def upload(token: str):
return redirect(url_for("fileshare.browse", share=token, path=relative))
@bp.get("/<token>/signature")
@permission_required("fileshare.read")
def signature_state(token: str):
"""Passt die Datei noch zu ihrem Eintrag im Aenderungsprotokoll?
Die Vorschau fragt das beim Oeffnen. Eine unterschriebene Fassung, die
seither veraendert wurde, sieht man einer PDF sonst nicht an -- und genau
das ist die Frage, die man sich vor einer Unterschrift stellt.
"""
mount = _mount_or_404(token)
try:
return service.signaturstand(db(), mount, request.args.get("path") or "")
except service.FileshareError as exc:
return {"error": str(exc)}, 400
@bp.get("/<token>/folders")
@permission_required("fileshare.read")
def folders(token: str):
"""Die Ordner **dieser** Freigabe als Vorschlagsliste.
Gebraucht, seit das Speichern in eine andere Freigabe gehen darf: die
Vorschlaege muessen der gewaehlten Freigabe folgen. Alle Listen beim
Seitenaufbau mitzuschicken waere die Alternative gewesen -- bei vier
eingebundenen Freigaben mit je ein paar hundert Ordnern ist das eine
viertel Megabyte, die fast nie gebraucht wird.
"""
mount = _mount_or_404(token)
return {"folders": service.all_directories(mount)}
@bp.post("/<token>/form")
@permission_required("fileshare_pdf.create")
def save_form(token: str):
@@ -196,15 +261,34 @@ def save_form(token: str):
die alte Datei danach loeschen -- das ist eine bewusste Handlung.
"""
mount = _mount_or_404(token)
# Das Ziel darf eine andere Freigabe sein: die Vorlage liegt oft in einer
# Vorlagenfreigabe, die ausgefuellte Fassung gehoert in die Ablage des
# Bereichs. Geprueft wird es wie jede andere Einbindung -- nur eine, die
# diesem Benutzer gerade gehoert, kommt in Frage.
ziel_token = (request.form.get("ziel") or "").strip()
ziel_mount = _mount_or_404(ziel_token) if ziel_token else mount
relative = request.form.get("path") or ""
upload_file = request.files.get("datei")
if upload_file is None or not upload_file.filename:
return {"error": "Es kam keine Datei an."}, 400
# Ein unterschriebenes Dokument ist abgeschlossen. Es als Vorlage fuer eine
# neue Fassung zu benutzen hiesse, eine Unterschrift unter einen anderen
# Text zu stellen -- die Oberflaeche blendet das aus, hier wird es
# abgewiesen.
if service.signaturstand(db(), mount, relative).get("status") in {
"unveraendert",
"veraendert",
}:
return {
"error": "Dieses Dokument ist unterschrieben und damit abgeschlossen. "
"Legen Sie eine neue Fassung aus der ursprünglichen Vorlage an."
}, 409
grenze = uploads.limit_bytes(db())
daten = upload_file.stream.read(grenze + 1)
if len(daten) > grenze:
return {"error": f"Zu gross (Grenze {grenze // 1024 // 1024} MB)."}, 413
return {"error": f"Zu groß (Grenze {grenze // 1024 // 1024} MB)."}, 413
if not daten.startswith(b"%PDF-"):
# Diese Route nimmt nur, was pdf.js hier ablegt. Ein anderer Inhalt
# waere ein Umweg, um beliebige Dateien in die Freigabe zu bekommen.
@@ -215,10 +299,10 @@ def save_form(token: str):
# Formularfelder, ist sie weiter veraenderbar -- dafuer braucht es
# "PDF-Formulare: Bearbeiten". Ein umgebogenes Feld im Browser hilft damit
# niemandem weiter.
if service.hat_formularfelder(daten) and not current_user.has("fileshare_pdf.edit"):
if service.hat_formularfelder(daten) and not current_user.has("fileshare_pdf.write"):
return {
"error": "Sie duerfen ausgefuellte Formulare nur abgeschlossen speichern "
"(Felder gesperrt). Bitte im Auswahlfeld 'Abgeschlossen' waehlen."
"error": "Sie dürfen ausgefüllte Formulare nur abgeschlossen speichern "
"(Felder gesperrt). Bitte im Auswahlfeld 'Abgeschlossen' wählen."
}, 403
# Wohin und unter welchem Namen -- beides darf der Benutzer bestimmen.
@@ -228,15 +312,22 @@ def save_form(token: str):
try:
original = service.resolve_path(mount, relative)
# Ohne Namen landet die Datei neben dem Original -- das geht nur in
# derselben Freigabe.
if ziel_mount.token != mount.token and not wunschname:
return {"error": "Für eine andere Freigabe braucht es einen Dateinamen."}, 400
# Mit Namen entscheidet das Ordnerfeld -- leer heisst Wurzelverzeichnis,
# so wie es im Feld steht. Ohne Namen (Aufruf ohne Oberflaeche) bleibt
# es beim Ordner des Originals.
if wunschname:
zielordner = service.resolve_path(mount, ordner)
zielordner = service.resolve_path(ziel_mount, ordner)
else:
zielordner = service.resolve_path(mount, ordner) if ordner else original.parent
if not zielordner.is_dir():
return {"error": f"Den Ordner '{ordner}' gibt es in dieser Freigabe nicht."}, 400
return {
"error": f"Den Ordner '{ordner}' gibt es in der Freigabe "
f"'{ziel_mount.label}' nicht."
}, 400
if wunschname:
# Eingegeben wird der Name ohne Endung; die kommt von hier. Wer
# sie mittippt, bekommt sie nicht doppelt -- und wer eine falsche
@@ -247,8 +338,8 @@ def save_form(token: str):
ziel = zielordner / name
if ziel.exists() and not ersetzen:
return {
"error": f"'{name}' gibt es dort schon. Anderen Namen waehlen oder "
"'Vorhandene ersetzen' ankreuzen."
"error": f"In '{ziel_mount.label}' gibt es '{name}' schon. Anderen "
"Namen wählen oder 'Vorhandene ersetzen' ankreuzen."
}, 409
else:
# Ohne Angabe wie bisher: neben das Original, ohne etwas zu ueberschreiben.
@@ -257,9 +348,57 @@ def save_form(token: str):
except service.FileshareError as exc:
return {"error": str(exc)}, 400
wohin = ziel.relative_to(mount.path.resolve()).as_posix()
_audit("fileshare.form_saved", f"{mount.label}:{relative}", wohin, severity="notice")
return {"message": f"Gespeichert als {wohin}.", "path": wohin}
wohin = ziel.relative_to(ziel_mount.path.resolve()).as_posix()
pruefsumme = hashlib.sha256(daten).hexdigest()
unterschriften = _unterschriften(request.form.get("unterschriften") or "")
# Unterschreiben ist kein Aendern: am Ende steht eine Fassung, die niemand
# mehr bearbeiten kann, mit Namen im Dokument und Pruefsumme im Protokoll.
# Wer Dateien ablegen darf, darf das nicht automatisch.
if unterschriften and not current_user.has("fileshare_signature.execute"):
return {"error": "Zum Unterschreiben fehlt die Berechtigung."}, 403
# Zwei Angaben, die man nicht verwechseln darf, und deshalb stehen beide
# da: der Name **in** der Unterschrift ist eine Angabe des
# Unterschreibenden -- wie auf Papier. Wer die Datei abgelegt hat, steht
# ohnehin als Handelnder in der Zeile und ist belegt.
# Zwei Zeilen: oben, was ein Mensch liest; unten die Pruefsumme, die
# niemand liest, aber jeder vergleichen koennen muss. In einer einzigen
# Zeile drueckte der Hash den Rest aus der Spalte.
kopf = f"{'Signiert' if unterschriften else 'Gespeichert'}: {wohin}"
if unterschriften:
kopf += f" von: {', '.join(unterschriften)}"
beschreibung = f"{kopf}{chr(10)}sha256={pruefsumme}"
_audit(
"fileshare.form_signed" if unterschriften else "fileshare.form_saved",
f"{mount.label}:{relative}",
beschreibung,
severity="notice",
)
if unterschriften:
# Zusaetzlich ins Signaturverzeichnis: das Protokoll wird irgendwann
# archiviert, die Frage "ist diese Datei noch die unterschriebene?"
# stellt sich aber noch Jahre spaeter. Und mit fsync -- die Datei liegt
# schon auf der Freigabe; ein Stromausfall soll nicht den Nachweis
# dazu verschlucken.
verbindung = db()
with core().database.dauerhaft(verbindung), transaction():
service.signatur_merken(
verbindung,
sha256=pruefsumme,
label=ziel_mount.label,
pfad=wohin,
actor=current_user.username,
namen=unterschriften,
)
# Zweites Exemplar ausserhalb der Datenbank.
service.signatur_journalisieren(
sha256=pruefsumme,
label=ziel_mount.label,
pfad=wohin,
actor=current_user.username,
namen=unterschriften,
)
return {"message": f"Gespeichert als {wohin}.", "path": wohin, "sha256": pruefsumme}
@bp.post("/<token>/folder")
@@ -278,7 +417,7 @@ def make_directory(token: str):
@bp.post("/<token>/rename")
@permission_required("fileshare.edit")
@permission_required("fileshare.write")
def rename(token: str):
mount = _mount_or_404(token)
relative = request.form.get("path") or ""
@@ -307,18 +446,18 @@ def delete(token: str):
except (service.FileshareError, OSError) as exc:
flash(str(exc), "danger")
if removed:
flash(f"{removed} Eintrag/Eintraege geloescht.", "success")
flash(f"{removed} Eintrag/Einträge gelöscht.", "success")
return redirect(url_for("fileshare.browse", share=token, path=parent))
@bp.post("/<token>/release")
@permission_required("fileshare.view")
@permission_required("fileshare.read")
def release(token: str):
mount = _mount_or_404(token)
with transaction() as conn:
service.release_mount(conn, mount.id)
_audit("fileshare.released", mount.label)
flash("Einbindung geloest.", "success")
flash("Einbindung gelöst.", "success")
return redirect(url_for("fileshare.browse"))
@@ -328,7 +467,7 @@ def release(token: str):
@bp.get("/mappings")
@permission_required("fileshare.edit")
@permission_required("fileshare_mappings.read")
def mappings():
from tesm_core.auth import directory
@@ -342,7 +481,7 @@ def mappings():
@bp.post("/mappings")
@permission_required("fileshare.edit")
@permission_required("fileshare_mappings.create")
def mapping_add():
try:
with transaction() as conn:
@@ -372,7 +511,7 @@ def mapping_add():
@bp.post("/mappings/<int:mapping_id>")
@permission_required("fileshare.edit")
@permission_required("fileshare_mappings.write")
def mapping_update(mapping_id: int):
try:
with transaction() as conn:
@@ -392,17 +531,17 @@ def mapping_update(mapping_id: int):
_audit(
"fileshare.mapping_updated",
str((nachher or {}).get("label") or request.form.get("label", "")),
service.mapping_changes(vorher, nachher) or "keine inhaltliche Aenderung",
service.mapping_changes(vorher, nachher) or "keine inhaltliche Änderung",
severity="notice",
)
flash("Zuordnung geaendert.", "success")
flash("Zuordnung geändert.", "success")
except service.FileshareError as exc:
flash(str(exc), "danger")
return redirect(url_for("fileshare.mappings"))
@bp.post("/mappings/<int:mapping_id>/delete")
@permission_required("fileshare.edit")
@permission_required("fileshare_mappings.delete")
def mapping_delete(mapping_id: int):
with transaction() as conn:
entfernt = service.get_mapping(conn, mapping_id)
+17 -13
View File
@@ -36,8 +36,12 @@ bp = Blueprint("hostkeys", __name__, url_prefix="/monitoring/host-keys")
KIND_DEVICE = "client"
KIND_SWITCH = "switch"
#: Welches Recht welche Art von Ziel freigibt.
EDIT_RIGHT = {KIND_DEVICE: "devices.edit", KIND_SWITCH: "switches.edit"}
#: Freigeben ist eine eigene Zeile: es war das Recht fuer Stammdaten
#: ("Gerät ändern"), obwohl es der Vorgang ist, mit dem man bestaetigt, dass
#: ein Geraet wirklich das ist, fuer das es sich ausgibt. Die Art des Ziels
#: entscheidet nicht mehr mit -- Schluessel ist Schluessel.
FREIGABE_RECHT = "hostkeys.execute"
EDIT_RIGHT = {KIND_DEVICE: FREIGABE_RECHT, KIND_SWITCH: FREIGABE_RECHT}
def _audit(action: str, target: str, detail: str = "", severity: str = "info") -> None:
@@ -112,7 +116,7 @@ def _orphans(conn: Any, targets: list[dict[str, Any]]) -> list[dict[str, Any]]:
@bp.get("/")
@permission_required("devices.view", "switches.view", mode="any")
@permission_required("hostkeys.read")
def overview():
conn = db()
targets = _targets(conn)
@@ -143,7 +147,7 @@ def _require(kind: str) -> None:
@bp.post("/<kind>/<int:target_id>/probe")
@permission_required("devices.view", "switches.view", mode="any")
@permission_required("hostkeys.read")
def probe(kind: str, target_id: int):
conn = db()
_require(kind)
@@ -170,7 +174,7 @@ def probe(kind: str, target_id: int):
@bp.post("/<kind>/<int:target_id>/trust")
@permission_required("devices.view", "switches.view", mode="any")
@permission_required("hostkeys.read")
@reauth_required
def trust(kind: str, target_id: int):
conn = db()
@@ -181,7 +185,7 @@ def trust(kind: str, target_id: int):
key_type = (request.form.get("key_type") or "").strip()
fingerprint = (request.form.get("fingerprint") or "").strip()
if not key_type or not ssh.valid_fingerprint(fingerprint):
flash("Es wurde kein gueltiger Fingerprint uebergeben.", "danger")
flash("Es wurde kein gültiger Fingerprint übergeben.", "danger")
return redirect(url_for("hostkeys.overview"))
with transaction():
@@ -199,12 +203,12 @@ def trust(kind: str, target_id: int):
f"{key_type} {fingerprint}",
severity="notice",
)
flash(f"Host-Schluessel von {target['label']} freigegeben.", "success")
flash(f"Host-Schlüssel von {target['label']} freigegeben.", "success")
return redirect(url_for("hostkeys.overview"))
@bp.post("/<kind>/<int:target_id>/forget")
@permission_required("devices.view", "switches.view", mode="any")
@permission_required("hostkeys.read")
def forget(kind: str, target_id: int):
conn = db()
_require(kind)
@@ -218,12 +222,12 @@ def forget(kind: str, target_id: int):
target["label"],
severity="warning",
)
flash(f"Gespeicherte Schluessel von {target['label']} entfernt.", "info")
flash(f"Gespeicherte Schlüssel von {target['label']} entfernt.", "info")
return redirect(url_for("hostkeys.overview"))
@bp.post("/orphaned/forget")
@permission_required("devices.edit", "switches.edit", mode="any")
@permission_required("hostkeys.execute")
def forget_orphan():
"""Entfernt eine Freigabe, zu der es kein Ziel mehr gibt."""
host = (request.form.get("host") or "").strip()
@@ -232,18 +236,18 @@ def forget_orphan():
except ValueError:
port = 0
if not host or not 1 <= port <= 65535:
flash("Ungueltiges Ziel.", "danger")
flash("Ungültiges Ziel.", "danger")
return redirect(url_for("hostkeys.overview"))
conn = db()
if (host, port) in {(row["host"], row["port"]) for row in _targets(conn)}:
# Ein Ziel, das es noch gibt, wird ueber seine eigene Zeile verworfen --
# sonst umginge dieser Weg die Rechtepruefung je Objektart.
flash("Zu diesem Eintrag gibt es ein Ziel -- bitte dort verwerfen.", "warning")
flash("Zu diesem Eintrag gibt es ein Ziel – bitte dort verwerfen.", "warning")
return redirect(url_for("hostkeys.overview"))
with transaction():
ssh.forget_key(conn, host, port)
_audit("host_key.orphan_forgotten", f"{host}:{port}", severity="warning")
flash(f"Verwaiste Freigabe fuer {host}:{port} entfernt.", "info")
flash(f"Verwaiste Freigabe für {host}:{port} entfernt.", "info")
return redirect(url_for("hostkeys.overview"))
+13 -13
View File
@@ -43,7 +43,7 @@ def _audit(action: str, target: str = "", detail: str = "", severity: str = "inf
@bp.get("/")
@permission_required("settings_license.view")
@permission_required("settings_license.read")
def overview():
extension = core()
conn = db()
@@ -70,7 +70,7 @@ def overview():
@bp.post("/install")
@permission_required("settings_license.edit")
@permission_required("settings_license.write")
def upload():
extension = core()
manager = extension.license
@@ -80,11 +80,11 @@ def upload():
upload_file = request.files.get("license_file")
if upload_file is None or not upload_file.filename:
flash("Keine Datei ausgewaehlt.", "danger")
flash("Keine Datei ausgewählt.", "danger")
return redirect(url_for("license.overview"))
raw = upload_file.stream.read(MAX_UPLOAD_BYTES + 1)
if len(raw) > MAX_UPLOAD_BYTES:
flash("Die Datei ist zu gross fuer eine Lizenzdatei.", "danger")
flash("Die Datei ist zu groß für eine Lizenzdatei.", "danger")
return redirect(url_for("license.overview"))
allow_new_issuer = request.form.get("allow_new_issuer") == "1" and current_user.is_admin
@@ -104,20 +104,20 @@ def upload():
if state.status and state.status.role != "customer":
flash(
f"Achtung: diese Lizenz hat die Rolle {state.status.role!r}. "
"In einer TESM-Kundeninstanz ist das ungewoehnlich.",
"In einer TESM-Kundeninstanz ist das ungewöhnlich.",
"warning",
)
return redirect(url_for("license.overview"))
@bp.post("/activate")
@permission_required("settings_license.edit")
@permission_required("settings_license.write")
def activate():
return _handshake("activate")
@bp.post("/deactivate")
@permission_required("settings_license.edit")
@permission_required("settings_license.write")
@reauth_required
def deactivate():
"""Gibt die Lizenz frei, damit sie auf einer anderen Maschine genutzt werden kann.
@@ -129,7 +129,7 @@ def deactivate():
@bp.post("/heartbeat")
@permission_required("settings_license.edit")
@permission_required("settings_license.write")
def heartbeat():
return _handshake("heartbeat")
@@ -159,7 +159,7 @@ def _handshake(action: str):
@bp.post("/offline-response")
@permission_required("settings_license.edit")
@permission_required("settings_license.write")
def offline_response():
extension = core()
manager = extension.license
@@ -178,7 +178,7 @@ def offline_response():
@bp.post("/server-certificate")
@permission_required("settings_license.edit")
@permission_required("settings_license.write")
def server_certificate():
"""Hinterlegt das Zertifikat des Lizenzservers.
@@ -214,9 +214,9 @@ def server_certificate():
severity="notice",
)
flash(
"Zertifikat hinterlegt. Der naechste Versuch laeuft wieder ueber den Online-Weg."
"Zertifikat hinterlegt. Der nächste Versuch läuft wieder über den Online-Weg."
if pem
else "Zertifikat entfernt -- es gelten wieder die Systemanker.",
else "Zertifikat entfernt – es gelten wieder die Systemanker.",
"success",
)
return redirect(url_for("license.overview"))
@@ -246,5 +246,5 @@ def remove_trusted_key(key_id: str):
if manager is not None:
with core().database.session() as conn:
manager.reload(conn)
flash("Aussteller-Schluessel entfernt.", "info")
flash("Aussteller-Schlüssel entfernt.", "info")
return redirect(url_for("license.overview"))
+3 -3
View File
@@ -19,7 +19,7 @@ MAX_TAIL_LINES = 2000
@bp.get("/dhcp")
@permission_required("logs_dhcp.view")
@permission_required("logs_dhcp.read")
def dhcp():
extension = core()
if extension.license is not None and not extension.license.module_active("dhcp"):
@@ -34,12 +34,12 @@ def dhcp():
else:
error = result.message
else:
error = "Systemhelfer nicht verfuegbar."
error = "Systemhelfer nicht verfügbar."
return render_template("tesm/logs_kea.html", lines=lines, path=kea.LOG_PATH, error=error)
@bp.get("/restarts")
@permission_required("devices.view")
@permission_required("devices.read")
def restarts():
"""Alle Neustarts -- ueber den PoE-Port und per Befehl aus der Wartung.
+13 -12
View File
@@ -23,6 +23,7 @@ from tesm_core.auth.service import client_ip
from tesm_core.db import Database
from tesm_core.extension import core, db, transaction
from ..permissions import SERVICING_PAGE
from ..services import inventory, maintenance as service, ssh, windowsops, monitor
bp = Blueprint("maintenance", __name__, url_prefix="/maintenance")
@@ -75,7 +76,7 @@ def _query_devices(conn) -> list[dict]: # type: ignore[no-untyped-def]
@bp.get("/")
@permission_required("maintenance.view", "maintenance.execute", mode="any")
@permission_required(*SERVICING_PAGE, mode="any")
def overview():
conn = db()
return render_template(
@@ -106,7 +107,7 @@ def _windows_tool_missing(conn) -> bool: # type: ignore[no-untyped-def]
@bp.post("/install-package")
@permission_required("maintenance.execute")
@permission_required("servicing_tool.execute")
def install_windows_tool():
"""Installiert das Paket, das der Fehlermeldung nach fehlt.
@@ -116,7 +117,7 @@ def install_windows_tool():
"""
sysops = core().sysops
if sysops is None or not sysops.available:
flash("Systemaktionen sind in dieser Umgebung nicht verfuegbar.", "warning")
flash("Systemaktionen sind in dieser Umgebung nicht verfügbar.", "warning")
return redirect(url_for("maintenance.overview"))
result = sysops.apt_install(windowsops.REQUIRED_PACKAGE)
@@ -139,7 +140,7 @@ def install_windows_tool():
@bp.get("/status")
@permission_required("maintenance.view", "maintenance.execute", mode="any")
@permission_required(*SERVICING_PAGE, mode="any")
def status():
"""Zustand der Auftraege -- aus der Datenbank, nicht aus dem Prozessspeicher."""
conn = db()
@@ -166,7 +167,7 @@ def status():
@bp.get("/job/<job_id>")
@permission_required("maintenance.view", "maintenance.execute", mode="any")
@permission_required(*SERVICING_PAGE, mode="any")
def job_detail(job_id: str):
conn = db()
job = service.get_job(conn, job_id)
@@ -176,7 +177,7 @@ def job_detail(job_id: str):
@bp.get("/job/<job_id>/output")
@permission_required("maintenance.view", "maintenance.execute", mode="any")
@permission_required(*SERVICING_PAGE, mode="any")
@fragment
def job_output(job_id: str):
conn = db()
@@ -191,7 +192,7 @@ def _start(kind: str) -> None:
conn = db()
device_ids = [int(value) for value in request.form.getlist("device_ids") if value.isdigit()]
if not device_ids:
flash("Es wurde kein Geraet ausgewaehlt.", "warning")
flash("Es wurde kein Gerät ausgewählt.", "warning")
return
eligible = {int(row["id"]): row for row in _eligible_devices(conn)}
@@ -204,8 +205,8 @@ def _start(kind: str) -> None:
# zurueck, der nie gestartet wird und ewig auf "wartet" steht.
if kind == service.JOB_KIND_UPDATE and str(device["category"]) != "linux":
flash(
f"{device['name']}: Paketaktualisierung gibt es nur fuer Linux-Clients. "
"Windows-Geraete lassen sich hier nur neu starten.",
f"{device['name']}: Paketaktualisierung gibt es nur für Linux-Clients. "
"Windows-Geräte lassen sich hier nur neu starten.",
"warning",
)
continue
@@ -273,18 +274,18 @@ def _start(kind: str) -> None:
started += 1
if started:
flash(f"{started} Auftrag/Auftraege gestartet.", "success")
flash(f"{started} Auftrag/Aufträge gestartet.", "success")
@bp.post("/update")
@permission_required("maintenance.execute")
@permission_required("servicing_update.execute")
def start_update():
_start(service.JOB_KIND_UPDATE)
return redirect(url_for("maintenance.overview"))
@bp.post("/restart")
@permission_required("maintenance.execute")
@permission_required("servicing_reboot.execute")
def start_reboot():
_start(service.JOB_KIND_REBOOT)
return redirect(url_for("maintenance.overview"))
+9 -7
View File
@@ -65,7 +65,7 @@ def _timezone_choices() -> list[str]:
@bp.get("/system")
@permission_required("settings_system.view")
@permission_required("settings_system.read")
def system():
extension = core()
conn = db()
@@ -82,6 +82,7 @@ def system():
"terminal_switches_enabled",
"terminal_clients_enabled",
"terminal_idle_timeout",
"signature_witness_enabled",
"trash_retention_days",
"session_idle_minutes",
"session_absolute_hours",
@@ -102,7 +103,7 @@ def system():
@bp.post("/system")
@permission_required("settings_system.edit")
@permission_required("settings_system.write")
def system_save():
extension = core()
conn = db()
@@ -116,6 +117,7 @@ def system_save():
"terminal_switches_enabled",
"terminal_clients_enabled",
"terminal_idle_timeout",
"signature_witness_enabled",
"trash_retention_days",
"session_idle_minutes",
"session_absolute_hours",
@@ -158,10 +160,10 @@ def system_save():
if changed:
message = "Einstellungen gespeichert."
if interval_changed:
message += " Das Pruefintervall greift beim naechsten Durchlauf."
message += " Das Prüfintervall greift beim nächsten Durchlauf."
flash(message, "success")
else:
flash("Keine Aenderungen.", "info")
flash("Keine Änderungen.", "info")
return redirect(url_for("settings.system"))
@@ -172,10 +174,10 @@ def set_hostname():
sysops = extension.sysops
hostname = (request.form.get("hostname") or "").strip()
if not hostname or len(hostname) > 63 or not hostname.replace("-", "").isalnum():
flash("Der Hostname ist ungueltig.", "danger")
flash("Der Hostname ist ungültig.", "danger")
return redirect(url_for("settings.system"))
if sysops is None or not sysops.available:
flash("Systemaktionen sind in dieser Umgebung nicht verfuegbar.", "warning")
flash("Systemaktionen sind in dieser Umgebung nicht verfügbar.", "warning")
return redirect(url_for("settings.system"))
result = sysops.set_hostname(hostname)
if result.ok:
@@ -198,7 +200,7 @@ def set_timezone():
flash("Unbekannte Zeitzone.", "danger")
return redirect(url_for("settings.system"))
if sysops is None or not sysops.available:
flash("Systemaktionen sind in dieser Umgebung nicht verfuegbar.", "warning")
flash("Systemaktionen sind in dieser Umgebung nicht verfügbar.", "warning")
return redirect(url_for("settings.system"))
result = sysops.set_timezone(timezone)
if result.ok:
+13 -13
View File
@@ -47,7 +47,7 @@ def _form_values() -> dict[str, Any]:
@bp.get("/")
@permission_required("switches.view")
@permission_required("switches.read")
def overview():
conn = db()
return render_template(
@@ -71,7 +71,7 @@ def create():
f"IP {request.form.get('ip')}",
severity="notice",
)
flash("Switch angelegt. Der Host-Schluessel muss vor dem ersten Zugriff freigegeben werden.", "success")
flash("Switch angelegt. Der Host-Schlüssel muss vor dem ersten Zugriff freigegeben werden.", "success")
return redirect(url_for("switches.detail", switch_id=switch_id))
except inventory.ValidationError as exc:
flash(str(exc), "danger")
@@ -79,7 +79,7 @@ def create():
@bp.post("/<int:switch_id>")
@permission_required("switches.edit")
@permission_required("switches.write")
def update(switch_id: int):
try:
with transaction() as conn:
@@ -92,7 +92,7 @@ def update(switch_id: int):
"; ".join(changes),
severity="notice",
)
flash("Aenderungen gespeichert." if changes else "Keine Aenderungen.", "success" if changes else "info")
flash("Änderungen gespeichert." if changes else "Keine Änderungen.", "success" if changes else "info")
except inventory.ValidationError as exc:
flash(str(exc), "danger")
return redirect(request.referrer or url_for("switches.overview"))
@@ -115,7 +115,7 @@ def delete(switch_id: int):
@bp.get("/<int:switch_id>")
@permission_required("switches.view")
@permission_required("switches.read")
def detail(switch_id: int):
conn = db()
switch = inventory.get_switch(conn, switch_id)
@@ -152,7 +152,7 @@ def detail(switch_id: int):
@bp.post("/<int:switch_id>/host-key/probe")
@permission_required("switches.edit")
@permission_required("switches.write")
def probe_host_key(switch_id: int):
conn = db()
switch = inventory.get_switch(conn, switch_id)
@@ -177,7 +177,7 @@ def probe_host_key(switch_id: int):
@bp.post("/<int:switch_id>/host-key/trust")
@permission_required("switches.edit")
@permission_required("switches.write")
@reauth_required
def trust_host_key(switch_id: int):
"""Gibt einen Host-Schluessel ausdruecklich frei.
@@ -192,7 +192,7 @@ def trust_host_key(switch_id: int):
key_type = (request.form.get("key_type") or "").strip()
fingerprint = (request.form.get("fingerprint") or "").strip()
if not key_type or not ssh.valid_fingerprint(fingerprint):
flash("Es wurde kein gueltiger Fingerprint uebergeben.", "danger")
flash("Es wurde kein gültiger Fingerprint übergeben.", "danger")
return redirect(url_for("switches.detail", switch_id=switch_id))
with transaction():
@@ -211,12 +211,12 @@ def trust_host_key(switch_id: int):
f"{key_type} {fingerprint}",
severity="notice",
)
flash("Host-Schluessel freigegeben.", "success")
flash("Host-Schlüssel freigegeben.", "success")
return redirect(url_for("switches.detail", switch_id=switch_id))
@bp.post("/<int:switch_id>/host-key/forget")
@permission_required("switches.edit")
@permission_required("switches.write")
def forget_host_key(switch_id: int):
conn = db()
switch = inventory.get_switch(conn, switch_id)
@@ -225,7 +225,7 @@ def forget_host_key(switch_id: int):
with transaction():
ssh.forget_key(conn, str(switch["ip"]), int(switch["ssh_port"]))
_audit(conn, "switch.host_key_forgotten", str(switch["hostname"]), severity="warning")
flash("Gespeicherte Host-Schluessel entfernt.", "info")
flash("Gespeicherte Host-Schlüssel entfernt.", "info")
return redirect(url_for("switches.detail", switch_id=switch_id))
@@ -235,7 +235,7 @@ def forget_host_key(switch_id: int):
@bp.post("/<int:switch_id>/command")
@permission_required("switches.execute")
@permission_required("switch_console.execute")
@reauth_required
def run_command(switch_id: int):
"""Fuehrt ein Kommando aus der Positivliste aus.
@@ -256,7 +256,7 @@ def run_command(switch_id: int):
flash("Dieses Kommando steht nicht auf der Positivliste.", "danger")
return redirect(url_for("switches.detail", switch_id=switch_id))
if not switch["credential_id"]:
flash("Fuer diesen Switch sind keine Zugangsdaten hinterlegt.", "danger")
flash("Für diesen Switch sind keine Zugangsdaten hinterlegt.", "danger")
return redirect(url_for("switches.detail", switch_id=switch_id))
try:
+16 -14
View File
@@ -12,7 +12,7 @@ Zwei Ziele, ein Ablauf:
* **Switch** -- ``switches.execute``. Interaktive ArubaOS-Sitzung ueber
:class:`~tesm.services.switchcli.SwitchCli`.
* **Client** -- ``maintenance.execute`` und das lizenzpflichtige Modul
* **Client** -- ``device_console.execute`` und das lizenzpflichtige Modul
``maintenance``. Ein Kommando je ``exec``-Kanal ueber
:class:`~tesm.services.shellcli.ShellSession`.
@@ -74,7 +74,7 @@ CLIENT_COMMANDS: tuple[tuple[str, str], ...] = (
("ip -brief address", "Netzwerkadressen"),
("systemctl --failed", "Fehlgeschlagene Dienste"),
("journalctl -p err -n 50 --no-pager", "Letzte Fehler im Journal"),
("apt list --upgradable 2>/dev/null", "Verfuegbare Aktualisierungen"),
("apt list --upgradable 2>/dev/null", "Verfügbare Aktualisierungen"),
("uname -a", "Kernel und Architektur"),
)
@@ -154,7 +154,7 @@ def _render_console(target: Target): # type: ignore[no-untyped-def]
if not _konsole_erlaubt(conn, target.kind):
abort(404)
if not target.credential_id:
abort(409, description="Fuer dieses Ziel sind keine Zugangsdaten hinterlegt.")
abort(409, description="Für dieses Ziel sind keine Zugangsdaten hinterlegt.")
return render_template(
"tesm/console.html",
@@ -167,7 +167,7 @@ def _render_console(target: Target): # type: ignore[no-untyped-def]
@bp.get("/monitoring/switches/<int:switch_id>/console")
@permission_required("switches.execute")
@permission_required("switch_console.execute")
@reauth_required
def switch_console(switch_id: int):
target = _load_target(db(), KIND_SWITCH, switch_id)
@@ -177,7 +177,7 @@ def switch_console(switch_id: int):
@bp.get("/monitoring/clients/<int:device_id>/console")
@permission_required("maintenance.execute")
@permission_required("device_console.execute")
@reauth_required
def device_console(device_id: int):
if not _client_module_active():
@@ -195,7 +195,7 @@ def init_app(app) -> None: # type: ignore[no-untyped-def]
try:
from flask_sock import Sock
except ImportError: # pragma: no cover - optionale Abhaengigkeit
logger.info("flask-sock ist nicht installiert -- die Konsole bleibt deaktiviert.")
logger.info("flask-sock ist nicht installiert – die Konsole bleibt deaktiviert.")
return
sock = Sock(app)
@@ -225,18 +225,20 @@ def _handle_socket(ws, kind: str, target_id: int) -> None: # type: ignore[no-un
# -- Berechtigungen: dieselben Pruefungen wie in der HTTP-Route. Ein
# WebSocket umgeht Dekoratoren, also stehen sie hier ausdruecklich.
required = "switches.execute" if kind == KIND_SWITCH else "maintenance.execute"
required = (
"switch_console.execute" if kind == KIND_SWITCH else "device_console.execute"
)
if not current_user.is_authenticated or not current_user.has(required):
_send(ws, "error", "Keine Berechtigung fuer diese Konsole.")
_send(ws, "error", "Keine Berechtigung für diese Konsole.")
return
if not reauth_is_fresh():
_send(ws, "error", "Die Passwortbestaetigung ist abgelaufen. Bitte Seite neu laden.")
_send(ws, "error", "Die Passwortbestätigung ist abgelaufen. Bitte Seite neu laden.")
return
if not _konsole_erlaubt(conn, kind):
_send(ws, "error", "Die Konsole ist in dieser Installation abgeschaltet.")
return
if kind == KIND_DEVICE and not _client_module_active():
_send(ws, "error", "Die Client-Konsole gehoert zum Modul Wartung -- es ist nicht aktiv.")
_send(ws, "error", "Die Client-Konsole gehört zum Modul Wartung – es ist nicht aktiv.")
return
target = _load_target(conn, kind, target_id)
@@ -293,8 +295,8 @@ def _handle_socket(ws, kind: str, target_id: int) -> None: # type: ignore[no-un
_send(
ws,
"error",
f"{exc} Die Konsole akzeptiert keine unbekannten Schluessel -- bitte auf der "
f"{page} ausdruecklich freigeben.",
f"{exc} Die Konsole akzeptiert keine unbekannten Schlüssel – bitte auf der "
f"{page} ausdrücklich freigeben.",
)
except ssh.SshError as exc:
_send(ws, "error", str(exc))
@@ -319,7 +321,7 @@ def _read_command(ws, idle_timeout: int) -> str | None: # type: ignore[no-untyp
"""Naechstes Kommando, oder ``None`` wenn die Sitzung enden soll."""
raw = ws.receive(timeout=idle_timeout)
if raw is None:
_send(ws, "info", "Verbindung wegen Untaetigkeit getrennt.")
_send(ws, "info", "Verbindung wegen Untätigkeit getrennt.")
return None
try:
message = json.loads(raw)
@@ -407,6 +409,6 @@ def _run_client_session( # type: ignore[no-untyped-def]
_send(
ws,
"error",
f"Rueckgabewert {result['status']} nach {result['duration_ms']} ms.",
f"Rückgabewert {result['status']} nach {result['duration_ms']} ms.",
)
return commands
+52 -24
View File
@@ -39,7 +39,7 @@ def cmd_create_admin(args: argparse.Namespace) -> int:
if not password:
password = getpass.getpass("Passwort: ")
if password != getpass.getpass("Passwort wiederholen: "):
print("Die Passwoerter stimmen nicht ueberein.", file=sys.stderr)
print("Die Passwörter stimmen nicht überein.", file=sys.stderr)
return 2
problems = extension.password_policy.check(password, username=username)
@@ -75,7 +75,7 @@ def cmd_create_admin(args: argparse.Namespace) -> int:
actor_id=user_id,
action="user.admin_created",
target=username,
detail=f"ueber die Kommandozeile {action}",
detail=f"über die Kommandozeile {action}",
severity="warning",
)
print(f"Administrator {username!r} {action}.")
@@ -133,7 +133,7 @@ def cmd_status(args: argparse.Namespace) -> int:
print(
"Audit-Kette : "
+ ("unversehrt" if chain["ok"] else f"GEBROCHEN bei Eintrag {chain['broken_at']}")
+ f" ({chain['checked']} geprueft)"
+ f" ({chain['checked']} geprüft)"
)
for key, value in counts.items():
print(f"{key.capitalize():<15}: {value}")
@@ -168,6 +168,27 @@ def cmd_housekeeping(_args: argparse.Namespace) -> int:
return 0
def cmd_restore_signatures(_args: argparse.Namespace) -> int:
"""Traegt Unterschriften aus dem Journal wieder in die Datenbank ein.
Gebraucht nach einer Wiederherstellung: die Freigabe traegt die Dateien
von gestern, die zurueckgespielte Datenbank ist von vorgestern -- die
Unterschriften dazwischen stehen dann nur noch im Journal neben dem
Protokollarchiv.
"""
app, extension = _app_and_core()
from .services import fileshare
with app.app_context(), extension.database.session() as conn:
with extension.database.transaction(conn):
uebernommen = fileshare.signaturen_aus_journal(conn)
gesamt = int(
conn.execute("SELECT COUNT(*) FROM document_signatures").fetchone()[0]
)
print(f"{uebernommen} Unterschrift(en) übernommen, {gesamt} insgesamt.")
return 0
def cmd_check_now(_args: argparse.Namespace) -> int:
app, extension = _app_and_core()
from .services import inventory, monitor
@@ -183,7 +204,7 @@ def cmd_check_now(_args: argparse.Namespace) -> int:
license_allows_auto_restart=allowed,
)
print(
f"{report.checked} geprueft, {report.online} online, {report.offline} offline, "
f"{report.checked} geprüft, {report.online} online, {report.offline} offline, "
f"{report.restarts_triggered} Neustarts ({report.restarts_ok} erfolgreich), "
f"{report.duration_ms} ms"
)
@@ -214,7 +235,7 @@ def cmd_convert_legacy(args: argparse.Namespace) -> int:
return 2
ziel = Path(args.ausgabe) if args.ausgabe else quelle.with_name(f"{quelle.stem}-neu.json")
if ziel.exists() and not args.force:
print(f"{ziel} existiert bereits. Mit --force ueberschreiben.")
print(f"{ziel} existiert bereits. Mit --force überschreiben.")
return 2
alt_pass = args.passphrase or getpass("Passphrase der alten Datei: ")
@@ -231,7 +252,7 @@ def cmd_convert_legacy(args: argparse.Namespace) -> int:
print("--dry-run: keine Datei geschrieben.")
return 0
neu_pass = args.neue_passphrase or getpass("Passphrase fuer die neue Datei: ")
neu_pass = args.neue_passphrase or getpass("Passphrase für die neue Datei: ")
try:
ziel.write_text(transfer.seal(nutzlast, neu_pass), encoding="utf-8", newline="\n")
except Exception as exc: # noqa: BLE001 - Passphrase zu kurz, Pfad nicht schreibbar
@@ -265,10 +286,10 @@ def cmd_legacy_export(args: argparse.Namespace) -> int:
quelle = Path(args.source)
ziel = Path(args.out)
if ziel.exists() and not args.force:
print(f"{ziel} existiert bereits. Mit --force ueberschreiben.")
print(f"{ziel} existiert bereits. Mit --force überschreiben.")
return 2
passphrase = args.passphrase or getpass("Passphrase fuer die Exportdatei: ")
passphrase = args.passphrase or getpass("Passphrase für die Exportdatei: ")
try:
nutzlast, bericht = legacy.read_installation(quelle)
inhalt = legacy.seal_legacy(nutzlast, passphrase)
@@ -354,7 +375,7 @@ def cmd_legacy_import(args: argparse.Namespace) -> int:
action="backup.imported",
detail="; ".join(
f"{key}: {zahlen['created']} neu, {zahlen['updated']} aktualisiert, "
f"{zahlen['skipped']} uebersprungen"
f"{zahlen['skipped']} übersprungen"
for key, zahlen in bericht.items()
)
+ " (Kommandozeile)",
@@ -364,19 +385,20 @@ def cmd_legacy_import(args: argparse.Namespace) -> int:
for key, zahlen in sorted(bericht.items()):
print(
f" {key}: {zahlen['created']} neu, {zahlen['updated']} aktualisiert, "
f"{zahlen['skipped']} uebersprungen"
f"{zahlen['skipped']} übersprungen"
)
return 0
def build_parser() -> argparse.ArgumentParser:
parser = argparse.ArgumentParser(
prog="tesm-admin", description="Verwaltungswerkzeuge fuer TESM"
prog="tesm-admin", description="Verwaltungswerkzeuge für TESM"
)
sub = parser.add_subparsers(dest="command", required=True)
admin = sub.add_parser("create-admin", help="Administratorkonto anlegen oder zuruecksetzen")
admin = sub.add_parser("create-admin", help="Administratorkonto anlegen oder zurücksetzen")
admin.add_argument("--username")
admin.add_argument("--password", help="Nur fuer automatisierte Installationen")
admin.add_argument("--password", help="Nur für automatisierte Installationen")
admin.add_argument("--force", action="store_true", help="Passwortregeln ignorieren")
admin.set_defaults(func=cmd_create_admin)
@@ -384,18 +406,24 @@ def build_parser() -> argparse.ArgumentParser:
status.add_argument("--json", action="store_true")
status.set_defaults(func=cmd_status)
house = sub.add_parser("housekeeping", help="Sitzungen, Ratenereignisse, Protokolle aufraeumen")
house = sub.add_parser("housekeeping", help="Sitzungen, Ratenereignisse, Protokolle aufräumen")
house.set_defaults(func=cmd_housekeeping)
check = sub.add_parser("check-now", help="Einen Ueberwachungsdurchlauf sofort ausfuehren")
restore = sub.add_parser(
"restore-signatures",
help="Unterschriften aus dem Journal neben dem Protokollarchiv übernehmen",
)
restore.set_defaults(func=cmd_restore_signatures)
check = sub.add_parser("check-now", help="Einen Überwachungsdurchlauf sofort ausführen")
check.set_defaults(func=cmd_check_now)
legacy = sub.add_parser(
"convert-legacy",
help="Export des alten TESM in das neue Format uebersetzen",
help="Export des alten TESM in das neue Format übersetzen",
description=(
"Liest eine Exportdatei des Vorgaengers und schreibt eine Datei im "
"Format dieser Anwendung. Uebersetzt werden Clients, Switche, "
"Liest eine Exportdatei des Vorgängers und schreibt eine Datei im "
"Format dieser Anwendung. Übersetzt werden Clients, Switche, "
"Zugangsdaten und die DHCP-Konfiguration."
),
)
@@ -410,7 +438,7 @@ def build_parser() -> argparse.ArgumentParser:
legacy.add_argument(
"--dry-run", action="store_true", help="Nur den Bericht zeigen, nichts schreiben"
)
legacy.add_argument("--force", action="store_true", help="Zieldatei ueberschreiben")
legacy.add_argument("--force", action="store_true", help="Zieldatei überschreiben")
legacy.set_defaults(func=cmd_convert_legacy)
@@ -418,10 +446,10 @@ def build_parser() -> argparse.ArgumentParser:
"legacy-export",
help="Daten einer alten Installation als Exportdatei sichern",
description=(
"Liest die Datenbank einer Installation der Vorgaengerfassung und schreibt "
"Liest die Datenbank einer Installation der Vorgängerfassung und schreibt "
"Clients, Switche, Zugangsdaten und DHCP in eine Datei im alten Format. "
"Die alte Installation wird nur gelesen. Ohne Browser und auch dann noch "
"moeglich, wenn die alte Anwendung nicht mehr startet."
"möglich, wenn die alte Anwendung nicht mehr startet."
),
)
export_alt.add_argument(
@@ -430,16 +458,16 @@ def build_parser() -> argparse.ArgumentParser:
export_alt.add_argument("--out", required=True, help="Zieldatei")
export_alt.add_argument("--passphrase", help="Passphrase der Zieldatei (sonst wird gefragt)")
export_alt.add_argument("--dry-run", action="store_true", help="Nur den Bericht zeigen")
export_alt.add_argument("--force", action="store_true", help="Zieldatei ueberschreiben")
export_alt.add_argument("--force", action="store_true", help="Zieldatei überschreiben")
export_alt.set_defaults(func=cmd_legacy_export)
import_neu = sub.add_parser(
"legacy-import",
help="Datei im Format dieser Anwendung einlesen",
description=(
"Liest eine Sicherungs- oder uebersetzte Datei ein -- derselbe Weg wie unter "
"Liest eine Sicherungs- oder übersetzte Datei ein – derselbe Weg wie unter "
"Verwaltung -> Sicherung, nur ohne Browser. Ohne --categories werden alle "
"Kategorien uebernommen, die in der Datei stehen."
"Kategorien übernommen, die in der Datei stehen."
),
)
import_neu.add_argument("datei", help="Datei im Format dieser Anwendung")
+26 -24
View File
@@ -13,6 +13,8 @@ from typing import Any
from tesm_core.extension import core
from tesm_core.nav import NavItem, NavTree
from .permissions import DHCP_PAGE, SERVICING_PAGE
def _module(name: str):
"""Bedingung: Vollmodul lizenziert?"""
@@ -36,7 +38,7 @@ def _has_fileshare_mounts(user: Any) -> bool:
return False
if not _module("fileshare")(user):
return False
if user.has("fileshare.edit"):
if user.has("fileshare.write"):
return True
from .services import fileshare
@@ -56,28 +58,28 @@ NAVIGATION = NavTree(
label="Clients",
icon="cpu",
endpoint="devices.overview",
permissions=("devices.view",),
permissions=("devices.read",),
),
NavItem(
key="switches",
label="Switche",
icon="switch",
endpoint="switches.overview",
permissions=("switches.view",),
permissions=("switches.read",),
),
NavItem(
key="credentials",
label="Zugangsdaten",
icon="key",
endpoint="credentials.overview",
permissions=("credentials.view",),
permissions=("credentials.read",),
),
NavItem(
key="hostkeys",
label="Host-Schlüssel",
icon="shield",
endpoint="hostkeys.overview",
permissions=("devices.view", "switches.view"),
permissions=("devices.read", "switches.read"),
),
),
),
@@ -86,7 +88,7 @@ NAVIGATION = NavTree(
label="Wartung",
icon="wrench",
endpoint="maintenance.overview",
permissions=("maintenance.view", "maintenance.execute"),
permissions=SERVICING_PAGE,
condition=_module("maintenance"),
),
NavItem(
@@ -94,7 +96,7 @@ NAVIGATION = NavTree(
label="DHCP-Server",
icon="network",
endpoint="dhcp.overview",
permissions=("dhcp.view", "dhcp.edit", "dhcp.execute"),
permissions=DHCP_PAGE,
condition=_module("dhcp"),
),
NavItem(
@@ -108,14 +110,14 @@ NAVIGATION = NavTree(
label="Meine Freigaben",
icon="folder",
endpoint="fileshare.browse",
permissions=("fileshare.view",),
permissions=("fileshare.read",),
),
NavItem(
key="fileshare_mappings",
label="Zuordnungen",
icon="link",
endpoint="fileshare.mappings",
permissions=("fileshare.edit",),
permissions=("fileshare.write",),
),
),
),
@@ -129,28 +131,28 @@ NAVIGATION = NavTree(
label="Laufend",
icon="terminal",
endpoint="logs.live",
permissions=("logs_live.view",),
permissions=("logs_live.read",),
),
NavItem(
key="logs_history",
label="Verlauf",
icon="clock",
endpoint="logs.history",
permissions=("logs_history.view", "logs_history.export"),
permissions=("logs_history.read", "logs_history.export"),
),
NavItem(
key="logs_audit",
label="Audit",
icon="history",
endpoint="logs.audit_view",
permissions=("logs_audit.view", "logs_audit.export"),
permissions=("logs_audit.read", "logs_audit.export"),
),
NavItem(
key="logs_dhcp",
label="DHCP",
icon="network",
endpoint="tesmlogs.dhcp",
permissions=("logs_dhcp.view",),
permissions=("logs_dhcp.read",),
condition=_module("dhcp"),
),
NavItem(
@@ -158,7 +160,7 @@ NAVIGATION = NavTree(
label="Neustarts",
icon="power",
endpoint="tesmlogs.restarts",
permissions=("devices.view",),
permissions=("devices.read",),
),
),
),
@@ -172,42 +174,42 @@ NAVIGATION = NavTree(
label="Benutzer",
icon="users",
endpoint="admin.users",
permissions=("users.view",),
permissions=("users.read",),
),
NavItem(
key="groups",
label="Gruppen und Rechte",
icon="shield-users",
endpoint="admin.groups",
permissions=("groups.view",),
permissions=("groups.read",),
),
NavItem(
key="settings_system",
label="System",
icon="sliders",
endpoint="settings.system",
permissions=("settings_system.view",),
permissions=("settings_system.read",),
),
NavItem(
key="settings_network",
label="Netzwerk",
icon="network",
endpoint="hostsettings.network",
permissions=("settings_network.view",),
permissions=("settings_network.read",),
),
NavItem(
key="settings_web",
label="Webserver und TLS",
icon="server",
endpoint="hostsettings.web",
permissions=("settings_web.view",),
permissions=("settings_web.read",),
),
NavItem(
key="settings_directory",
label="Verzeichnisdienst",
icon="users",
endpoint="hostsettings.directory_settings",
permissions=("settings_directory.view",),
permissions=("settings_directory.read",),
),
NavItem(
key="settings_license",
@@ -216,28 +218,28 @@ NAVIGATION = NavTree(
endpoint="license.overview",
# Bewusst immer erreichbar, auch ohne gueltige Lizenz --
# sonst liesse sich eine neue Lizenz nie einspielen.
permissions=("settings_license.view",),
permissions=("settings_license.read",),
),
NavItem(
key="backup",
label="Sicherung",
icon="transfer",
endpoint="backup.overview",
permissions=("backup.view", "backup.export", "backup.execute"),
permissions=("backup_export.read", "backup_import.read"),
),
NavItem(
key="trash",
label="Papierkorb",
icon="trash",
endpoint="trash.overview",
permissions=("trash.view",),
permissions=("trash.read",),
),
NavItem(
key="diagnostics",
label="Diagnose",
icon="info",
endpoint="diagnostics.overview",
permissions=("diagnostics.view",),
permissions=("diagnostics.read",),
),
),
),
+332 -75
View File
@@ -30,66 +30,219 @@ A = Action
DEVICES = Resource(
key="devices",
label="Clients",
actions=(A.VIEW, A.CREATE, A.EDIT, A.DELETE, A.EXECUTE),
hint="Überwachte PoE-Endgeräte",
actions=(A.READ, A.CREATE, A.WRITE, A.DELETE),
hint="Stammdaten überwachter PoE-Endgeräte: Name, MAC, IP, Switch und Port",
action_hints={
A.EXECUTE: "PoE-Neustart eines Geraets manuell ausloesen. Der automatische "
"Neustart bei Ausfall ist davon unabhaengig und laeuft immer.",
A.DELETE: "Geraet in den Papierkorb legen.",
A.DELETE: "Gerät in den Papierkorb legen.",
},
)
#: Drei Wege, drei Rechte -- bisher hingen alle an ``devices.execute``.
#:
#: Wer jemandem den PoE-Neustart erlauben wollte (der Weg, der auch bei einem
#: haengenden Geraet noch wirkt und nichts Laufendes unterbricht), erlaubte ihm
#: damit zugleich, ein arbeitendes System ueber SSH herunterzufahren. Das sind
#: drei verschiedene Eingriffe mit drei verschiedenen Folgen -- also drei
#: Zeilen. Die Reihenfolge ist die der Rangfolge in ``services.restart``.
DEVICE_RESTART_POE = Resource(
key="device_restart_poe",
parent="devices",
label="Clients: Neustart über PoE",
actions=(A.READ, A.EXECUTE),
hint="Portzyklus am Switch – wirkt in Sekunden, auch wenn das Gerät hängt",
action_hints={
A.READ: "Den Knopf sehen.",
A.EXECUTE: "Neustart auslösen. Bewusst nicht lizenzpflichtig: ein hängendes "
"Gerät soll man auch ohne gültige Lizenz von Hand neu starten können.",
},
)
DEVICE_RESTART_SSH = Resource(
key="device_restart_ssh",
parent="devices",
label="Clients: Neustart über SSH",
actions=(A.READ, A.EXECUTE),
hint="Sauberes Herunterfahren eines Linux-Geräts (Modul Wartung)",
action_hints={
A.EXECUTE: "Neustartauftrag anlegen. Dauert Minuten und setzt ein "
"antwortendes Gerät samt freigegebenem Host-Schlüssel voraus.",
},
)
DEVICE_RESTART_RPC = Resource(
key="device_restart_rpc",
parent="devices",
label="Clients: Neustart über RPC",
actions=(A.READ, A.EXECUTE),
hint="Windows-Gerät ohne SSH und ohne Host-Schlüssel (Modul Wartung)",
action_hints={A.EXECUTE: "Neustartauftrag anlegen (wie 'shutdown /m')."},
)
#: Die Client-Konsole lief unter ``maintenance.execute`` mit -- demselben Recht
#: wie die Paketaktualisierung. Eine Sitzung auf einem Geraet ist aber etwas
#: anderes als ein Auftrag, den der Server abarbeitet: hier tippt ein Mensch.
DEVICE_CONSOLE = Resource(
key="device_console",
parent="devices",
label="Clients: Konsole",
actions=(A.READ, A.EXECUTE),
hint="Browser-Terminal auf einem Client (Modul Wartung)",
action_hints={
A.EXECUTE: "Sitzung öffnen. Verlangt eine frische Passwortbestätigung; "
"jede Sitzung wird vollständig mitgeschrieben.",
},
)
SWITCHES = Resource(
key="switches",
label="Switche",
actions=(A.VIEW, A.CREATE, A.EDIT, A.DELETE, A.EXECUTE),
hint="Aruba-Switche und ihre Erreichbarkeit",
actions=(A.READ, A.CREATE, A.WRITE, A.DELETE),
hint="Aruba-Switche, ihre Erreichbarkeit und Ports",
)
SWITCH_CONSOLE = Resource(
key="switch_console",
parent="switches",
label="Switche: Konsole",
actions=(A.READ, A.EXECUTE),
hint="Kommandos auf dem Switch ausführen",
action_hints={
A.EXECUTE: "Browser-Terminal oeffnen und Kommandos auf dem Switch ausfuehren. "
"Verlangt zusaetzlich eine frische Passwortbestaetigung; jede Sitzung wird "
"vollstaendig protokolliert.",
A.EXECUTE: "Sitzung öffnen. Verlangt eine frische Passwortbestätigung; "
"jede Sitzung wird vollständig mitgeschrieben.",
},
)
#: Einen geaenderten Host-Schluessel freizugeben hing an "Gerät ändern" bzw.
#: "Switch ändern" -- also an einem Recht fuer Stammdaten. Es ist aber der
#: Vorgang, mit dem man sagt: "dieses Geraet ist wirklich das, fuer das es sich
#: ausgibt". Wer Namen und Standort pflegt, muss das nicht entscheiden duerfen.
HOSTKEYS = Resource(
key="hostkeys",
label="Host-Schlüssel",
actions=(A.READ, A.EXECUTE),
hint="Ein Gerät meldet sich mit einem anderen SSH-Schlüssel als beim letzten Mal",
action_hints={
A.READ: "Offene und freigegebene Schlüssel sehen.",
A.EXECUTE: "Einen geänderten Schlüssel freigeben.",
},
)
CREDENTIALS = Resource(
key="credentials",
label="Zugangsdaten",
actions=(A.VIEW, A.CREATE, A.EDIT, A.DELETE, A.SECRETS),
actions=(A.READ, A.CREATE, A.WRITE, A.DELETE, A.SECRETS),
hint="Wiederverwendbare SSH-Logins",
action_hints={
A.VIEW: "Namen und Benutzer sehen -- nicht das Passwort.",
A.READ: "Namen und Benutzer sehen – nicht das Passwort.",
A.SECRETS: "Passwort im Klartext anzeigen. Verlangt eine frische "
"Passwortbestaetigung und wird protokolliert.",
"Passwortbestätigung und wird protokolliert.",
},
)
MAINTENANCE = Resource(
key="maintenance",
label="Wartung",
actions=(A.VIEW, A.EXECUTE),
hint="Paketaktualisierung und Neustart per SSH (lizenzpflichtiges Modul)",
action_hints={A.EXECUTE: "Aktualisierung oder Neustart auf ausgewaehlten Geraeten starten."},
#: Aus einer Zeile ("Aktualisierung und Neustart") wurden drei. Sie deckte
#: vier Funktionen ab: Pakete aktualisieren, reihenweise neu starten, das
#: Windows-Werkzeug installieren -- und die Client-Konsole, die jetzt bei den
#: Clients steht, wo sie hingehoert.
SERVICING_UPDATE = Resource(
key="servicing_update",
label="Paketaktualisierung",
actions=(A.READ, A.EXECUTE),
hint="Pakete auf ausgewählten Geräten aktualisieren (lizenzpflichtiges Modul)",
action_hints={A.EXECUTE: "Auftrag starten."},
)
DHCP = Resource(
key="dhcp",
label="DHCP-Server",
actions=(A.VIEW, A.EDIT, A.EXECUTE),
hint="DHCP: Subnetze, Optionen, Reservierungen (lizenzpflichtiges Modul)",
SERVICING_REBOOT = Resource(
key="servicing_reboot",
label="Neustart als Auftrag",
actions=(A.READ, A.EXECUTE),
hint="Reihenweise Neustarts mit Wartezeit und Rückmeldung",
action_hints={A.EXECUTE: "Auftrag starten."},
)
SERVICING_TOOL = Resource(
key="servicing_tool",
label="Windows-Werkzeug installieren",
actions=(A.READ, A.EXECUTE),
hint="Voraussetzung für den RPC-Weg auf einem Windows-Gerät",
action_hints={A.EXECUTE: "Installation auslösen."},
)
#: Die Wartungsseite zeigt alle drei Aufgaben. Sie oeffnet, wer **eine** davon
#: sehen darf -- und zeigt dann nur die. Als Konstante, damit die vier Routen
#: dieselbe Antwort geben; einzeln getippt liefen sie irgendwann auseinander.
SERVICING_PAGE: tuple[str, ...] = (
"servicing_update.read",
"servicing_reboot.read",
"servicing_tool.read",
)
#: Elf Funktionen hingen an ``dhcp.edit``: Grundeinstellungen, Subnetze,
#: Optionen, Geraeteoptionen, eigene Optionen, Reservierungen und das
#: Schreiben der Dienstkonfiguration. Wer eine Reservierung eintragen sollte,
#: durfte damit auch Subnetze loeschen und die Konfiguration ueberschreiben.
DHCP_SUBNETS = Resource(
key="dhcp_subnets",
label="DHCP: Subnetze",
actions=(A.READ, A.CREATE, A.WRITE, A.DELETE),
hint="Bereiche, Gateway, DNS, Reihenfolge (lizenzpflichtiges Modul)",
)
DHCP_OPTIONS = Resource(
key="dhcp_options",
parent="dhcp_subnets",
label="DHCP: Optionen",
actions=(A.READ, A.WRITE),
hint="Globale Optionen, Optionen je Gerät und eigene Optionen",
action_hints={A.WRITE: "Werte setzen, eigene Optionen anlegen und entfernen."},
)
DHCP_RESERVATIONS = Resource(
key="dhcp_reservations",
parent="dhcp_subnets",
label="DHCP: Reservierungen",
actions=(A.READ, A.CREATE, A.WRITE, A.DELETE),
hint="Feste Adressen zu einer MAC",
)
DHCP_CONFIG = Resource(
key="dhcp_config",
parent="dhcp_subnets",
label="DHCP: Konfiguration schreiben",
actions=(A.READ, A.EXECUTE),
hint="Den bearbeiteten Stand in die Dienstkonfiguration übernehmen",
action_hints={
A.EDIT: "Konfiguration aendern und schreiben.",
A.EXECUTE: "Dienst installieren, starten oder stoppen.",
A.EXECUTE: "Schreiben und neu laden. Bis dahin ändert sich am laufenden "
"Dienst nichts – Bearbeiten und Wirksamwerden sind zwei Schritte.",
},
)
DHCP_SERVICE = Resource(
key="dhcp_service",
parent="dhcp_subnets",
label="DHCP: Dienst",
actions=(A.READ, A.EXECUTE),
hint="Kea installieren, starten, stoppen",
action_hints={A.EXECUTE: "Dienstzustand ändern."},
)
#: Die DHCP-Seite zeigt alle Abschnitte; jeder Abschnitt haengt an seiner
#: eigenen Zeile. Geoeffnet wird sie, wer einen davon sehen darf.
DHCP_PAGE: tuple[str, ...] = (
"dhcp_subnets.read",
"dhcp_options.read",
"dhcp_reservations.read",
"dhcp_config.read",
"dhcp_service.read",
)
FILESHARE = Resource(
key="fileshare",
label="Dateifreigaben",
actions=(A.VIEW, A.CREATE, A.EDIT, A.DELETE, A.EXPORT),
actions=(A.READ, A.CREATE, A.WRITE, A.DELETE, A.EXPORT),
hint="SMB-Freigaben aus dem Verzeichnisdienst (lizenzpflichtiges Modul)",
action_hints={
A.CREATE: "Ordner anlegen und Dateien hochladen.",
A.EDIT: "Umbenennen und verschieben.",
A.WRITE: "Umbenennen und verschieben.",
# Genau die Bedeutung aus der Legende: Daten aus dem System
# heraustragen. Ansehen und Mitnehmen sind zweierlei -- eine Vorschau
# bleibt im Haus, eine heruntergeladene Datei nicht.
@@ -108,48 +261,99 @@ FILESHARE = Resource(
#: soll deshalb nicht automatisch veraenderbare Formulare ablegen duerfen.
FILESHARE_PDF = Resource(
key="fileshare_pdf",
parent="fileshare",
label="PDF-Formulare",
actions=(A.VIEW, A.CREATE, A.EDIT),
hint="Formulare in der Vorschau ausfuellen und in der Freigabe ablegen",
actions=(A.READ, A.CREATE, A.WRITE),
hint="Formulare in der Vorschau ausfüllen und in der Freigabe ablegen",
action_hints={
A.VIEW: "In der Vorschau ausfuellen (ohne Speichern).",
A.CREATE: "Ausgefuellt speichern -- abgeschlossen, Felder gesperrt.",
A.EDIT: "Ausgefuellt speichern -- weiter ausfuellbar, inklusive Bild.",
A.READ: "In der Vorschau ausfüllen (ohne Speichern).",
A.CREATE: "Ausgefüllt speichern – abgeschlossen, Felder gesperrt.",
A.WRITE: "Ausgefüllt speichern – weiter ausfüllbar, inklusive Bild.",
},
)
#: Unterschreiben ist kein Aendern: am Ende steht eine Fassung, die niemand
#: mehr bearbeiten kann, mit Namen und Zeitpunkt im Dokument und einer
#: Pruefsumme im Aenderungsprotokoll. Wer Dateien umbenennen darf, soll das
#: nicht automatisch duerfen.
FILESHARE_SIGNATURE = Resource(
key="fileshare_signature",
parent="fileshare",
label="Unterschriften",
actions=(A.READ, A.EXECUTE),
hint="Mit dem Finger unterschreiben; das Ergebnis ist unveränderbar",
action_hints={
A.READ: "Unterschriebene Dateien öffnen und die Prüfung sehen.",
A.EXECUTE: "Unterschreiben und abgeschlossen ablegen.",
},
)
#: Welche Verzeichnisfreigabe unter welchem Namen erscheint, ist Administration
#: und kein Dateibetrieb -- es lief unter demselben Recht wie "umbenennen".
FILESHARE_MAPPINGS = Resource(
key="fileshare_mappings",
parent="fileshare",
label="Freigabe-Zuordnungen",
actions=(A.READ, A.CREATE, A.WRITE, A.DELETE),
hint="Verzeichnisgruppe, UNC-Pfad und Anzeigename einer Freigabe",
)
LOGS_DHCP = Resource(
key="logs_dhcp",
label="DHCP-Protokoll",
actions=(A.VIEW,),
actions=(A.READ,),
)
MONITORING_AREA = Area(
key="monitoring",
label="Überwachung",
icon="cpu",
hint="Geraete, Switche, Zugangsdaten und Wartung. Ohne diesen Zugang bleibt der "
hint="Geräte, Switche und Zugangsdaten. Ohne diesen Zugang bleibt der "
"gesamte Bereich verborgen.",
resources=(DEVICES, SWITCHES, CREDENTIALS, MAINTENANCE),
resources=(
DEVICES,
DEVICE_RESTART_POE,
DEVICE_RESTART_SSH,
DEVICE_RESTART_RPC,
DEVICE_CONSOLE,
SWITCHES,
SWITCH_CONSOLE,
HOSTKEYS,
CREDENTIALS,
),
)
#: Wartung ueberwacht nichts, sie greift ein -- und sie steht seit 2.5.0 als
#: eigener Punkt im Menue. Der Bereichsschluessel heisst ``servicing``, weil
#: ``maintenance`` schon die Ressource ist und Bereiche und Ressourcen sich
#: einen Namensraum teilen. Nach aussen heisst beides "Wartung".
MAINTENANCE_AREA = Area(
key="servicing",
label="Wartung",
icon="wrench",
hint="Paketpflege und Neustarts. Ohne diesen Zugang bleibt der Bereich "
"verborgen – auch wenn einzelne Rechte darunter gesetzt sind.",
resources=(SERVICING_UPDATE, SERVICING_REBOOT, SERVICING_TOOL),
)
NETWORK_AREA = Area(
key="network",
label="Netzwerkdienste",
icon="network",
resources=(DHCP,),
resources=(DHCP_SUBNETS, DHCP_OPTIONS, DHCP_RESERVATIONS, DHCP_CONFIG, DHCP_SERVICE),
)
FILES_AREA = Area(
key="files",
label="Dateifreigaben",
icon="folder",
resources=(FILESHARE, FILESHARE_PDF),
resources=(FILESHARE, FILESHARE_PDF, FILESHARE_SIGNATURE, FILESHARE_MAPPINGS),
)
PERMISSIONS = PermissionTree(
[
MONITORING_AREA,
MAINTENANCE_AREA,
NETWORK_AREA,
FILES_AREA,
observability_area(LOGS_DHCP),
@@ -158,40 +362,78 @@ PERMISSIONS = PermissionTree(
)
#: Alle Funktionsrechte ausserhalb der Verwaltung, in einer Gruppe.
#:
#: Seit 2.8.0 heisst das Administratorkennzeichen "Verwaltung" und nicht
#: "alles": Geraete, Neustarts, DHCP und Freigaben kommen ueber Gruppen. Diese
#: Vorlage ist die Gruppe, die man sich dafuer zuweist -- und die Migration
#: gibt sie bestehenden Administratoren, damit nach dem Update nichts fehlt,
#: was vorher ging. Entfernen kann man sie mit einem Klick.
#:
#: Die Liste entsteht aus dem Baum und nicht aus Tippen: eine neue Zeile in der
#: Matrix ist sonst genau die, die hier vergessen wird.
FUNKTIONEN_VOLLZUGRIFF = RolePreset(
key="functions",
name="Funktionen (Vollzugriff)",
description=(
"Alle Rechte ausserhalb der Verwaltung. Gedacht fuer Administratoren, "
"die nicht nur einstellen, sondern auch bedienen."
),
grants=tuple(
(resource.key, "*")
for area in PERMISSIONS.areas
if area.key != PermissionTree.VERWALTUNGSBEREICH
for resource in area.resources
),
)
ROLE_PRESETS: tuple[RolePreset, ...] = (
RolePreset(
key="viewer",
name="Benutzer",
description="Standardgruppe: Geraete und Switche ansehen, laufendes Protokoll lesen.",
description="Standardgruppe: Geräte und Switche ansehen, laufendes Protokoll lesen.",
grants=(
("devices", (A.VIEW,)),
("switches", (A.VIEW,)),
("logs_live", (A.VIEW,)),
("devices", (A.READ,)),
("switches", (A.READ,)),
("logs_live", (A.READ,)),
),
is_default=True,
),
RolePreset(
key="operations",
name="Betrieb",
description="Geraete und Switche pflegen, Neustarts ausloesen, Wartung fahren.",
description="Geräte und Switche pflegen, Neustarts auslösen, Wartung fahren.",
grants=(
("devices", "*"),
("switches", (A.VIEW, A.CREATE, A.EDIT, A.EXECUTE)),
("credentials", (A.VIEW,)),
("maintenance", "*"),
("logs_live", (A.VIEW,)),
("logs_history", (A.VIEW,)),
("trash", (A.VIEW, A.EDIT)),
("device_restart_poe", "*"),
("device_restart_ssh", "*"),
("device_restart_rpc", "*"),
("device_console", "*"),
("switches", (A.READ, A.CREATE, A.WRITE)),
("switch_console", "*"),
("hostkeys", "*"),
("credentials", (A.READ,)),
("servicing_update", "*"),
("servicing_reboot", "*"),
("servicing_tool", "*"),
("logs_live", (A.READ,)),
("logs_history", (A.READ,)),
("trash", (A.READ, A.WRITE)),
),
),
RolePreset(
key="support",
name="Support",
description="Erste Hilfe am Telefon: Status sehen, PoE-Neustart ausloesen.",
description="Erste Hilfe am Telefon: Status sehen, PoE-Neustart auslösen.",
grants=(
("devices", (A.VIEW, A.EXECUTE)),
("switches", (A.VIEW,)),
("logs_live", (A.VIEW,)),
("devices", (A.READ,)),
# Nur der PoE-Weg: der wirkt auch bei einem haengenden Geraet und
# unterbricht nichts Laufendes. SSH und RPC fahren ein arbeitendes
# System herunter -- das gehoert nicht in die erste Hilfe.
("device_restart_poe", "*"),
("switches", (A.READ,)),
("logs_live", (A.READ,)),
),
),
RolePreset(
@@ -199,49 +441,64 @@ ROLE_PRESETS: tuple[RolePreset, ...] = (
name="Netzwerk",
description="DHCP und Host-Netzwerkeinstellungen.",
grants=(
("dhcp", "*"),
("dhcp_subnets", "*"),
("dhcp_options", "*"),
("dhcp_reservations", "*"),
("dhcp_config", "*"),
("dhcp_service", "*"),
("settings_network", "*"),
("logs_dhcp", (A.VIEW,)),
("devices", (A.VIEW,)),
("switches", (A.VIEW,)),
("logs_dhcp", (A.READ,)),
("devices", (A.READ,)),
("switches", (A.READ,)),
),
),
RolePreset(
key="auditor",
name="Revision",
description="Nur lesen -- inklusive Aenderungsprotokoll und Diagnose.",
description="Nur lesen – inklusive Änderungsprotokoll und Diagnose.",
grants=(
("devices", (A.VIEW,)),
("switches", (A.VIEW,)),
("credentials", (A.VIEW,)),
("dhcp", (A.VIEW,)),
("users", (A.VIEW,)),
("groups", (A.VIEW,)),
("logs_live", (A.VIEW,)),
("logs_history", (A.VIEW, A.EXPORT)),
("logs_audit", (A.VIEW, A.EXPORT)),
("diagnostics", (A.VIEW,)),
("trash", (A.VIEW,)),
("devices", (A.READ,)),
("switches", (A.READ,)),
("credentials", (A.READ,)),
("dhcp_subnets", (A.READ,)),
("dhcp_options", (A.READ,)),
("dhcp_reservations", (A.READ,)),
("users", (A.READ,)),
("groups", (A.READ,)),
("logs_live", (A.READ,)),
("logs_history", (A.READ, A.EXPORT)),
("logs_audit", (A.READ, A.EXPORT)),
("diagnostics", (A.READ,)),
("trash", (A.READ,)),
),
),
RolePreset(
key="administration",
name="Administration",
description="Benutzer, Gruppen und Einstellungen -- ohne Admin-Kennzeichen.",
description="Benutzer, Gruppen und Einstellungen – ohne Admin-Kennzeichen.",
grants=(
("users", "*"),
("groups", "*"),
("settings_system", "*"),
("settings_nav", "*"),
("settings_license", "*"),
("settings_directory", (A.VIEW, A.EDIT, A.EXECUTE)),
("settings_directory", (A.READ, A.WRITE, A.EXECUTE)),
("settings_web", "*"),
("settings_network", "*"),
("backup", (A.VIEW, A.EXECUTE, A.EXPORT)),
("backup_export", (A.READ, A.EXPORT)),
("backup_import", "*"),
("trash", "*"),
("diagnostics", (A.VIEW,)),
("logs_audit", (A.VIEW,)),
("diagnostics", (A.READ,)),
("logs_audit", (A.READ,)),
),
),
FUNKTIONEN_VOLLZUGRIFF,
)
__all__ = ["PERMISSIONS", "ROLE_PRESETS", "LOGS_DHCP"]
__all__ = [
"PERMISSIONS",
"ROLE_PRESETS",
"LOGS_DHCP",
"SERVICING_PAGE",
"DHCP_PAGE",
]
+123 -6
View File
@@ -257,19 +257,19 @@ CREATE INDEX IF NOT EXISTS idx_restart_events_method ON restart_events(method, t
V4 = """
INSERT OR IGNORE INTO group_permissions (group_id, permission)
SELECT group_id, 'fileshare.export' FROM group_permissions
WHERE permission = 'fileshare.view';
WHERE permission = 'fileshare.read';
INSERT OR IGNORE INTO group_permissions (group_id, permission)
SELECT group_id, 'fileshare_pdf.view' FROM group_permissions
WHERE permission = 'fileshare.view';
SELECT group_id, 'fileshare_pdf.read' FROM group_permissions
WHERE permission = 'fileshare.read';
INSERT OR IGNORE INTO group_permissions (group_id, permission)
SELECT group_id, 'fileshare_pdf.create' FROM group_permissions
WHERE permission = 'fileshare.create';
INSERT OR IGNORE INTO group_permissions (group_id, permission)
SELECT group_id, 'fileshare_pdf.edit' FROM group_permissions
WHERE permission = 'fileshare.edit';
SELECT group_id, 'fileshare_pdf.write' FROM group_permissions
WHERE permission = 'fileshare.write';
"""
@@ -289,10 +289,127 @@ DELETE FROM settings WHERE key = 'terminal_enabled';
"""
# Wartung ist ein eigener Bereich geworden und hat damit einen eigenen
# Kill-Switch. Ohne diesen Schritt waere sie nach dem Update bei allen weg:
# das neue Bereichsrecht ist bei niemandem gesetzt, und ohne Bereichsrecht
# greift kein Recht darunter.
#
# Bewusst nicht "alle, die ein Wartungsrecht haben": wer den Bereich
# Ueberwachung nicht hatte, kam auch vorher nicht an die Wartung. Ein Update
# darf Zugang erhalten, aber keinen neuen schaffen.
#
# Die Bedingung nennt absichtlich keine festen Schluessel, sondern Praefixe:
# Wer von einer Fassung vor diesem Schritt direkt auf 2.8 geht, hat vorher die
# Migrationen des Kerns durchlaufen (core laeuft vor der Anwendung) -- die
# Rechte heissen dann schon "read"/"write" und die Wartungszeilen "servicing_".
# Mit ausgeschriebenen Schluesseln fand dieser Schritt in genau diesem Fall
# nichts und der Bereich waere doch weg. Ein Ueberrest ist die Zeile nicht:
# eine angewendete Migration laeuft nie wieder.
V6 = """
INSERT OR IGNORE INTO group_permissions (group_id, permission)
SELECT DISTINCT group_id, 'servicing.read'
FROM group_permissions
WHERE (permission LIKE 'maintenance.%' OR permission LIKE 'servicing%')
AND group_id IN (
SELECT group_id FROM group_permissions WHERE permission = 'monitoring.read'
);
"""
# Die Pruefung "unveraendert seit der Unterschrift" hing am Aenderungsprotokoll
# -- und das wird ab 20.000 Zeilen tageweise in Dateien ausgelagert. Mit dem
# ausgelagerten Tag waere die Pruefsumme aus der Datenbank verschwunden und
# jede aeltere unterschriebene Fassung waere still zu "unbekannt" geworden.
# Schlimmer noch: auch eine **veraenderte** Fassung, denn ohne Vergleichswert
# gibt es keinen Widerspruch.
#
# Deshalb eine eigene, winzige Tabelle: eine Zeile je Unterschrift, nie
# archiviert. Sie ist ein Verzeichnis, keine Wahrheit -- die Wahrheit bleibt
# das Aenderungsprotokoll mit seiner Hash-Kette, auch im Archiv.
V7 = """
CREATE TABLE IF NOT EXISTS document_signatures (
id INTEGER PRIMARY KEY AUTOINCREMENT,
sha256 TEXT NOT NULL,
share_label TEXT NOT NULL DEFAULT '',
path TEXT NOT NULL DEFAULT '',
signed_at TEXT NOT NULL,
actor TEXT NOT NULL DEFAULT '',
names TEXT NOT NULL DEFAULT '',
audit_id INTEGER
);
CREATE INDEX IF NOT EXISTS idx_document_signatures_sha
ON document_signatures(sha256);
CREATE INDEX IF NOT EXISTS idx_document_signatures_ort
ON document_signatures(share_label, path);
"""
def uebernehme_signaturen(conn) -> None: # type: ignore[no-untyped-def]
"""Traegt die bereits protokollierten Unterschriften ins Verzeichnis ein.
Ohne diesen Schritt waeren alle vor dem Update unterschriebenen Fassungen
ab sofort "unbekannt" -- richtig waere das nicht, die Eintraege stehen ja
noch da.
"""
from .services import fileshare as service
zeilen = conn.execute(
"SELECT id, ts, actor, detail FROM audit_log WHERE action='fileshare.form_signed' "
"ORDER BY id"
).fetchall()
for zeile in zeilen:
detail = str(zeile["detail"] or "")
gelesen = service.signaturdetail_lesen(detail)
if not gelesen["sha256"]:
continue
conn.execute(
"INSERT INTO document_signatures (sha256, share_label, path, signed_at, actor, "
"names, audit_id) VALUES (?,?,?,?,?,?,?)",
(
gelesen["sha256"],
gelesen["label"],
gelesen["pfad"],
str(zeile["ts"]),
str(zeile["actor"] or ""),
", ".join(gelesen["namen"]),
int(zeile["id"]),
),
)
def uebergang_funktionsgruppe(conn) -> None: # type: ignore[no-untyped-def]
"""Bestehende Administratoren behalten ihre Funktionen -- ueber eine Gruppe.
Steht hier und nicht im Kern, weil erst die Anwendung weiss, welche Zeilen
ausserhalb der Verwaltung es gibt. Laeuft nach den Migrationen des Kerns
(die Rechte heissen dann schon read/write und sind aufgeteilt).
"""
from tesm_core.rbac import service as rbac
from .permissions import FUNKTIONEN_VOLLZUGRIFF, PERMISSIONS
rbac.funktionsgruppe_fuer_administratoren(conn, PERMISSIONS, FUNKTIONEN_VOLLZUGRIFF)
TESM_MIGRATIONS: tuple[Migration, ...] = (
Migration(version=1, name="baseline", sql=V1),
Migration(version=2, name="seed-dhcp-options", fn=seed_dhcp_options),
Migration(version=3, name="restart-events", sql=V3),
Migration(version=4, name="fileshare-pdf-rechte", sql=V4),
Migration(
version=4,
name="fileshare-pdf-rechte",
sql=V4,
geaendert_weil="Die Rechteschluessel heissen seit 2.8.0 read/write. Auf einer frischen Installation laufen die Migrationen des Kerns zuerst, also muss dieser Schritt die neuen Namen setzen -- mit den alten blieben sie ungueltig.",
),
Migration(version=5, name="terminal-getrennt", sql=V5),
Migration(
version=6,
name="wartung-eigener-bereich",
sql=V6,
geaendert_weil="Die Rechteschluessel heissen seit 2.8.0 read/write. Auf einer frischen Installation laufen die Migrationen des Kerns zuerst, also muss dieser Schritt die neuen Namen setzen -- mit den alten blieben sie ungueltig.",
),
Migration(version=7, name="signaturverzeichnis", sql=V7, fn=uebernehme_signaturen),
Migration(version=8, name="funktionsgruppe-fuer-admins", fn=uebergang_funktionsgruppe),
)
+339 -22
View File
@@ -21,7 +21,9 @@ Sicherheitsrelevante Aenderungen gegenueber dem Vorgaenger:
from __future__ import annotations
import hashlib
import zlib
import json
import logging
import mimetypes
import os
@@ -41,7 +43,7 @@ from tesm_core.extension import core
logger = logging.getLogger(__name__)
_UNC_HINT = (
"Der Freigabepfad muss die Form \\\\server\\freigabe haben. Schraegstriche "
"Der Freigabepfad muss die Form \\\\server\\freigabe haben. Schrägstriche "
"gehen auch: //server/freigabe."
)
@@ -194,11 +196,11 @@ def resolve_unc_host(unc: str, suffixes: Iterable[str]) -> tuple[str, str]:
kandidat = f"{host}.{suffix.strip('.')}"
if _resolvable(kandidat):
neu = chr(92) * 2 + kandidat + (chr(92) + rest if rest else "")
return neu, f"Name {host} ueber {kandidat} aufgeloest"
return neu, f"Name {host} über {kandidat} aufgelöst"
return unc, (
f"Der Name {host} ist auf diesem Server nicht aufloesbar. Bitte den "
"vollqualifizierten Namen oder die IP-Adresse eintragen -- oder unter "
"Netzwerk eine Suchdomaene setzen."
f"Der Name {host} ist auf diesem Server nicht auflösbar. Bitte den "
"vollqualifizierten Namen oder die IP-Adresse eintragen – oder unter "
"Netzwerk eine Suchdomäne setzen."
)
@@ -236,7 +238,7 @@ def describe_mapping(row: Mapping[str, Any] | None) -> str:
gruppe = str(row["ad_group_name"] or row["ad_group_dn"] or "")
if gruppe:
teile.append(f"Gruppe: {gruppe}")
return " -- ".join(teil for teil in teile if teil)
return " – ".join(teil for teil in teile if teil)
def mapping_changes(vorher: Mapping[str, Any] | None, nachher: Mapping[str, Any] | None) -> str:
@@ -260,7 +262,7 @@ def add_mapping(
if not clean_label:
raise FileshareError("Der Anzeigename darf nicht leer sein.")
if not (ad_group_dn or "").strip():
raise FileshareError("Es ist keine Verzeichnisgruppe ausgewaehlt.")
raise FileshareError("Es ist keine Verzeichnisgruppe ausgewählt.")
cursor = conn.execute(
"INSERT INTO fileshare_mappings (ad_group_dn, ad_group_name, label, unc, created_at) "
"VALUES (?,?,?,?,?) ON CONFLICT(ad_group_dn, unc) DO NOTHING",
@@ -292,7 +294,7 @@ def update_mapping(
if not clean_label:
raise FileshareError("Der Anzeigename darf nicht leer sein.")
if not clean_dn:
raise FileshareError("Es ist keine Verzeichnisgruppe ausgewaehlt.")
raise FileshareError("Es ist keine Verzeichnisgruppe ausgewählt.")
vorhanden = Database.one(
conn, "SELECT id FROM fileshare_mappings WHERE id=?", (mapping_id,)
@@ -363,12 +365,32 @@ def mount_root() -> Path:
return Path(str(core().settings.get(db(), "fileshare_mount_root") or "/mnt/tesm-shares"))
def active_mounts(conn: sqlite3.Connection, user_id: int) -> list[Mount]:
def aktuelle_sitzung() -> str:
"""Die ID der laufenden Sitzung -- oder leer ausserhalb einer Anfrage."""
from flask import session
return str(getattr(session, "sid", "") or "")
def active_mounts(
conn: sqlite3.Connection, user_id: int, session_id: str | None = None
) -> list[Mount]:
"""Die offenen Einbindungen dieses Kontos.
Mit ``session_id`` nur die dieser Sitzung. Das braucht das Abmelden: wer
an zwei Geraeten angemeldet ist, hat je Geraet eine eigene Einbindung mit
eigenem Einhaengepunkt, und das Abmelden am einen darf das andere nicht
aushaengen.
"""
bedingung = "AND session_id = ? " if session_id else ""
werte: list[Any] = [user_id, _iso(_now())]
if session_id:
werte.insert(1, session_id)
rows = Database.all(
conn,
"SELECT * FROM fileshare_mounts WHERE user_id=? AND released_at IS NULL "
"AND expires_at > ? ORDER BY label COLLATE NOCASE",
(user_id, _iso(_now())),
"SELECT * FROM fileshare_mounts WHERE user_id=? " + bedingung
+ "AND released_at IS NULL AND expires_at > ? ORDER BY label COLLATE NOCASE, id DESC",
tuple(werte),
)
return [
Mount(
@@ -389,6 +411,38 @@ def has_mounts(user_id: int) -> bool:
return bool(active_mounts(db(), user_id))
def doppelte_zusammenfassen(
conn: sqlite3.Connection, mounts: list[Mount], session_id: str = ""
) -> list[Mount]:
"""Je Freigabe eine Karteikarte -- vorzugsweise die dieser Sitzung.
Wer an zwei Geraeten angemeldet ist, hat zwei Einbindungen derselben
Freigabe: eine je Sitzung, jede mit eigenem Einhaengepunkt. In der Leiste
stand sie deshalb doppelt, einmal "Share" und einmal wieder "Share" -- ohne
jeden Unterschied fuer den Betrachter.
Genommen wird die Einbindung der eigenen Sitzung. Nur wenn es die nicht
gibt (alte Zeile, Hintergrundprozess), bleibt eine fremde stehen.
"""
eigene: set[int] = set()
if session_id:
eigene = {
int(zeile["id"])
for zeile in Database.all(
conn,
"SELECT id FROM fileshare_mounts WHERE session_id=? AND released_at IS NULL",
(session_id,),
)
}
gewaehlt: dict[str, Mount] = {}
for mount in mounts:
schluessel = mount.unc.lower()
vorhanden = gewaehlt.get(schluessel)
if vorhanden is None or (mount.id in eigene and vorhanden.id not in eigene):
gewaehlt[schluessel] = mount
return sorted(gewaehlt.values(), key=lambda m: m.label.lower())
def mount_for_login(
conn: sqlite3.Connection,
*,
@@ -408,7 +462,7 @@ def mount_for_login(
extension = core()
sysops = extension.sysops
if sysops is None or not sysops.available:
return ["Systemhelfer nicht verfuegbar -- keine Einbindungen."]
return ["Systemhelfer nicht verfügbar – keine Einbindungen."]
dns = [dn for dn in group_dns if dn and dn.strip()]
shares = shares_for_groups(conn, dns)
@@ -431,7 +485,7 @@ def mount_for_login(
# eingebunden, aber leer. Das betrifft die Anmeldung mit zweitem Faktor, bei
# der das Passwort im zweiten Schritt nicht mehr vorliegt.
if not password:
return ["Kein Passwort fuer den Fileserver verfuegbar -- keine Einbindungen."]
return ["Kein Passwort für den Fileserver verfügbar – keine Einbindungen."]
# Was zuerst kommt: das Ende der Sitzung oder die eigene Obergrenze. Die
# Sitzung ist die eigentliche Klammer -- mit ihr endet die Einbindung; die
@@ -532,14 +586,30 @@ def forget_all_mounts(conn: sqlite3.Connection) -> int:
return int(cursor.rowcount or 0)
def release_all_for_user(conn: sqlite3.Connection, user_id: int) -> int:
def release_all_for_user(conn: sqlite3.Connection, user_id: int, session_id: str = "") -> int:
"""Loest die Einbindungen -- ohne Sitzung die des ganzen Kontos.
Beim Abmelden wird die Sitzung uebergeben: das andere Geraet desselben
Benutzers arbeitet weiter, seine Einbindung bleibt. Ohne Sitzung (etwa
beim Loeschen eines Kontos) faellt alles.
"""
count = 0
for mount in active_mounts(conn, user_id):
for mount in active_mounts(conn, user_id, session_id):
if session_id and not _gehoert_zur_sitzung(conn, mount.id, session_id):
continue
release_mount(conn, mount.id)
count += 1
return count
def _gehoert_zur_sitzung(conn: sqlite3.Connection, mount_id: int, session_id: str) -> bool:
"""Zeilen ohne Sitzung werden beim Abmelden nicht mitgerissen."""
zeile = Database.one(
conn, "SELECT session_id FROM fileshare_mounts WHERE id=?", (mount_id,)
)
return zeile is not None and str(zeile["session_id"] or "") == session_id
def sweep_expired(database: Any) -> int:
"""Loest abgelaufene Einbindungen -- laeuft im Hintergrundprozess.
@@ -596,14 +666,260 @@ def resolve_path(mount: Mount, relative: str) -> Path:
"""
candidate = PurePosixPath((relative or "").strip().lstrip("/"))
if any(part == ".." for part in candidate.parts):
raise FileshareError("Ungueltiger Pfad.")
raise FileshareError("Ungültiger Pfad.")
root = mount.path.resolve()
target = (root / str(candidate)).resolve()
if target != root and root not in target.parents:
raise FileshareError("Der Pfad liegt ausserhalb der Freigabe.")
raise FileshareError("Der Pfad liegt außerhalb der Freigabe.")
return target
#: Wie eine unterschriebene Fassung im Aenderungsprotokoll steht. Die
#: Pruefsumme ist der Anker -- sie steht im selben Eintrag wie der Name, den
#: der Unterschreibende angegeben hat.
SIGNATUR_AKTION = "fileshare.form_signed"
def pruefsumme(pfad: Path) -> str:
"""SHA-256 der Datei, blockweise gelesen."""
kessel = hashlib.sha256()
with pfad.open("rb") as strom:
for block in iter(lambda: strom.read(1024 * 1024), b""):
kessel.update(block)
return kessel.hexdigest()
def signaturdetail_lesen(detail: str) -> dict[str, Any]:
"""Zerlegt die Protokollzeile einer Unterschrift.
Aufbau: ``<Freigabe>:<Pfad> sha256=<Summe> -- angegeben unterschrieben
von: <Namen>``. Gelesen wird sie an zwei Stellen -- beim Uebernehmen
alter Eintraege und wenn das Verzeichnis nichts weiss.
"""
# Der Trenner ist heute ein Zeilenumbruch, frueher ein Leerzeichen -- die
# Zerlegung muss beides vertragen, sonst sind alte Eintraege stumm.
ort, _, rest = detail.partition("sha256=")
ort = ort.strip()
label, _, pfad = ort.partition(":")
summe = rest.split(" ", 1)[0].strip() if rest else ""
return {
"sha256": summe,
"label": label.strip(),
"pfad": pfad.strip(),
"namen": _namen_aus_detail(detail),
}
def signatur_merken(
conn: sqlite3.Connection,
*,
sha256: str,
label: str,
pfad: str,
actor: str,
namen: Iterable[str],
audit_id: int | None = None,
) -> None:
"""Haelt eine Unterschrift im Verzeichnis fest.
Das Aenderungsprotokoll bleibt der Beleg -- mit Hash-Kette und, nach der
Archivierung, in einer Datei. Dieses Verzeichnis ist nur der schnelle Weg
dorthin und wird nie ausgelagert; eine Zeile misst ein paar hundert Byte.
"""
conn.execute(
"INSERT INTO document_signatures (sha256, share_label, path, signed_at, actor, "
"names, audit_id) VALUES (?,?,?,?,?,?,?)",
(
sha256,
label,
pfad,
_iso(_now()),
actor,
", ".join(namen),
audit_id,
),
)
def signaturjournal() -> Path:
"""Wo das zweite Exemplar liegt: neben dem Archiv des Protokolls."""
return core().audit_archive_dir / "signaturen.jsonl"
def signatur_journalisieren(
*, sha256: str, label: str, pfad: str, actor: str, namen: Iterable[str]
) -> None:
"""Schreibt die Unterschrift zusaetzlich in eine Datei -- nur angehaengt.
Zwei Exemplare an zwei Orten: die Tabelle beantwortet die Frage schnell,
diese Datei ueberlebt auch eine zurueckgespielte aeltere Datenbank. Genau
das ist der Fall, den eine Sicherung erzeugt: die Datei auf der Freigabe
ist von gestern, die Datenbank von vorgestern -- ohne das Journal waere
die Unterschrift dazwischen verloren.
Ein Fehlschlag hier darf das Speichern nicht kippen: die Datei liegt
bereits auf der Freigabe, und Tabelle wie Aenderungsprotokoll haben den
Eintrag. Er wird protokolliert, nicht geworfen.
"""
eintrag = {
"ts": _iso(_now()),
"sha256": sha256,
"share": label,
"path": pfad,
"actor": actor,
"names": list(namen),
}
try:
ziel = signaturjournal()
ziel.parent.mkdir(parents=True, exist_ok=True)
neu = not ziel.exists()
with ziel.open("a", encoding="utf-8", newline=chr(10)) as strom:
strom.write(json.dumps(eintrag, ensure_ascii=False, sort_keys=True) + chr(10))
strom.flush()
# Ohne fsync steht die Zeile im Puffer des Kernels -- genau der
# Zustand, gegen den dieses Journal geschrieben wurde.
os.fsync(strom.fileno())
if neu:
try:
os.chmod(ziel, 0o640)
except OSError: # pragma: no cover - andere Dateisysteme
pass
except OSError as fehler: # pragma: no cover - Plattenfehler
logger.warning("Signaturjournal nicht geschrieben: %s", fehler)
def signaturen_aus_journal(conn: sqlite3.Connection) -> int:
"""Traegt fehlende Unterschriften aus dem Journal in die Tabelle ein.
Der Weg zurueck nach einer Wiederherstellung. Vorhandene bleiben, wie sie
sind -- verglichen wird ueber Pruefsumme und Ablageort.
"""
quelle = signaturjournal()
if not quelle.is_file():
return 0
uebernommen = 0
with quelle.open("r", encoding="utf-8") as strom:
for zeile in strom:
zeile = zeile.strip()
if not zeile:
continue
try:
eintrag = json.loads(zeile)
except ValueError:
continue
vorhanden = Database.value(
conn,
"SELECT 1 FROM document_signatures WHERE sha256=? AND path=? LIMIT 1",
(str(eintrag.get("sha256", "")), str(eintrag.get("path", ""))),
)
if vorhanden:
continue
conn.execute(
"INSERT INTO document_signatures (sha256, share_label, path, signed_at, "
"actor, names, audit_id) VALUES (?,?,?,?,?,?,NULL)",
(
str(eintrag.get("sha256", "")),
str(eintrag.get("share", "")),
str(eintrag.get("path", "")),
str(eintrag.get("ts", "")),
str(eintrag.get("actor", "")),
", ".join(eintrag.get("names", []) or []),
),
)
uebernommen += 1
return uebernommen
def signaturstand(conn: sqlite3.Connection, mount: "Mount", relative: str) -> dict[str, Any]:
"""Ist diese Datei die, die unterschrieben wurde?
Drei moegliche Antworten, und die dritte ist die wichtigste:
* ``unveraendert`` -- es gibt einen Protokolleintrag mit genau dieser
Pruefsumme. Die Datei ist Byte fuer Byte die unterschriebene.
* ``veraendert`` -- es gibt einen Eintrag zu genau diesem Ablageort, aber
mit anderer Pruefsumme. Jemand hat nach der Unterschrift etwas an der
Datei geaendert. Das ist der Fall, wegen dem es diese Pruefung gibt.
* ``unbekannt`` -- kein Eintrag. Kein Verdacht: die meisten Dateien in
einer Freigabe sind nie durch TESM gegangen.
Nachgeschlagen wird im Signaturverzeichnis (``document_signatures``) und
nicht im Aenderungsprotokoll: das wird ab 20.000 Zeilen tageweise in
Dateien ausgelagert, und mit dem ausgelagerten Tag waere die Pruefsumme aus
der Datenbank verschwunden. Eine aeltere unterschriebene Fassung waere
still zu "unbekannt" geworden -- und eine **veraenderte** ebenso, weil ohne
Vergleichswert niemand widerspricht. Das Verzeichnis wird nie archiviert.
"""
ziel = resolve_path(mount, relative)
if not ziel.is_file():
return {"status": "unbekannt"}
hash_ = pruefsumme(ziel)
zeile = Database.one(
conn,
"SELECT signed_at, actor, names FROM document_signatures WHERE sha256=? "
"ORDER BY id DESC LIMIT 1",
(hash_,),
)
if zeile is not None:
return _stand("unveraendert", hash_, zeile)
# Nichts mit dieser Pruefsumme -- aber vielleicht etwas zu diesem Ort.
zeile = Database.one(
conn,
"SELECT signed_at, actor, names FROM document_signatures WHERE share_label=? "
"AND path=? ORDER BY id DESC LIMIT 1",
(mount.label, relative),
)
if zeile is not None:
return _stand("veraendert", hash_, zeile)
return {"status": "unbekannt", "sha256": hash_}
def _stand(status: str, hash_: str, zeile: Any) -> dict[str, Any]:
namen = [teil.strip() for teil in str(zeile["names"] or "").split(",") if teil.strip()]
return {
"status": status,
"sha256": hash_,
"zeit": str(zeile["signed_at"]),
"konto": str(zeile["actor"] or ""),
"namen": namen,
}
def _namen_aus_detail(detail: str) -> list[str]:
"""Die angegebenen Namen aus dem Protokolltext -- ohne sie zu deuten."""
marke = "angegeben unterschrieben von: "
if marke not in detail:
return []
return [teil.strip() for teil in detail.split(marke, 1)[1].split(",") if teil.strip()]
#: Mehr als das zaehlt niemand mehr mit dem Auge -- und auf einer
#: Netzwerkfreigabe kostet jeder weitere Eintrag Zeit.
ZAEHLGRENZE = 500
def _inhalt_zaehlen(verzeichnis: Path) -> int:
"""Wie viele Eintraege liegen im Ordner? Begrenzt gezaehlt.
Gezeigt wird die Zahl an der Stelle, an der bei einer Datei die Groesse
steht -- dort stand bisher ein Gedankenstrich. Bei mehr als
``ZAEHLGRENZE`` bricht das Zaehlen ab: die Oberflaeche schreibt dann
"500+", und niemand wartet auf eine Freigabe mit 40.000 Dateien.
"""
anzahl = 0
try:
with os.scandir(verzeichnis) as eintraege:
for _ in eintraege:
anzahl += 1
if anzahl >= ZAEHLGRENZE:
break
except OSError:
return -1
return anzahl
def list_directory(mount: Mount, relative: str = "") -> dict[str, Any]:
path = resolve_path(mount, relative)
if not path.is_dir():
@@ -625,6 +941,7 @@ def list_directory(mount: Mount, relative: str = "") -> dict[str, Any]:
),
}
if entry.is_dir():
record["entries"] = _inhalt_zaehlen(entry)
directories.append(record)
else:
record["previewable"] = entry.suffix.lower() in PREVIEW_MIME
@@ -655,7 +972,7 @@ def preview_mime(name: str) -> str:
suffix = Path(name).suffix.lower()
if suffix in PREVIEW_MIME:
return PREVIEW_MIME[suffix]
raise FileshareError("Fuer diesen Dateityp gibt es keine Vorschau -- bitte herunterladen.")
raise FileshareError("Für diesen Dateityp gibt es keine Vorschau – bitte herunterladen.")
def download_mime(name: str) -> str:
@@ -667,7 +984,7 @@ def safe_filename(name: str) -> str:
"""Verhindert Pfadanteile und versteckte Dateien in Uploads/Neuanlagen."""
cleaned = os.path.basename((name or "").strip().replace("\\", "/"))
if not cleaned or cleaned in {".", ".."} or cleaned.startswith("."):
raise FileshareError("Ungueltiger Dateiname.")
raise FileshareError("Ungültiger Dateiname.")
if len(cleaned) > 200:
raise FileshareError("Der Dateiname ist zu lang.")
return cleaned
@@ -739,14 +1056,14 @@ def free_name(parent: Path, stem: str, zusatz: str, suffix: str) -> Path:
kandidat = parent / f"{stem}{zusatz}-{zaehler}{suffix}"
zaehler += 1
if zaehler > 200:
raise FileshareError("Zu viele Dateien dieses Namens -- bitte aufraeumen.")
raise FileshareError("Zu viele Dateien dieses Namens – bitte aufräumen.")
return kandidat
def delete_entry(mount: Mount, relative: str) -> str:
path = resolve_path(mount, relative)
if path == mount.path.resolve():
raise FileshareError("Das Wurzelverzeichnis der Freigabe kann nicht geloescht werden.")
raise FileshareError("Das Wurzelverzeichnis der Freigabe kann nicht gelöscht werden.")
if path.is_dir():
shutil.rmtree(path)
return "Verzeichnis"
+29 -23
View File
@@ -54,13 +54,13 @@ def is_ssh_managed(category: str | None) -> bool:
#: war "Windows-Client" vorher -- waehlbar, aber ohne jede Wirkung.
CATEGORY_EFFECTS: dict[str, str] = {
"switch": "Anmeldung an Switchen: PoE schalten, Konsole, Statusabfragen.",
"linux": "Wartung ueber SSH: Paketaktualisierung (apt) und Neustart. Konsole.",
"linux": "Wartung über SSH: Paketaktualisierung (apt) und Neustart. Konsole.",
"windows": (
"Neustart ueber RPC (wie 'shutdown /m'). Kein SSH, kein Host-Schluessel. Das "
"Geraet braucht offene Datei- und Druckerfreigabe (Port 445); das Konto braucht "
"Neustart über RPC (wie 'shutdown /m'). Kein SSH, kein Host-Schlüssel. Das "
"Gerät braucht offene Datei- und Druckerfreigabe (Port 445); das Konto braucht "
"das Recht, aus der Ferne herunterzufahren. Paketaktualisierung gibt es hier nicht."
),
"router": "Nur Dokumentation -- diese Kategorie loest keine Aktion aus.",
"router": "Nur Dokumentation – diese Kategorie löst keine Aktion aus.",
}
DEVICE_CATEGORIES: tuple[tuple[str, str], ...] = (
@@ -95,7 +95,7 @@ def normalize_mac(value: str) -> str:
cleaned = re.sub(r"[^0-9a-fA-F]", "", value or "")
if len(cleaned) != 12:
raise ValidationError(
"Die MAC-Adresse muss zwoelf hexadezimale Zeichen enthalten "
"Die MAC-Adresse muss zwölf hexadezimale Zeichen enthalten "
"(z. B. aa:bb:cc:dd:ee:ff)."
)
return ":".join(cleaned[index : index + 2] for index in range(0, 12, 2)).lower()
@@ -106,7 +106,7 @@ def validate_ip(value: str, *, field: str = "IP-Adresse") -> str:
try:
ipaddress.ip_address(text)
except ValueError as exc:
raise ValidationError(f"{field}: {text!r} ist keine gueltige IP-Adresse.") from exc
raise ValidationError(f"{field}: {text!r} ist keine gültige IP-Adresse.") from exc
return text
@@ -116,7 +116,7 @@ def validate_port_name(value: str) -> str:
return ""
if not PORT_RE.match(text):
raise ValidationError(
"Die Portbezeichnung enthaelt unerlaubte Zeichen (erlaubt: Buchstaben, "
"Die Portbezeichnung enthält unerlaubte Zeichen (erlaubt: Buchstaben, "
"Ziffern, / . : -)."
)
return text
@@ -125,7 +125,7 @@ def validate_port_name(value: str) -> str:
def validate_hostname(value: str) -> str:
text = (value or "").strip()
if not HOSTNAME_RE.match(text):
raise ValidationError("Der Hostname enthaelt unerlaubte Zeichen oder ist leer.")
raise ValidationError("Der Hostname enthält unerlaubte Zeichen oder ist leer.")
return text
@@ -208,7 +208,7 @@ def create_credential(
if existing["deleted_at"]:
raise ValidationError(
f"Zugangsdaten namens {clean_name!r} liegen im Papierkorb. Stellen Sie sie "
"wieder her oder loeschen Sie sie endgueltig."
"wieder her oder löschen Sie sie endgültig."
)
raise ValidationError(f"Zugangsdaten namens {clean_name!r} existieren bereits.")
@@ -258,11 +258,11 @@ def update_credential(
if clean_name != str(row["name"]):
changes.append(f"Name: {row['name']} -> {clean_name}")
if (username or "").strip() != str(row["username"] or ""):
changes.append("Benutzer geaendert")
changes.append("Benutzer geändert")
if category != str(row["category"]):
changes.append(f"Kategorie: {row['category']} -> {category}")
if (description or "").strip() != str(row["description"] or ""):
changes.append("Beschreibung geaendert")
changes.append("Beschreibung geändert")
conn.execute(
"UPDATE credentials SET name=?, username=?, category=?, description=?, updated_at=?, "
@@ -274,7 +274,7 @@ def update_credential(
"UPDATE credentials SET secret_encrypted=? WHERE id=?",
(keystore.encrypt(secret, aad=aad_for_credential(credential_id)), credential_id),
)
changes.append("Passwort geaendert")
changes.append("Passwort geändert")
return changes
@@ -296,8 +296,8 @@ def credential_secret(
secret = keystore.decrypt(encrypted, aad=aad_for_credential(int(credential_id)))
except DecryptionError as exc:
raise ValidationError(
"Das gespeicherte Passwort konnte nicht entschluesselt werden. Wurde der "
"Datenschluessel ausgetauscht? Bitte die Zugangsdaten neu eingeben."
"Das gespeicherte Passwort konnte nicht entschlüsselt werden. Wurde der "
"Datenschlüssel ausgetauscht? Bitte die Zugangsdaten neu eingeben."
) from exc
return str(row["username"] or ""), secret
@@ -315,7 +315,7 @@ def delete_credential(conn: sqlite3.Connection, credential_id: int) -> None:
if int(row.get("switches") or 0) or int(row.get("devices") or 0):
raise ValidationError(
f"Diese Zugangsdaten werden noch von {row.get('switches')} Switch(en) und "
f"{row.get('devices')} Geraet(en) verwendet."
f"{row.get('devices')} Gerät(en) verwendet."
)
conn.execute("UPDATE credentials SET deleted_at=? WHERE id=?", (_now(), credential_id))
@@ -509,7 +509,7 @@ def delete_switch(conn: sqlite3.Connection, switch_id: int) -> None:
)
if int(count or 0):
raise ValidationError(
f"Diesem Switch sind noch {count} Geraet(e) zugeordnet. Bitte zuerst umhaengen."
f"Diesem Switch sind noch {count} Gerät(e) zugeordnet. Bitte zuerst umhängen."
)
conn.execute("UPDATE switches SET deleted_at=? WHERE id=?", (_now(), switch_id))
@@ -590,13 +590,13 @@ def create_device(
)
if existing is not None:
if existing["deleted_at"]:
raise ValidationError(f"Ein Geraet mit der MAC {clean_mac} liegt im Papierkorb.")
raise ValidationError(f"Ein Geraet mit der MAC {clean_mac} existiert bereits.")
raise ValidationError(f"Ein Gerät mit der MAC {clean_mac} liegt im Papierkorb.")
raise ValidationError(f"Ein Gerät mit der MAC {clean_mac} existiert bereits.")
if switch_id and not clean_port:
raise ValidationError(
"Zu einem zugeordneten Switch gehoert eine Portbezeichnung -- sonst ist kein "
"PoE-Neustart moeglich."
"Zu einem zugeordneten Switch gehört eine Portbezeichnung – sonst ist kein "
"PoE-Neustart möglich."
)
cursor = conn.execute(
@@ -651,7 +651,7 @@ def update_device(
conn, "SELECT * FROM devices WHERE id=? AND deleted_at IS NULL", (device_id,)
)
if row is None:
raise ValidationError("Dieses Geraet existiert nicht (mehr).")
raise ValidationError("Dieses Gerät existiert nicht (mehr).")
clean_name = (name or "").strip()
if not clean_name:
raise ValidationError("Der Name darf nicht leer sein.")
@@ -664,9 +664,9 @@ def update_device(
(clean_mac, device_id),
)
if clash is not None:
raise ValidationError(f"Ein Geraet mit der MAC {clean_mac} existiert bereits.")
raise ValidationError(f"Ein Gerät mit der MAC {clean_mac} existiert bereits.")
if switch_id and not clean_port:
raise ValidationError("Zu einem zugeordneten Switch gehoert eine Portbezeichnung.")
raise ValidationError("Zu einem zugeordneten Switch gehört eine Portbezeichnung.")
changes: list[str] = []
for label, before, after in (
@@ -677,6 +677,12 @@ def update_device(
("Port", str(row["port"] or ""), clean_port),
("Aktiv", str(bool(row["is_active"])), str(bool(is_active))),
("Automatischer Neustart", str(bool(row["auto_restart"])), str(bool(auto_restart))),
# Diese vier fehlten: eine geaenderte Kategorie oder ein anderer
# SSH-Port stand nirgends, obwohl beides das Verhalten aendert.
("SSH-Port", str(row["ssh_port"] or ""), str(validate_ssh_port(ssh_port) or "")),
("Zugangsdaten", str(row["credential_id"] or ""), str(credential_id or "")),
("Kategorie", str(row["category"] or ""), (category or "").strip()),
("Standort", str(row["location"] or ""), (location or "").strip()),
):
if before != after:
changes.append(f"{label}: {before or '-'} -> {after or '-'}")
+12 -12
View File
@@ -46,7 +46,7 @@ STANDARD_OPTIONS: tuple[tuple[int, str, str, str], ...] = (
(9, "lpr-servers", "ipv4-address", "LPR-Druckserver"),
(10, "impress-servers", "ipv4-address", "Impress-Server"),
(11, "resource-location-servers", "ipv4-address", "Resource Location Server"),
(13, "boot-size", "uint16", "Boot-Image-Groesse (Bloecke)"),
(13, "boot-size", "uint16", "Boot-Image-Größe (Blöcke)"),
(14, "merit-dump", "string", "Crash-Dump-Datei"),
(16, "swap-server", "ipv4-address", "Swap-Server"),
(17, "root-path", "string", "Root-Pfad (NFS)"),
@@ -54,8 +54,8 @@ STANDARD_OPTIONS: tuple[tuple[int, str, str, str], ...] = (
(19, "ip-forwarding", "boolean", "IP-Forwarding aktivieren"),
(20, "non-local-source-routing", "boolean", "Non-Local Source Routing"),
(21, "policy-filter", "string", "Policy Filter (Ziel,Maske,...)"),
(22, "max-dgram-reassembly", "uint16", "Maximale Datagramm-Reassemblierungsgroesse"),
(23, "default-ip-ttl", "uint8", "Standard-TTL fuer IP"),
(22, "max-dgram-reassembly", "uint16", "Maximale Datagramm-Reassemblierungsgröße"),
(23, "default-ip-ttl", "uint8", "Standard-TTL für IP"),
(24, "path-mtu-aging-timeout", "uint32", "Path-MTU-Aging-Timeout (Sek.)"),
(25, "path-mtu-plateau-table", "uint16", "Path-MTU-Plateau-Tabelle"),
(26, "interface-mtu", "uint16", "MTU des Interfaces"),
@@ -69,7 +69,7 @@ STANDARD_OPTIONS: tuple[tuple[int, str, str, str], ...] = (
(34, "trailer-encapsulation", "boolean", "Trailer Encapsulation"),
(35, "arp-cache-timeout", "uint32", "ARP-Cache-Timeout (Sek.)"),
(36, "ieee802-3-encapsulation", "boolean", "Ethernet-Encapsulation (IEEE 802.3)"),
(37, "default-tcp-ttl", "uint8", "Standard-TTL fuer TCP"),
(37, "default-tcp-ttl", "uint8", "Standard-TTL für TCP"),
(38, "tcp-keepalive-interval", "uint32", "TCP-Keepalive-Intervall (Sek.)"),
(40, "nis-domain", "string", "NIS-Domain"),
(41, "nis-servers", "ipv4-address", "NIS-Server"),
@@ -190,12 +190,12 @@ def validate_subnet(
) -> str:
"""Rueckgabe: leerer String bei Erfolg, sonst die Fehlermeldung."""
if not interface:
return "Es ist kein Interface ausgewaehlt."
return "Es ist kein Interface ausgewählt."
try:
start = ipaddress.ip_address(range_start)
end = ipaddress.ip_address(range_end)
except ValueError:
return "Start- und Endadresse muessen gueltige IPv4-Adressen sein."
return "Start- und Endadresse müssen gültige IPv4-Adressen sein."
if int(end) < int(start):
return "Die Endadresse liegt vor der Startadresse."
if matching_network(networks, interface, range_start, range_end) is None:
@@ -405,7 +405,7 @@ def render_config(
# fuehren, dass gar keine Konfiguration mehr geschrieben wird.
warnings.append(
f"Subnetz {subnet['range_start']}-{subnet['range_end']} auf {interface} "
"passt in kein aktuelles Netz und wurde uebersprungen."
"passt in kein aktuelles Netz und wurde übersprungen."
)
continue
interfaces.add(interface)
@@ -444,7 +444,7 @@ def render_config(
)
if not subnet_entries:
warnings.append("Es ist kein gueltiges Subnetz konfiguriert -- Kea wuerde nicht starten.")
warnings.append("Es ist kein gültiges Subnetz konfiguriert | Kea würde nicht starten.")
global_option_data = option_data(global_values)
domain = str(settings.get("dhcp_domain") or "").strip()
@@ -560,14 +560,14 @@ class Lease:
#: benutzte, und ein Geraet, das noch auf einer alten Adresse haengt, faellt
#: ueberhaupt nicht auf.
RESERVATION_STATES: dict[str, tuple[str, str]] = {
"aktiv": ("online", "Das Geraet benutzt diese Adresse gerade."),
"abgelaufen": ("", "Lease auf dieser Adresse ist abgelaufen -- Geraet derzeit nicht da."),
"aktiv": ("online", "Das Gerät benutzt diese Adresse gerade."),
"abgelaufen": ("", "Lease auf dieser Adresse ist abgelaufen | Gerät derzeit nicht da."),
"andere_adresse": (
"warning",
"Das Geraet haelt noch eine Lease auf einer anderen Adresse. Es uebernimmt die "
"Das Gerät hält noch eine Lease auf einer anderen Adresse. Es übernimmt die "
"Reservierung erst nach Ablauf oder Neuanforderung.",
),
"unbenutzt": ("", "Fuer dieses Geraet liegt keine Lease vor."),
"unbenutzt": ("", "Für dieses Gerät liegt keine Lease vor."),
}
+31 -31
View File
@@ -42,19 +42,19 @@ SUPPORTED = ("credentials", "switches", "devices", "dhcp")
KNOWN_UNSUPPORTED: dict[str, str] = {
"users": (
"Lokale Konten: der alte Passwort-Hash ist bcrypt, diese Anwendung "
"verwendet Argon2id. Ein Hash laesst sich nicht umrechnen -- das ist sein "
"verwendet Argon2id. Ein Hash lässt sich nicht umrechnen – das ist sein "
"Zweck. Konten neu anlegen."
),
"groups": "Gruppen und Rechte: die Rechteschluessel wurden neu geschnitten.",
"groups": "Gruppen und Rechte: die Rechteschlüssel wurden neu geschnitten.",
"ldap": (
"Verzeichnisdienst: Einstellungen, Gruppen- und Freigabe-Zuordnungen von "
"Hand uebertragen."
"Hand übertragen."
),
"nginx": "Webserver: Domain, Ports und Zertifikat von Hand uebertragen.",
"nginx": "Webserver: Domain, Ports und Zertifikat von Hand übertragen.",
"logs": "Auditlog: bleibt bewusst beim alten System.",
"known_hosts": (
"SSH-Host-Schluessel: werden hier je Geraet mit Fingerprint gefuehrt und "
"ueber die Seite 'Host-Schluessel' freigegeben."
"SSH-Host-Schlüssel: werden hier je Gerät mit Fingerprint geführt und "
"über die Seite 'Host-Schlüssel' freigegeben."
),
}
@@ -119,10 +119,10 @@ def open_legacy(raw: bytes | str, passphrase: str) -> dict[str, Any]:
except ValueError as exc:
raise LegacyTransferError("Die Datei ist kein JSON.") from exc
if not isinstance(envelope, dict):
raise LegacyTransferError("Die Datei enthaelt kein Objekt.")
raise LegacyTransferError("Die Datei enthält kein Objekt.")
if str(envelope.get("app") or "") != LEGACY_APP_TAG:
raise LegacyTransferError(
f"Diese Datei gehoert zu {envelope.get('app') or 'einer unbekannten Anwendung'!r}, "
f"Diese Datei gehört zu {envelope.get('app') or 'einer unbekannten Anwendung'!r}, "
"nicht zu TESM."
)
for schluessel in ("salt", "payload"):
@@ -142,15 +142,15 @@ def open_legacy(raw: bytes | str, passphrase: str) -> dict[str, Any]:
klartext = Fernet(key).decrypt(str(envelope["payload"]).encode("utf-8"))
except (InvalidToken, ValueError) as exc:
raise LegacyTransferError(
"Entschluesselung fehlgeschlagen -- falsche Passphrase oder beschaedigte Datei."
"Entschlüsselung fehlgeschlagen – falsche Passphrase oder beschädigte Datei."
) from exc
try:
payload = json.loads(klartext.decode("utf-8"))
except ValueError as exc:
raise LegacyTransferError("Die entschluesselte Nutzlast ist kein JSON.") from exc
raise LegacyTransferError("Die entschlüsselte Nutzlast ist kein JSON.") from exc
if not isinstance(payload, dict):
raise LegacyTransferError("Die Nutzlast enthaelt kein Objekt.")
raise LegacyTransferError("Die Nutzlast enthält kein Objekt.")
return payload
@@ -180,14 +180,14 @@ def _credentials(items: Any, report: Report) -> list[dict[str, Any]]:
for entry in _liste(items):
name = str(entry.get("name") or "").strip()
if not name:
report.note("Zugangsdaten ohne Namen uebersprungen.")
report.note("Zugangsdaten ohne Namen übersprungen.")
continue
umgesetzt: dict[str, Any] = {
"name": name,
"username": str(entry.get("username") or ""),
"category": _category(entry.get("category"), report, f"Zugangsdaten {name!r}"),
# Der Vorgaenger kennt kein Beschreibungsfeld.
"description": "aus altem TESM uebernommen",
"description": "aus altem TESM übernommen",
}
# Der alte Export entschluesselt das Passwort und legt es im Klartext in
# die -- als Ganzes passphrasenverschluesselte -- Datei. Beim Import
@@ -199,8 +199,8 @@ def _credentials(items: Any, report: Report) -> list[dict[str, Any]]:
ergebnis.append(umgesetzt)
if ohne_passwort:
report.note(
f"{ohne_passwort} Zugangsdaten ohne Passwort in der Datei -- "
"sie muessen nachgetragen werden."
f"{ohne_passwort} Zugangsdaten ohne Passwort in der Datei – "
"sie müssen nachgetragen werden."
)
report.took("credentials", len(ergebnis))
return ergebnis
@@ -211,7 +211,7 @@ def _switches(items: Any, report: Report) -> list[dict[str, Any]]:
for entry in _liste(items):
hostname = str(entry.get("hostname") or "").strip()
if not hostname:
report.note("Switch ohne Hostnamen uebersprungen.")
report.note("Switch ohne Hostnamen übersprungen.")
continue
ergebnis.append(
{
@@ -240,7 +240,7 @@ def _devices(items: Any, credentials: list[dict[str, Any]], report: Report) -> l
for entry in _liste(items):
mac = str(entry.get("mac") or "").strip()
if not mac:
report.note("Client ohne MAC-Adresse uebersprungen.")
report.note("Client ohne MAC-Adresse übersprungen.")
continue
zugang = entry.get("credential_name")
kategorie = kategorie_je_zugang.get(str(zugang or ""), "")
@@ -266,7 +266,7 @@ def _devices(items: Any, credentials: list[dict[str, Any]], report: Report) -> l
if abgeleitet:
report.note(
f"Kategorie von {abgeleitet} Client(s) aus den zugeordneten Zugangsdaten "
"abgeleitet -- der Vorgaenger kennt kein solches Feld. Bitte pruefen."
"abgeleitet – der Vorgänger kennt kein solches Feld. Bitte prüfen."
)
report.took("devices", len(ergebnis))
return ergebnis
@@ -298,14 +298,14 @@ def _dhcp(data: Any, report: Report) -> tuple[dict[str, Any], dict[str, str]]:
for entry in _liste(data.get("reservations")):
mac = str(entry.get("mac") or "").strip()
if not mac:
report.note("Manuelle Reservierung ohne MAC-Adresse uebersprungen.")
report.note("Manuelle Reservierung ohne MAC-Adresse übersprungen.")
continue
reservations.append(
{
"mac": mac,
"ip": str(entry.get("ip") or ""),
"hostname": str(entry.get("name") or ""),
"comment": "aus altem TESM uebernommen",
"comment": "aus altem TESM übernommen",
}
)
@@ -322,7 +322,7 @@ def _dhcp(data: Any, report: Report) -> tuple[dict[str, Any], dict[str, str]]:
"is_standard": int(bool(definition.get("is_standard"))),
}
if not gemeinsam["code"] or not gemeinsam["name"]:
report.note("DHCP-Option ohne Code oder Namen uebersprungen.")
report.note("DHCP-Option ohne Code oder Namen übersprungen.")
continue
werte = _liste(definition.get("values"))
if not werte:
@@ -339,7 +339,7 @@ def _dhcp(data: Any, report: Report) -> tuple[dict[str, Any], dict[str, str]]:
)
if ohne_wert:
report.note(
f"{ohne_wert} eigene DHCP-Option(en) ohne Wert uebersprungen -- ohne Wert "
f"{ohne_wert} eigene DHCP-Option(en) ohne Wert übersprungen – ohne Wert "
"gibt es nichts zu senden. Bei Bedarf von Hand anlegen."
)
@@ -405,7 +405,7 @@ def convert(legacy: dict[str, Any]) -> tuple[dict[str, Any], Report]:
report.note(
"Diese Zugangsdaten sind zugeordnet, fehlen aber in der Datei und bleiben "
f"deshalb leer: {', '.join(fehlend)}. Beim Export im alten TESM die "
"Kategorie 'Zugangsdaten' mitwaehlen."
"Kategorie 'Zugangsdaten' mitwählen."
)
for schluessel, grund in KNOWN_UNSUPPORTED.items():
@@ -413,12 +413,12 @@ def convert(legacy: dict[str, Any]) -> tuple[dict[str, Any], Report]:
report.note(grund)
unbekannt = sorted(set(legacy) - set(SUPPORTED) - set(KNOWN_UNSUPPORTED))
if unbekannt:
report.note(f"Unbekannte Abschnitte uebersprungen: {', '.join(unbekannt)}.")
report.note(f"Unbekannte Abschnitte übersprungen: {', '.join(unbekannt)}.")
if not payload:
raise LegacyTransferError(
"Die Datei enthaelt keine Clients, Switche, Zugangsdaten oder DHCP-Daten. "
"Beim Export im alten TESM diese Kategorien mitwaehlen."
"Die Datei enthält keine Clients, Switche, Zugangsdaten oder DHCP-Daten. "
"Beim Export im alten TESM diese Kategorien mitwählen."
)
return payload, report
@@ -488,7 +488,7 @@ def _entschluessler(root: Path, report: Report) -> Any:
schluesseldatei = root / LEGACY_FERNET_NAME
if not schluesseldatei.is_file():
report.note(
f"{LEGACY_FERNET_NAME} nicht gefunden -- die Passwoerter der Zugangsdaten "
f"{LEGACY_FERNET_NAME} nicht gefunden – die Passwörter der Zugangsdaten "
"bleiben leer und sind nachzutragen."
)
return lambda _token: ""
@@ -499,7 +499,7 @@ def _entschluessler(root: Path, report: Report) -> Any:
fernet = Fernet(schluesseldatei.read_bytes().strip())
except (ValueError, TypeError):
report.note(
f"{LEGACY_FERNET_NAME} ist unlesbar -- die Passwoerter der Zugangsdaten "
f"{LEGACY_FERNET_NAME} ist unlesbar – die Passwörter der Zugangsdaten "
"bleiben leer und sind nachzutragen."
)
return lambda _token: ""
@@ -515,8 +515,8 @@ def _entschluessler(root: Path, report: Report) -> Any:
gescheitert.append(1)
if len(gescheitert) == 1:
report.note(
"Mindestens ein Passwort liess sich mit dem gefundenen Schluessel "
"nicht entschluesseln -- es bleibt leer."
"Mindestens ein Passwort ließ sich mit dem gefundenen Schlüssel "
"nicht entschlüsseln – es bleibt leer."
)
return ""
@@ -643,7 +643,7 @@ def read_installation(root: Path) -> tuple[dict[str, Any], Report]:
payload = {key: value for key, value in payload.items() if value}
if not payload:
raise LegacyTransferError(
f"In {root} stehen keine uebernehmbaren Daten (Clients, Switche, "
f"In {root} stehen keine übernehmbaren Daten (Clients, Switche, "
"Zugangsdaten, DHCP)."
)
for abschnitt, inhalt in payload.items():
+32 -32
View File
@@ -110,47 +110,47 @@ def is_noise(line: str) -> bool:
HINTS: tuple[tuple[str, str], ...] = (
(
"incorrect password attempt",
"Das Passwort aus den Zugangsdaten wurde von 'sudo' abgewiesen. Fuer die "
"SSH-Anmeldung hat es gereicht -- 'sudo' auf diesem Geraet verlangt also ein "
"Das Passwort aus den Zugangsdaten wurde von 'sudo' abgewiesen. Für die "
"SSH-Anmeldung hat es gereicht – 'sudo' auf diesem Gerät verlangt also ein "
"anderes Passwort, oder das Konto steht nicht in der sudoers-Datei.",
),
(
"is not in the sudoers file",
"Das Wartungskonto darf auf diesem Geraet kein 'sudo' ausfuehren. Auf dem "
"Zielgeraet eintragen, z. B. in /etc/sudoers.d/tesm-wartung: "
"Das Wartungskonto darf auf diesem Gerät kein 'sudo' ausführen. Auf dem "
"Zielgerät eintragen, z. B. in /etc/sudoers.d/tesm-wartung: "
"'<benutzer> ALL=(root) /usr/bin/apt-get, /sbin/reboot'. Mit vorangestelltem "
"NOPASSWD: entfaellt die Passwortabfrage ganz.",
"NOPASSWD: entfällt die Passwortabfrage ganz.",
),
(
"a password is required",
"'sudo' verlangt ein Passwort, und in den Zugangsdaten dieses Geraets ist keines "
"hinterlegt. Tragen Sie dort das Passwort des Wartungskontos ein -- TESM reicht "
"es ueber die bereits verschluesselte SSH-Verbindung an 'sudo' weiter.",
"'sudo' verlangt ein Passwort, und in den Zugangsdaten dieses Geräts ist keines "
"hinterlegt. Tragen Sie dort das Passwort des Wartungskontos ein | TESM reicht "
"es über die bereits verschlüsselte SSH-Verbindung an 'sudo' weiter.",
),
(
"no tty present",
"Das Wartungskonto verlangt fuer 'sudo' ein Terminal. In der sudoers-Datei des "
"Zielgeraets 'Defaults requiretty' entfernen oder fuer dieses Konto abschalten.",
"Das Wartungskonto verlangt für 'sudo' ein Terminal. In der sudoers-Datei des "
"Zielgeräts 'Defaults requiretty' entfernen oder für dieses Konto abschalten.",
),
(
"command not found",
"Das Kommando gibt es auf dem Zielgeraet nicht. Die Wartung erwartet ein "
"Das Kommando gibt es auf dem Zielgerät nicht. Die Wartung erwartet ein "
"Debian- oder Ubuntu-System mit apt-get.",
),
(
"Access is denied",
"Das Konto darf auf diesem Windows-Geraet keinen Neustart ausloesen. Es muss "
"Das Konto darf auf diesem Windows-Gerät keinen Neustart auslösen. Es muss "
"Mitglied der lokalen Administratoren sein.",
),
(
"is not recognized as an internal or external command",
"Das Kommando gibt es auf diesem Geraet nicht. Ist bei den Zugangsdaten die "
"richtige Kategorie gewaehlt (Linux-Client bzw. Windows-Client)?",
"Das Kommando gibt es auf diesem Gerät nicht. Ist bei den Zugangsdaten die "
"richtige Kategorie gewählt (Linux-Client bzw. Windows-Client)?",
),
(
"Could not get lock",
"Ein anderer Paketvorgang laeuft bereits auf dem Zielgeraet (etwa "
"unattended-upgrades). Spaeter erneut versuchen.",
"Ein anderer Paketvorgang läuft bereits auf dem Zielgerät (etwa "
"unattended-upgrades). Später erneut versuchen.",
),
)
@@ -256,8 +256,8 @@ def mark_orphaned_jobs(conn: sqlite3.Connection) -> int:
"UPDATE jobs SET state='unknown', message=?, finished_at=?, updated_at=? "
"WHERE state IN ('pending','running')",
(
"Der Dienst wurde waehrend des Laufs neu gestartet. Was auf dem Zielgeraet "
"passiert ist, laesst sich von hier nicht mehr feststellen.",
"Der Dienst wurde während des Laufs neu gestartet. Was auf dem Zielgerät "
"passiert ist, lässt sich von hier nicht mehr feststellen.",
_now(),
_now(),
),
@@ -293,7 +293,7 @@ def _run_remote_command(
channel.sendall(stdin_text.encode("utf-8"))
channel.shutdown_write()
except Exception as exc: # noqa: BLE001
on_line(f"[Eingabe konnte nicht uebergeben werden: {exc}]")
on_line(f"[Eingabe konnte nicht übergeben werden: {exc}]")
deadline = time.monotonic() + timeout
pending = b""
while True:
@@ -308,7 +308,7 @@ def _run_remote_command(
elif channel.exit_status_ready():
break
elif time.monotonic() > deadline:
on_line("[Zeitlimit ueberschritten -- Verbindung wird getrennt]")
on_line("[Zeitlimit überschritten | Verbindung wird getrennt]")
channel.close()
return 124
else:
@@ -341,14 +341,14 @@ def _sudo_mode(
except Exception: # noqa: BLE001 - dann eben der Weg mit Passwort
status = 1
if status == 0:
on_line("sudo ist ohne Passwort moeglich.")
on_line("sudo ist ohne Passwort möglich.")
return SUDO_PASSWORDLESS, ""
if not password:
on_line(
"sudo verlangt ein Passwort, in den Zugangsdaten ist keines hinterlegt."
)
return SUDO_PASSWORDLESS, ""
on_line("sudo verlangt ein Passwort -- es wird aus den Zugangsdaten uebergeben.")
on_line("sudo verlangt ein Passwort – es wird aus den Zugangsdaten übergeben.")
return SUDO_WITH_PASSWORD, password + "\n"
@@ -411,7 +411,7 @@ def run_update(
)
if status != 0:
failed = True
emit(f"Schritt {label!r} endete mit Rueckgabewert {status}.")
emit(f"Schritt {label!r} endete mit Rückgabewert {status}.")
problem = hint_for("\n".join(collected))
if problem:
emit("")
@@ -465,7 +465,7 @@ def _reboot_windows(
Rueckkehr danach ist dasselbe -- und das steht beim Aufrufer.
"""
host = str(device["ip"])
emit(f"Windows-Geraet -- Neustart ueber RPC an {host} (Port {WINDOWS_PROBE_PORT}).")
emit(f"Windows-Gerät | Neustart über RPC an {host} (Port {WINDOWS_PROBE_PORT}).")
result = windowsops.reboot(host, username, password)
for line in result.output.splitlines():
@@ -582,13 +582,13 @@ def run_reboot(
sudo, sudo_stdin = _sudo_mode(transport, password, emit)
command = REBOOT_COMMAND.format(sudo=sudo)
try:
emit(f"Neustart wird ausgeloest ({command})")
emit(f"Neustart wird ausgelöst ({command})")
try:
_run_remote_command(
transport, command, timeout=20, on_line=capture, stdin_text=sudo_stdin
)
except Exception as exc: # noqa: BLE001 - Abbruch ist hier normal
emit(f"Verbindung getrennt ({exc}) -- das ist beim Neustart zu erwarten.")
emit(f"Verbindung getrennt ({exc}) – das ist beim Neustart zu erwarten.")
finally:
try:
transport.close()
@@ -621,7 +621,7 @@ def run_reboot(
)
return
update_job(database, job_id, progress=40, message="Warte auf Rueckkehr des Geraets")
update_job(database, job_id, progress=40, message="Warte auf Rückkehr des Geräts")
time.sleep(REBOOT_GRACE_SECONDS)
deadline = time.monotonic() + wait_seconds
ssh_port = probe_port
@@ -632,7 +632,7 @@ def run_reboot(
# Zeitueberschreitung, obwohl das Geraet zurueck war. Ausserdem ist
# "SSH antwortet wieder" die Aussage, auf die es hier ankommt.
if tcp_reachable(host, ssh_port):
emit(f"Geraet ist wieder erreichbar (Port {ssh_port} antwortet).")
emit(f"Gerät ist wieder erreichbar (Port {ssh_port} antwortet).")
update_job(
database,
job_id,
@@ -656,7 +656,7 @@ def run_reboot(
result="ok",
actor=actor,
duration_ms=elapsed(),
detail="Neustart ueber SSH, Geraet ist zurueckgekehrt.",
detail="Neustart über SSH, Gerät ist zurückgekehrt.",
method=method,
)
return
@@ -668,7 +668,7 @@ def run_reboot(
job_id,
state="failed",
progress=100,
message=f"Geraet nicht zurueckgekehrt ({host}:{ssh_port} antwortet nicht).",
message=f"Gerät nicht zurückgekehrt ({host}:{ssh_port} antwortet nicht).",
finished=True,
)
_log_restart(
@@ -678,7 +678,7 @@ def run_reboot(
actor=actor,
duration_ms=elapsed(),
detail=(
f"Neustart ausgeloest, aber {host}:{ssh_port} hat innerhalb von "
f"Neustart ausgelöst, aber {host}:{ssh_port} hat innerhalb von "
f"{wait_seconds}s nicht wieder geantwortet."
),
method=method,
@@ -718,7 +718,7 @@ def _log_restart(
method=method,
)
except Exception: # noqa: BLE001 - Protokollieren darf den Auftrag nie kippen
logger.exception("Neustart konnte nicht protokolliert werden (Geraet %s)", device_id)
logger.exception("Neustart konnte nicht protokolliert werden (Gerät %s)", device_id)
def start_background(target: Callable[..., None], **kwargs: Any) -> None:
+7 -7
View File
@@ -115,7 +115,7 @@ def ping(host: str, *, timeout: int = PING_TIMEOUT_SECONDS) -> PingResult:
check=False,
)
except subprocess.TimeoutExpired:
return PingResult(False, detail="Zeitlimit ueberschritten")
return PingResult(False, detail="Zeitlimit überschritten")
except OSError as exc:
return PingResult(False, detail=str(exc))
@@ -274,8 +274,8 @@ METHOD_SSH = "ssh"
METHOD_RPC = "rpc"
METHOD_LABELS = {
METHOD_POE: "PoE-Port",
METHOD_SSH: "Neustart ueber SSH",
METHOD_RPC: "Neustart ueber RPC",
METHOD_SSH: "Neustart über SSH",
METHOD_RPC: "Neustart über RPC",
}
#: Zustand zwischen ausgeloestem Neustart und Rueckkehr.
@@ -406,7 +406,7 @@ def restart_device_poe(
if not port or not switch_ip:
message = (
"Kein Switch oder kein Port zugeordnet -- ein PoE-Neustart ist nicht moeglich."
"Kein Switch oder kein Port zugeordnet – ein PoE-Neustart ist nicht möglich."
)
with write():
record_restart(
@@ -422,7 +422,7 @@ def restart_device_poe(
return {"ok": False, "message": message, "transcript": ""}
if not credential_id:
message = f"Fuer Switch {device.get('switch_hostname') or switch_ip} sind keine Zugangsdaten hinterlegt."
message = f"Für Switch {device.get('switch_hostname') or switch_ip} sind keine Zugangsdaten hinterlegt."
with write():
record_restart(
conn,
@@ -486,7 +486,7 @@ def restart_device_poe(
live.error("poe", f"{name}: PoE-Neustart fehlgeschlagen -- {outcome.error}")
return {
"ok": outcome.ok,
"message": outcome.error or "PoE-Neustart durchgefuehrt.",
"message": outcome.error or "PoE-Neustart durchgeführt.",
"transcript": outcome.transcript,
}
@@ -567,7 +567,7 @@ def run_sweep(
report.skipped_unlicensed += 1
live.warning(
"poe",
f"{name}: automatischer PoE-Neustart uebersprungen -- keine gueltige Lizenz.",
f"{name}: automatischer PoE-Neustart übersprungen – keine gültige Lizenz.",
)
continue
report.restarts_triggered += 1
+52 -13
View File
@@ -22,7 +22,7 @@ etwa bei einem Geraet, das schreibend auf eine Platte zugreift.
from __future__ import annotations
from dataclasses import dataclass
from typing import Any
from typing import Any, Callable
METHOD_POE = "poe"
METHOD_SSH = "ssh"
@@ -40,6 +40,16 @@ class Method:
#: Braucht dieser Weg das lizenzpflichtige Modul "Wartung"?
licensed: bool = False
@property
def recht(self) -> str:
"""Das Recht, das genau diesen Weg freigibt.
Am Weg und nicht in der Route: die Liste der Wege wird an vier Stellen
gebraucht (Dashboard, Geraeteliste, Detailseite, Route), und ein Recht,
das man an vier Stellen von Hand dazuschreibt, fehlt an der fuenften.
"""
return f"device_restart_{self.key}.execute"
@property
def is_poe(self) -> bool:
return self.key == METHOD_POE
@@ -54,36 +64,46 @@ DEFINITIONS: dict[str, Method] = {
POWER_ON: Method(
key=METHOD_POE,
label="Einschalten (PoE)",
hint="Schaltet den Switch-Port aus und wieder ein. Bei einem Geraet, das nicht "
hint="Schaltet den Switch-Port aus und wieder ein. Bei einem Gerät, das nicht "
"antwortet, ist das der einzige Weg, der noch etwas bewirkt.",
),
METHOD_POE: Method(
key=METHOD_POE,
label="PoE-Port",
hint="Schaltet den Switch-Port kurz ab. Wirkt auch, wenn das Geraet haengt.",
hint="Schaltet den Switch-Port kurz ab. Wirkt auch, wenn das Gerät hängt.",
),
METHOD_SSH: Method(
key=METHOD_SSH,
label="Neustart ueber SSH",
hint="Faehrt das Betriebssystem sauber herunter. Setzt ein antwortendes Geraet "
"und einen freigegebenen Host-Schluessel voraus.",
label="Neustart über SSH",
hint="Fährt das Betriebssystem sauber herunter. Setzt ein antwortendes Gerät "
"und einen freigegebenen Host-Schlüssel voraus.",
licensed=True,
),
METHOD_RPC: Method(
key=METHOD_RPC,
label="Neustart ueber RPC",
label="Neustart über RPC",
hint="Windows: wie 'shutdown /m'. Setzt offene Datei- und Druckerfreigabe voraus.",
licensed=True,
),
}
def available(device: Any, *, maintenance_active: bool = True) -> list[Method]:
def available(
device: Any,
*,
maintenance_active: bool = True,
darf: Callable[[str], bool] | None = None,
) -> list[Method]:
"""Alle Wege, die bei diesem Geraet tatsaechlich zu etwas fuehren.
Ein Weg, der nur *fast* geht -- Switch zugeordnet, aber kein Port --, gilt
als nicht verfuegbar. Ein Knopf, der verlaesslich nichts bewirkt, ist
schlimmer als kein Knopf.
``darf`` filtert zusaetzlich nach dem Recht des jeweiligen Weges (in der
Anwendung ``current_user.has``). Damit verschwindet der Knopf fuer den, der
ihn nicht druecken darf -- und zwar an allen Stellen zugleich, weil alle
dieselbe Liste benutzen. Ohne ``darf`` ist die Antwort rein technisch.
"""
def field(name: str) -> Any:
@@ -102,7 +122,10 @@ def available(device: Any, *, maintenance_active: bool = True) -> list[Method]:
# der PoE-Weg, und der heisst dort "Einschalten": er schaltet den Port
# wieder ein, statt ein laufendes System neu zu starten.
if str(field("state") or "") == "offline":
return [DEFINITIONS[POWER_ON]] if hat_poe else []
einschalten = [DEFINITIONS[POWER_ON]] if hat_poe else []
if darf is not None:
einschalten = [entry for entry in einschalten if darf(entry.recht)]
return einschalten
category = str(field("credential_category") or "")
has_login = bool(field("credential_id"))
@@ -112,23 +135,39 @@ def available(device: Any, *, maintenance_active: bool = True) -> list[Method]:
elif category == "linux":
methods.append(DEFINITIONS[METHOD_SSH])
if darf is not None:
methods = [entry for entry in methods if darf(entry.recht)]
return sorted(methods, key=lambda entry: PREFERENCE.index(entry.key))
def preferred(device: Any, *, maintenance_active: bool = True) -> Method | None:
def preferred(
device: Any,
*,
maintenance_active: bool = True,
darf: Callable[[str], bool] | None = None,
) -> Method | None:
"""Der Weg, der vorausgewaehlt wird -- oder ``None``, wenn es keinen gibt."""
options = available(device, maintenance_active=maintenance_active)
options = available(device, maintenance_active=maintenance_active, darf=darf)
return options[0] if options else None
def resolve(device: Any, requested: str, *, maintenance_active: bool = True) -> Method | None:
def resolve(
device: Any,
requested: str,
*,
maintenance_active: bool = True,
darf: Callable[[str], bool] | None = None,
) -> Method | None:
"""Prueft eine Anforderung gegen das, was tatsaechlich moeglich ist.
Die Oberflaeche darf vorschlagen; entscheiden tut der Server. Ein Weg, der
fuer dieses Geraet nicht offensteht, wird nicht "irgendwie" ersetzt --
sonst startet jemand ein Geraet anders neu, als er dachte.
"""
options = {entry.key: entry for entry in available(device, maintenance_active=maintenance_active)}
options = {
entry.key: entry
for entry in available(device, maintenance_active=maintenance_active, darf=darf)
}
if not options:
return None
if not requested:
+1 -1
View File
@@ -128,7 +128,7 @@ class ShellSession:
elif time.monotonic() > deadline:
channel.close()
raise SshError(
f"Das Kommando hat das Zeitlimit von {timeout}s ueberschritten."
f"Das Kommando hat das Zeitlimit von {timeout}s überschritten."
)
else:
time.sleep(0.05)
+11 -11
View File
@@ -48,8 +48,8 @@ class UnknownHostKey(SshError):
def __init__(self, host: str, port: int, key_type: str, fingerprint: str) -> None:
super().__init__(
f"Der SSH-Host-Schluessel von {host}:{port} ist unbekannt "
f"({key_type}, {fingerprint}). Bitte pruefen und ausdruecklich freigeben."
f"Der SSH-Host-Schlüssel von {host}:{port} ist unbekannt "
f"({key_type}, {fingerprint}). Bitte prüfen und ausdrücklich freigeben."
)
self.host = host
self.port = port
@@ -62,9 +62,9 @@ class HostKeyChanged(SshError):
def __init__(self, host: str, port: int, expected: str, received: str) -> None:
super().__init__(
f"Der SSH-Host-Schluessel von {host}:{port} hat sich geaendert "
f"Der SSH-Host-Schlüssel von {host}:{port} hat sich geändert "
f"(erwartet {expected}, erhalten {received}). Der Aufbau wurde abgebrochen. "
"Das kann ein Geraetetausch sein -- oder ein Angriff."
"Das kann ein Gerätetausch sein – oder ein Angriff."
)
self.host = host
self.port = port
@@ -187,17 +187,17 @@ def describe_probe(
if known is None:
return (
"info",
f"Host-Schluessel gelesen: {record.key_type} {record.fingerprint}. "
"Bitte gegen eine unabhaengige Quelle pruefen und dann freigeben.",
f"Host-Schlüssel gelesen: {record.key_type} {record.fingerprint}. "
"Bitte gegen eine unabhängige Quelle prüfen und dann freigeben.",
)
if known.fingerprint != record.fingerprint:
return (
"danger",
f"Achtung: der Schluessel weicht vom gespeicherten ab. Gespeichert "
f"Achtung: der Schlüssel weicht vom gespeicherten ab. Gespeichert "
f"{known.fingerprint}, gelesen {record.fingerprint}. Das kann ein "
"Geraetetausch sein -- oder ein Angriff.",
"Gerätetausch sein – oder ein Angriff.",
)
return ("success", "Der Host-Schluessel stimmt mit dem gespeicherten ueberein.")
return ("success", "Der Host-Schlüssel stimmt mit dem gespeicherten überein.")
def probe_host_key(host: str, port: int = 22, *, timeout: int = CONNECT_TIMEOUT) -> HostKeyRecord:
@@ -281,8 +281,8 @@ def open_transport(
raise SshError(
f"SSH-Handshake mit {host}:{port} fehlgeschlagen ({exc}). "
f"Freigegeben sind nur {', '.join(sorted(set(trusted_types)))} -- "
"bietet das Geraet inzwischen einen anderen Schluesseltyp an, muss der "
"Schluessel neu ausgelesen und freigegeben werden."
"bietet das Gerät inzwischen einen anderen Schlüsseltyp an, muss der "
"Schlüssel neu ausgelesen und freigegeben werden."
) from exc
raise SshError(f"SSH-Handshake mit {host}:{port} fehlgeschlagen ({exc}).") from exc
+4 -4
View File
@@ -149,7 +149,7 @@ class SwitchCli:
``tolerate_error`` (z. B. ``no page``, das nicht jede Firmware kennt).
"""
if self._channel is None:
raise SshError("Die Sitzung ist nicht geoeffnet.")
raise SshError("Die Sitzung ist nicht geöffnet.")
self.transcript.append(f"\n$ {command}\n")
self._channel.send(command + "\r\n")
output = self._read_until_prompt(timeout=timeout)
@@ -207,7 +207,7 @@ class SwitchCli:
off_state = self.poe_state(port)
if off_state == "enabled":
result.error = (
"Der Switch meldet den Port nach dem Abschalten weiter als aktiv -- "
"Der Switch meldet den Port nach dem Abschalten weiter als aktiv – "
"der Neustart hat nicht stattgefunden."
)
result.transcript = self.full_transcript
@@ -245,11 +245,11 @@ class SwitchCli:
#: Kommandos, die die Oberflaeche ohne freies Eingabefeld anbietet.
SAFE_COMMANDS: tuple[tuple[str, str], ...] = (
("show system information", "Systeminformationen"),
("show power-over-ethernet brief", "PoE-Uebersicht aller Ports"),
("show power-over-ethernet brief", "PoE-Übersicht aller Ports"),
("show interfaces brief", "Portstatus"),
("show vlans", "VLAN-Uebersicht"),
("show mac-address", "MAC-Adresstabelle"),
("show lldp info remote-device", "Nachbargeraete (LLDP)"),
("show lldp info remote-device", "Nachbargeräte (LLDP)"),
("show version", "Firmware-Version"),
("show logging", "Switch-Protokoll"),
)
+83 -5
View File
@@ -14,6 +14,7 @@ from typing import Any, Callable, Iterable
from tesm_core.db import Database
from tesm_core.keystore import Keystore
from tesm_core.rbac.legacy_permissions import umgeschrieben
from tesm_core.transfer import (
MIN_PASSPHRASE_LENGTH,
PREVIEW_TTL_MINUTES,
@@ -50,13 +51,13 @@ def unseal(raw: bytes | str, passphrase: str) -> tuple[dict[str, Any], dict[str,
CATEGORIES: tuple[Category, ...] = (
Category("devices", "Clients", "Geraetestammdaten inklusive Switch- und Portzuordnung"),
Category("devices", "Clients", "Gerätestammdaten inklusive Switch- und Portzuordnung"),
Category("switches", "Switche", "Switch-Inventar"),
Category(
"credentials",
"Zugangsdaten",
"SSH-Logins. Die Passwoerter liegen im Export im Klartext -- geschuetzt "
"ausschliesslich durch die Passphrase.",
"SSH-Logins. Die Passwörter liegen im Export im Klartext – geschützt "
"ausschließlich durch die Passphrase.",
sensitive=True,
),
Category("dhcp", "DHCP-Konfiguration", "Subnetze, Optionen und manuelle Reservierungen"),
@@ -64,6 +65,13 @@ CATEGORIES: tuple[Category, ...] = (
Category("users", "Benutzer", "Lokale Konten mit Passwort-Hash", admin_only=True),
Category("groups", "Gruppen und Rechte", "Rechtematrix", admin_only=True),
Category("settings", "Einstellungen", "Laufzeiteinstellungen der Anwendung", admin_only=True),
Category(
"signatures",
"Unterschriften",
"Pruefsummen unterschriebener Dokumente. Ohne sie sagt die Vorschau nach einer "
"Wiederherstellung zu jeder alten Fassung \"unbekannt\" – auch zu einer "
"veraenderten.",
),
)
CATEGORY_BY_KEY = {category.key: category for category in CATEGORIES}
@@ -123,7 +131,7 @@ def build_export(
str(row["secret_encrypted"]), aad=aad_for_credential(int(row["id"]))
)
except Exception: # noqa: BLE001
entry["secret_error"] = "nicht entschluesselbar"
entry["secret_error"] = "nicht entschlüsselbar"
entries.append(entry)
payload["credentials"] = entries
if "dhcp" in wanted:
@@ -186,6 +194,16 @@ def build_export(
# Sicherung -- sonst wuerde ein Restore eine fremde Aktivierung erben.
if not str(row["key"]).startswith("license_")
}
if "signatures" in wanted:
# Das Verzeichnis der Unterschriften. Der Beleg selbst bleibt das
# Aenderungsprotokoll (Hash-Kette) und das Journal neben dem Archiv --
# beides wandert nicht in die Sicherung. Ohne diese Zeilen waere nach
# einer Wiederherstellung jede unterschriebene Fassung "unbekannt".
payload["signatures"] = Database.all(
conn,
"SELECT sha256, share_label, path, signed_at, actor, names "
"FROM document_signatures ORDER BY id",
)
return payload
@@ -237,6 +255,9 @@ def apply_import(
"""
from .inventory import ValidationError, aad_for_credential, normalize_mac
#: Merkt, ob das Paket alte Rechteschluessel mitbringt (siehe unten).
alte_fassung: set[bool] = set()
def mac_or_none(value: Any) -> str | None:
"""MAC normalisieren, ohne den ganzen Import zu sprengen.
@@ -557,9 +578,21 @@ def apply_import(
group_id = int(existing["id"])
bump("groups", "updated")
conn.execute("DELETE FROM group_permissions WHERE group_id=?", (group_id,))
# Eine Sicherung aus 2.7.x nennt devices.view und devices.edit.
# Ohne die Umschreibung landen lauter unbekannte Schluessel in der
# Gruppe, und sanitize() wirft Unbekanntes still weg: die
# wiederhergestellte Gruppe waere leer, ohne eine Zeile Meldung.
mitgebracht = [str(recht) for recht in entry.get("permissions", []) or []]
neue = umgeschrieben(mitgebracht)
if sorted(set(mitgebracht)) != neue:
# Das Paket kennt die alten Schluessel -- es stammt also von
# vor 2.8.0. Ein Versionsfeld gibt es im Umschlag nicht, aber
# die Schluessel selbst sind das verlaesslichere Kennzeichen:
# sie stehen genau dann drin, wenn die Sicherung aelter ist.
alte_fassung.add(True)
conn.executemany(
"INSERT OR IGNORE INTO group_permissions (group_id, permission) VALUES (?,?)",
[(group_id, str(permission)) for permission in entry.get("permissions", [])],
[(group_id, permission) for permission in neue],
)
if "users" in wanted:
@@ -625,6 +658,38 @@ def apply_import(
(user_id, int(group_id)),
)
if "signatures" in wanted:
for eintrag in payload.get("signatures") or []:
if not isinstance(eintrag, dict):
continue
summe = str(eintrag.get("sha256") or "").strip()
pfad = str(eintrag.get("path") or "").strip()
if not summe:
continue
# Zweimal einlesen darf nichts verdoppeln: verglichen wird ueber
# Pruefsumme und Ablageort, genau wie beim Journal.
vorhanden = Database.value(
conn,
"SELECT 1 FROM document_signatures WHERE sha256=? AND path=? LIMIT 1",
(summe, pfad),
)
if vorhanden:
bump("signatures", "skipped")
continue
conn.execute(
"INSERT INTO document_signatures (sha256, share_label, path, signed_at, "
"actor, names, audit_id) VALUES (?,?,?,?,?,?,NULL)",
(
summe,
str(eintrag.get("share_label") or ""),
pfad,
str(eintrag.get("signed_at") or stamp),
str(eintrag.get("actor") or ""),
str(eintrag.get("names") or ""),
),
)
bump("signatures", "created")
if "settings" in wanted:
for key, value in (payload.get("settings") or {}).items():
if str(key).startswith("license_"):
@@ -634,4 +699,17 @@ def apply_import(
set_setting(str(key), value)
bump("settings", "updated")
if alte_fassung and "users" in wanted:
# Dieselbe Ueberlegung wie in der Migration: in der Welt, aus der
# diese Sicherung kommt, konnte ein Administrator alles. Ohne die
# Gruppe fehlt ihm nach dem Einlesen die halbe Anwendung -- und er
# haelt das fuer einen Fehler der Wiederherstellung.
from tesm_core.rbac import service as rbac
from ..permissions import FUNKTIONEN_VOLLZUGRIFF, PERMISSIONS
rbac.funktionsgruppe_fuer_administratoren(
conn, PERMISSIONS, FUNKTIONEN_VOLLZUGRIFF
)
return report
+20 -20
View File
@@ -51,28 +51,28 @@ def available() -> bool:
HINTS: tuple[tuple[str, str], ...] = (
(
"NT_STATUS_LOGON_FAILURE",
"Benutzername oder Passwort wurden vom Windows-Geraet abgewiesen. Bei einem "
"Domaenenkonto die Form DOMAENE\\benutzer verwenden -- mit *einem* "
"Benutzername oder Passwort wurden vom Windows-Gerät abgewiesen. Bei einem "
"Domänenkonto die Form DOMAENE\\benutzer verwenden – mit *einem* "
"Backslash.",
),
(
"NT_STATUS_ACCESS_DENIED",
"Das Konto darf auf diesem Geraet keinen Neustart ausloesen. Es braucht das Recht "
"'Herunterfahren von einem Remotesystem aus' -- Mitglied der lokalen "
"Administratoren genuegt dafuer in der Regel.",
"Das Konto darf auf diesem Gerät keinen Neustart auslösen. Es braucht das Recht "
"'Herunterfahren von einem Remotesystem aus' | Mitglied der lokalen "
"Administratoren genügt dafür in der Regel.",
),
(
"NT_STATUS_CONNECTION_REFUSED",
"Das Geraet nimmt keine RPC-Verbindung an. Die Datei- und Druckerfreigabe muss "
"Das Gerät nimmt keine RPC-Verbindung an. Die Datei- und Druckerfreigabe muss "
"aktiv und Port 445 in der Windows-Firewall freigegeben sein.",
),
(
"NT_STATUS_IO_TIMEOUT",
"Keine Antwort auf Port 445. Ist das Geraet erreichbar und die Firewall offen?",
"Keine Antwort auf Port 445. Ist das Gerät erreichbar und die Firewall offen?",
),
(
"NT_STATUS_HOST_UNREACHABLE",
"Das Geraet ist nicht erreichbar.",
"Das Gerät ist nicht erreichbar.",
),
# Diese Meldung liest sich wie ein technisches Detail, hat aber fast immer
# eine einzige Ursache: das Konto ist auf dem Zielgeraet kein Administrator.
@@ -81,14 +81,14 @@ HINTS: tuple[tuple[str, str], ...] = (
# bekommt ein Standardkonto die winreg-Pipe gar nicht zu sehen.
(
"pipe winreg",
"Das Konto hat auf diesem Geraet keine Administratorrechte. Ein Neustart ueber "
"RPC braucht sie: die Pipe, ueber die er laeuft, ist fuer Standardkonten nicht "
"sichtbar. Ein Konto der lokalen Administratoren hinterlegen -- pruefen laesst "
"Das Konto hat auf diesem Gerät keine Administratorrechte. Ein Neustart über "
"RPC braucht sie: die Pipe, über die er läuft, ist für Standardkonten nicht "
"sichtbar. Ein Konto der lokalen Administratoren hinterlegen – prüfen lässt "
"sich das mit 'net rpc service status RemoteRegistry'.",
),
(
"NT_STATUS_OBJECT_NAME_NOT_FOUND",
"Der benoetigte RPC-Dienst antwortet auf dem Geraet nicht. Meist fehlen dem "
"Der benötigte RPC-Dienst antwortet auf dem Gerät nicht. Meist fehlen dem "
"Konto die Administratorrechte; sonst ist der Dienst 'Remoteregistrierung' "
"gestoppt.",
),
@@ -143,8 +143,8 @@ def _net_with_credentials(
return RemoteResult(
False,
"",
f"Auf diesem Server fehlt das Paket {REQUIRED_PACKAGE}. Ohne 'net' laesst sich "
"ein Windows-Geraet von hier nicht ansprechen.",
f"Auf diesem Server fehlt das Paket {REQUIRED_PACKAGE}. Ohne 'net' lässt sich "
"ein Windows-Gerät von hier nicht ansprechen.",
)
if not username:
return RemoteResult(False, "", "Es sind keine Zugangsdaten hinterlegt.")
@@ -176,7 +176,7 @@ def _net_with_credentials(
check=False,
)
except subprocess.TimeoutExpired:
return RemoteResult(False, "", f"Zeitlimit von {timeout}s ueberschritten.")
return RemoteResult(False, "", f"Zeitlimit von {timeout}s überschritten.")
except OSError as exc:
return RemoteResult(False, "", str(exc))
return completed.returncode, (completed.stdout + completed.stderr).strip()
@@ -190,7 +190,7 @@ def _net_with_credentials(
stream.flush()
os.fsync(stream.fileno())
except OSError: # pragma: no cover - defensiv
logger.warning("Anmeldedatei konnte nicht ueberschrieben werden: %s", path)
logger.warning("Anmeldedatei konnte nicht überschrieben werden: %s", path)
try:
os.unlink(path)
except OSError: # pragma: no cover - defensiv
@@ -236,10 +236,10 @@ def check(
return RemoteResult(
False,
output,
"Anmeldung erfolgreich, aber das Konto hat auf diesem Geraet keine "
"Administratorrechte. Fuer einen Neustart ueber RPC braucht es sie.",
"Anmeldung erfolgreich, aber das Konto hat auf diesem Gerät keine "
"Administratorrechte. Für einen Neustart über RPC braucht es sie.",
)
return RemoteResult(False, output, hint_for(output) or "Pruefung fehlgeschlagen.")
return RemoteResult(False, output, hint_for(output) or "Prüfung fehlgeschlagen.")
def reboot(
@@ -275,5 +275,5 @@ def reboot(
return ergebnis
code, output = ergebnis
if code == 0:
return RemoteResult(True, output or "Neustart ausgeloest.")
return RemoteResult(True, output or "Neustart ausgelöst.")
return RemoteResult(False, output, hint_for(output))
+29 -16
View File
@@ -12,8 +12,8 @@ TESM_SETTINGS: tuple[SettingSpec, ...] = (
"monitor_interval_seconds",
300,
"int",
"Pruefintervall (Sekunden)",
hint="Abstand zwischen zwei Erreichbarkeitspruefungen. Lizenzpflichtig.",
"Prüfintervall (Sekunden)",
hint="Abstand zwischen zwei Erreichbarkeitsprüfungen. Lizenzpflichtig.",
section="monitoring",
minimum=30,
maximum=86400,
@@ -23,8 +23,8 @@ TESM_SETTINGS: tuple[SettingSpec, ...] = (
2,
"int",
"Fehlversuche bis zum automatischen PoE-Neustart",
hint="Erst nach so vielen aufeinanderfolgenden Fehlschlaegen wird geschaltet. "
"Der Vorgaenger schaltete sofort beim ersten Ausfall.",
hint="Erst nach so vielen aufeinanderfolgenden Fehlschlägen wird geschaltet. "
"Der Vorgänger schaltete sofort beim ersten Ausfall.",
section="monitoring",
minimum=1,
maximum=10,
@@ -40,8 +40,8 @@ TESM_SETTINGS: tuple[SettingSpec, ...] = (
"dashboard_public",
True,
"bool",
"Statusuebersicht ohne Anmeldung erreichbar",
hint="Zeigt ausschliesslich Name und Erreichbarkeit aktiver Geraete -- keine "
"Statusübersicht ohne Anmeldung erreichbar",
hint="Zeigt ausschließlich Name und Erreichbarkeit aktiver Geräte – keine "
"IP-Adressen, keine Switch-Zuordnung, keine Verwaltungsfunktionen.",
section="monitoring",
),
@@ -74,7 +74,7 @@ TESM_SETTINGS: tuple[SettingSpec, ...] = (
"fileshare_max_age_hours",
12,
"int",
"Einbindungen automatisch loesen nach (Stunden)",
"Einbindungen automatisch lösen nach (Stunden)",
section="fileshare",
minimum=1,
maximum=168,
@@ -93,20 +93,33 @@ TESM_SETTINGS: tuple[SettingSpec, ...] = (
"maintenance_reboot_wait",
300,
"int",
"Wartezeit auf die Rueckkehr nach einem Neustart (Sekunden)",
"Wartezeit auf die Rückkehr nach einem Neustart (Sekunden)",
section="maintenance",
minimum=30,
maximum=1800,
),
# -- Unterschriften ------------------------------------------------------ #
SettingSpec(
"signature_witness_enabled",
True,
"bool",
"Unterschriften mit dem ablegenden Konto bezeugen",
hint="Eine Zeile unter der **ersten** Unterschrift nennt das Konto, das das "
"Dokument in TESM abgelegt hat. In den Dokumenteigenschaften und im "
"Änderungsprotokoll steht es ohnehin, unabhängig von diesem Schalter. Der Name in "
"der Unterschrift ist eine Angabe des Unterschreibenden – wie auf Papier; das "
"Konto ist belegt. Eine Passwortabfrage gibt es dafür nicht.",
section="fileshare",
),
# -- Terminal ----------------------------------------------------------- #
SettingSpec(
"terminal_switches_enabled",
True,
"bool",
"Browser-Konsole fuer Switche zulassen",
hint="Auch wenn aktiv: erfordert das Recht 'Ausfuehren' auf Switche, eine frische "
"Passwortbestaetigung und wird vollstaendig protokolliert. Das Freigeben von "
"Host-Schluesseln bleibt davon unberuehrt -- es wird fuer den PoE-Neustart "
"Browser-Konsole für Switche zulassen",
hint="Auch wenn aktiv: erfordert das Recht 'Ausführen' auf Switche, eine frische "
"Passwortbestätigung und wird vollständig protokolliert. Das Freigeben von "
"Host-Schlüsseln bleibt davon unberührt – es wird für den PoE-Neustart "
"gebraucht.",
section="monitoring",
),
@@ -114,16 +127,16 @@ TESM_SETTINGS: tuple[SettingSpec, ...] = (
"terminal_clients_enabled",
True,
"bool",
"Browser-Konsole fuer Clients zulassen",
hint="Braucht zusaetzlich das Modul Wartung und das Recht 'Ausfuehren' auf Wartung. "
"Das Freigeben von Host-Schluesseln bleibt davon unberuehrt.",
"Browser-Konsole für Clients zulassen",
hint="Braucht zusätzlich das Modul Wartung und das Recht 'Ausführen' auf Wartung. "
"Das Freigeben von Host-Schlüsseln bleibt davon unberührt.",
section="monitoring",
),
SettingSpec(
"terminal_idle_timeout",
300,
"int",
"Terminal bei Untaetigkeit trennen nach (Sekunden)",
"Terminal bei Untätigkeit trennen nach (Sekunden)",
section="monitoring",
minimum=60,
maximum=3600,
@@ -84,7 +84,7 @@
<a class="btn btn--sm btn--ghost" href="{{ url_for('devices.detail', device_id=tile.id) }}">
Details
</a>
{% if current_user.has('devices.execute') and tile.restart_methods %}
{% if tile.restart_methods %}
{% set method = tile.restart_methods[0] %}
<form method="post" data-no-guard
action="{{ url_for('devices.restart_device', device_id=tile.id) }}">
@@ -99,7 +99,7 @@
</button>
</form>
{% endif %}
{% if current_user.has('devices.edit') and tile.state == 'disabled' %}
{% if current_user.has('devices.write') and tile.state == 'disabled' %}
<form method="post" action="{{ url_for('devices.toggle_active', device_id=tile.id) }}"
data-no-guard>
<input type="hidden" name="{{ csrf_field_name }}" value="{{ csrf_token() }}">
@@ -149,10 +149,10 @@ sie getrennt von der Sicherung auf.', 'warning', 'Passphrase') }}
</div>
<div class="card__body">
<ul class="stack stack--tight fs-sm muted">
<li>Verzeichniskonten werden nie exportiert -- sie entstehen am Ziel bei der ersten Anmeldung neu.</li>
<li>Verzeichniskonten werden nie exportiert – sie entstehen am Ziel bei der ersten Anmeldung neu.</li>
<li>Lizenz- und Aktivierungszustand bleiben ausgenommen: sie gehören zur Maschine, nicht zur Sicherung.</li>
<li>Sitzungen, Ratenbegrenzung und das Änderungsprotokoll sind nicht Teil der Sicherung.</li>
<li>Der Zwischenstand des Imports liegt in der Datenbank -- ein Dienst-Neustall verliert ihn nicht.</li>
<li>Der Zwischenstand des Imports liegt in der Datenbank – ein Dienst-Neustall verliert ihn nicht.</li>
</ul>
</div>
</section>
@@ -79,7 +79,7 @@ davon abhängt, welche Geräte auf der Wartungsseite erscheinen.', 'info') }}
data-confirm-style="primary">{{ icon('eye', size=15) }}</button>
</form>
{% endif %}
{% if current_user.has('credentials.edit') %}
{% if current_user.has('credentials.write') %}
<button class="btn btn--sm btn--ghost" type="button"
data-dialog-open="credential-edit-{{ entry.id }}" aria-label="Bearbeiten">
{{ icon('pencil', size=15) }}
@@ -121,7 +121,7 @@ davon abhängt, welche Geräte auf der Wartungsseite erscheinen.', 'info') }}
</form>
{% endcall %}
{% endif %}
{% if current_user.has('credentials.edit') %}
{% if current_user.has('credentials.write') %}
{% for entry in credentials %}
{% call modal('credential-edit-' ~ entry.id, entry.name) %}
<form method="post" action="{{ url_for('credentials.update', credential_id=entry.id) }}">
@@ -11,12 +11,12 @@
{% endblock %}
{% block topbar_extra %}
{% if terminal_enabled and current_user.has('maintenance.execute') and device.credential_id %}
{% if terminal_enabled and current_user.has('device_console.execute') and device.credential_id %}
<a class="btn btn--sm" href="{{ url_for('terminal.device_console', device_id=device.id) }}">
{{ icon('terminal', size=15) }} Konsole
</a>
{% endif %}
{% if current_user.has('devices.execute') and restart_methods %}
{% if restart_methods %}
{% for method in restart_methods %}
<form method="post" style="display:inline"
action="{{ url_for('devices.restart_device', device_id=device.id) }}" data-no-guard>
@@ -88,7 +88,7 @@
<div class="flex-1">
<div class="card__title">{{ icon('power', size=17) }} Neustarts</div>
<div class="card__sub">
Die letzten {{ events | length }} Neustarts -- über den PoE-Port wie per SSH
Die letzten {{ events | length }} Neustarts – über den PoE-Port wie per SSH
</div>
</div>
</div>
@@ -138,7 +138,7 @@
Ohne freigegebenen Schlüssel verweigern Wartung und Konsole die Verbindung.
</div>
</div>
{% if current_user.has('devices.edit') %}
{% if current_user.has('devices.write') %}
<form method="post" action="{{ url_for('devices.probe_host_key', device_id=device.id) }}"
data-no-guard>
<input type="hidden" name="{{ csrf_field_name }}" value="{{ csrf_token() }}">
@@ -151,7 +151,7 @@
<div class="card__body stack">
{% set probed_type = request.args.get('probed_type') %}
{% set probed_fingerprint = request.args.get('probed_fingerprint') %}
{% if probed_type and probed_fingerprint and current_user.has('devices.edit') %}
{% if probed_type and probed_fingerprint and current_user.has('devices.write') %}
<div class="alert alert--warning">
{{ icon('alert', size=18) }}
<div class="alert__body">
@@ -182,7 +182,7 @@
<dd class="mono fs-xs break-all">{{ key.fingerprint }}</dd>
{% endfor %}
</dl>
{% if current_user.has('devices.edit') %}
{% if current_user.has('devices.write') %}
<form method="post"
action="{{ url_for('devices.forget_host_key', device_id=device.id) }}"
data-no-guard>
@@ -206,7 +206,7 @@
<section class="card">
<div class="card__header">
<div class="flex-1"><div class="card__title">{{ icon('info', size=17) }} Stammdaten</div></div>
{% if current_user.has('devices.edit') %}
{% if current_user.has('devices.write') %}
<a class="btn btn--sm" href="{{ url_for('devices.overview') }}">Bearbeiten</a>
{% endif %}
</div>
@@ -232,7 +232,7 @@
</dl>
{% if device.notes %}<p class="fs-sm muted mt-3">{{ device.notes }}</p>{% endif %}
</div>
{% if current_user.has('devices.edit') %}
{% if current_user.has('devices.write') %}
<div class="card__footer">
<form method="post" action="{{ url_for('devices.toggle_active', device_id=device.id) }}" data-no-guard>
<input type="hidden" name="{{ csrf_field_name }}" value="{{ csrf_token() }}">
@@ -213,10 +213,10 @@
{% endif %}
</td>
<td class="actions">
{% if current_user.has('devices.execute') %}
{% if restart_methods.get(device.id) %}
{{ restart_control(device, restart_methods.get(device.id, []), compact=True) }}
{% endif %}
{% if current_user.has('devices.edit') %}
{% if current_user.has('devices.write') %}
<button class="btn btn--sm btn--ghost" type="button"
data-dialog-open="device-edit-{{ device.id }}" aria-label="Bearbeiten">
{{ icon('pencil', size=15) }}
@@ -263,7 +263,7 @@ nicht -- damit kein Neustart vorgetäuscht wird, der nichts bewirkt.', 'info') }
{% endcall %}
{% endif %}
{% if current_user.has('devices.edit') %}
{% if current_user.has('devices.write') %}
{% for device in devices %}
{% call modal('device-edit-' ~ device.id, device.name, device.mac, 'wide') %}
<form method="post" action="{{ url_for('devices.update', device_id=device.id) }}">
+12 -12
View File
@@ -27,7 +27,7 @@
<div class="stat">
<span class="stat__label">Reservierungen</span>
<span class="stat__value">{{ reservations | length }}</span>
<span class="stat__hint">automatisch + manüll</span>
<span class="stat__hint">automatisch + manuell</span>
</div>
<div class="stat">
<span class="stat__label">Leases</span>
@@ -39,7 +39,7 @@
</div>
</div>
{% if current_user.has('dhcp.execute') %}
{% if current_user.has('dhcp_service.execute') %}
<section class="card">
<div class="card__header">
<div class="flex-1">
@@ -72,7 +72,7 @@
<div class="flex-1">
<div class="card__title">{{ icon('network', size=17) }} Subnetze</div>
<div class="card__sub">
Subnetz und Maske kommen vom laufenden System -- eingegeben wird nur der Adressbereich.
Subnetz und Maske kommen vom laufenden System – eingegeben wird nur der Adressbereich.
</div>
</div>
</div>
@@ -89,7 +89,7 @@
<td class="mono fs-sm">{{ subnet.dns or '&ndash;' | safe }}</td>
<td>{% if subnet.enabled %}{{ pill('aktiv', 'online') }}{% else %}{{ pill('pausiert', '') }}{% endif %}</td>
<td class="actions">
{% if current_user.has('dhcp.edit') %}
{% if current_user.has('dhcp_subnets.write') %}
<form method="post" action="{{ url_for('dhcp.delete_subnet', subnet_id=subnet.id) }}"
style="display:inline" data-no-guard>
<input type="hidden" name="{{ csrf_field_name }}" value="{{ csrf_token() }}">
@@ -109,7 +109,7 @@
{{ empty_state('Kein Subnetz', 'Ohne Subnetz startet Kea nicht.', 'network') }}
{% endif %}
{% if current_user.has('dhcp.edit') %}
{% if current_user.has('dhcp_subnets.create') %}
<form method="post" action="{{ url_for('dhcp.add_subnet') }}">
<input type="hidden" name="{{ csrf_field_name }}" value="{{ csrf_token() }}">
<div class="card__body">
@@ -135,7 +135,7 @@
</section>
{# -- Globale Einstellungen --------------------------------------------- #}
{% if current_user.has('dhcp.edit') %}
{% if current_user.has('dhcp_subnets.write') %}
<section class="card">
<div class="card__header">
<div class="flex-1"><div class="card__title">{{ icon('sliders', size=17) }} Globale Einstellungen</div></div>
@@ -183,7 +183,7 @@
</td>
<td class="fs-xs mono">{{ option.type }}</td>
<td>
{% if current_user.has('dhcp.edit') %}
{% if current_user.has('dhcp_options.write') %}
<form method="post" action="{{ url_for('dhcp.set_option_value') }}" class="row row--tight"
data-no-guard>
<input type="hidden" name="{{ csrf_field_name }}" value="{{ csrf_token() }}">
@@ -197,7 +197,7 @@
{% endif %}
</td>
<td class="actions">
{% if current_user.has('dhcp.edit') and not option.is_standard %}
{% if current_user.has('dhcp_options.write') and not option.is_standard %}
<form method="post" action="{{ url_for('dhcp.delete_custom_option', option_id=option.id) }}"
data-no-guard>
<input type="hidden" name="{{ csrf_field_name }}" value="{{ csrf_token() }}">
@@ -213,7 +213,7 @@
</tbody>
</table>
</div>
{% if current_user.has('dhcp.edit') %}
{% if current_user.has('dhcp_options.write') %}
<form method="post" action="{{ url_for('dhcp.add_custom_option') }}">
<input type="hidden" name="{{ csrf_field_name }}" value="{{ csrf_token() }}">
<div class="card__body">
@@ -339,7 +339,7 @@
{% endif %}
</td>
<td class="actions">
{% if reservation.source == 'manüll' and current_user.has('dhcp.edit') %}
{% if reservation.source == 'manuell' and current_user.has('dhcp_reservations.delete') %}
<form method="post" data-no-guard
action="{{ url_for('dhcp.delete_reservation', reservation_id=reservation.reservation_id) }}">
<input type="hidden" name="{{ csrf_field_name }}" value="{{ csrf_token() }}">
@@ -355,7 +355,7 @@
</tbody>
</table>
</div>
{% if current_user.has('dhcp.edit') %}
{% if current_user.has('dhcp_reservations.create') %}
<form method="post" action="{{ url_for('dhcp.add_reservation') }}">
<input type="hidden" name="{{ csrf_field_name }}" value="{{ csrf_token() }}">
<div class="card__body">
@@ -434,7 +434,7 @@
{{ icon('chevron-down', size=16) }}
</summary>
<pre class="log-view">{{ preview }}</pre>
{% if current_user.has('dhcp.edit') %}
{% if current_user.has('dhcp_config.execute') %}
<div class="card__footer">
<form method="post" action="{{ url_for('dhcp.write_config') }}" data-no-guard>
<input type="hidden" name="{{ csrf_field_name }}" value="{{ csrf_token() }}">
+108 -21
View File
@@ -5,7 +5,7 @@
{% block page_sub %}{{ mounts | length }} eingebundene Freigabe(n){% endblock %}
{% block topbar_extra %}
{% if current_user.has('fileshare.edit') %}
{% if current_user.has('fileshare.write') %}
<a class="btn btn--sm" href="{{ url_for('fileshare.mappings') }}">
{{ icon('settings', size=15) }} Zuordnungen
</a>
@@ -81,11 +81,24 @@
{% if current_user.has('fileshare.delete') %}
<td><label class="check"><input type="checkbox" name="paths" value="{{ entry.relative }}"><span class="sr-only">auswählen</span></label></td>
{% endif %}
<td>
{# Symbol und Name in einer Zeile: der Zeilenumbruch dazwischen
liess den Ordner aussehen wie zwei halbe Zeilen. #}
<td class="file-cell">
{{ icon('folder', size=15) }}
<a href="{{ url_for('fileshare.browse', share=token, path=entry.relative) }}">{{ entry.name }}</a>
</td>
<td class="numeric faint">&ndash;</td>
{# An der Stelle der Dateigrösse: wie viel liegt darin. #}
<td class="numeric faint fs-sm">
{%- if entry.entries is not defined or entry.entries < 0 -%}
&ndash;
{%- elif entry.entries >= 500 -%}
500+ Einträge
{%- elif entry.entries == 1 -%}
1 Eintrag
{%- else -%}
{{ entry.entries }} Einträge
{%- endif -%}
</td>
<td class="fs-sm">{{ entry.modified | dt }}</td>
<td class="actions"></td>
</tr>
@@ -103,6 +116,7 @@
<button class="link-icon file-name" type="button"
data-dialog-open="file-preview"
data-fill-Src="{{ url_for('fileshare.preview', token=token, path=entry.relative) }}"
data-fill-Pruefung="{{ url_for('fileshare.signature_state', token=token, path=entry.relative) }}"
data-fill-Kind="{{ entry.preview_kind }}"
data-fill-Pfad="{{ entry.relative }}"
data-fill-Name="{{ entry.name }}"
@@ -131,13 +145,14 @@
<button class="btn btn--sm btn--ghost" type="button"
data-dialog-open="file-preview"
data-fill-Src="{{ url_for('fileshare.preview', token=token, path=entry.relative) }}"
data-fill-Pruefung="{{ url_for('fileshare.signature_state', token=token, path=entry.relative) }}"
data-fill-Kind="{{ entry.preview_kind }}"
data-fill-Pfad="{{ entry.relative }}"
data-fill-Name="{{ entry.name }}"
{% if current_user.has('fileshare.export') %}data-fill-Download="{{ url_for('fileshare.download', token=token, path=entry.relative) }}"{% endif %}
aria-label="Vorschau">{{ icon('eye', size=15) }}</button>
{% endif %}
{% if current_user.has('fileshare.edit') %}
{% if current_user.has('fileshare.write') %}
<button class="btn btn--sm btn--ghost" type="button"
data-dialog-open="file-rename"
data-fill-Pfad="{{ entry.relative }}"
@@ -222,9 +237,13 @@
<div class="modal__body modal__body--flush" data-viewer
{# Ohne das Recht zum Ausfuellen zeigt die Vorschau das Dokument so,
wie es ist -- mit seinen eigenen Marken, ohne Eingabefelder. #}
data-viewer-formulare="{{ '1' if current_user.has('fileshare_pdf.view') else '' }}"
data-viewer-formulare="{{ '1' if current_user.has('fileshare_pdf.read') else '' }}"
data-viewer-pdfjs="{{ asset_url('vendor/pdfjs/pdf.min.js') }}"
data-viewer-pdflib="{{ asset_url('vendor/pdflib/pdf-lib.min.js') }}">
data-viewer-pdflib="{{ asset_url('vendor/pdflib/pdf-lib.min.js') }}"
data-viewer-konto="{{ current_user.username }}"
data-viewer-zeuge="{{ '1' if signature_witness else '0' }}"
data-viewer-zeit="{{ serverzeit }}"
data-viewer-ordnerliste="{{ verzeichnisse | tojson }}">
<div class="viewer">
<div class="viewer__stage" data-viewer-bildbuehne hidden>
<img class="viewer__img" alt="" data-viewer-bild>
@@ -243,11 +262,60 @@
eine Zeile Formular über jeder Bildvorschau. Und nur, wer Formulare
ablegen darf, sieht sie überhaupt. #}
{% if current_user.has('fileshare_pdf.create') %}
{# Unterschreiben: Name tippen, mit dem Finger zeichnen, ins Dokument
setzen. Der Name daneben ist eine Angabe des Unterschreibenden – wie
auf Papier; wer abgelegt hat, steht im Änderungsprotokoll. #}
<div class="viewer__sign" data-viewer-unterschriftpanel hidden>
<div class="viewer__signfelder">
<label class="viewer__feld">
<span class="field__label">Vorname</span>
<input class="input" data-viewer-vorname autocomplete="off">
</label>
<label class="viewer__feld">
<span class="field__label">Nachname</span>
<input class="input" data-viewer-nachname autocomplete="off">
</label>
</div>
<canvas class="viewer__signpad" data-viewer-signpad width="700" height="200"
aria-label="Unterschriftsfeld"></canvas>
<div class="viewer__signaktionen">
<span class="fs-xs faint" data-viewer-signhinweis></span>
<button class="btn btn--sm btn--ghost" type="button" data-viewer-signleeren>Leeren</button>
<button class="btn btn--sm btn--ghost" type="button" data-viewer-signabbrechen>Abbrechen</button>
<button class="btn btn--sm btn--primary" type="button" data-viewer-signsetzen>
Unterschrift setzen
</button>
</div>
<p class="fs-xs faint">
Nach „Unterschrift setzen“ auf die Stelle im Dokument tippen. Mit Unterschrift
wird immer abgeschlossen gespeichert – die Felder sind danach gesperrt.
</p>
</div>
<div class="viewer__save" data-viewer-speichernzeile hidden>
{# Zwei eingebundene Freigaben, ein Formular: die Vorlage liegt in der
einen, die ausgefüllte Fassung gehört in die andere. #}
<label class="viewer__feld">
<span class="field__label">Freigabe</span>
<select class="select" data-viewer-ziel
data-url-vorlage="{{ url_for('fileshare.folders', token='__token__') }}">
{% for eintrag in mounts %}
<option value="{{ eintrag.token }}" {% if eintrag.token == token %}selected{% endif %}>
{{ eintrag.label }}
</option>
{% endfor %}
</select>
</label>
<label class="viewer__feld">
<span class="field__label">Ordner</span>
<input class="input" list="freigabe-ordner" data-viewer-ordner
placeholder="Wurzelverzeichnis der Freigabe" autocomplete="off">
{# Auswahl statt Eingabe mit Vorschlagsliste: auf einem iPad laesst
sich ein <datalist> kaum bedienen -- das Freigabefeld daneben
zeigt, wie es sein soll. #}
<select class="select" data-viewer-ordner>
<option value="">Wurzelverzeichnis der Freigabe</option>
{% for eintrag in verzeichnisse %}
<option value="{{ eintrag }}">{{ eintrag }}</option>
{% endfor %}
</select>
</label>
<label class="viewer__feld">
<span class="field__label">Dateiname (ohne Endung)</span>
@@ -262,20 +330,34 @@
PDF-Formulare/Bearbeiten, "abgeschlossen" an Anlegen. Wer nur
anlegen darf, sieht eine Zeile statt einer Auswahl. #}
<select class="select" data-viewer-modus>
{% if current_user.has('fileshare_pdf.edit') %}
{% if current_user.has('fileshare_pdf.write') %}
<option value="formular">Formular – weiter ausfüllbar</option>
{% endif %}
<option value="fertig">Abgeschlossen – Felder gesperrt</option>
</select>
</label>
<label class="check">
<input type="checkbox" data-viewer-ersetzen>
<span>Vorhandene ersetzen</span>
</label>
<button class="btn btn--sm btn--primary" type="button" data-viewer-jetzt>Speichern</button>
<button class="btn btn--sm btn--ghost" type="button" data-viewer-abbrechen>Abbrechen</button>
{# Haken über den Knöpfen und beides rechts: gelesen wird die Zeile von
links nach rechts (wohin, wie es heißt, wie gespeichert), und die
Entscheidung steht am Ende. #}
<div class="viewer__saveaktionen">
<label class="check" data-viewer-ersetzenfeld>
<input type="checkbox" data-viewer-ersetzen>
<span>Vorhandene ersetzen</span>
</label>
<div class="viewer__saveknoepfe">
<button class="btn btn--sm btn--ghost" type="button" data-viewer-abbrechen>
Abbrechen
</button>
<button class="btn btn--sm btn--primary" type="button" data-viewer-jetzt>
Speichern
</button>
</div>
</div>
</div>
{% endif %}
{# Das Ergebnis der Pruefung steht über der Leiste – wer eine
unterschriebene Fassung öffnet, soll es sehen, bevor er liest. #}
<p class="viewer__pruefung" data-viewer-pruefung hidden></p>
<div class="viewer__bar" data-viewer-leiste hidden>
<button class="btn btn--sm btn--ghost" type="button" data-viewer-zoom="aus"
aria-label="Verkleinern">{{ icon('minus', size=15) }}</button>
@@ -292,22 +374,27 @@
{{ icon('download', size=15) }} Herunterladen
</a>
{% endif %}
{# Unterschreiben ist eine eigene Zeile der Matrix: wer ausgefuellte
Formulare ablegen darf, darf damit nicht unterschreiben. Der Server
weist es ohnehin ab -- aber ein Knopf, der immer in eine Meldung
laeuft, ist keiner. #}
{% if current_user.has('fileshare_signature.execute') %}
<button class="btn btn--sm" type="button" data-viewer-unterschreiben hidden>
{{ icon('pencil', size=15) }} Unterschreiben
</button>
{% endif %}
{% if current_user.has('fileshare_pdf.create') %}
<button class="btn btn--sm" type="button" data-viewer-speichern hidden
data-url="{{ url_for('fileshare.save_form', token=token) }}">
{{ icon('save', size=15) }} Ausgefüllt speichern
</button>
{% endif %}
<button class="btn btn--primary" type="button" data-dialog-close>Schliessen</button>
<button class="btn btn--primary" type="button" data-dialog-close>Schließen</button>
</div>
{% endcall %}
{# Die Ordner der Freigabe als Vorschlag; getippt werden darf trotzdem. #}
<datalist id="freigabe-ordner">
{% for eintrag in verzeichnisse %}<option value="{{ eintrag }}"></option>{% endfor %}
</datalist>
{% endif %}
{% if listing and current_user.has('fileshare.edit') %}
{% if listing and current_user.has('fileshare.write') %}
{% call modal('file-rename', 'Umbenennen', '', 'narrow') %}
<form method="post" action="{{ url_for('fileshare.rename', token=token) }}">
<input type="hidden" name="{{ csrf_field_name }}" value="{{ csrf_token() }}">
@@ -33,7 +33,7 @@ Einbindungen.', 'info') }}
<td class="fs-sm">{{ entry.ad_group_name }}
<div class="fs-xs faint break-all">{{ entry.ad_group_dn }}</div></td>
<td class="actions">
{% if current_user.has('fileshare.edit') %}
{% if current_user.has('fileshare.write') %}
<button class="btn btn--sm btn--ghost" type="button"
data-dialog-open="mapping-edit-{{ entry.id }}"
aria-label="Bearbeiten">{{ icon('pencil', size=15) }}</button>
@@ -80,7 +80,7 @@ Einbindungen.', 'info') }}
{# Bearbeiten statt neu anlegen: bei einem Tippfehler im UNC-Pfad oder im
Anzeigenamen soll man ihn korrigieren können. Sonst legt man daneben einen
zweiten Eintrag an und vergisst, den ersten zu löschen. #}
{% if current_user.has('fileshare.edit') %}
{% if current_user.has('fileshare.write') %}
{% for entry in mappings %}
{% call modal('mapping-edit-' ~ entry.id, entry.label, 'Zuordnung ändern') %}
<form method="post" action="{{ url_for('fileshare.mapping_update', mapping_id=entry.id) }}">
@@ -37,7 +37,7 @@ wird nie stillschweigend übernommen: das ist der Fall, der bei einem Angriff au
<div class="alert__title">Gelesener Schlüssel von {{ probed_host }}:{{ probed_port }}</div>
<div class="mono fs-sm break-all">{{ probed_type }} {{ probed_fingerprint }}</div>
<p class="fs-sm mt-2">
Vergleichen Sie den Fingerprint mit einer unabhängigen Quelle -- Konsolenzugang am
Vergleichen Sie den Fingerprint mit einer unabhängigen Quelle | Konsolenzugang am
Gerät, Inventardokumentation --, bevor Sie ihn unten freigeben.
</p>
</div>
@@ -145,7 +145,7 @@ wird nie stillschweigend übernommen: das ist der Fall, der bei einem Angriff au
<div class="flex-1">
<div class="card__title">{{ icon('alert', size=17) }} Verwaiste Freigaben</div>
<div class="card__sub">
Zu diesen Einträgen gibt es kein Ziel mehr -- gelöscht oder mit neuer IP.
Zu diesen Einträgen gibt es kein Ziel mehr – gelöscht oder mit neuer IP.
</div>
</div>
</div>
@@ -160,7 +160,7 @@ wird nie stillschweigend übernommen: das ist der Fall, der bei einem Angriff au
<td class="mono fs-xs break-all">{{ row.fingerprint }}</td>
<td class="fs-sm">{{ row.added_at | dt }} <span class="faint">von {{ row.added_by }}</span></td>
<td>
{% if current_user.has('devices.edit') or current_user.has('switches.edit') %}
{% if current_user.has('devices.write') or current_user.has('switches.write') %}
<form method="post" action="{{ url_for('hostkeys.forget_orphan') }}" data-no-guard>
<input type="hidden" name="{{ csrf_field_name }}" value="{{ csrf_token() }}">
<input type="hidden" name="host" value="{{ row.host }}">
@@ -76,7 +76,7 @@
</dd>
</dl>
</div>
{% if current_user.has('settings_license.edit') %}
{% if current_user.has('settings_license.write') %}
<div class="card__footer">
{% if not state.activated %}
<form method="post" action="{{ url_for('license.activate') }}" data-no-guard>
@@ -125,7 +125,7 @@
{% if pending.code %}
<div class="field">
<span class="field__label">
Anfragecode -- an den Anbieter übermitteln
Anfragecode – an den Anbieter übermitteln
</span>
<pre class="log-view" id="offline-request" style="max-height:14dvh">{{ pending.code }}</pre>
<div class="row row--end mt-2">
@@ -155,7 +155,7 @@
</section>
{% endif %}
{% if current_user.has('settings_license.edit') %}
{% if current_user.has('settings_license.write') %}
<section class="card">
<div class="card__header">
<div class="flex-1">
@@ -190,7 +190,7 @@
</section>
{% endif %}
{% if current_user.has('settings_license.edit') %}
{% if current_user.has('settings_license.write') %}
<section class="card">
<div class="card__header">
<div class="flex-1">
@@ -234,7 +234,7 @@
</dl>
<p class="fs-xs faint mt-3">
Der Fingerprint stammt aus der stabilen Maschinenidentität. Eine Umbenennung des Hosts
ändert ihn <strong>nicht</strong> mehr -- im Vorgänger führte genau das zu
ändert ihn <strong>nicht</strong> mehr – im Vorgänger führte genau das zu
&bdquo;bereits anderweitig gebunden&ldquo;.
</p>
</div>
@@ -5,7 +5,7 @@
{% block topbar_extra %}{{ search_box('restart-table', 'Gerät, Ergebnis, Methode ...') }}{% endblock %}
{% block content %}
{{ alert('Jeder Neustart wird mit Methode, Ergebnis, Dauer und Auslöser festgehalten -- automatisch
wie manüll, über den PoE-Port des Switches ebenso wie per Neustart-Befehl aus der Wartung.
wie manuell, über den PoE-Port des Switches ebenso wie per Neustart-Befehl aus der Wartung.
Der Vorgänger protokollierte Neustarts ausdrücklich nicht.', 'info') }}
<section class="card">
@@ -54,7 +54,7 @@ Druckerfreigabe. Der PoE-Neustart ist davon getrennt: er schaltet den Switch-Por
<span>Alle auswählen</span>
</label>
<span class="table-toolbar__spacer"></span>
{% if current_user.has('maintenance.execute') %}
{% if current_user.has('servicing_update.execute') %}
<button class="btn btn--sm btn--primary" type="submit"
formaction="{{ url_for('maintenance.start_update') }}"
title="Nur für Linux-Clients -- Windows-Geräte werden dabei übersprungen."
@@ -91,7 +91,7 @@ Druckerfreigabe. Der PoE-Neustart ist davon getrennt: er schaltet den Switch-Por
<label class="check">
<input type="checkbox" name="device_ids" value="{{ device.id }}"
class="device-select" data-category="{{ device.category }}"
{% if not current_user.has('maintenance.execute') %}disabled{% endif %}>
{% if not current_user.has('servicing_update.execute') %}disabled{% endif %}>
<span class="sr-only">{{ device.name }} auswählen</span>
</label>
</td>
@@ -121,7 +121,7 @@ Druckerfreigabe. Der PoE-Neustart ist davon getrennt: er schaltet den Switch-Por
</td>
<td class="nowrap">
{% if terminal_enabled and device.ssh_managed
and current_user.has('maintenance.execute') %}
and current_user.has('servicing_update.execute') %}
<a class="btn btn--sm btn--ghost"
href="{{ url_for('terminal.device_console', device_id=device.id) }}">
{{ icon('terminal', size=14) }} Konsole
@@ -151,7 +151,7 @@ Druckerfreigabe. Der PoE-Neustart ist davon getrennt: er schaltet den Switch-Por
<div class="flex-1">
<div class="card__title">{{ icon('clock', size=17) }} Aufträge</div>
<div class="card__sub">
Zustand liegt in der Datenbank -- ein Dienst-Neustart verliert ihn nicht mehr
Zustand liegt in der Datenbank – ein Dienst-Neustart verliert ihn nicht mehr
</div>
</div>
</div>
@@ -194,7 +194,7 @@ Druckerfreigabe. Der PoE-Neustart ist davon getrennt: er schaltet den Switch-Por
{% block scripts %}
<script type="module" nonce="{{ csp_nonce }}">
// Auswahl beim Laden bewusst zurücksetzen: Browser stellen den Checked-Zustand
// sonst aus dem Verlauf wieder her -- und dann wird bei "Neustarten"
// sonst aus dem Verlauf wieder her – und dann wird bei "Neustarten"
// versehentlich das falsche Gerät erwischt.
const boxes = Array.from(document.querySelectorAll(".device-select"));
boxes.forEach((box) => (box.checked = false));
@@ -211,7 +211,7 @@ Druckerfreigabe. Der PoE-Neustart ist davon getrennt: er schaltet den Switch-Por
const state = await window.tesm.api("{{ url_for('maintenance.status') }}");
if (state.running) window.setTimeout(() => location.reload(), state.poll_ms);
} catch {
/* stumm bleiben -- die Seite ist auch ohne Aktualisierung nutzbar */
/* stumm bleiben – die Seite ist auch ohne Aktualisierung nutzbar */
}
}
poll();
@@ -41,7 +41,7 @@
</div>
{{ checkbox('monitor_auto_restart', 'Automatischen PoE-Neustart bei Ausfall aktivieren',
checked=values.monitor_auto_restart,
hint_text='Zusätzlich lizenzpflichtig. Der manülle Knopf im Dashboard
hint_text='Zusätzlich lizenzpflichtig. Der manuelle Knopf im Dashboard
funktioniert unabhängig davon.') }}
{{ checkbox('dashboard_public', 'Statusübersicht ohne Anmeldung erreichbar',
checked=values.dashboard_public,
@@ -78,6 +78,29 @@
</form>
</section>
<section class="card">
<div class="card__header">
<div class="flex-1">
<div class="card__title">{{ icon('pencil', size=17) }} Unterschriften</div>
<div class="card__sub">
Der Name in der Unterschrift ist eine Angabe des Unterschreibenden – wie auf
Papier. Wer das Dokument abgelegt hat, ist dagegen belegt: in den
Dokumenteigenschaften und im Änderungsprotokoll, auf Wunsch zusätzlich
sichtbar unter der ersten Unterschrift.
</div>
</div>
</div>
<form method="post" action="{{ url_for('settings.system_save') }}">
<input type="hidden" name="{{ csrf_field_name }}" value="{{ csrf_token() }}">
<div class="card__body stack">
{{ checkbox('signature_witness_enabled', 'Unterschriften mit dem ablegenden Konto bezeugen',
checked=values.signature_witness_enabled,
hint_text=specs['signature_witness_enabled'].hint) }}
</div>
<div class="card__footer"><button class="btn btn--primary" type="submit">Speichern</button></div>
</form>
</section>
{# Eigene Karte: die Abmeldung stand zwischen Protokollrotation und
Papierkorb -- drei Dinge ohne Zusammenhang. Wer die Sitzungsdauer sucht,
sucht sie nicht unter "Protokolle". #}
@@ -87,7 +110,7 @@
<div class="card__title">{{ icon('clock', size=17) }} Sitzungen</div>
<div class="card__sub">
Wie lange eine Anmeldung gilt. Beides bestimmt auch, wie lange eine
eingebundene Dateifreigabe bestehen bleibt -- sie endet mit der Sitzung.
eingebundene Dateifreigabe bestehen bleibt – sie endet mit der Sitzung.
</div>
</div>
</div>
@@ -11,7 +11,7 @@
{% endblock %}
{% block topbar_extra %}
{% if terminal_enabled and current_user.has('switches.execute') and host_keys %}
{% if terminal_enabled and current_user.has('switch_console.execute') and host_keys %}
<a class="btn btn--sm btn--primary" href="{{ url_for('terminal.switch_console', switch_id=switch.id) }}">
{{ icon('terminal', size=15) }} Konsole
</a>
@@ -32,7 +32,7 @@
Ohne freigegebenen Schlüssel verweigert die Anwendung jeden Zugriff auf diesen Switch.
</div>
</div>
{% if current_user.has('switches.edit') %}
{% if current_user.has('switches.write') %}
<form method="post" action="{{ url_for('switches.probe_host_key', switch_id=switch.id) }}"
data-no-guard>
<input type="hidden" name="{{ csrf_field_name }}" value="{{ csrf_token() }}">
@@ -53,7 +53,7 @@
Vergleichen Sie den Fingerprint mit einer unabhängigen Quelle (Konsolenzugang am
Switch, Inventardokumentation), bevor Sie ihn freigeben.
</p>
{% if current_user.has('switches.edit') %}
{% if current_user.has('switches.write') %}
<form method="post" class="mt-2"
action="{{ url_for('switches.trust_host_key', switch_id=switch.id) }}">
<input type="hidden" name="{{ csrf_field_name }}" value="{{ csrf_token() }}">
@@ -78,7 +78,7 @@
</dd>
{% endfor %}
</dl>
{% if current_user.has('switches.edit') %}
{% if current_user.has('switches.write') %}
<form method="post" action="{{ url_for('switches.forget_host_key', switch_id=switch.id) }}"
data-no-guard>
<input type="hidden" name="{{ csrf_field_name }}" value="{{ csrf_token() }}">
@@ -95,7 +95,7 @@
</div>
</section>
{% if current_user.has('switches.execute') %}
{% if current_user.has('switch_console.execute') %}
<section class="card">
<div class="card__header">
<div class="flex-1">
@@ -83,13 +83,13 @@ stillschweigend übernommen.', 'info', 'Host-Schlüssel') }}
{% endif %}
</td>
<td class="actions">
{% if terminal_enabled and current_user.has('switches.execute') and switch.host_key_known %}
{% if terminal_enabled and current_user.has('switch_console.execute') and switch.host_key_known %}
<a class="btn btn--sm btn--ghost" title="Konsole"
href="{{ url_for('terminal.switch_console', switch_id=switch.id) }}">
{{ icon('terminal', size=15) }}
</a>
{% endif %}
{% if current_user.has('switches.edit') %}
{% if current_user.has('switches.write') %}
<button class="btn btn--sm btn--ghost" type="button"
data-dialog-open="switch-edit-{{ switch.id }}" aria-label="Bearbeiten">
{{ icon('pencil', size=15) }}
@@ -135,7 +135,7 @@ stillschweigend übernommen.', 'info', 'Host-Schlüssel') }}
</form>
{% endcall %}
{% endif %}
{% if current_user.has('switches.edit') %}
{% if current_user.has('switches.write') %}
{% for switch in switches %}
{% call modal('switch-edit-' ~ switch.id, switch.hostname, switch.ip) %}
<form method="post" action="{{ url_for('switches.update', switch_id=switch.id) }}">
+7 -7
View File
@@ -36,7 +36,7 @@ class MonitorDaemon:
self.running = True
def stop(self, signum: int, _frame: FrameType | None) -> None:
logger.info("Signal %s empfangen -- beende nach dem laufenden Durchlauf.", signum)
logger.info("Signal %s empfangen – beende nach dem laufenden Durchlauf.", signum)
self.running = False
# ------------------------------------------------------------------ #
@@ -68,8 +68,8 @@ class MonitorDaemon:
def run(self) -> int:
live = self.extension.registry["live_log"]
live.info("monitor", "Ueberwachungsprozess gestartet")
logger.info("Ueberwachung laeuft, Datenbank: %s", self.extension.config.db_path)
live.info("monitor", "Überwachungsprozess gestartet")
logger.info("Überwachung läuft, Datenbank: %s", self.extension.config.db_path)
while self.running:
interval = self._interval()
@@ -84,8 +84,8 @@ class MonitorDaemon:
failures_before_restart=self._failures_before_restart(),
)
logger.info(
"Durchlauf: %s geprueft, %s online, %s offline, %s Neustarts (%s erfolgreich), "
"%s ohne Lizenz uebersprungen, %sms",
"Durchlauf: %s geprüft, %s online, %s offline, %s Neustarts (%s erfolgreich), "
"%s ohne Lizenz übersprungen, %sms",
report.checked,
report.online,
report.offline,
@@ -96,7 +96,7 @@ class MonitorDaemon:
)
except Exception: # noqa: BLE001 - der Dienst darf nie sterben
logger.exception("Durchlauf fehlgeschlagen")
live.error("monitor", "Durchlauf fehlgeschlagen -- siehe app.log")
live.error("monitor", "Durchlauf fehlgeschlagen – siehe app.log")
# Das Aufraeumen abgelaufener Freigabe-Einbindungen laeuft **nicht**
# hier, sondern im Webprozess: eingebunden wird in dessen
@@ -112,7 +112,7 @@ class MonitorDaemon:
time.sleep(min(1.0, remaining))
remaining -= 1.0
live.info("monitor", "Ueberwachungsprozess beendet")
live.info("monitor", "Überwachungsprozess beendet")
return 0
+9
View File
@@ -168,6 +168,8 @@ LOG_DIR="/var/log/$NAME"
SERVICE_USER="$APP"
UNIT="$NAME.service"
MONITOR_UNIT="$NAME-monitor.service"
CLEANUP_UNIT="$NAME-cleanup.service"
CLEANUP_TIMER="$NAME-cleanup.timer"
NGINX_SITE="/etc/nginx/sites-available/$NAME"
ENV_PREFIX="TESM_"
[[ "$APP" == "tesm-license" ]] && ENV_PREFIX="TESM_LICENSE_"
@@ -539,6 +541,11 @@ render_unit "$ROOT/deploy/systemd/$APP.service" "/etc/systemd/system/$UNIT"
if [[ "$APP" == "tesm" ]]; then
render_unit "$ROOT/deploy/systemd/tesm-monitor.service" "/etc/systemd/system/$MONITOR_UNIT"
fi
# Aufraeumen lief bisher nur von Hand -- also praktisch nie. Auf einer
# laufenden Installation lagen deshalb hunderte abgelaufene Sitzungszeilen in
# der Datenbank, und das Aenderungsprotokoll waere nie archiviert worden.
render_unit "$ROOT/deploy/systemd/$APP-cleanup.service" "/etc/systemd/system/$CLEANUP_UNIT"
render_unit "$ROOT/deploy/systemd/$APP-cleanup.timer" "/etc/systemd/system/$CLEANUP_TIMER"
[[ $UNITS_CHANGED -eq 1 ]] && systemctl daemon-reload && info "Units neu geladen" \
|| info "Units unveraendert"
@@ -611,6 +618,8 @@ systemctl enable --now "$UNIT" >/dev/null
if [[ "$APP" == "tesm" ]]; then
systemctl enable --now "$MONITOR_UNIT" >/dev/null
fi
# Der Timer, nicht der Dienst: der Dienst laeuft einmal und ist fertig.
systemctl enable --now "$CLEANUP_TIMER" >/dev/null 2>&1 && info "Aufraeumen: taeglich 03:30" || info "Aufraeum-Timer nicht aktiviert -- 'systemctl status $CLEANUP_TIMER' zeigt warum"
# -- Health-Check und Rollback ----------------------------------------------
step "Gesundheitspruefung"
+34
View File
@@ -0,0 +1,34 @@
[Unit]
Description=TESM -- Aufraeumen: Sitzungen, Ratenereignisse, Protokollarchiv
After=tesm.service
# Ohne die laufende Anwendung ist nichts kaputt -- der Befehl arbeitet direkt
# auf der Datenbank. "After" sorgt nur fuer eine sinnvolle Reihenfolge beim
# Hochfahren.
[Service]
Type=oneshot
User=tesm
Group=tesm
WorkingDirectory=/srv/tesm
Environment=TESM_BASE_DIR=/srv/tesm
Environment=TESM_DATA_DIR=/srv/tesm/data
Environment=TESM_LOG_DIR=/var/log/tesm
Environment=PYTHONUNBUFFERED=1
ExecStart=/srv/tesm/venv/bin/tesm-admin housekeeping
# Hier darf voll gehaertet werden: dieser Aufruf fasst nur die Datenbank und
# das Protokollverzeichnis an, keine Systemdateien und keinen Helfer per sudo.
NoNewPrivileges=yes
PrivateTmp=yes
ProtectSystem=strict
ProtectHome=yes
ProtectKernelTunables=yes
ProtectKernelModules=yes
ProtectControlGroups=yes
RestrictSUIDSGID=yes
RestrictNamespaces=yes
RestrictAddressFamilies=AF_UNIX
LockPersonality=yes
SystemCallArchitectures=native
UMask=0027
ReadWritePaths=/srv/tesm/data /var/log/tesm
+18
View File
@@ -0,0 +1,18 @@
[Unit]
Description=TESM -- taegliches Aufraeumen
[Timer]
# Nachts, wenn niemand arbeitet: abgelaufene Sitzungen, alte Ratenereignisse
# und die Archivierung des Aenderungsprotokolls.
#
# Vorher lief das nur, wenn jemand "tesm-admin housekeeping" aufrief oder in
# der Diagnose darauf klickte -- also praktisch nie. Gemessen auf einer
# Installation nach vier Wochen: 747 Sitzungszeilen, 682 davon abgelaufen.
OnCalendar=*-*-* 03:30:00
# Streuung, damit nicht jede Installation im Netz zur selben Sekunde loslegt.
RandomizedDelaySec=15m
# Nachgeholt, wenn die Maschine nachts aus war.
Persistent=true
[Install]
WantedBy=timers.target
@@ -0,0 +1,34 @@
[Unit]
Description=TESM-Lizenzserver -- Aufraeumen: Sitzungen, Ratenereignisse, Protokollarchiv
After=tesm-license.service
# Ohne die laufende Anwendung ist nichts kaputt -- der Befehl arbeitet direkt
# auf der Datenbank. "After" sorgt nur fuer eine sinnvolle Reihenfolge beim
# Hochfahren.
[Service]
Type=oneshot
User=tesm-license
Group=tesm-license
WorkingDirectory=/srv/tesm-license
Environment=TESM_LICENSE_BASE_DIR=/srv/tesm-license
Environment=TESM_LICENSE_DATA_DIR=/srv/tesm-license/data
Environment=TESM_LICENSE_LOG_DIR=/var/log/tesm-license
Environment=PYTHONUNBUFFERED=1
ExecStart=/srv/tesm-license/venv/bin/tesm-license-admin housekeeping
# Hier darf voll gehaertet werden: dieser Aufruf fasst nur die Datenbank und
# das Protokollverzeichnis an, keine Systemdateien und keinen Helfer per sudo.
NoNewPrivileges=yes
PrivateTmp=yes
ProtectSystem=strict
ProtectHome=yes
ProtectKernelTunables=yes
ProtectKernelModules=yes
ProtectControlGroups=yes
RestrictSUIDSGID=yes
RestrictNamespaces=yes
RestrictAddressFamilies=AF_UNIX
LockPersonality=yes
SystemCallArchitectures=native
UMask=0027
ReadWritePaths=/srv/tesm-license/data /var/log/tesm-license
+18
View File
@@ -0,0 +1,18 @@
[Unit]
Description=TESM-Lizenzserver -- taegliches Aufraeumen
[Timer]
# Nachts, wenn niemand arbeitet: abgelaufene Sitzungen, alte Ratenereignisse
# und die Archivierung des Aenderungsprotokolls.
#
# Vorher lief das nur, wenn jemand "tesm-license-admin housekeeping" aufrief oder in
# der Diagnose darauf klickte -- also praktisch nie. Gemessen auf einer
# Installation nach vier Wochen: 747 Sitzungszeilen, 682 davon abgelaufen.
OnCalendar=*-*-* 03:30:00
# Streuung, damit nicht jede Installation im Netz zur selben Sekunde loslegt.
RandomizedDelaySec=15m
# Nachgeholt, wenn die Maschine nachts aus war.
Persistent=true
[Install]
WantedBy=timers.target
+5
View File
@@ -11,6 +11,7 @@ Was geschützt wird, womit, und wo bewusst Grenzen gezogen sind.
| Speicherung | Argon2id (argon2-cffi) |
| Altbestand | bcrypt wird noch geprüft und bei der nächsten erfolgreichen Anmeldung stillschweigend auf Argon2id umgestellt |
| Zweiter Faktor | TOTP, optional erzwingbar für Administratoren |
| Rechte | Eine Zeile je Funktion; das Administratorkennzeichen gibt den Verwaltungsbereich, nicht alles |
| Sperre je Konto | nach `LOGIN_MAX_ATTEMPTS` Versuchen |
| Sperre je Adresse | zusätzlich `LOGIN_MAX_ATTEMPTS_PER_IP` -- sonst lässt sich die Kontosperre umgehen, indem man viele Konten je einmal probiert |
| Verzeichnisdienst | LDAP nur über TLS, Zertifikat wird geprüft. Ohne gültiges Zertifikat keine Anmeldung -- kein Schalter, der das abschaltet |
@@ -171,6 +172,10 @@ braucht der Dienst kein `--workers 1` mehr.
* **Kein CSRF-Freibrief für cookie-autorisierte Routen.**
* **Kein `unsafe-inline` für Skripte**, auch nicht "vorübergehend".
* **Keine Rechteausweitung**, auch nicht für Administratoren untereinander.
Ein echter Administrator darf sich Funktionsrechte über eine Gruppe geben --
das ist gewollt und hinterlässt eine Zeile im Änderungsprotokoll. Was es
nicht gibt, ist der stille Weg: ein Kennzeichen, das ohne Eintrag alles
aufschließt.
* **Kein Hostname im Lizenz-Fingerabdruck** -- Umbenennen darf die Bindung
nicht brechen.
* **Keine von Hand gepflegte nginx-Site.** Sie wird immer neu erzeugt.
+1 -1
View File
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
[project]
name = "tesm-core"
version = "2.5.1"
version = "2.8.0"
description = "Gemeinsames Anwendungsgeruest (Auth, RBAC, Navigation, Design-System, Migrationen) fuer TESM und TESM-Lizenzserver"
requires-python = ">=3.11"
dependencies = [
+19 -11
View File
@@ -59,7 +59,7 @@ CORE_SETTINGS: tuple[SettingSpec, ...] = (
30,
"int",
"Aufbewahrung im Papierkorb (Tage)",
hint="Nach dieser Frist werden Eintraege beim naechsten Aufruf endgueltig entfernt.",
hint="Nach dieser Frist werden Einträge beim nächsten Aufruf endgültig entfernt.",
section="system",
minimum=1,
maximum=3650,
@@ -68,8 +68,8 @@ CORE_SETTINGS: tuple[SettingSpec, ...] = (
"session_absolute_hours",
12,
"int",
"Laengstmoegliche Sitzungsdauer (Stunden)",
hint="Danach ist Schluss, auch bei staendiger Arbeit -- eine Sitzung soll nicht "
"Längstmögliche Sitzungsdauer (Stunden)",
hint="Danach ist Schluss, auch bei ständiger Arbeit – eine Sitzung soll nicht "
"ewig leben. Die eingebundenen Dateifreigaben enden mit ihr.",
section="system",
minimum=1,
@@ -80,8 +80,8 @@ CORE_SETTINGS: tuple[SettingSpec, ...] = (
30,
"int",
"Automatische Abmeldung nach Leerlauf (Minuten)",
hint="Jede Anfrage setzt den Zaehler zurueck -- gezaehlt wird nur Untaetigkeit. "
"Gilt auch fuer die eingebundenen Dateifreigaben: mit der Sitzung endet die "
hint="Jede Anfrage setzt den Zähler zurück – gezählt wird nur Untätigkeit. "
"Gilt auch für die eingebundenen Dateifreigaben: mit der Sitzung endet die "
"Einbindung.",
section="system",
minimum=5,
@@ -114,8 +114,8 @@ CORE_SETTINGS: tuple[SettingSpec, ...] = (
SettingSpec("web_hsts_enabled", False, "bool", "HSTS senden", section="web"),
SettingSpec("web_redirect_http", True, "bool", "HTTP auf HTTPS umleiten", section="web"),
SettingSpec("web_cert_path", "", "str", "Zertifikat (Pfad)", section="web"),
SettingSpec("web_key_path", "", "str", "Privater Schluessel (Pfad)", section="web"),
SettingSpec("web_acme_email", "", "str", "E-Mail fuer Let's Encrypt", section="web"),
SettingSpec("web_key_path", "", "str", "Privater Schlüssel (Pfad)", section="web"),
SettingSpec("web_acme_email", "", "str", "E-Mail für Let's Encrypt", section="web"),
SettingSpec("web_acme_webroot", "", "str", "ACME-Webroot", section="web"),
# Abweichende Ports braucht nur eine Testinstanz neben der Produktion --
# im Regelbetrieb bleibt es bei 80 und 443.
@@ -126,7 +126,7 @@ CORE_SETTINGS: tuple[SettingSpec, ...] = (
"web_https_port", 443, "int", "HTTPS-Port", section="web", minimum=1, maximum=65535
),
SettingSpec(
"web_max_body_mb", 128, "int", "Maximale Anfragegroesse (MB)", section="web",
"web_max_body_mb", 128, "int", "Maximale Anfragegröße (MB)", section="web",
minimum=1, maximum=8192,
),
*directory.SETTINGS,
@@ -148,7 +148,11 @@ def create_base_app(
#: Wortmarke, ohne Zeile darunter; die Marke selbst zeigen beide
#: Anwendungen.
auth_tagline: str = "",
app_version: str = "2.5.1",
#: Beide Anwendungen geben ihre eigene Paketversion mit -- und die laeuft
#: absichtlich auseinander: was sich nicht geaendert hat, bekommt keine
#: neue Nummer. Eine feste Zahl an dieser Stelle wuerde irgendwann eine
#: falsche Version in die Fussnote schreiben.
app_version: str = "unbekannt",
built_in_trusted_keys: tuple[str, ...] = (),
enable_license: bool = True,
template_folder: str | None = None,
@@ -160,6 +164,10 @@ def create_base_app(
static_folder=static_folder or "static",
static_url_path="/assets",
)
# Umlaute bleiben Umlaute -- auch in JSON. Flask wuerde sonst nach ASCII
# ausweichen ("ü"), und genau darin stehen die Flash-Meldungen in der
# Seite: eine Meldung mit "ue" war lesbar, eine mit "ü" wurde zu Zahlen.
app.json.ensure_ascii = False
# Templates und Design-System des Kerns liegen im Paket ``tesm_core`` und
# werden ueber einen eigenen Blueprint bereitgestellt. Dadurch kann jede
@@ -374,8 +382,8 @@ def create_base_app(
# sehen. Vorher stand hier nur der nackte Status.
grenze = uploads.limit_mb()
error.description = (
f"Diese Datei ist groesser als erlaubt. Zurzeit sind {grenze} MB je Upload "
"eingestellt; aendern kann das ein Administrator unter "
f"Diese Datei ist größer als erlaubt. Zurzeit sind {grenze} MB je Upload "
"eingestellt; ändern kann das ein Administrator unter "
'"Einstellungen -> Webserver und TLS".'
)
if _wants_json():
+46 -3
View File
@@ -28,7 +28,7 @@ import sqlite3
from collections import defaultdict
from datetime import datetime, timezone
from pathlib import Path
from typing import Any, Iterable
from typing import Any, Collection, Iterable, Mapping, Sequence
from .db import Database
@@ -116,6 +116,49 @@ def log(
return int(cursor.lastrowid or 0)
def diff(
vorher: Mapping[str, Any] | None,
nachher: Mapping[str, Any] | None,
*,
felder: Sequence[tuple[str, str]] | None = None,
geheim: Collection[str] = (),
) -> str:
"""Was sich geaendert hat: ``Feld: alt -> neu``, mit Komma getrennt.
Damit steht im Protokoll nicht nur *dass* etwas geaendert wurde, sondern
auch *von was auf was* -- der Weg zurueck steht damit in der Zeile selbst.
``felder`` gibt Auswahl und Beschriftung vor (``[("ssh_port", "SSH-Port")]``);
ohne Angabe werden alle gemeinsamen Felder verglichen. Namen in ``geheim``
werden nie im Klartext geschrieben -- dort steht nur, dass sie sich
geaendert haben.
"""
if vorher is None or nachher is None:
return ""
paare = felder or [(name, name) for name in sorted(set(vorher) & set(nachher))]
teile: list[str] = []
for name, beschriftung in paare:
if name not in vorher or name not in nachher:
continue
alt, neu = vorher[name], nachher[name]
if alt == neu:
continue
if name in geheim:
teile.append(f"{beschriftung}: geaendert")
continue
teile.append(f"{beschriftung}: {_wert(alt)} -> {_wert(neu)}")
return ", ".join(teile)
def _wert(wert: Any) -> str:
if wert is None or wert == "":
return "(leer)"
if isinstance(wert, bool):
return "ein" if wert else "aus"
text = " ".join(str(wert).split())
return text if len(text) <= 80 else text[:79] + "…"
def verify_chain(conn: sqlite3.Connection, *, limit: int | None = None) -> dict[str, Any]:
"""Prueft die Hash-Kette. Rueckgabe: ``{"ok", "checked", "broken_at", "reason"}``."""
sql = "SELECT * FROM audit_log ORDER BY id"
@@ -133,14 +176,14 @@ def verify_chain(conn: sqlite3.Connection, *, limit: int | None = None) -> dict[
"ok": False,
"checked": checked,
"broken_at": data["id"],
"reason": "Vorgaenger-Hash passt nicht -- eine Zeile wurde entfernt oder eingefuegt.",
"reason": "Vorgänger-Hash passt nicht – eine Zeile wurde entfernt oder eingefügt.",
}
if compute_hash(str(data["prev_hash"]), data) != data["hash"]:
return {
"ok": False,
"checked": checked,
"broken_at": data["id"],
"reason": "Zeileninhalt passt nicht zum gespeicherten Hash -- Eintrag geaendert.",
"reason": "Zeileninhalt passt nicht zum gespeicherten Hash | Eintrag geändert.",
}
expected_prev = str(data["hash"])
checked += 1
@@ -59,20 +59,20 @@ SETTINGS: tuple[SettingSpec, ...] = (
section="ldap",
choices=(("ldaps", "LDAPS (Port 636)"), ("starttls", "StartTLS (Port 389)"), ("none", "Unverschluesselt")),
),
SettingSpec("ldap_verify_cert", True, "bool", "Serverzertifikat pruefen", section="ldap"),
SettingSpec("ldap_verify_cert", True, "bool", "Serverzertifikat prüfen", section="ldap"),
SettingSpec("ldap_ca_file", "", "str", "CA-Zertifikat (Pfad)", section="ldap"),
SettingSpec(
"ldap_allow_insecure",
False,
"bool",
"Unverschluesselte Verbindung ausdruecklich erlauben",
hint="Nur fuer Testumgebungen. Das Passwort geht dabei im Klartext ueber das Netz.",
"Unverschlüsselte Verbindung ausdrücklich erlauben",
hint="Nur für Testumgebungen. Das Passwort geht dabei im Klartext über das Netz.",
section="ldap",
),
SettingSpec("ldap_base_dn", "", "str", "Basis-DN (leer = automatisch)", section="ldap"),
SettingSpec("ldap_user_attribute", "sAMAccountName", "str", "Anmeldeattribut", section="ldap"),
SettingSpec("ldap_email_attribute", "userPrincipalName", "str", "E-Mail-Attribut", section="ldap"),
SettingSpec("ldap_group_sync", True, "bool", "Gruppen aus dem Verzeichnis uebernehmen", section="ldap"),
SettingSpec("ldap_group_sync", True, "bool", "Gruppen aus dem Verzeichnis übernehmen", section="ldap"),
SettingSpec("ldap_timeout", 8, "int", "Zeitlimit (Sekunden)", section="ldap", minimum=1, maximum=60),
)
@@ -123,7 +123,7 @@ def bind_credentials(conn: sqlite3.Connection) -> tuple[str, str]:
try:
secret = core().keystore.decrypt(encrypted, aad=AAD_LDAP_BIND)
except Exception: # noqa: BLE001 - Schluessel gewechselt/Datei kaputt
logger.error("Bind-Passwort des Verzeichnisdienstes konnte nicht entschluesselt werden")
logger.error("Bind-Passwort des Verzeichnisdienstes konnte nicht entschlüsselt werden")
return str(row.get("username") or ""), ""
return str(row.get("username") or ""), secret
@@ -182,7 +182,7 @@ def _connect(config: dict[str, Any], user: str, password: str):
security = str(config["ldap_security"])
if security == "none" and not config["ldap_allow_insecure"]:
raise PermissionError(
"Unverschluesselte Verzeichnisverbindungen sind deaktiviert. "
"Unverschlüsselte Verzeichnisverbindungen sind deaktiviert. "
"Nutzen Sie LDAPS oder StartTLS."
)
connection = Connection(
@@ -249,9 +249,9 @@ def authenticate(conn: sqlite3.Connection, username: str, password: str) -> Dire
bind_user, bind_password = bind_credentials(conn)
warnings: list[str] = []
if str(config["ldap_security"]) == "none":
warnings.append("Unverschluesselte Verzeichnisverbindung in Benutzung")
warnings.append("Unverschlüsselte Verzeichnisverbindung in Benutzung")
if not config["ldap_verify_cert"]:
warnings.append("Serverzertifikat des Verzeichnisdienstes wird nicht geprueft")
warnings.append("Serverzertifikat des Verzeichnisdienstes wird nicht geprüft")
try:
service_conn, bound = _connect(config, bind_user, bind_password)
@@ -359,7 +359,7 @@ def _resolve_groups(connection: Any, base: str, user_dn: str) -> tuple[str, ...]
)
return tuple(str(entry.entry_dn) for entry in connection.entries)
except Exception as exc: # noqa: BLE001
logger.warning("Gruppenaufloesung fehlgeschlagen: %s", exc)
logger.warning("Gruppenauflösung fehlgeschlagen: %s", exc)
return ()
@@ -423,18 +423,24 @@ def _apply_group_mappings(
zugewiesene Gruppen bleiben erhalten, wenn sie kein Verzeichnis-Mapping
haben -- sonst waere jede lokale Zuweisung nach dem naechsten Login weg.
"""
if not group_dns:
return
mappings = Database.all(
conn, "SELECT ad_group_dn, app_group_id FROM ldap_group_mappings"
conn, "SELECT ad_group_dn, app_group_id, grants_admin FROM ldap_group_mappings"
)
if not mappings:
return
mapped_group_ids = {int(row["app_group_id"]) for row in mappings}
lowered = {dn.lower() for dn in group_dns}
# Das Kennzeichen zuerst -- es haengt an keiner Gruppe und muss auch dann
# ausgewertet werden, wenn das Konto in keiner zugeordneten Gruppe steht.
_kennzeichen_setzen(conn, user_id, mappings, lowered)
if not group_dns:
return
gruppenzuordnungen = [row for row in mappings if row["app_group_id"] is not None]
if not gruppenzuordnungen:
return
mapped_group_ids = {int(row["app_group_id"]) for row in gruppenzuordnungen}
wanted = {
int(row["app_group_id"])
for row in mappings
for row in gruppenzuordnungen
if str(row["ad_group_dn"]).lower() in lowered
}
@@ -452,6 +458,71 @@ def _apply_group_mappings(
)
def _kennzeichen_setzen(
conn: sqlite3.Connection,
user_id: int,
mappings: list[dict[str, Any]],
gruppen: set[str],
) -> None:
"""Setzt oder entzieht das Administratorkennzeichen nach dem Verzeichnis.
Wirkung wie bei Gruppen: **ersetzend**. Wer aus der zugeordneten
AD-Gruppe herausfaellt, verliert das Kennzeichen bei der naechsten
Anmeldung -- sonst waere ein Austritt im Verzeichnis eine Aenderung, die
hier nie ankommt.
Zwei Grenzen, beide absichtlich:
* Nur **Verzeichniskonten**. Ein lokales Konto (etwa das, das
``tesm-admin create-admin`` anlegt) bleibt unberuehrt -- es ist der
Notausgang, wenn das Verzeichnis nicht erreichbar ist.
* Nie den letzten entsperrten Administrator herunterstufen. Ein
Tippfehler im DN wuerde sonst beim naechsten Login die Anlage
verschliessen, und niemand koennte ihn korrigieren.
"""
zuordnungen = [row for row in mappings if int(row["grants_admin"] or 0) == 1]
if not zuordnungen:
return
soll = any(str(row["ad_group_dn"]).lower() in gruppen for row in zuordnungen)
zeile = Database.one(
conn, "SELECT is_admin, auth_source FROM users WHERE id=?", (user_id,)
)
if zeile is None or str(zeile["auth_source"]) != "ldap":
return
ist = bool(zeile["is_admin"])
if ist == soll:
return
if not soll:
uebrig = Database.value(
conn,
"SELECT COUNT(*) FROM users WHERE is_admin=1 AND is_locked=0 "
"AND deleted_at IS NULL AND id<>?",
(user_id,),
default=0,
)
if not uebrig:
logger.warning(
"Administratorkennzeichen bleibt bei Benutzer %s: es waere das letzte.",
user_id,
)
return
conn.execute(
"UPDATE users SET is_admin=?, updated_at=? WHERE id=?", (int(soll), _now(), user_id)
)
audit.log(
conn,
actor="system",
action="auth.admin_flag_changed",
target=str(user_id),
detail=(
"Administrator: "
+ ("nein -> ja" if soll else "ja -> nein")
+ " (aus der Verzeichniszuordnung)"
),
severity="warning",
)
def _user_group_ids(conn: sqlite3.Connection, user_id: int) -> list[dict[str, Any]]:
return Database.all(conn, "SELECT group_id AS id FROM user_groups WHERE user_id=?", (user_id,))
+28 -13
View File
@@ -77,25 +77,40 @@ class User:
@property
def effective_permissions(self) -> frozenset[str]:
"""Rechte nach Anwendung der Bereichs-Kill-Switches."""
"""Rechte nach Anwendung der Bereichs-Kill-Switches.
Ein echter Administrator hat den Verwaltungsbereich immer dabei -- auch
ohne Gruppe und ohne dass jemand ihn angehakt haette. Sonst koennte
sich das letzte Administratorkonto aus der eigenen Anlage aussperren,
indem es seine Gruppe verliert.
"""
if self._effective is None:
tree = self._tree
self._effective = (
frozenset(tree.effective(self.granted)) if tree is not None else frozenset()
)
if tree is None:
self._effective = frozenset()
else:
eigene = set(tree.effective(self.granted))
if self.is_admin:
eigene |= set(tree.verwaltungsrechte())
self._effective = frozenset(eigene)
return self._effective
def has(self, *permissions: str) -> bool:
"""True, wenn **alle** angegebenen Rechte greifen. Admins duerfen immer alles."""
if self.is_admin:
return True
"""True, wenn **alle** angegebenen Rechte greifen.
Das Administratorkennzeichen gibt seit 2.8.0 **den Verwaltungsbereich**
frei und nicht mehr jede Pruefung: Benutzer, Gruppen, Einstellungen,
Sicherung, Papierkorb, Diagnose. Funktionsrechte -- Geraete, Neustarts,
DHCP, Freigaben -- kommen ueber Gruppen, und die darf sich ein
Administrator selbst zuweisen. Der Unterschied ist nicht, *ob* er sie
bekommen kann, sondern dass es dann eine Zeile im
Aenderungsprotokoll gibt und in der Matrix zu sehen ist.
"""
if not permissions:
return True
return all(permission in self.effective_permissions for permission in permissions)
def has_any(self, permissions: Iterable[str]) -> bool:
if self.is_admin:
return True
effective = self.effective_permissions
return any(permission in effective for permission in permissions)
@@ -245,9 +260,9 @@ def _bitte_bestaetigen(permission: str) -> Any:
if is_automatic(request) or (
request.accept_mimetypes.accept_json and not request.accept_mimetypes.accept_html
):
abort(403, description="Bitte bestaetigen Sie zur Sicherheit Ihr Passwort.")
abort(403, description="Bitte bestätigen Sie zur Sicherheit Ihr Passwort.")
session["_after_reauth"] = request.full_path if request.query_string else request.path
flash("Bitte bestaetigen Sie zur Sicherheit Ihr Passwort.", "info")
flash("Bitte bestätigen Sie zur Sicherheit Ihr Passwort.", "info")
return redirect(url_for("auth.reauth"))
@@ -268,7 +283,7 @@ def permission_required(*permissions: str, mode: str = "all") -> Callable[..., A
else current_user.has(*permissions)
)
if not ok:
return _deny("Fuer diese Seite fehlt Ihnen die Berechtigung.")
return _deny("Für diese Seite fehlt Ihnen die Berechtigung.")
# Geheimnisse und Exporte verlangen eine frische Bestaetigung --
# das steht im Rechtemodell und wird deshalb hier abgefragt, nicht
# in jeder Route einzeln. Vorher hing es daran, dass jemand an den
@@ -318,7 +333,7 @@ def reauth_required(view: Callable[..., Any]) -> Callable[..., Any]:
return _deny("Anmeldung erforderlich.")
if not reauth_is_fresh():
session["_after_reauth"] = request.full_path if request.query_string else request.path
flash("Bitte bestaetigen Sie zur Sicherheit Ihr Passwort.", "info")
flash("Bitte bestätigen Sie zur Sicherheit Ihr Passwort.", "info")
return redirect(url_for("auth.reauth"))
return view(*args, **kwargs)
@@ -151,7 +151,7 @@ def authenticate(
if ip_verdict.blocked:
return AuthOutcome(
"rate_limited",
"Zu viele Anmeldeversuche von dieser Adresse. Bitte spaeter erneut versuchen.",
"Zu viele Anmeldeversuche von dieser Adresse. Bitte später erneut versuchen.",
retry_after=ip_verdict.retry_after_seconds,
)
@@ -165,7 +165,7 @@ def authenticate(
if user_verdict.blocked:
return AuthOutcome(
"rate_limited",
"Dieses Konto ist nach mehreren Fehlversuchen voruebergehend gesperrt.",
"Dieses Konto ist nach mehreren Fehlversuchen vorübergehend gesperrt.",
retry_after=user_verdict.retry_after_seconds,
)
@@ -248,7 +248,7 @@ def _verify_credentials(
return AuthOutcome(
"directory_unavailable",
"Der Verzeichnisdienst ist derzeit nicht erreichbar. "
"Bitte versuchen Sie es spaeter erneut.",
"Bitte versuchen Sie es später erneut.",
)
if result.status != "ok" or result.profile is None:
return AuthOutcome("invalid", GENERIC_FAILURE)
@@ -308,7 +308,7 @@ def complete_login(
actor_id=int(user_row["id"]),
action="auth.first_login",
target=str(user_row["username"]),
detail=f"Erste Anmeldung -- Quelle: {user_row.get('auth_source') or 'local'}",
detail=f"Erste Anmeldung | Quelle: {user_row.get('auth_source') or 'local'}",
ip=ip,
request_id=getattr(g, "request_id", ""),
severity="notice",
@@ -359,15 +359,11 @@ def logout(conn: sqlite3.Connection) -> None:
current_app.logger.exception(
"Abmeldehaken %r fehlgeschlagen", getattr(hook, "__name__", hook)
)
with core().database.transaction(conn):
audit.log(
conn,
actor=user.username,
actor_id=user.id,
action="auth.logout",
target=user.username,
ip=client_ip(),
)
# Kein Protokolleintrag fuer das Abmelden: eine Abmeldung aendert
# nichts. Sie stand als "Info" in jeder zweiten Zeile und verdraengte
# die Eintraege, um die es geht. Wer wissen will, wer wann da war,
# liest die Sitzungsuebersicht; fehlgeschlagene Anmeldungen und
# Sperren stehen weiterhin jedes Mal im Protokoll.
session.destroy() if hasattr(session, "destroy") else session.clear() # type: ignore[attr-defined]
g.user = ANONYMOUS
+12 -12
View File
@@ -83,7 +83,7 @@ def run_web_setup(app: Any, extension: Any, args: argparse.Namespace) -> int:
port = getattr(args, flag, None)
if port:
if not 1 <= int(port) <= 65535:
print(f"Ungueltiger Port: {port}", file=sys.stderr)
print(f"Ungültiger Port: {port}", file=sys.stderr)
return 2
values[key] = int(port)
@@ -93,11 +93,11 @@ def run_web_setup(app: Any, extension: Any, args: argparse.Namespace) -> int:
# -- Zertifikat --------------------------------------------------- #
config = _config_from_settings(extension, conn)
cert: dict[str, Any] = {"ok": True, "message": "Zertifikat unveraendert."}
cert: dict[str, Any] = {"ok": True, "message": "Zertifikat unverändert."}
if args.acme:
if sysops is None or not sysops.available:
print("Der Systemhelfer ist nicht verfuegbar.", file=sys.stderr)
print("Der Systemhelfer ist nicht verfügbar.", file=sys.stderr)
return 2
cert = webserver.request_certificate(
sysops,
@@ -118,7 +118,7 @@ def run_web_setup(app: Any, extension: Any, args: argparse.Namespace) -> int:
if args.self_signed and not args.acme:
if sysops is None or not sysops.available:
print("Der Systemhelfer ist nicht verfuegbar.", file=sys.stderr)
print("Der Systemhelfer ist nicht verfügbar.", file=sys.stderr)
return 2
suggested = webserver.local_names()
cert = webserver.create_self_signed(
@@ -144,7 +144,7 @@ def run_web_setup(app: Any, extension: Any, args: argparse.Namespace) -> int:
if args.https:
if not (config.cert_path and config.key_path):
print(
"HTTPS verlangt Zertifikat und Schluessel -- bitte --self-signed "
"HTTPS verlangt Zertifikat und Schlüssel – bitte --self-signed "
"oder --acme angeben.",
file=sys.stderr,
)
@@ -172,7 +172,7 @@ def run_web_setup(app: Any, extension: Any, args: argparse.Namespace) -> int:
return 0
if sysops is None or not sysops.available:
print("Der Systemhelfer ist nicht verfuegbar.", file=sys.stderr)
print("Der Systemhelfer ist nicht verfügbar.", file=sys.stderr)
return 2
result = webserver.apply_config(sysops, rendered)
print(result["message"])
@@ -194,7 +194,7 @@ def add_web_setup(sub: Any, runner: Any) -> None:
help="nginx und TLS einrichten (Port 80/443)",
description=(
"Setzt die Webserver-Einstellungen und erzeugt daraus die nginx-Site. "
"Die Datei wird immer vollstaendig neu geschrieben -- eine von Hand "
"Die Datei wird immer vollständig neu geschrieben – eine von Hand "
"bearbeitete Site-Datei gibt es in diesem Projekt bewusst nicht."
),
)
@@ -207,20 +207,20 @@ def add_web_setup(sub: Any, runner: Any) -> None:
parser.add_argument(
"--acme",
action="store_true",
help="Zertifikat per Let's Encrypt anfordern (Domain muss oeffentlich zeigen)",
help="Zertifikat per Let's Encrypt anfordern (Domain muss öffentlich zeigen)",
)
parser.add_argument("--domain", help="Oeffentlicher Name dieser Installation")
parser.add_argument("--acme-email", help="Kontaktadresse fuer Let's Encrypt")
parser.add_argument("--domain", help="Öffentlicher Name dieser Installation")
parser.add_argument("--acme-email", help="Kontaktadresse für Let's Encrypt")
parser.add_argument("--hsts", action="store_true", help="HSTS-Header setzen")
parser.add_argument(
"--no-redirect",
action="store_true",
help="Port 80 nicht auf HTTPS umleiten (Sonderfall)",
)
parser.add_argument("--max-body-mb", type=int, help="Obergrenze fuer Uploads")
parser.add_argument("--max-body-mb", type=int, help="Obergrenze für Uploads")
parser.add_argument("--http-port", type=int, help="Abweichender HTTP-Port (Standard 80)")
parser.add_argument("--https-port", type=int, help="Abweichender HTTPS-Port (Standard 443)")
parser.add_argument("--apply", action="store_true", help="nginx schreiben, pruefen, neu laden")
parser.add_argument("--apply", action="store_true", help="nginx schreiben, prüfen, neu laden")
parser.add_argument(
"--print-config", action="store_true", help="Nur die erzeugte Datei ausgeben"
)
+2 -2
View File
@@ -175,11 +175,11 @@ def load_core_config(
bind = (_env(env_prefix, "BIND") or default_bind).strip()
if not re.fullmatch(r"[0-9A-Za-z_.\[\]:-]{1,80}:\d{1,5}", bind):
raise ValueError(f"Ungueltige Bind-Adresse: {bind!r}")
raise ValueError(f"Ungültige Bind-Adresse: {bind!r}")
site_key = (_env(env_prefix, "SITE_KEY") or app_key).strip().lower()
if not re.fullmatch(r"[a-z0-9][a-z0-9-]{0,39}", site_key):
raise ValueError(f"Ungueltiger SITE_KEY: {site_key!r}")
raise ValueError(f"Ungültiger SITE_KEY: {site_key!r}")
return CoreConfig(
app_key=app_key,
+144 -2
View File
@@ -141,11 +141,16 @@ CREATE TABLE IF NOT EXISTS service_accounts (
updated_at TEXT NOT NULL
);
-- Eine Verzeichnisgruppe zeigt entweder auf eine lokale Gruppe **oder** auf
-- das Administratorkennzeichen (grants_admin). Darum ist app_group_id
-- nullbar: "Domänen-Admins" soll echte Administratoren erzeugen koennen und
-- nicht nur Mitglieder der Gruppe "Administration".
CREATE TABLE IF NOT EXISTS ldap_group_mappings (
id INTEGER PRIMARY KEY AUTOINCREMENT,
ad_group_dn TEXT NOT NULL UNIQUE,
ad_group_name TEXT NOT NULL,
app_group_id INTEGER NOT NULL REFERENCES groups(id) ON DELETE CASCADE,
app_group_id INTEGER REFERENCES groups(id) ON DELETE CASCADE,
grants_admin INTEGER NOT NULL DEFAULT 0,
created_at TEXT NOT NULL
);
"""
@@ -186,8 +191,145 @@ CREATE INDEX IF NOT EXISTS idx_jobs_kind_state ON jobs(kind, state);
CREATE INDEX IF NOT EXISTS idx_jobs_created ON jobs(created_at);
"""
def benenne_rechte_um(conn) -> None: # type: ignore[no-untyped-def]
"""Schreibt bestehende Gruppenrechte auf das neue Vokabular um.
``devices.view`` wird ``devices.read``, ``devices.edit`` wird
``devices.write``. Ohne diesen Schritt stehen in den Gruppen nur noch
Schluessel, die der Rechtebaum nicht kennt -- und
:meth:`PermissionTree.sanitize` wirft Unbekanntes **still** weg. Nach dem
Update waeren alle Gruppen leer und niemand kaeme mehr an seine Seiten:
kein Fehler, den man sieht, sondern einer, den man erst merkt, wenn jemand
anruft.
Im Kern und nicht in den Anwendungen, weil die Tabelle beiden gehoert.
Idempotent: was schon neu heisst, wird nicht angefasst.
"""
from .rbac.legacy_permissions import UMBENANNTE_AKTIONEN
for alt, neu in UMBENANNTE_AKTIONEN.items():
# Erst die Dubletten weg, die beim Umschreiben entstehen wuerden: haette
# eine Gruppe (aus welchem Grund auch immer) beide Schluessel, brach der
# eindeutige Index. Lieber vorher aufraeumen als in der Migration
# scheitern.
conn.execute(
"DELETE FROM group_permissions WHERE permission LIKE ? AND EXISTS ("
" SELECT 1 FROM group_permissions AS andere"
" WHERE andere.group_id = group_permissions.group_id"
" AND andere.permission = substr(group_permissions.permission, 1,"
" length(group_permissions.permission) - ?) || ?)",
(f"%.{alt}", len(alt), neu),
)
conn.execute(
"UPDATE group_permissions"
" SET permission = substr(permission, 1, length(permission) - ?) || ?"
" WHERE permission LIKE ?",
(len(alt), neu, f"%.{alt}"),
)
def zuordnung_auf_kennzeichen(conn) -> None: # type: ignore[no-untyped-def]
"""Erlaubt einer Verzeichnisgruppe, das Administratorkennzeichen zu setzen.
Bisher konnte eine Zuordnung nur auf eine lokale Gruppe zeigen. "Domänen-
Admins" landete deshalb in der Gruppe *Administration* -- und wurde damit
gerade **kein** echter Administrator: die Gruppe pflegt Benutzer und
Rechte, hat aber kein Kennzeichen und kann sich keines geben.
Zwei Aenderungen an der Tabelle, und SQLite kann Spalten nicht
umdefinieren: also neu anlegen und umkopieren. ``app_group_id`` wird
nullbar (eine Zuordnung auf das Kennzeichen zeigt auf keine Gruppe), und
``grants_admin`` sagt, dass genau das gemeint ist.
"""
spalten = {
str(zeile[1]) for zeile in conn.execute("PRAGMA table_info(ldap_group_mappings)")
}
if "grants_admin" in spalten:
return
conn.execute(
"""
CREATE TABLE ldap_group_mappings_neu (
id INTEGER PRIMARY KEY AUTOINCREMENT,
ad_group_dn TEXT NOT NULL UNIQUE,
ad_group_name TEXT NOT NULL,
app_group_id INTEGER REFERENCES groups(id) ON DELETE CASCADE,
grants_admin INTEGER NOT NULL DEFAULT 0,
created_at TEXT NOT NULL
)
"""
)
conn.execute(
"INSERT INTO ldap_group_mappings_neu "
"(id, ad_group_dn, ad_group_name, app_group_id, grants_admin, created_at) "
"SELECT id, ad_group_dn, ad_group_name, app_group_id, 0, created_at "
" FROM ldap_group_mappings"
)
conn.execute("DROP TABLE ldap_group_mappings")
conn.execute("ALTER TABLE ldap_group_mappings_neu RENAME TO ldap_group_mappings")
def teile_rechte_auf(conn) -> None: # type: ignore[no-untyped-def]
"""Verteilt ein altes Sammelrecht auf die Zeilen, die daraus wurden.
Additiv: wer ``dhcp.edit`` hatte, bekommt alle fuenf DHCP-Zeilen, und das
alte Recht verschwindet. Ohne diesen Schritt stuende in der Gruppe ein
Schluessel, den der Baum nicht kennt -- und weg waere er still, denn genau
das tut :meth:`PermissionTree.sanitize` mit Unbekanntem.
Laeuft nach ``benenne_rechte_um``: die Tabelle nennt beide Schreibweisen,
wo es darauf ankommt, und ein zweiter Lauf findet nichts mehr zu tun.
"""
from .rbac.legacy_permissions import (
ERWEITERTE_RECHTE,
GETEILTE_RECHTE,
neue_schluessel,
)
def gruppen_mit(recht: str) -> list[int]:
return [
int(zeile[0])
for zeile in conn.execute(
"SELECT DISTINCT group_id FROM group_permissions WHERE permission=?",
(recht,),
).fetchall()
]
# Geteilt: das alte Recht gibt es nicht mehr, also ersetzen.
for altes, neue in GETEILTE_RECHTE.items():
gruppen = gruppen_mit(altes)
if not gruppen:
continue
conn.executemany(
"INSERT OR IGNORE INTO group_permissions (group_id, permission) VALUES (?,?)",
[(gid, recht) for gid in gruppen for recht in neue],
)
conn.execute("DELETE FROM group_permissions WHERE permission=?", (altes,))
# Erweitert: das Recht bleibt und bekommt dazu, was bisher an ihm hing.
# Loeschen waere hier falsch -- es ist keines von gestern.
for recht, dazu in ERWEITERTE_RECHTE.items():
gruppen = gruppen_mit(recht)
if not gruppen:
continue
conn.executemany(
"INSERT OR IGNORE INTO group_permissions (group_id, permission) VALUES (?,?)",
[(gid, weiteres) for gid in gruppen for weiteres in dazu],
)
assert neue_schluessel # in derselben Tabelle nachgeschlagen wie beim Import
CORE_MIGRATIONS: tuple[Migration, ...] = (
Migration(version=1, name="baseline", sql=V1_BASELINE),
Migration(
version=1,
name="baseline",
sql=V1_BASELINE,
geaendert_weil=(
"Das Grundschema legt ldap_group_mappings jetzt mit grants_admin und nullbarer app_group_id an -- eine neue Installation soll nicht erst core/6 brauchen, um die Tabelle wieder umzubauen."
),
),
Migration(version=2, name="trusted-issuer-keys", sql=V2_TRUSTED_KEYS),
Migration(version=3, name="jobs", sql=V3_JOBS),
Migration(version=4, name="rechte-read-write", fn=benenne_rechte_um),
Migration(version=5, name="rechte-je-funktion", fn=teile_rechte_auf),
Migration(version=6, name="ldap-kennzeichen", fn=zuordnung_auf_kennzeichen),
)
+25 -2
View File
@@ -80,8 +80,8 @@ class Database:
"""Oeffnet eine neue Verbindung. Nicht aufrufen, solange eine Transaktion laeuft."""
if self._depth() > 0:
raise NestedConnectionError(
"Es laeuft bereits eine Schreibtransaktion auf dieser Datenbank. "
"Reiche die bestehende Verbindung durch, statt eine neue zu oeffnen "
"Es läuft bereits eine Schreibtransaktion auf dieser Datenbank. "
"Reiche die bestehende Verbindung durch, statt eine neue zu öffnen "
"(sonst blockiert SQLite sich selbst)."
)
return self._raw_connect()
@@ -119,6 +119,29 @@ class Database:
finally:
conn.close()
@contextmanager
def dauerhaft(self, conn: sqlite3.Connection) -> Iterator[sqlite3.Connection]:
"""Fuer Schreibvorgaenge, die einen Stromausfall ueberstehen muessen.
Im Alltag laeuft die Datenbank mit ``synchronous=NORMAL``: schnell, und
bei einem Stromausfall gehen hoechstens die letzten Sekunden verloren --
die Datei bleibt heil. Fuer einen Messwert ist das genau richtig.
Fuer eine Unterschrift nicht. Dort liegt die Datei anschliessend auf der
Freigabe, und fehlte der Eintrag dazu, waere sie "unbekannt" statt
nachweisbar. Ein fsync kostet ein paar Millisekunden -- bei ein paar
Unterschriften am Tag ist das keine Diskussion wert.
Umschliesst die Transaktion, nicht umgekehrt: ``PRAGMA synchronous``
wirkt auf den naechsten Commit, und gesetzt werden kann es nur
ausserhalb einer laufenden Transaktion.
"""
conn.execute("PRAGMA synchronous=FULL")
try:
yield conn
finally:
conn.execute("PRAGMA synchronous=NORMAL")
# ------------------------------------------------------------------ #
# Transaktionen
# ------------------------------------------------------------------ #
@@ -79,7 +79,7 @@ def core(app: Flask | None = None) -> TesmCore:
try:
return target.extensions["tesm"] # type: ignore[return-value]
except KeyError as exc: # pragma: no cover - Programmierfehler
raise RuntimeError("tesm_core ist fuer diese Anwendung nicht initialisiert") from exc
raise RuntimeError("tesm_core ist für diese Anwendung nicht initialisiert") from exc
def db() -> sqlite3.Connection:
+6 -6
View File
@@ -78,7 +78,7 @@ def check_private_file(path: Path) -> list[str]:
except OSError:
return problems
if mode & (stat.S_IRGRP | stat.S_IROTH | stat.S_IWGRP | stat.S_IWOTH):
problems.append(f"{path} ist fuer Gruppe/Andere lesbar oder schreibbar (erwartet 0600)")
problems.append(f"{path} ist für Gruppe/Andere lesbar oder schreibbar (erwartet 0600)")
return problems
@@ -110,11 +110,11 @@ class Keystore:
created_at=str(entry.get("created_at", "")),
)
if len(key.material) != _KEY_BYTES:
raise ValueError(f"Schluessel {key.key_id} hat die falsche Laenge")
raise ValueError(f"Schlüssel {key.key_id} hat die falsche Länge")
self._keys[key.key_id] = key
self._active = str(raw.get("active") or "")
if self._active not in self._keys:
raise ValueError("Aktiver Schluessel fehlt im Schluesselbund")
raise ValueError("Aktiver Schlüssel fehlt im Schlüsselbund")
return
self._active = "1"
self._keys = {
@@ -160,7 +160,7 @@ class Keystore:
def drop_key(self, key_id: str) -> None:
"""Entfernt einen alten Schluessel -- erst nach vollstaendiger Neuverschluesselung."""
if key_id == self._active:
raise ValueError("Der aktive Schluessel kann nicht entfernt werden")
raise ValueError("Der aktive Schlüssel kann nicht entfernt werden")
self._keys.pop(key_id, None)
self._persist()
@@ -183,14 +183,14 @@ class Keystore:
raise DecryptionError(f"Unbekannte Chiffrat-Version: {prefix!r}")
key = self._keys.get(key_id)
if key is None:
raise DecryptionError(f"Schluessel {key_id} ist nicht im Schluesselbund")
raise DecryptionError(f"Schlüssel {key_id} ist nicht im Schlüsselbund")
try:
plain = AESGCM(key.material).decrypt(
_b64d(nonce_b64), _b64d(ct_b64), aad.encode("utf-8")
)
except (InvalidTag, ValueError) as exc:
raise DecryptionError(
"Chiffrat konnte nicht entschluesselt werden (falscher Schluessel, "
"Chiffrat konnte nicht entschlüsselt werden (falscher Schlüssel, "
"manipulierte Daten oder falscher Verwendungszweck)"
) from exc
return plain.decode("utf-8")
@@ -68,10 +68,10 @@ API_PATHS = {
#: die einzige Wahrheit -- Templates lesen sie, Routen erzwingen sie.
LICENSED_FEATURES: dict[str, str] = {
"directory": "Verzeichnisanmeldung (LDAP/AD) konfigurieren",
"nginx": "Webserver-Einstellungen aendern",
"nginx": "Webserver-Einstellungen ändern",
"export": "Daten exportieren",
"trash_restore": "Papierkorb wiederherstellen und endgueltig loeschen",
"monitor_interval": "Pruefintervall der Ueberwachung aendern",
"trash_restore": "Papierkorb wiederherstellen und endgültig löschen",
"monitor_interval": "Prüfintervall der Überwachung ändern",
"auto_poe_restart": "Automatischer PoE-Neustart bei Ausfall",
}
@@ -85,7 +85,7 @@ def describe_transport_error(exc: BaseException, endpoint: str) -> str:
"""
text = str(exc)
if "CERTIFICATE_VERIFY_FAILED" in text or "certificate verify failed" in text:
detail = "Das Zertifikat konnte nicht geprueft werden"
detail = "Das Zertifikat konnte nicht geprüft werden"
if "self-signed" in text or "self signed" in text:
detail = "Der Lizenzserver benutzt ein selbstsigniertes Zertifikat"
return (
@@ -94,7 +94,7 @@ def describe_transport_error(exc: BaseException, endpoint: str) -> str:
"einer anerkannten Stelle."
)
if "Name or service not known" in text or "nodename nor servname" in text:
return f"Der Name im Endpunkt ({endpoint}) laesst sich nicht aufloesen."
return f"Der Name im Endpunkt ({endpoint}) lässt sich nicht auflösen."
if "Connection refused" in text:
return f"{endpoint} nimmt keine Verbindung an."
if "timed out" in text or "timeout" in text.lower():
@@ -257,8 +257,8 @@ class LicenseManager:
def require(self, feature: str) -> None:
if not self.feature_allowed(feature):
raise LicenseError(
f"{LICENSED_FEATURES.get(feature, feature)} ist ohne gueltige, "
"aktivierte Lizenz nicht moeglich."
f"{LICENSED_FEATURES.get(feature, feature)} ist ohne gültige, "
"aktivierte Lizenz nicht möglich."
)
# ------------------------------------------------------------------ #
@@ -284,7 +284,7 @@ class LicenseManager:
try:
payload = json.loads(text)
except ValueError as exc:
raise LicenseError("Die Datei ist kein gueltiges JSON.") from exc
raise LicenseError("Die Datei ist kein gültiges JSON.") from exc
try:
document, client_key = lic.split_bundle(payload)
@@ -294,20 +294,20 @@ class LicenseManager:
try:
lic.verify_license(document) # innere Konsistenz
except lic.LicensingError as exc:
raise LicenseError(f"Die Lizenzdatei ist ungueltig: {exc}") from exc
raise LicenseError(f"Die Lizenzdatei ist ungültig: {exc}") from exc
master_pubkey = str(document.get("master_pubkey") or "")
known = self.trusted_keys(conn)
if known and master_pubkey not in set(known) and not allow_new_issuer:
raise LicenseError(
"Diese Lizenz wurde von einem anderen Lizenzserver ausgestellt "
f"(Schluessel {lic.key_id(master_pubkey)}). Ein Administrator muss den "
"Wechsel des Ausstellers ausdruecklich bestaetigen."
f"(Schlüssel {lic.key_id(master_pubkey)}). Ein Administrator muss den "
"Wechsel des Ausstellers ausdrücklich bestätigen."
)
if not client_key and not self.key_path.is_file():
raise LicenseError(
"Der Datei fehlt der Client-Schluessel. Bitte das vollstaendige "
"Der Datei fehlt der Client-Schlüssel. Bitte das vollständige "
"Lizenz-Bundle des Lizenzservers verwenden."
)
@@ -332,7 +332,7 @@ class LicenseManager:
actor=actor,
action="license.issuer_pinned",
target=lic.key_id(master_pubkey),
detail="Trust on first use" if not known else "Aussteller-Wechsel bestaetigt",
detail="Trust on first use" if not known else "Aussteller-Wechsel bestätigt",
severity="notice",
)
@@ -397,11 +397,11 @@ class LicenseManager:
self, action: str, *, hostname: str = "", report: dict[str, Any] | None = None
) -> dict[str, Any]:
if not self._state.valid:
raise LicenseError("Es ist keine gueltige Lizenz installiert.")
raise LicenseError("Es ist keine gültige Lizenz installiert.")
key = self.client_key()
if not key:
raise LicenseError(
"Der Client-Schluessel dieser Lizenz fehlt. Bitte die Lizenzdatei erneut importieren."
"Der Client-Schlüssel dieser Lizenz fehlt. Bitte die Lizenzdatei erneut importieren."
)
return lic.build_client_request(
action, self._state.document, key, hostname=hostname, report=report
@@ -442,8 +442,8 @@ class LicenseManager:
)
else:
reason = (
"In dieser Lizenz ist kein Lizenzserver hinterlegt -- sie kann sich nur "
"ueber den Offline-Weg aktivieren."
"In dieser Lizenz ist kein Lizenzserver hinterlegt – sie kann sich nur "
"über den Offline-Weg aktivieren."
)
# Offline-Weg: Anfrage merken -- **mit** dem Code. Zwischen Anfrage und
@@ -475,7 +475,7 @@ class LicenseManager:
"code": code,
"message": (
(reason + " " if reason else "")
+ "Der Offline-Weg steht offen: uebermitteln Sie den angezeigten Code an "
+ "Der Offline-Weg steht offen: übermitteln Sie den angezeigten Code an "
"Ihren Ansprechpartner und tragen Sie die Antwort hier ein."
),
}
@@ -527,7 +527,7 @@ class LicenseManager:
current_seq=current_seq,
)
except lic.LicensingError as exc:
raise LicenseError(f"Die Antwort des Lizenzservers ist nicht gueltig: {exc}") from exc
raise LicenseError(f"Die Antwort des Lizenzservers ist nicht gültig: {exc}") from exc
status = str(response.get("status") or "")
detail = str(response.get("detail") or "")
@@ -597,7 +597,7 @@ class LicenseManager:
actor=actor,
)
self.settings.set(conn, SETTING_HEARTBEAT_ERROR, "", actor=actor)
message = "Verbindung zum Lizenzserver bestaetigt."
message = "Verbindung zum Lizenzserver bestätigt."
self.settings.set(conn, SETTING_PENDING, "", actor=actor)
# Ein erfolgreicher Heartbeat laeuft alle paar Minuten und ist kein
@@ -648,7 +648,7 @@ class LicenseManager:
url: str, payload: dict[str, Any], *, timeout: int, ca_pem: str = ""
) -> dict[str, Any]:
if not url.startswith(("https://", "http://")):
raise ValueError("Ungueltiger Endpunkt")
raise ValueError("Ungültiger Endpunkt")
data = json.dumps(payload).encode("utf-8")
request = urllib.request.Request( # noqa: S310 - Schema oben geprueft
url,
@@ -748,7 +748,7 @@ class LicenseManager:
}
if not state.valid:
return {
"label": "Lizenz ungueltig",
"label": "Lizenz ungültig",
"css_class": "status-pill--danger",
"dot": "1",
"dot_class": "status-pill__dot--pulse",
@@ -773,29 +773,29 @@ class LicenseManager:
"dot": "1",
"dot_class": "status-pill__dot--pulse",
"title": (
"Die Kulanzfrist laeuft noch, Funktionen bleiben vorerst verfuegbar."
"Die Kulanzfrist läuft noch, Funktionen bleiben vorerst verfügbar."
if status.grace_active
else "Lizenzpflichtige Funktionen sind abgeschaltet."
),
}
if status.expiring_soon:
return {
"label": f"Lizenz laeuft in {status.days_left} Tagen ab",
"label": f"Lizenz läuft in {status.days_left} Tagen ab",
"css_class": "status-pill--warning",
"dot": "1",
"dot_class": "status-pill__dot--pulse",
"title": "Bitte rechtzeitig verlaengern.",
"title": "Bitte rechtzeitig verlängern.",
}
# Zwischen der Warnschwelle und 90 Tagen: gruen, rein als Hinweis. Wer
# eine Verlaengerung im Voraus plant, will das Datum sehen, ohne dass es
# nach einem Problem aussieht.
if status.days_left is not None and 0 < status.days_left <= EXPIRY_HINT_DAYS:
return {
"label": f"Lizenz laeuft in {status.days_left} Tagen ab",
"label": f"Lizenz läuft in {status.days_left} Tagen ab",
"css_class": "",
"dot": "1",
"dot_class": "",
"title": "Nur ein Hinweis -- es ist nichts eingeschraenkt.",
"title": "Nur ein Hinweis – es ist nichts eingeschränkt.",
}
if state.last_heartbeat_at:
try:
@@ -809,6 +809,6 @@ class LicenseManager:
"css_class": "status-pill--warning",
"dot": "1",
"dot_class": "",
"title": "Rein informativ -- es wird nichts abgeschaltet.",
"title": "Rein informativ – es wird nichts abgeschaltet.",
}
return None
@@ -94,7 +94,7 @@ def init_app(app: Flask, *, log_dir: Path, debug: bool, json_logs: bool = False)
except OSError:
pass
except OSError as exc: # pragma: no cover - z. B. fehlende Rechte
root.warning("Konnte app.log nicht oeffnen: %s", exc)
root.warning("Konnte app.log nicht öffnen: %s", exc)
# Zugriffsprotokoll separat: eine Zeile pro Anfrage, ohne Stacktraces.
access = logging.getLogger(ACCESS_LOGGER)
+34 -12
View File
@@ -50,6 +50,12 @@ class Migration:
sql: str = ""
fn: MigrationFn | None = None
allow_integrity_error: bool = False
#: Begruendung, falls der Text einer bereits angewendeten Migration
#: absichtlich geaendert wurde -- etwa weil eine frische Installation
#: mit der neuen Schreibweise starten muss. Ohne Begruendung warnt der
#: Lauf, und das soll er auch: ein stiller Umbau einer angewendeten
#: Migration ist fast immer ein Versehen.
geaendert_weil: str = ""
tags: tuple[str, ...] = field(default=())
@property
@@ -175,17 +181,33 @@ class MigrationRunner:
record = known.get(migration.version)
if record is not None:
if record["checksum"] != migration.checksum:
logger.warning(
"Migration %s/%s (%s) wurde nachtraeglich geaendert "
"(Pruefsumme %s != %s). Bereits angewendete Migrationen werden "
"nicht erneut ausgefuehrt -- neue Aenderungen brauchen eine neue "
"Versionsnummer.",
component,
migration.version,
migration.name,
record["checksum"],
migration.checksum,
)
if migration.geaendert_weil:
# Mit Begruendung ist es eine Notiz, keine Warnung:
# manchmal muss der Text einer laengst angewendeten
# Migration mit, damit eine **frische** Installation
# denselben Stand erreicht. Wer das Protokoll liest,
# soll den Unterschied zu einem Versehen sehen.
logger.info(
"Migration %s/%s (%s) wurde absichtlich geändert: %s "
"Auf dieser Installation ist sie längst angewendet und "
"wird nicht erneut ausgeführt.",
component,
migration.version,
migration.name,
migration.geaendert_weil,
)
else:
logger.warning(
"Migration %s/%s (%s) wurde nachträglich geändert "
"(Prüfsumme %s != %s). Bereits angewendete Migrationen werden "
"nicht erneut ausgeführt – neue Änderungen brauchen eine neue "
"Versionsnummer.",
component,
migration.version,
migration.name,
record["checksum"],
migration.checksum,
)
continue
try:
@@ -210,7 +232,7 @@ class MigrationRunner:
raise
logger.error(
"Migration %s/%s (%s) konnte wegen bestehender Altdaten nicht "
"angewendet werden. Der Start laeuft weiter; die Daten muessen "
"angewendet werden. Der Start läuft weiter; die Daten müssen "
"manuell bereinigt werden.",
component,
migration.version,
+55 -31
View File
@@ -16,10 +16,10 @@ A = Action
USERS = Resource(
key="users",
label="Benutzer",
actions=(A.VIEW, A.CREATE, A.EDIT, A.DELETE),
actions=(A.READ, A.CREATE, A.WRITE, A.DELETE),
hint="Konten anlegen, sperren, Gruppen zuordnen",
action_hints={
A.EDIT: "Stammdaten, Sperre und Gruppenzuordnung aendern.",
A.WRITE: "Stammdaten, Sperre und Gruppenzuordnung ändern.",
A.DELETE: "Konto in den Papierkorb legen (Verzeichniskonten sofort entfernen).",
},
)
@@ -27,35 +27,46 @@ USERS = Resource(
GROUPS = Resource(
key="groups",
label="Gruppen und Rechte",
actions=(A.VIEW, A.CREATE, A.EDIT, A.DELETE),
actions=(A.READ, A.CREATE, A.WRITE, A.DELETE),
hint="Rechtematrix pflegen",
action_hints={
A.EDIT: "Rechte vergeben -- nur Rechte, die man selbst besitzt.",
A.WRITE: "Rechte vergeben – nur Rechte, die man selbst besitzt.",
},
)
SETTINGS_SYSTEM = Resource(
key="settings_system",
label="Systemeinstellungen",
actions=(A.VIEW, A.EDIT, A.EXECUTE),
hint="Hostname, Zeitzone, Protokollrotation, Navigation",
action_hints={A.EXECUTE: "Systemaktionen ausloesen (Dienste, Netzwerk uebernehmen)."},
actions=(A.READ, A.WRITE, A.EXECUTE),
hint="Hostname, Zeitzone, Protokollrotation, Sitzungsdauer",
action_hints={A.EXECUTE: "Systemaktionen auslösen (Dienste, Netzwerk übernehmen)."},
)
#: Die Reihenfolge des Menues lief unter "Systemaktionen auslösen" mit -- also
#: unter demselben Recht wie das Aendern des Hostnamens. Es ist aber das
#: harmloseste, was man in der Verwaltung tun kann, und das haeufigste.
SETTINGS_NAV = Resource(
key="settings_nav",
parent="settings_system",
label="Navigation",
actions=(A.READ, A.WRITE),
hint="Reihenfolge der Menüpunkte und ihrer Unterpunkte",
)
SETTINGS_LICENSE = Resource(
key="settings_license",
label="Lizenz",
actions=(A.VIEW, A.EDIT),
actions=(A.READ, A.WRITE),
hint="Lizenzdatei einspielen, aktivieren, deaktivieren",
)
SETTINGS_DIRECTORY = Resource(
key="settings_directory",
label="Verzeichnisdienst (LDAP/AD)",
actions=(A.VIEW, A.EDIT, A.EXECUTE, A.SECRETS),
actions=(A.READ, A.WRITE, A.EXECUTE, A.SECRETS),
hint="Anbindung und Gruppen-Zuordnung",
action_hints={
A.EXECUTE: "Verbindungstest ausfuehren.",
A.EXECUTE: "Verbindungstest ausführen.",
A.SECRETS: "Bind-Passwort des Dienstkontos setzen.",
},
)
@@ -63,58 +74,69 @@ SETTINGS_DIRECTORY = Resource(
SETTINGS_WEB = Resource(
key="settings_web",
label="Webserver und TLS",
actions=(A.VIEW, A.EDIT, A.EXECUTE),
actions=(A.READ, A.WRITE, A.EXECUTE),
hint="Domain, Zertifikat, HSTS",
action_hints={A.EXECUTE: "Konfiguration uebernehmen, Zertifikat anfordern."},
action_hints={A.EXECUTE: "Konfiguration übernehmen, Zertifikat anfordern."},
)
SETTINGS_NETWORK = Resource(
key="settings_network",
label="Netzwerkeinstellungen",
actions=(A.VIEW, A.EDIT),
actions=(A.READ, A.WRITE),
hint="IP-Adresse, Gateway, DNS des Hosts",
)
BACKUP = Resource(
key="backup",
label="Sicherung und Übertragung",
actions=(A.VIEW, A.EXECUTE, A.EXPORT, A.SECRETS),
hint="Verschluesselter Export und Import",
#: Sichern und Einspielen sind zwei Zeilen, weil es zwei Vorgaenge mit sehr
#: verschiedenen Folgen sind: eine Sicherung zu erzeugen aendert nichts, eine
#: einzuspielen aendert alles. Sie liefen unter einem Recht, und wer eine
#: Sicherung ziehen durfte, durfte damit auch eine fremde einspielen.
BACKUP_EXPORT = Resource(
key="backup_export",
label="Sicherung erstellen",
actions=(A.READ, A.EXPORT, A.SECRETS),
hint="Verschlüsselter Export des Datenstands",
action_hints={
A.EXECUTE: "Eine Sicherung einspielen.",
A.EXPORT: "Sicherung erzeugen und herunterladen.",
A.SECRETS: "Zugangsdaten in die Sicherung einschliessen.",
A.SECRETS: "Zugangsdaten in die Sicherung einschließen.",
},
)
BACKUP_IMPORT = Resource(
key="backup_import",
label="Sicherung einspielen",
actions=(A.READ, A.EXECUTE),
hint="Prüfen, übernehmen, verwerfen",
action_hints={A.EXECUTE: "Eine geprüfte Sicherung anwenden."},
)
TRASH = Resource(
key="trash",
label="Papierkorb",
actions=(A.VIEW, A.EDIT, A.DELETE),
hint="Geloeschtes wiederherstellen oder endgueltig entfernen",
actions=(A.READ, A.WRITE, A.DELETE),
hint="Gelöschtes wiederherstellen oder endgültig entfernen",
action_hints={
A.EDIT: "Eintraege wiederherstellen.",
A.DELETE: "Eintraege endgueltig entfernen.",
A.WRITE: "Einträge wiederherstellen.",
A.DELETE: "Einträge endgültig entfernen.",
},
)
DIAGNOSTICS = Resource(
key="diagnostics",
label="Diagnose",
actions=(A.VIEW,),
hint="Schemastand, Protokollintegritaet, Schluesselrechte",
actions=(A.READ,),
hint="Schemastand, Protokollintegrität, Schlüsselrechte",
)
LOGS_LIVE = Resource(
key="logs_live",
label="Laufendes Protokoll",
actions=(A.VIEW,),
actions=(A.READ,),
)
LOGS_HISTORY = Resource(
key="logs_history",
label="Protokollverlauf",
actions=(A.VIEW, A.DELETE, A.EXPORT),
actions=(A.READ, A.DELETE, A.EXPORT),
hint="Rotierte und archivierte Protokolle",
action_hints={A.DELETE: "Archivierte Tage vom Server entfernen."},
)
@@ -122,8 +144,8 @@ LOGS_HISTORY = Resource(
LOGS_AUDIT = Resource(
key="logs_audit",
label="Änderungsprotokoll",
actions=(A.VIEW, A.EXPORT),
hint="Wer hat wann was geaendert",
actions=(A.READ, A.EXPORT),
hint="Wer hat wann was geändert",
)
@@ -139,11 +161,13 @@ def administration_area(*extra: Resource) -> Area:
USERS,
GROUPS,
SETTINGS_SYSTEM,
SETTINGS_NAV,
SETTINGS_LICENSE,
SETTINGS_DIRECTORY,
SETTINGS_WEB,
SETTINGS_NETWORK,
BACKUP,
BACKUP_EXPORT,
BACKUP_IMPORT,
TRASH,
DIAGNOSTICS,
*extra,
@@ -0,0 +1,171 @@
"""Alte Rechteschluessel auf neue -- an einer Stelle, nicht an dreien.
Mit 2.8.0 heisst das Aktionsvokabular durchgehend wie das, was es tut:
``view`` wurde ``read``, ``edit`` wurde ``write``. Danach steht in der Matrix
"Write" und im Aenderungsprotokoll ``write``, nicht zweierlei.
Drei Stellen brauchen die Zuordnung, und darum steht sie hier und nicht dort:
* die **Migration**, die bestehende Gruppenzeilen umschreibt,
* der **Import**, dem eine Sicherung aus 2.7.x untergeschoben wird -- ohne die
Zuordnung landen dort lauter unbekannte Schluessel, und
:meth:`PermissionTree.sanitize` wirft Unbekanntes absichtlich **still** weg.
Aus einer Sicherung wuerden Gruppen ohne Rechte.
* der **Test**, der prueft, dass kein alter Schluessel mehr im Code steht.
Warum nicht dreimal dieselbe Ersetzung tippen: weil die dritte Kopie beim
naechsten Umbau vergessen wird. Genau so entstand das Muster bei den Adressen
(:mod:`tesm_core.legacy_urls`).
"""
from __future__ import annotations
#: Aktion alt -> neu. Die Ressource bleibt, wie sie heisst.
UMBENANNTE_AKTIONEN: dict[str, str] = {
"view": "read",
"edit": "write",
}
#: Ein altes Recht, das in mehrere neue zerfaellt -- ein Recht je Funktion.
#:
#: Die Aufteilung ist **additiv**: wer das alte Recht hatte, bekommt alle
#: neuen. Niemand verliert etwas; ab jetzt laesst sich jedes Stueck einzeln
#: vergeben. Der umgekehrte Weg waere auch denkbar gewesen -- nur das
#: Harmloseste uebernehmen --, waere aber ein Update, das Leuten Rechte
#: wegnimmt, ohne dass jemand es entschieden hat.
#:
#: Die Schluessel stehen fuer beide Anwendungen in einer Tabelle. Auf einer
#: TESM-Datenbank tut die Zeile fuer ``licenses.write`` nichts, weil sie dort
#: in keiner Gruppe steht -- und umgekehrt. Zwei getrennte Tabellen waeren
#: zwei Stellen, die man pflegen muss.
GETEILTE_RECHTE: dict[str, tuple[str, ...]] = {
# Drei Neustartwege mit drei verschiedenen Folgen.
"devices.execute": (
"device_restart_poe.read",
"device_restart_poe.execute",
"device_restart_ssh.read",
"device_restart_ssh.execute",
"device_restart_rpc.read",
"device_restart_rpc.execute",
),
# Die Switch-Konsole war "Switch ausfuehren".
"switches.execute": ("switch_console.read", "switch_console.execute"),
# Vier Funktionen: aktualisieren, neu starten, Werkzeug installieren --
# und die Client-Konsole, die jetzt bei den Clients steht.
"maintenance.read": (
"servicing_update.read",
"servicing_reboot.read",
"servicing_tool.read",
"device_console.read",
),
"maintenance.execute": (
"servicing_update.read",
"servicing_update.execute",
"servicing_reboot.read",
"servicing_reboot.execute",
"servicing_tool.read",
"servicing_tool.execute",
"device_console.read",
"device_console.execute",
),
# Elf Funktionen an einem Recht.
"dhcp.read": (
"dhcp_subnets.read",
"dhcp_options.read",
"dhcp_reservations.read",
"dhcp_config.read",
"dhcp_service.read",
),
"dhcp.write": (
"dhcp_subnets.read",
"dhcp_subnets.create",
"dhcp_subnets.write",
"dhcp_subnets.delete",
"dhcp_options.read",
"dhcp_options.write",
"dhcp_reservations.read",
"dhcp_reservations.create",
"dhcp_reservations.write",
"dhcp_reservations.delete",
"dhcp_config.read",
"dhcp_config.execute",
),
"dhcp.execute": ("dhcp_service.read", "dhcp_service.execute"),
# Sichern und Einspielen.
"backup.read": ("backup_export.read", "backup_import.read"),
"backup.export": ("backup_export.read", "backup_export.export"),
"backup.secrets": ("backup_export.read", "backup_export.secrets"),
"backup.execute": ("backup_import.read", "backup_import.execute"),
# Lizenzserver: "aendern" hiess widerrufen **oder** erneuern -- zwei
# Eingriffe mit entgegengesetzter Wirkung unter einem Haken.
"licenses.create": ("license_issue.read", "license_issue.execute"),
"licenses.write": (
"license_renew.read",
"license_renew.execute",
"license_revoke.read",
"license_revoke.execute",
),
"licenses.execute": ("license_activation.read", "license_activation.execute"),
}
#: Ein Recht, das **bleibt** und bisher noch etwas anderes mitgab.
#:
#: Der Unterschied zu :data:`GETEILTE_RECHTE` ist keine Formsache: dort ist der
#: alte Schluessel verschwunden und muss ersetzt werden, hier gilt er weiter
#: und bekommt nur Gesellschaft. Beides in eine Tabelle zu werfen hiesse, in
#: der Migration ein Recht zu loeschen, das es noch gibt -- und im Test nicht
#: mehr pruefen zu koennen, welcher Fall gemeint war.
ERWEITERTE_RECHTE: dict[str, tuple[str, ...]] = {
# Die Navigationsreihenfolge lief unter "Systemaktionen ausloesen" mit.
"settings_system.execute": ("settings_nav.read", "settings_nav.write"),
# Einen Host-Schluessel freizugeben hing an den Stammdaten.
"devices.write": ("hostkeys.read", "hostkeys.execute"),
"switches.write": ("hostkeys.read", "hostkeys.execute"),
# Umbenennen war auch "Freigaben zuordnen".
"fileshare.write": (
"fileshare_mappings.read",
"fileshare_mappings.create",
"fileshare_mappings.write",
"fileshare_mappings.delete",
),
# Ausgefuellt ablegen war auch "unterschreiben".
"fileshare_pdf.create": ("fileshare_signature.read", "fileshare_signature.execute"),
}
def neue_schluessel(alt: str) -> tuple[str, ...]:
"""Was aus einem alten Rechteschluessel wird -- eins oder mehrere.
Unbekanntes kommt unveraendert zurueck: ob ein Schluessel gilt, entscheidet
der Rechtebaum, nicht diese Tabelle. Sie benennt nur um.
"""
if alt in GETEILTE_RECHTE:
return GETEILTE_RECHTE[alt]
ressource, punkt, aktion = alt.rpartition(".")
if not punkt:
return (alt,)
neu = UMBENANNTE_AKTIONEN.get(aktion)
selbst = f"{ressource}.{neu}" if neu else alt
# Ein Recht, das bleibt, nimmt mit, was es bisher mitgab -- sonst verliert
# jemand beim Update genau die Funktion, die vorher an diesem Haken hing.
return (selbst, *ERWEITERTE_RECHTE.get(selbst, ()))
def umgeschrieben(rechte: object) -> list[str]:
"""Eine ganze Liste umschreiben, ohne Dubletten und in fester Reihenfolge."""
if not isinstance(rechte, (list, tuple, set, frozenset)):
return []
ergebnis: set[str] = set()
for recht in rechte:
ergebnis.update(neue_schluessel(str(recht)))
return sorted(ergebnis)
__all__ = [
"UMBENANNTE_AKTIONEN",
"GETEILTE_RECHTE",
"ERWEITERTE_RECHTE",
"neue_schluessel",
"umgeschrieben",
]
+123 -32
View File
@@ -1,6 +1,14 @@
"""Rechtemodell: Bereiche, Ressourcen, Aktionen.
Das Vorgaengermodell kannte fuenf Spalten (R/W/E/D/X), wobei ``E`` ("Aendern")
Das Vokabular heisst seit 2.8.0 durchgehend wie das, was es tut: **Read,
Create, Write, Delete, Execute, Export, Secrets**. Bis dahin hiessen zwei
Aktionen anders (``view``, ``edit``), waehrend die Matrix "Bearbeiten" zeigte
und die Kurzfassung "U" -- dieselbe Aktion in drei Schreibweisen. Der
Kill-Switch eines Bereichs heisst entsprechend ``<bereich>.read``.
:mod:`tesm_core.rbac.legacy_permissions` schreibt alte Schluessel um; die
Migration ``core/4`` tut das fuer bestehende Gruppen.
Das Modell vor 2.0 kannte fuenf Spalten (R/W/E/D/X), wobei ``E`` ("Aendern")
das Loeschen **mit abdeckte** und ``D``/``X`` je nach Zeile etwas voellig anderes
bedeuteten (Dashboard-Neustart bzw. Export). Das war kompakt, aber:
@@ -15,7 +23,7 @@ Aktionen eine Ressource ueberhaupt kennt, entscheidet die Ressource; die Matrix
rendert nur die Spalten, die im jeweiligen Bereich wirklich vorkommen.
Beibehalten wird der bewaehrte **Kill-Switch**: jeder Bereich hat ein
``<bereich>.view``-Recht. Ohne dieses greift kein einziges Recht innerhalb des
``<bereich>.read``-Recht. Ohne dieses greift kein einziges Recht innerhalb des
Bereichs -- unabhaengig davon, was einzeln angehakt ist. Das erlaubt es, einer
Gruppe einen ganzen Bereich mit einem Klick zu entziehen, ohne die fein
eingestellten Einzelrechte zu verlieren.
@@ -29,38 +37,68 @@ from typing import Iterable, Mapping, Sequence
class Action(str, Enum):
"""Aktionsvokabular. Bedeutung ist ueberall dieselbe -- keine Ausnahmen."""
"""Aktionsvokabular. Bedeutung ist ueberall dieselbe -- keine Ausnahmen.
VIEW = "view"
Die Namen sind die englischen, weil sie in jedem Rechtesystem dieselben
sind und keiner Uebersetzung bedarf: wer ``write`` liest, weiss es. Zwei
hiessen bis 2.7.x anders (``view``, ``edit``) -- in der Matrix stand
"Bearbeiten" und im Protokoll ``edit``, also zweierlei fuer dasselbe.
:mod:`tesm_core.rbac.legacy_permissions` schreibt die alten Schluessel um.
"""
READ = "read"
CREATE = "create"
EDIT = "edit"
WRITE = "write"
DELETE = "delete"
EXECUTE = "execute"
EXPORT = "export"
SECRETS = "secrets"
#: Kuerzel und Erklaerung je Aktion -- Kopfzeile der Rechtematrix.
ACTION_META: dict[Action, tuple[str, str, str]] = {
Action.VIEW: ("R", "Ansehen", "Datensaetze und Seiten dieses Bereichs lesen."),
Action.CREATE: ("C", "Anlegen", "Neue Datensaetze erstellen."),
Action.EDIT: ("U", "Bearbeiten", "Bestehende Datensaetze aendern -- ohne Loeschen."),
Action.DELETE: ("D", "Loeschen", "Datensaetze loeschen bzw. endgueltig entfernen."),
Action.EXECUTE: ("X", "Ausfuehren", "Aktionen ausloesen (Neustart, Dienste, Jobs, Import)."),
Action.EXPORT: ("E", "Exportieren", "Daten aus dem System heraustragen (Datei-Download)."),
#: Kuerzel, englischer Name, deutsche Beschriftung, Erklaerung.
#:
#: Beides hat seinen Ort: die Matrix fuehrt die Spalte unter ihrem englischen
#: Namen (das ist das Vokabular, und es steht so auch im Schluessel), die
#: Kleinschrift darunter und jeder Satz in der Oberflaeche bleiben deutsch.
ACTION_META: dict[Action, tuple[str, str, str, str]] = {
Action.READ: ("R", "Read", "ansehen", "Datensätze und Seiten dieses Bereichs ansehen."),
Action.CREATE: ("C", "Create", "anlegen", "Neue Datensätze anlegen."),
Action.WRITE: (
"W",
"Write",
"ändern",
"Bestehende Datensätze ändern – ohne Anlegen, ohne Löschen.",
),
Action.DELETE: ("D", "Delete", "löschen", "Datensätze löschen bzw. endgültig entfernen."),
Action.EXECUTE: (
"X",
"Execute",
"auslösen",
"Aktionen auslösen (Neustart, Dienste, Aufträge, Import).",
),
Action.EXPORT: (
"E",
"Export",
"mitnehmen",
"Daten aus dem System heraustragen (Datei-Download).",
),
Action.SECRETS: (
"S",
"Geheimnisse",
"Passwoerter und Schluessel im Klartext sehen oder mitnehmen.",
"Secrets",
"Klartext",
"Passwörter und Schlüssel im Klartext sehen oder mitnehmen.",
),
}
#: Aktionen, die zusaetzlich eine frische Passworteingabe verlangen (sudo-Modus).
SENSITIVE_ACTIONS: frozenset[Action] = frozenset({Action.SECRETS, Action.EXPORT})
#: ``view`` ist Voraussetzung fuer alles andere in derselben Zeile.
#: ``read`` ist Voraussetzung fuer alles andere in derselben Zeile. Umgekehrt
#: gilt nichts: wer anlegen darf, darf damit nicht aendern, und wer aendern
#: darf, nicht anlegen. Das ist die Trennung, die man in einer
#: Verwaltungsanwendung am haeufigsten braucht.
IMPLIED_BY: dict[Action, tuple[Action, ...]] = {
action: (Action.VIEW,) for action in Action if action is not Action.VIEW
action: (Action.READ,) for action in Action if action is not Action.READ
}
@@ -74,12 +112,33 @@ class Resource:
hint: str = ""
#: Abweichende Erklaerung einzelner Aktionen (z. B. was "Ausfuehren" hier meint).
action_hints: Mapping[Action, str] = field(default_factory=dict)
#: Zu welcher Zeile diese gehoert -- rein fuer die Darstellung.
#:
#: Aus einer Zeile "Clients" sind sechs geworden (Stammdaten, drei
#: Neustartwege, Konsole, Host-Schluessel). Untereinander und alle gleich
#: eingerueckt liest man sie als sechs unabhaengige Dinge; eingerueckt
#: unter ihrer Hauptzeile sieht man, dass sie zusammengehoeren. Auf die
#: Rechte hat das keine Wirkung: jede Zeile bleibt einzeln vergebbar, und
#: die Hauptzeile ist **nicht** Voraussetzung fuer ihre Unterzeilen.
parent: str = ""
#: Aktionen, die hier **keine** frische Passwortbestaetigung verlangen,
#: obwohl sie in SENSITIVE_ACTIONS stehen. Bewusst hier und nicht als
#: stilles Weglassen in der Route: eine Ausnahme von einer
#: Sicherheitsregel gehoert dorthin, wo man sie sieht und begruenden muss.
ohne_wiederanmeldung: tuple[Action, ...] = ()
@property
def short_label(self) -> str:
"""Beschriftung ohne den Namen der Hauptzeile.
Unter "Clients" steht "Neustart über PoE" und nicht "Clients: Neustart
über PoE" -- das Wort stand sonst siebenmal untereinander. Ausserhalb
der Matrix (Protokoll, Meldungen) bleibt der vollstaendige Name.
"""
if self.parent and ": " in self.label:
return self.label.split(": ", 1)[1]
return self.label
def permission(self, action: Action) -> str:
return f"{self.key}.{action.value}"
@@ -101,8 +160,9 @@ class Area:
hint: str = ""
@property
def view_key(self) -> str:
return f"{self.key}.view"
def read_key(self) -> str:
"""Der Kill-Switch des Bereichs. Ohne ihn greift keine Zeile darunter."""
return f"{self.key}.read"
def columns(self) -> tuple[Action, ...]:
"""Nur die Aktionen, die in diesem Bereich tatsaechlich vorkommen."""
@@ -128,37 +188,65 @@ class PermissionTree:
self._parent: dict[str, str] = {}
self._all: list[str] = []
self._resources: dict[str, tuple[Area, Resource]] = {}
self._verwaltung: frozenset[str] | None = None
seen_keys: set[str] = set()
for area in self.areas:
if area.key in seen_keys:
raise ValueError(f"Doppelter Bereichsschluessel: {area.key}")
raise ValueError(f"Doppelter Bereichsschlüssel: {area.key}")
seen_keys.add(area.key)
self._by_key[area.key] = area
self._all.append(area.view_key)
self._all.append(area.read_key)
for resource in area.resources:
if resource.key in seen_keys:
raise ValueError(f"Doppelter Ressourcenschluessel: {resource.key}")
raise ValueError(f"Doppelter Ressourcenschlüssel: {resource.key}")
seen_keys.add(resource.key)
if Action.VIEW not in resource.actions:
if Action.READ not in resource.actions:
raise ValueError(
f"Ressource {resource.key} muss die Aktion 'view' anbieten -- "
"sie ist Voraussetzung fuer jede andere Aktion."
f"Ressource {resource.key} muss die Aktion 'read' anbieten – "
"sie ist Voraussetzung für jede andere Aktion."
)
self._resources[resource.key] = (area, resource)
for permission in resource.permissions():
self._all.append(permission)
self._parent[permission] = area.view_key
self._parent[permission] = area.read_key
# ------------------------------------------------------------------ #
def all_keys(self) -> tuple[str, ...]:
return tuple(self._all)
#: Der Bereich, den ein echter Administrator immer ganz hat.
#:
#: Nicht "alles": das Kennzeichen ``is_admin`` gab bisher jede Pruefung
#: frei, auch Geraete, DHCP und Dateifreigaben. Ein Administrator ist aber
#: jemand, der die **Anlage** verwaltet -- Benutzer, Rechte,
#: Einstellungen --, und nicht automatisch jemand, der Maschinen neu
#: startet oder in Freigaben liest. Diese Rechte holt er sich ueber eine
#: Gruppe, und dann steht es im Aenderungsprotokoll.
VERWALTUNGSBEREICH = "administration"
def verwaltungsrechte(self) -> frozenset[str]:
"""Alle Rechte des Verwaltungsbereichs, samt seinem Kill-Switch.
Einmal gerechnet und gemerkt: die Antwort haengt nur am Baum, und der
entsteht beim Import.
"""
if self._verwaltung is None:
bereich = self._by_key.get(self.VERWALTUNGSBEREICH)
if bereich is None:
self._verwaltung = frozenset()
else:
rechte = {bereich.read_key}
for resource in bereich.resources:
rechte.update(resource.permissions())
self._verwaltung = frozenset(rechte)
return self._verwaltung
def area(self, key: str) -> Area | None:
return self._by_key.get(key)
def parent_view_key(self, permission: str) -> str | None:
def parent_read_key(self, permission: str) -> str | None:
return self._parent.get(permission)
def resource(self, key: str) -> tuple[Area, Resource] | None:
@@ -185,7 +273,7 @@ class PermissionTree:
def label_for(self, permission: str) -> str:
"""Menschenlesbare Beschreibung eines Rechteschluessels -- fuer Audit-Logs."""
if permission.endswith(".view") and permission[:-5] in self._by_key:
if permission.endswith(".read") and permission[:-5] in self._by_key:
return f"Bereich {self._by_key[permission[:-5]].label}: Zugang"
resource_key, _, action_value = permission.rpartition(".")
entry = self._resources.get(resource_key)
@@ -196,7 +284,10 @@ class PermissionTree:
action = Action(action_value)
except ValueError:
return permission
return f"{resource.label}: {ACTION_META[action][1]}"
# Die deutsche Beschriftung, nicht der englische Name: dieser Text
# landet in Saetzen ("Sie koennen kein Recht vergeben ...") und im
# Aenderungsprotokoll, und die sind deutsch.
return f"{resource.label}: {ACTION_META[action][2]}"
def sanitize(self, permissions: Iterable[str]) -> list[str]:
"""Wirft unbekannte Rechte weg und ergaenzt implizierte.
@@ -204,7 +295,7 @@ class PermissionTree:
Regeln:
* Ein Recht, das nicht im Baum steht, wird verworfen (kein stilles
Weiterschleppen von Altrechten nach einem Refactoring).
* Jede Aktion impliziert ``view`` derselben Zeile.
* Jede Aktion impliziert ``read`` derselben Zeile -- aber nur diese.
* Existiert irgendein Recht eines Bereichs, wird der Kill-Switch des
Bereichs mitgesetzt -- sonst waere die Auswahl wirkungslos und der
Bearbeiter wuerde sich wundern.
@@ -224,13 +315,13 @@ class PermissionTree:
result.add(candidate)
for area in self.areas:
if any(p in result for resource in area.resources for p in resource.permissions()):
result.add(area.view_key)
result.add(area.read_key)
return sorted(result)
def effective(self, permissions: Iterable[str]) -> set[str]:
"""Rechte, die nach Anwendung der Kill-Switches tatsaechlich greifen."""
granted = set(permissions)
active = {key for key in granted if key.endswith(".view") and key[:-5] in self._by_key}
active = {key for key in granted if key.endswith(".read") and key[:-5] in self._by_key}
return {
key
for key in granted
@@ -29,7 +29,7 @@ from typing import Any, Iterable, Sequence
from ..db import Database
from ..security import passwords
from .model import Action, PermissionTree, RolePreset
from .model import ACTION_META, Action, PermissionTree, RolePreset
class PermissionDenied(Exception):
@@ -124,7 +124,20 @@ def group_permissions(conn: sqlite3.Connection, group_id: int) -> list[str]:
def guard_no_amplification(
actor: Any, tree: PermissionTree, added: Iterable[str], *, what: str = "Recht"
) -> None:
"""Verhindert, dass jemand Rechte vergibt, die er selbst nicht besitzt."""
"""Verhindert, dass jemand Rechte vergibt, die er selbst nicht besitzt.
Ein echter Administrator darf es -- und das ist seit 2.8.0 die bewusst
offene Tuer: sein Kennzeichen gibt ihm den Verwaltungsbereich, die
Funktionen holt er sich ueber eine Gruppe, auch fuer sich selbst. Der
Unterschied zu vorher ist nicht, *ob* er an die Funktionen kommt, sondern
dass es dann eine Zeile im Aenderungsprotokoll gibt und in der Matrix zu
sehen ist, statt unsichtbar im Kennzeichen zu stecken.
Fuer alle anderen bleibt die Regel dicht -- auch fuer die Gruppe
"Administration", die Benutzer und Gruppen pflegt: sie kann keiner Gruppe
ein Recht geben, das sie nicht selbst hat, und sich damit nicht ueber eine
neue Gruppe hochstufen.
"""
if getattr(actor, "is_admin", False):
return
missing = sorted(p for p in added if not actor.has(p))
@@ -132,7 +145,7 @@ def guard_no_amplification(
labels = ", ".join(tree.label_for(p) for p in missing[:6])
more = "" if len(missing) <= 6 else f" (und {len(missing) - 6} weitere)"
raise PermissionDenied(
f"Sie koennen kein {what} vergeben, das Sie selbst nicht besitzen: {labels}{more}."
f"Sie können kein {what} vergeben, das Sie selbst nicht besitzen: {labels}{more}."
)
@@ -160,7 +173,7 @@ def create_group(
if existing["deleted_at"]:
raise ValidationError(
f"Eine Gruppe namens {clean_name!r} liegt im Papierkorb. "
"Stellen Sie sie wieder her oder loeschen Sie sie endgueltig."
"Stellen Sie sie wieder her oder löschen Sie sie endgültig."
)
raise ValidationError(f"Eine Gruppe namens {clean_name!r} existiert bereits.")
@@ -205,7 +218,7 @@ def update_group(
if name is not None and name.strip() != group.name:
if group.is_system:
raise PermissionDenied("Systemgruppen koennen nicht umbenannt werden.")
raise PermissionDenied("Systemgruppen können nicht umbenannt werden.")
clean = name.strip()
if not clean:
raise ValidationError("Der Gruppenname darf nicht leer sein.")
@@ -224,13 +237,13 @@ def update_group(
"UPDATE groups SET description=?, updated_at=? WHERE id=?",
(description.strip(), _now(), group_id),
)
changes.append("Beschreibung geaendert")
changes.append("Beschreibung geändert")
if permissions is not None:
if group.is_system and not unlock_system:
raise PermissionDenied(
"Die Rechte dieser Systemgruppe sind gesperrt. "
"Sie muessen sie zuerst ausdruecklich freischalten."
"Sie müssen sie zuerst ausdrücklich freischalten."
)
wanted = tree.sanitize(permissions)
added = sorted(set(wanted) - set(group.permissions))
@@ -240,7 +253,7 @@ def update_group(
_write_permissions(conn, group_id, wanted)
conn.execute("UPDATE groups SET updated_at=? WHERE id=?", (_now(), group_id))
if added:
changes.append("Rechte hinzugefuegt: " + ", ".join(tree.label_for(p) for p in added))
changes.append("Rechte hinzugefügt: " + ", ".join(tree.label_for(p) for p in added))
if removed:
changes.append("Rechte entfernt: " + ", ".join(tree.label_for(p) for p in removed))
@@ -252,7 +265,7 @@ def soft_delete_group(conn: sqlite3.Connection, group_id: int) -> None:
if group is None:
raise ValidationError("Diese Gruppe existiert nicht.")
if group.is_system:
raise PermissionDenied("Systemgruppen koennen nicht geloescht werden.")
raise PermissionDenied("Systemgruppen können nicht gelöscht werden.")
conn.execute("UPDATE groups SET deleted_at=? WHERE id=?", (_now(), group_id))
@@ -315,6 +328,49 @@ def ensure_presets(
return created
def funktionsgruppe_fuer_administratoren(
conn: sqlite3.Connection, tree: PermissionTree, preset: RolePreset
) -> int:
"""Legt die Vollzugriffsgruppe an und gibt sie allen Administratoren.
Der Uebergang zu 2.8.0: bis dahin gab das Kennzeichen ``is_admin`` jede
Pruefung frei. Danach gibt es den Verwaltungsbereich, und alles andere
kommt ueber Gruppen. Ohne diesen Schritt fehlt einem bestehenden
Administrator nach dem Update die halbe Anwendung -- und er haelt das fuer
einen Fehler, nicht fuer eine Absicht.
Auf einer frischen Installation gibt es beim Migrieren noch kein Konto;
dann entsteht nur die Gruppe, und wer sie will, weist sie sich zu. Genau so
ist die neue Trennung gedacht.
Gibt die Nummer der Gruppe zurueck.
"""
zeile = Database.one(
conn, "SELECT id FROM groups WHERE name=? COLLATE NOCASE", (preset.name,)
)
if zeile is None:
cursor = conn.execute(
"INSERT INTO groups (name, description, is_system, is_default, preset_key, "
"created_at, updated_at) VALUES (?,?,0,0,?,?,?)",
(preset.name, preset.description, preset.key, _now(), _now()),
)
gruppe = int(cursor.lastrowid or 0)
_write_permissions(conn, gruppe, tree.expand_preset(preset))
else:
gruppe = int(zeile["id"])
conn.executemany(
"INSERT OR IGNORE INTO user_groups (user_id, group_id) VALUES (?,?)",
[
(int(row["id"]), gruppe)
for row in Database.all(
conn, "SELECT id FROM users WHERE is_admin=1 AND deleted_at IS NULL"
)
],
)
return gruppe
def default_group_id(conn: sqlite3.Connection) -> int | None:
value = Database.value(
conn, "SELECT id FROM groups WHERE is_default=1 AND deleted_at IS NULL ORDER BY id LIMIT 1"
@@ -410,7 +466,7 @@ def guard_target_account(actor: Any, target: dict[str, Any]) -> None:
"""Ein Administratorkonto darf nur ein echter Administrator anfassen."""
if bool(target.get("is_admin")) and not getattr(actor, "is_admin", False):
raise PermissionDenied(
"Administratorkonten koennen nur von Administratoren bearbeitet werden."
"Administratorkonten können nur von Administratoren bearbeitet werden."
)
@@ -420,8 +476,8 @@ def guard_last_admin(conn: sqlite3.Connection, user_id: int, *, action: str) ->
return
if count_active_admins(conn, exclude_id=user_id) == 0:
raise PermissionDenied(
f"{action} nicht moeglich: es muss mindestens ein entsperrtes "
"Administratorkonto uebrig bleiben."
f"{action} nicht möglich: es muss mindestens ein entsperrtes "
"Administratorkonto übrig bleiben."
)
@@ -482,12 +538,12 @@ def create_user(
if existing["deleted_at"]:
raise ValidationError(
f"Der Benutzername {clean!r} liegt im Papierkorb. Stellen Sie das Konto "
"wieder her oder loeschen Sie es endgueltig."
"wieder her oder löschen Sie es endgültig."
)
raise ValidationError(f"Der Benutzername {clean!r} ist bereits vergeben.")
if is_admin and not getattr(actor, "is_admin", False):
raise PermissionDenied("Nur Administratoren koennen weitere Administratoren anlegen.")
raise PermissionDenied("Nur Administratoren können weitere Administratoren anlegen.")
if auth_source == "local":
problems = policy.check(password, username=clean)
@@ -552,24 +608,30 @@ def update_user(
# ueberschrieben -- die Bearbeitung waere eine Illusion.
raise ValidationError(
"Name und E-Mail eines Verzeichniskontos werden bei jeder Anmeldung "
"aus dem Verzeichnis uebernommen und koennen hier nicht geaendert werden."
"aus dem Verzeichnis übernommen und können hier nicht geändert werden."
)
fields: dict[str, Any] = {}
# Mit Werten, nicht nur "geaendert": aus dem Protokoll soll man den
# vorherigen Stand ablesen koennen, ohne eine Sicherung auszupacken.
beschriftungen = {"first_name": "Vorname", "last_name": "Nachname", "email": "E-Mail"}
for column, value in (
("first_name", first_name),
("last_name", last_name),
("email", email),
):
if value is not None and value.strip() != str(target.get(column) or ""):
alt = str(target.get(column) or "")
if value is not None and value.strip() != alt:
fields[column] = value.strip()
changes.append(f"{column} geaendert")
changes.append(
f"{beschriftungen[column]}: {alt or '(leer)'} -> {value.strip() or '(leer)'}"
)
if is_admin is not None and bool(is_admin) != bool(target["is_admin"]):
if not getattr(actor, "is_admin", False):
raise PermissionDenied("Das Admin-Kennzeichen kann nur ein Administrator aendern.")
raise PermissionDenied("Das Admin-Kennzeichen kann nur ein Administrator ändern.")
if int(target["id"]) == int(getattr(actor, "id", 0)):
raise PermissionDenied("Sie koennen Ihr eigenes Admin-Kennzeichen nicht aendern.")
raise PermissionDenied("Sie können Ihr eigenes Admin-Kennzeichen nicht ändern.")
if not is_admin:
guard_last_admin(conn, user_id, action="Herabstufen")
fields["is_admin"] = int(bool(is_admin))
@@ -577,7 +639,7 @@ def update_user(
if is_locked is not None and bool(is_locked) != bool(target["is_locked"]):
if int(target["id"]) == int(getattr(actor, "id", 0)):
raise PermissionDenied("Sie koennen Ihr eigenes Konto nicht sperren.")
raise PermissionDenied("Sie können Ihr eigenes Konto nicht sperren.")
if is_locked:
guard_last_admin(conn, user_id, action="Sperren")
fields["is_locked"] = int(bool(is_locked))
@@ -595,7 +657,7 @@ def update_user(
after = {int(gid) for gid in group_ids}
if before != after:
set_user_groups(conn, user_id, sorted(after), actor=actor, tree=tree)
changes.append("Gruppenzuordnung geaendert")
changes.append("Gruppenzuordnung geändert")
return changes
@@ -613,7 +675,7 @@ def set_password(
raise ValidationError("Dieses Konto existiert nicht.")
if str(row.get("auth_source")) == "ldap":
raise ValidationError(
"Verzeichniskonten haben hier kein Passwort -- es wird im Verzeichnisdienst gepflegt."
"Verzeichniskonten haben hier kein Passwort – es wird im Verzeichnisdienst gepflegt."
)
problems = policy.check(new_password, username=str(row["username"]))
if problems:
@@ -631,7 +693,7 @@ def soft_delete_user(conn: sqlite3.Connection, user_id: int, *, actor: Any) -> s
raise ValidationError("Dieses Konto existiert nicht (mehr).")
guard_target_account(actor, target)
if int(target["id"]) == int(getattr(actor, "id", 0)):
raise PermissionDenied("Sie koennen Ihr eigenes Konto nicht loeschen.")
raise PermissionDenied("Sie können Ihr eigenes Konto nicht löschen.")
guard_last_admin(conn, user_id, action="Loeschen")
if str(target.get("auth_source")) == "ldap":
@@ -677,7 +739,7 @@ def matrix_state(
granted = set(permissions)
state: dict[str, dict[str, bool]] = {}
for area in tree.areas:
state[area.key] = {"view": area.view_key in granted}
state[area.key] = {"read": area.read_key in granted}
for resource in area.resources:
state[resource.key] = {
action.value: resource.permission(action) in granted for action in resource.actions
@@ -690,7 +752,7 @@ def summarize_permissions(tree: PermissionTree, permissions: Iterable[str]) -> l
granted = set(permissions)
lines: list[str] = []
for area in tree.areas:
if area.view_key not in granted:
if area.read_key not in granted:
continue
parts: list[str] = []
for resource in area.resources:
@@ -706,12 +768,9 @@ def summarize_permissions(tree: PermissionTree, permissions: Iterable[str]) -> l
return lines
#: Abgeleitet und nicht abgeschrieben: die Buchstaben stehen in ACTION_META.
#: Die zweite Liste hier hatte "U" fuer Bearbeiten, waehrend die Matrix "W"
#: zeigte -- dieselbe Aktion, zwei Kuerzel, je nachdem wo man hinsah.
ACTION_LETTERS: dict[Action, str] = {
Action.VIEW: "R",
Action.CREATE: "C",
Action.EDIT: "U",
Action.DELETE: "D",
Action.EXECUTE: "X",
Action.EXPORT: "E",
Action.SECRETS: "S",
action: meta[0] for action, meta in ACTION_META.items()
}
@@ -112,7 +112,7 @@ def protect() -> None:
if not expected or not provided:
abort(403, description="Das Sicherheitstoken des Formulars fehlt. Bitte Seite neu laden.")
if not hmac.compare_digest(str(expected), str(provided)):
abort(403, description="Das Sicherheitstoken des Formulars ist ungueltig. Bitte Seite neu laden.")
abort(403, description="Das Sicherheitstoken des Formulars ist ungültig. Bitte Seite neu laden.")
def exempt(view):
@@ -65,10 +65,10 @@ class PasswordPolicy:
if classes < self.require_classes:
problems.append(
f"Mindestens {self.require_classes} verschiedene Zeichenarten "
"(Klein-/Grossbuchstaben, Ziffern, Sonderzeichen)."
"(Klein-/Großbuchstaben, Ziffern, Sonderzeichen)."
)
if normalized.lower() in _FORBIDDEN:
problems.append("Dieses Passwort ist zu haeufig und damit unsicher.")
problems.append("Dieses Passwort ist zu häufig und damit unsicher.")
if username and len(username) >= 3 and username.lower() in normalized.lower():
problems.append("Das Passwort darf den Benutzernamen nicht enthalten.")
if len(set(normalized)) <= 3 and normalized:
@@ -67,6 +67,45 @@ class SettingSpec:
return "" if value is None else str(value)
#: So lang darf ein Wert im Protokoll werden -- danach wird gekuerzt. Ein
#: JSON-Feld mit der halben Navigationsreihenfolge macht die Zeile unlesbar.
WERT_GRENZE = 80
class Aenderung(str):
"""Eine geaenderte Einstellung, lesbar als ``schluessel: alt -> neu``.
Eine Zeichenkette und kein eigener Typ, weil die Aufrufer die Liste
weiterhin mit ``", ".join(...)`` in einen Protokolleintrag schreiben --
so gibt es keine Stelle, die man beim Umbau vergessen kann.
"""
key: str
alt: str
neu: str
def __new__(cls, key: str, alt: Any, neu: Any, *, geheim: bool = False) -> "Aenderung":
alt_text = "(gesetzt)" if geheim and alt else _kurz(alt)
neu_text = "(geaendert)" if geheim else _kurz(neu)
selbst = super().__new__(cls, f"{key}: {alt_text} -> {neu_text}")
selbst.key = key
selbst.alt = alt_text
selbst.neu = neu_text
return selbst
def _kurz(wert: Any) -> str:
"""Ein Wert als kurzer Text -- leer wird sichtbar, lang wird gekuerzt."""
if wert is None or wert == "":
return "(leer)"
if isinstance(wert, bool):
return "ein" if wert else "aus"
text = " ".join(str(wert).split())
if len(text) > WERT_GRENZE:
return text[: WERT_GRENZE - 1] + "…"
return text
class SettingsStore:
"""Zugriff auf ``settings``. Alle Methoden nehmen die bestehende Verbindung."""
@@ -140,16 +179,24 @@ class SettingsStore:
def set_many(
self, conn: sqlite3.Connection, values: dict[str, Any], *, actor: str = ""
) -> list[str]:
"""Setzt mehrere Werte, gibt die tatsaechlich geaenderten Schluessel zurueck."""
changed: list[str] = []
) -> list["Aenderung"]:
"""Setzt mehrere Werte und gibt die Aenderungen zurueck.
Jede Aenderung ist eine Zeichenkette der Form ``schluessel: alt -> neu``
-- und traegt die Einzelteile als Attribute. Damit steht im
Aenderungsprotokoll, was sich geaendert hat, ohne dass jede
Einstellungsseite es einzeln zusammenbauen muss. Vorher stand dort nur
der Schluessel, und die Frage "was war vorher eingestellt?" liess sich
aus dem Protokoll nicht beantworten.
"""
changed: list[Aenderung] = []
current = self.get_many(conn, list(values))
for key, value in values.items():
spec = self.spec(key)
if spec.serialize(current.get(key)) == spec.serialize(value):
continue
self.set(conn, key, value, actor=actor)
changed.append(key)
changed.append(Aenderung(key, current.get(key), value, geheim=spec.kind == "secret"))
return changed
def delete(self, conn: sqlite3.Connection, key: str) -> None:
@@ -847,6 +847,25 @@
flex: 1 1 12rem;
margin: 0;
}
/* Die Entscheidung steht rechts und der Haken darueber: er gehoert zum
Speichern, nicht zu den Feldern davor. */
.viewer__saveaktionen {
margin-left: auto;
display: flex;
flex-direction: column;
align-items: flex-end;
gap: var(--sp-2);
}
.viewer__saveknoepfe {
display: flex;
gap: var(--sp-2);
}
/* Nach "gibt es schon": der Haken ist die Antwort -- also faellt er auf. */
.viewer__saveaktionen .check.is-gefragt {
outline: 2px solid var(--accent);
outline-offset: 3px;
border-radius: var(--r-xs);
}
/* Eigener Name: ".field--inline" gibt es schon und steht dort fuer
"waagerecht" -- diese Regel haette sie app-weit umgestellt. */
.viewer__feld {
@@ -991,7 +1010,25 @@
text-align: center;
}
.matrix thead th:first-child { text-align: left; }
.matrix td:not(:first-child), .matrix th:not(:first-child) { width: 62px; text-align: center; }
/* Kuerzel, englischer Name, deutsche Beschriftung -- untereinander. Nur das
Kuerzel allein war eine Spalte, die man nachschlagen musste; die Legende
steht unter einer Tabelle, die man dafuer erst zu Ende scrollt. */
.matrix__spalte { display: flex; flex-direction: column; align-items: center; line-height: 1.15; }
.matrix__spalte b {
font-family: var(--font-mono);
font-size: var(--fs-sm);
color: var(--text);
font-weight: 650;
}
.matrix__spalte span { font-size: var(--fs-xs); color: var(--text-muted); text-transform: none; }
.matrix__spalte small {
font-size: 10px;
color: var(--text-faint);
text-transform: none;
letter-spacing: 0;
font-weight: 400;
}
.matrix td:not(:first-child), .matrix th:not(:first-child) { width: 72px; text-align: center; }
.matrix tr.matrix__area > td {
background: var(--surface-2);
font-weight: 640;
@@ -1017,6 +1054,46 @@
}
.matrix__resource-label { display: flex; flex-direction: column; gap: 1px; }
.matrix__resource-label small { color: var(--text-faint); font-size: var(--fs-xs); }
.matrix__zeile { display: flex; align-items: baseline; gap: var(--sp-2); }
.matrix__zeile b { font-weight: 600; }
/* Unterzeile: gehoert zur Zeile darueber. Ohne Einrueckung liest man sechs
unabhaengige Dinge, wo sechs Teile eines Ganzen stehen. */
.matrix tr.matrix__unterzeile > td:first-child { padding-left: var(--sp-6); }
.matrix tr.matrix__unterzeile > td:first-child .matrix__zeile b { font-weight: 500; }
/* Was eine Aktion in dieser Zeile bedeutet -- in der Zeile, nicht im
Titelattribut: mit dem Finger gibt es kein "hover". */
.matrix__bedeutung { color: var(--text-faint); font-size: var(--fs-xs); }
.matrix__bedeutung b {
font-family: var(--font-mono);
color: var(--text-muted);
font-weight: 500;
}
.matrix__alle {
border: 1px solid var(--border);
background: transparent;
color: var(--text-muted);
border-radius: var(--r-sm);
font-size: 10px;
line-height: 1;
padding: 2px 4px;
cursor: pointer;
}
.matrix__alle:hover { color: var(--accent); border-color: var(--accent); }
.matrix__filter {
display: flex;
align-items: baseline;
gap: var(--sp-3);
margin-bottom: var(--sp-3);
flex-wrap: wrap;
}
.matrix__filter-hint { color: var(--text-faint); font-size: var(--fs-xs); }
/* Eine ausgefilterte Zeile ist versteckt, nicht entfernt: ihre Kaestchen
bleiben im Formular, sonst loescht ein Filter beim Speichern Rechte. */
.matrix tr[hidden] { display: none; }
.matrix__legend {
display: flex;
flex-wrap: wrap;
@@ -1384,3 +1461,271 @@
background: transparent;
border-style: dashed;
}
/* -- Unterschrift --------------------------------------------------------- */
/* Die Zeichenflaeche braucht "touch-action: none": sonst scrollt ein iPad die
Seite, statt einen Strich zu zeichnen -- und es sieht aus, als reagierte das
Feld nicht. */
.viewer__sign {
display: flex;
flex-direction: column;
gap: 8px;
padding: 10px 12px;
border-top: 1px solid var(--border);
background: var(--surface-2);
}
.viewer__signfelder {
display: flex;
gap: 10px;
flex-wrap: wrap;
}
.viewer__signpad {
width: 100%;
height: 160px;
border: 1px dashed var(--border-strong, var(--border));
border-radius: var(--r-sm);
background: #fff;
touch-action: none;
cursor: crosshair;
}
.viewer__signaktionen {
display: flex;
align-items: center;
gap: 8px;
justify-content: flex-end;
flex-wrap: wrap;
}
.viewer__pdfscroll--setzen {
cursor: crosshair;
}
.viewer__pdfscroll--setzen .page {
outline: 2px dashed var(--accent, #c8791f);
outline-offset: -2px;
}
/* Die gesetzte Unterschrift liegt auf der Seite -- in Prozent, damit sie beim
Zoomen an ihrer Stelle bleibt. Sie nimmt Zeiger an: verschieben mit dem
Block, Groesse mit dem Griff unten rechts, entfernen mit dem Kreuz.
"touch-action: none" ist auf dem iPad die Bedingung dafuer, dass ein Finger
zieht statt die Seite zu scrollen. */
/* Die Marke ist genau die Zeichnung: ihre Unterkante liegt auf dem
Ankerpunkt -- dieselbe Kante, an der pdf-lib das Bild setzt. Der Text
haengt darunter und darf die Hoehe nicht mitbestimmen. */
.viewer__unterschrift {
position: absolute;
z-index: 3;
cursor: grab;
touch-action: none;
/* "outline" statt "border": ein Rahmen haette die Marke um zwei Pixel
groesser gemacht und die Bildkante vom Ankerpunkt weggeschoben. */
outline: 1px dashed transparent;
outline-offset: 1px;
}
.viewer__unterschrift:hover,
.viewer__unterschrift.is-fassend {
outline-color: var(--accent);
cursor: grabbing;
}
.viewer__unterschrift img {
display: block;
width: 100%;
pointer-events: none;
}
/* Dieselbe Rechnung wie im PDF (Breite durch 18): auf dem Schirm steht, was
spaeter in der Datei steht. */
/* "width: max-content": der Strich ist so lang wie der Text darunter -- so
wie im PDF. Waere er so breit wie der Block, zeigte die Vorschau etwas
anderes als die Datei. */
.viewer__unterschrifttext {
/* Unter der Zeichnung, nicht in ihr: "top: 100%" setzt die Oberkante des
Strichs auf die Bildkante -- genau dort zieht ihn auch pdf-lib. Abstand,
Strichstaerke und Innenabstand rechnet das Skript in Punkten. */
position: absolute;
top: 100%;
left: 0;
/* Helvetica: dieselbe Schrift, die das PDF benutzt (StandardFonts.Helvetica).
Mit der Hausschrift sah die Vorschau anders aus als das Ergebnis. Die
Groesse setzt das Skript je Unterschrift -- hier steht nur ein Rueckfall. */
font-family: Helvetica, Arial, sans-serif;
/* Die tatsaechliche Groesse setzt das Skript in Pixeln (Punkte mal
Pixel-je-Punkt der Seite). Dieser Wert gilt nur, solange sie noch nicht
gerechnet wurde -- geerbt wuerde sonst die Schriftgroesse der Seite. */
font-size: 8px;
line-height: 1.15;
color: #111;
border-top: 1px solid rgba(0, 0, 0, 0.85);
pointer-events: none;
white-space: nowrap;
width: max-content;
}
.viewer__unterschriftgriff,
.viewer__unterschriftweg {
position: absolute;
width: 16px;
height: 16px;
padding: 0;
border: 1px solid var(--accent);
border-radius: 3px;
background: var(--surface-1);
color: var(--accent);
font-size: 11px;
line-height: 1;
opacity: 0;
cursor: nwse-resize;
}
.viewer__unterschriftweg {
cursor: pointer;
top: -8px;
right: -8px;
}
.viewer__unterschriftgriff {
right: -8px;
bottom: -8px;
}
.viewer__unterschrift:hover .viewer__unterschriftgriff,
.viewer__unterschrift:hover .viewer__unterschriftweg,
.viewer__unterschrift.is-fassend .viewer__unterschriftgriff {
opacity: 1;
}
/* Auf einem Tastbildschirm gibt es kein "hover" -- dort stehen die Knoepfe
immer, sonst kaeme man nie an sie heran. */
@media (hover: none) {
.viewer__unterschriftgriff,
.viewer__unterschriftweg {
opacity: 1;
}
}
/* -- Ergebnis der Signaturpruefung ---------------------------------------- */
/* Der Schleier liegt ueber der Seite und nimmt keine Klicks an: ein
unterschriebenes Dokument ist flach, aber bei einem Irrtum soll die
Kennzeichnung nicht auch noch die Bedienung blockieren. */
.viewer__pdf--unveraendert {
box-shadow: inset 0 0 0 3px var(--success);
}
.viewer__pdf--unveraendert::after,
.viewer__pdf--veraendert::after {
content: "";
position: absolute;
inset: 0;
pointer-events: none;
z-index: 4;
}
.viewer__pdf--unveraendert::after {
background: rgba(47, 158, 68, 0.1);
}
.viewer__pdf--veraendert {
box-shadow: inset 0 0 0 3px var(--danger);
}
.viewer__pdf--veraendert::after {
background: rgba(201, 42, 42, 0.08);
}
.viewer__pruefung {
margin: 0;
padding: 6px 12px;
font-size: var(--fs-xs);
border-top: 1px solid var(--border);
}
.viewer__pruefung--gut {
color: var(--success);
background: rgba(47, 158, 68, 0.12);
}
.viewer__pruefung--schlecht {
color: var(--danger);
background: rgba(201, 42, 42, 0.12);
}
/* -- Tabelle, die schmal zu Bloecken wird -------------------------------- */
/* Eine Protokollzeile besteht aus sieben Angaben, von denen eine lang ist:
das Detail. Auf einem breiten Schirm passt das nebeneinander. Wird es eng,
ist eine Spalte von zwei Zentimetern fuer eine Pruefsumme keine Loesung --
dann steht jede Angabe auf ihrer eigenen Zeile, beschriftet. */
.table--stapelbar .td--detail {
/* Zeilenumbrueche aus dem Eintrag bleiben stehen: die Pruefsumme steht
unter dem lesbaren Teil, nicht mitten darin. Und ein Hash ohne Trennstelle
darf notfalls hart umbrechen. */
white-space: pre-line;
overflow-wrap: anywhere;
max-width: 52ch;
}
@media (max-width: 1100px) {
.table--stapelbar thead {
display: none;
}
.table--stapelbar,
.table--stapelbar tbody,
.table--stapelbar tr,
.table--stapelbar td {
display: block;
width: auto;
}
.table--stapelbar tr {
padding: var(--sp-3) 0;
border-bottom: 1px solid var(--border);
}
.table--stapelbar td {
display: grid;
grid-template-columns: 8.5rem 1fr;
gap: var(--sp-2);
align-items: baseline;
border: 0;
padding: 2px var(--sp-3);
white-space: normal;
}
.table--stapelbar td::before {
content: attr(data-spalte);
color: var(--text-muted);
font-size: var(--fs-xs);
}
.table--stapelbar .td--detail {
max-width: none;
}
/* Leere Zellen brauchen keine Zeile. */
.table--stapelbar td:empty {
display: none;
}
}
/* -- Dateiliste: Symbol und Name in einer Zeile -------------------------- */
/* Das Symbol ist ein Block-SVG; ohne diese Regel stand der Name darunter und
eine Ordnerzeile sah doppelt so hoch aus wie eine Dateizeile. */
.file-cell {
display: flex;
align-items: center;
gap: 6px;
}
.file-cell > svg {
flex: 0 0 auto;
}
@@ -109,7 +109,7 @@ export function showToast(message, type = "info", { timeout = 6000 } = {}) {
const close = document.createElement("button");
close.type = "button";
close.className = "toast__close";
close.setAttribute("aria-label", "Meldung schliessen");
close.setAttribute("aria-label", "Meldung schließen");
close.textContent = "×";
toast.append(body, close);
toastStack.appendChild(toast);
@@ -293,7 +293,7 @@ function initConfirmations() {
event.preventDefault();
event.stopPropagation();
pending = trigger;
titleNode.textContent = trigger.dataset.confirmTitle || "Bitte bestaetigen";
titleNode.textContent = trigger.dataset.confirmTitle || "Bitte bestätigen";
textNode.textContent = trigger.dataset.confirm;
okButton.textContent = trigger.dataset.confirmOk || "Fortfahren";
okButton.className = `btn btn--${trigger.dataset.confirmStyle || "danger"}`;
@@ -440,6 +440,56 @@ function initPermissionMatrix() {
});
};
/* -- Ganze Zeile, ganze Spalte, Filter -----------------------------
Bei 37 Zeilen und bis zu sieben Spalten je Bereich sind das ueber
zweihundert Kaestchen. Ohne diese drei Hilfen setzt man oben den
Bereichsschalter und laesst es dabei -- und die feine Aufteilung
haette nichts gebracht. */
// Nur was man sieht: eine vom Filter ausgeblendete Zeile darf ein
// Sammelknopf nicht mitnehmen. Sonst setzt man "alle Write" waehrend nach
// "Neustart" gefiltert ist und aendert dabei Zeilen, die gar nicht auf dem
// Schirm stehen -- und merkt es erst nach dem Speichern.
const sichtbar = (box) => !box.disabled && !box.closest("tr").hidden;
const felder = (bereich) =>
$$('input[type="checkbox"][name][data-action]', bereich).filter(sichtbar);
table.addEventListener("click", (event) => {
const ziel = event.target;
if (!(ziel instanceof HTMLElement)) return;
const zeilenknopf = ziel.closest("[data-matrix-row]");
if (zeilenknopf) {
event.preventDefault();
const row = zeilenknopf.closest("tr");
if (!row) return;
const kaestchen = felder(row);
// Erst wenn alles gesetzt ist, nimmt der Knopf weg -- sonst waere
// ein zweiter Klick auf eine halb gesetzte Zeile ein Ruecksprung.
const alleGesetzt = kaestchen.length > 0 && kaestchen.every((box) => box.checked);
kaestchen.forEach((box) => {
box.checked = !alleGesetzt;
box.dispatchEvent(new Event("change", { bubbles: true }));
});
return;
}
const spaltenknopf = ziel.closest("[data-matrix-column]");
if (spaltenknopf) {
event.preventDefault();
const aktion = spaltenknopf.dataset.matrixColumn;
const bereich = spaltenknopf.dataset.area;
const kaestchen = $$(
`tr[data-area="${bereich}"] input[data-action="${aktion}"][name]`,
table
).filter(sichtbar);
const alleGesetzt = kaestchen.length > 0 && kaestchen.every((box) => box.checked);
kaestchen.forEach((box) => {
box.checked = !alleGesetzt;
box.dispatchEvent(new Event("change", { bubbles: true }));
});
}
});
$$("[data-area-switch]", table).forEach((master) => {
const areaKey = master.dataset.areaSwitch;
syncArea(areaKey);
@@ -451,8 +501,12 @@ function initPermissionMatrix() {
if (!(box instanceof HTMLInputElement) || !box.dataset.action) return;
const row = box.closest("tr");
if (!row) return;
const viewBox = $('input[data-action="view"]', row);
if (box.dataset.action === "view") {
// "read", nicht "view": die Aktion heisst seit 2.8.0 wie das, was sie
// tut. Mit dem alten Namen fand diese Zeile das Kaestchen nicht mehr --
// die Matrix haette sich weiter bedienen lassen und dabei die Regel
// "jede Aktion setzt Ansehen voraus" stillschweigend fallen gelassen.
const viewBox = $('input[data-action="read"]', row);
if (box.dataset.action === "read") {
// "Ansehen" abwaehlen entfernt alles andere dieser Zeile.
if (!box.checked) {
$$('input[type="checkbox"][name]', row).forEach((other) => {
@@ -469,6 +523,30 @@ function initPermissionMatrix() {
master.dispatchEvent(new Event("change"));
}
});
const suche = $("[data-matrix-filter]");
const zaehler = $("[data-matrix-count]");
if (suche) {
const zeilen = $$("tr[data-suchtext]", table);
const filtern = () => {
const begriff = suche.value.trim().toLowerCase();
let sichtbar = 0;
zeilen.forEach((row) => {
const passt = !begriff || (row.dataset.suchtext || "").includes(begriff);
// "hidden" und nicht aus dem Formular nehmen: ein Filter, der
// Kaestchen entfernt, loescht beim Speichern Rechte.
row.hidden = !passt;
if (passt) sichtbar += 1;
});
if (zaehler) {
zaehler.textContent = begriff
? `${sichtbar} von ${zeilen.length} Zeilen`
: `${zeilen.length} Zeilen`;
}
};
suche.addEventListener("input", filtern);
filtern();
}
});
}
@@ -497,14 +575,14 @@ function initAutoRefresh() {
nameField.value = entry.name || "";
dnField.value = entry.dn || "";
results.hidden = true;
show(`Uebernommen: ${entry.name || entry.dn}`);
show(`Übernommen: ${entry.name || entry.dn}`);
};
const search = async () => {
const term = query.value.trim();
if (term.length < 2) { show("Bitte mindestens zwei Zeichen eingeben."); return; }
button.disabled = true;
show("Suche laeuft ...");
show("Suche läuft ...");
results.innerHTML = "";
try {
const url = `${picker.dataset.searchUrl}?q=${encodeURIComponent(term)}`;
@@ -532,10 +610,10 @@ function initAutoRefresh() {
results.appendChild(row);
});
results.hidden = false;
show(`${entries.length} Treffer -- zum Uebernehmen anklicken.`);
show(`${entries.length} Treffer – zum Übernehmen anklicken.`);
} catch (error) {
results.hidden = true;
show("Die Suche ist fehlgeschlagen. Laeuft die Verbindung zum Verzeichnis?");
show("Die Suche ist fehlgeschlagen. Läuft die Verbindung zum Verzeichnis?");
} finally {
button.disabled = false;
}
@@ -720,7 +798,7 @@ function initClipboard() {
timeout: 2500,
});
} catch {
showToast("Kopieren nicht moeglich -- bitte manuell markieren.", "warning");
showToast("Kopieren nicht möglich – bitte manuell markieren.", "warning");
}
});
}
@@ -169,7 +169,7 @@ async function fotoAlsJpeg(datei) {
const daten = await new Promise((fertig, schiefgegangen) => {
const leser = new FileReader();
leser.onload = () => fertig(String(leser.result));
leser.onerror = () => schiefgegangen(new Error("Die Datei liess sich nicht lesen."));
leser.onerror = () => schiefgegangen(new Error("Die Datei ließ sich nicht lesen."));
leser.readAsDataURL(datei);
});
bild = await new Promise((fertig, schiefgegangen) => {
@@ -207,7 +207,7 @@ async function pdflibLaden(adresse) {
skript.onload = () => fertig(window.PDFLib);
skript.onerror = () => {
pdflibGeladen = null;
schiefgegangen(new Error("pdf-lib liess sich nicht laden."));
schiefgegangen(new Error("pdf-lib ließ sich nicht laden."));
};
document.head.append(skript);
});
@@ -228,7 +228,12 @@ async function pdflibLaden(adresse) {
* ``abschliessen`` rechnet danach alle Felder flach in die Seite: heraus kommt
* ein PDF ohne Formular -- nichts mehr zu verstellen.
*/
async function nachbearbeiten(bytes, bilder, adresse, { abschliessen = false } = {}) {
async function nachbearbeiten(
bytes,
bilder,
adresse,
{ abschliessen = false, unterschriften = [], zeuge = "" } = {}
) {
const PDFLib = await pdflibLaden(adresse);
const dokument = await PDFLib.PDFDocument.load(bytes);
const formular = dokument.getForm();
@@ -258,11 +263,77 @@ async function nachbearbeiten(bytes, bilder, adresse, { abschliessen = false } =
try {
formular.removeField(knopf);
} catch (fehler) {
console.warn("Bildknopf liess sich nicht entfernen", fehler);
console.warn("Bildknopf ließ sich nicht entfernen", fehler);
}
}
}
// Unterschriften: Bild und darunter der angegebene Name mit Zeitpunkt. Das
// Bild allein waere eine Zeichnung ohne Aussage -- auf Papier steht neben
// der Unterschrift auch der Name in Druckbuchstaben.
if (unterschriften.length) {
const schrift = await dokument.embedFont(PDFLib.StandardFonts.Helvetica);
for (const eintrag of unterschriften) {
const seite = dokument.getPage(eintrag.seite - 1);
const png = await dokument.embedPng(eintrag.bytes);
const breite = eintrag.breite;
const hoehe = (png.height / png.width) * breite;
seite.drawImage(png, { x: eintrag.x, y: eintrag.y, width: breite, height: hoehe });
const zeilen = [`${eintrag.name} | ${eintrag.zeit}`];
// Der Zeugenvermerk gehoert zum Dokument, nicht zu jeder Unterschrift:
// unter drei Unterschriften stand dreimal derselbe Satz. Sichtbar
// erscheint er deshalb nur unter der ersten -- fest steht er ohnehin in
// den Dokumenteigenschaften und im Aenderungsprotokoll.
if (zeuge && eintrag === unterschriften[0]) {
zeilen.push(`In TESM abgelegt durch ${zeuge}`);
}
// Die Schrift waechst mit der Unterschrift: wer sie kleiner zieht, will
// den ganzen Block kleiner haben, nicht eine Zeichnung mit einer
// Bildunterschrift in Originalgroesse daneben.
const groesse = schriftgroesse(breite);
// Der Strich ist so lang wie die laengste Zeile darunter -- nicht so
// breit wie die Zeichnung. Eine kurze Unterschrift ueber einem langen
// Namen sah sonst aus wie zwei Dinge, die nicht zusammengehoeren.
const textbreite = Math.max(
...zeilen.map((zeile) => schrift.widthOfTextAtSize(zeile, groesse))
);
let unten = eintrag.y - UNTERSCHRIFT.textY;
for (const zeile of zeilen) {
unten -= groesse * UNTERSCHRIFT.zeile;
seite.drawText(zeile, {
x: eintrag.x,
y: unten,
size: groesse,
font: schrift,
color: PDFLib.rgb(0.1, 0.1, 0.1),
});
}
// Kraeftig genug, um neben den Linien eines Formulars als eigener Strich
// erkennbar zu bleiben: ein halber Punkt in hellem Grau ging zwischen
// den Tabellenlinien schlicht unter.
seite.drawLine({
start: { x: eintrag.x, y: eintrag.y - UNTERSCHRIFT.strichY },
end: { x: eintrag.x + textbreite, y: eintrag.y - UNTERSCHRIFT.strichY },
thickness: UNTERSCHRIFT.strich,
color: PDFLib.rgb(0.15, 0.15, 0.15),
});
}
}
if (unterschriften.length) {
// In den Dokumenteigenschaften -- dort sucht man so etwas, und dort steht
// es einmal statt unter jeder Unterschrift. Jeder Betrachter zeigt das
// an, auch ausserhalb von TESM.
const namen = unterschriften.map((eintrag) => eintrag.name);
const wann = unterschriften[unterschriften.length - 1].zeit;
dokument.setAuthor(namen.join(", "));
dokument.setSubject(
`Unterschrieben am ${wann}` + (zeuge ? ` | in TESM abgelegt durch ${zeuge}` : "")
);
dokument.setProducer("TESM");
dokument.setModificationDate(new Date());
}
if (abschliessen) {
// Alle Felder werden Teil der Seite. Danach gibt es kein Formular mehr --
// gewollt: so kann niemand mehr etwas verstellen.
@@ -271,6 +342,177 @@ async function nachbearbeiten(bytes, bilder, adresse, { abschliessen = false } =
return dokument.save();
}
/** Masse des Textblocks unter einer Unterschrift -- in PDF-Punkten.
*
* Die Vorschau rechnet dieselben Zahlen in Pixel um. Standen sie zweimal im
* Code, liefen sie auseinander: die Marke haengt mit ihrer **Unterkante** am
* Ankerpunkt, das PDF setzt dort die **Unterkante des Bildes** und schreibt
* den Text darunter. Beim Setzen sass der Block deshalb um die Texthoehe
* hoeher als in der gespeicherten Datei.
*/
const UNTERSCHRIFT = {
//: Mitte des Strichs unter der Bildkante.
strichY: 1.5,
//: Staerke des Strichs.
strich: 0.9,
//: Bildkante bis zur ersten Grundlinie, vor dem Zeilenabstand.
textY: 2,
//: Zeilenabstand als Vielfaches der Schriftgroesse.
zeile: 1.15,
//: Oberkante der Zeilenbox bis zur Grundlinie, in "em" -- nur ein
//: Rueckfall: gewoehnlich misst "grundlinie()" das am echten Text nach.
//: (Helvetica/Arial: Ascender 0,905 plus halber Durchschuss.)
grundlinie: 0.9215,
};
//: Gemessene Grundlinien, je dargestellter Schriftgroesse in Pixeln.
const grundlinien = new Map();
/** Abstand von der Oberkante der Zeilenbox zur Grundlinie, in "em".
*
* Gemessen statt geraten, und bei genau der Pixelgroesse, die auch auf dem
* Schirm steht. Zwei Gruende: welche Datei hinter "Helvetica" steckt,
* entscheidet das Geraet -- auf einem iPad eine andere als auf einem
* Windows-Rechner, mit anderen Oberlaengen. Und der Browser rundet die
* Schriftmasse auf ganze Pixel: bei acht Punkt Schrift verschiebt das die
* Zeile um einen halben Pixel gegenueber der Rechnung. pdf-lib rundet nicht.
*
* Eine leere Inline-Box sitzt auf der Grundlinie -- ihre Lage verraet also,
* wo der Text steht.
*/
function grundlinie(px) {
const schluessel = px.toFixed(1);
const gemerkt = grundlinien.get(schluessel);
if (gemerkt !== undefined) return gemerkt;
let anteil = UNTERSCHRIFT.grundlinie;
try {
const probe = document.createElement("div");
probe.className = "viewer__unterschrifttext";
probe.style.cssText =
"position:absolute;left:-9999px;top:0;visibility:hidden;border:0;padding:0;";
probe.style.fontSize = `${px}px`;
probe.style.lineHeight = String(UNTERSCHRIFT.zeile);
const lot = document.createElement("span");
lot.style.cssText = "display:inline-block;width:0;height:0;";
probe.append(document.createTextNode("Hg"), lot);
document.body.append(probe);
const oben = probe.getBoundingClientRect().top;
const auf = lot.getBoundingClientRect().top;
probe.remove();
if (auf > oben) anteil = (auf - oben) / px;
} catch (fehler) {
console.warn("Grundlinie nicht messbar -- Rueckfall auf Helvetica", fehler);
}
grundlinien.set(schluessel, anteil);
return anteil;
}
/** Schriftgroesse des Namenszugs unter einer Unterschrift dieser Breite.
*
* Ein Achtzehntel: bei den 150 Punkt der vollen Breite sind das gut acht
* Punkt -- die uebliche Groesse einer Unterschriftszeile auf Papier. Dieselbe
* Rechnung benutzt die Vorschau -- in Pixeln umgerechnet --, damit auf dem
* Schirm steht, was spaeter im PDF steht.
*/
function schriftgroesse(breite) {
return Math.max(5, Math.min(10, breite / 18));
}
/** Die gezeichnete Unterschrift als PNG -- auf das Gezeichnete beschnitten.
*
* Ungeschnitten waere jede Unterschrift so gross wie die Zeichenflaeche, mit
* viel Luft ringsum. Im Dokument sieht das aus wie ein verrutschter Stempel.
*/
function unterschriftAlsPng(leinwand, kasten) {
const rand = 6;
const links = Math.max(0, Math.floor(kasten.x1 - rand));
const oben = Math.max(0, Math.floor(kasten.y1 - rand));
const breite = Math.min(leinwand.width - links, Math.ceil(kasten.x2 - kasten.x1 + rand * 2));
const hoehe = Math.min(leinwand.height - oben, Math.ceil(kasten.y2 - kasten.y1 + rand * 2));
const ziel = document.createElement("canvas");
ziel.width = Math.max(1, breite);
ziel.height = Math.max(1, hoehe);
ziel
.getContext("2d")
.drawImage(leinwand, links, oben, ziel.width, ziel.height, 0, 0, ziel.width, ziel.height);
// Ueber eine data:-Adresse und nicht ueber blob: -- die Sicherheitsregeln
// der Anwendung erlauben blob: nicht, und ein stilles "img-src" waere ein
// Loch, das man fuer eine Unterschrift nicht aufmacht.
const adresse = ziel.toDataURL("image/png");
const roh = atob(adresse.slice(adresse.indexOf(",") + 1));
const bytes = new Uint8Array(roh.length);
for (let i = 0; i < roh.length; i++) bytes[i] = roh.charCodeAt(i);
return { bytes, vorschau: adresse, breite: ziel.width, hoehe: ziel.height };
}
/** Zeichenflaeche fuer die Unterschrift -- Finger, Stift oder Maus.
*
* ``touch-action: none`` steht im Stylesheet: ohne das scrollt ein iPad die
* Seite, statt einen Strich zu zeichnen.
*/
function unterschriftPad(leinwand) {
const stift = leinwand.getContext("2d");
let kasten = null;
let zeichnet = false;
const punkt = (event) => {
const rechteck = leinwand.getBoundingClientRect();
return {
x: ((event.clientX - rechteck.left) / rechteck.width) * leinwand.width,
y: ((event.clientY - rechteck.top) / rechteck.height) * leinwand.height,
};
};
const merken = ({ x, y }) => {
kasten = kasten
? {
x1: Math.min(kasten.x1, x),
y1: Math.min(kasten.y1, y),
x2: Math.max(kasten.x2, x),
y2: Math.max(kasten.y2, y),
}
: { x1: x, y1: y, x2: x, y2: y };
};
stift.lineWidth = 2.5;
stift.lineCap = "round";
stift.lineJoin = "round";
stift.strokeStyle = "#111";
leinwand.addEventListener("pointerdown", (event) => {
event.preventDefault();
leinwand.setPointerCapture(event.pointerId);
zeichnet = true;
const p = punkt(event);
merken(p);
stift.beginPath();
stift.moveTo(p.x, p.y);
});
leinwand.addEventListener("pointermove", (event) => {
if (!zeichnet) return;
event.preventDefault();
const p = punkt(event);
merken(p);
stift.lineTo(p.x, p.y);
stift.stroke();
});
const beenden = () => {
zeichnet = false;
};
leinwand.addEventListener("pointerup", beenden);
leinwand.addEventListener("pointercancel", beenden);
leinwand.addEventListener("pointerleave", beenden);
return {
leeren: () => {
stift.clearRect(0, 0, leinwand.width, leinwand.height);
kasten = null;
},
leer: () => kasten === null,
alsPng: () => (kasten ? unterschriftAlsPng(leinwand, kasten) : null),
};
}
/* -- PDF ------------------------------------------------------------------- */
let pdfjsGeladen = null;
@@ -448,6 +690,206 @@ async function pdfBetrachter(behaelter, seiten, url, basis, { formulare = true }
});
await bildknoepfeAufsetzen();
/* Unterschriften: gezeichnet wird ausserhalb, gesetzt wird hier. Die Stelle
bestimmt ein Tipp ins Dokument -- ein festes Feld gibt es in den wenigsten
Vorlagen, und "unten rechts" ist bei einem Formular mit drei
Unterschriftszeilen die falsche Annahme. */
// Ein menschliches Mass: rund fuenf Zentimeter breit, hoechstens knapp zwei
// hoch. Ohne die Hoehengrenze wird aus einem hohen Gekritzel ein Stempel,
// der die halbe Seite einnimmt -- das Seitenverhaeltnis kommt aus dem
// Zuschnitt der Zeichnung, nicht aus einer Vorlage. Nach dem Setzen laesst
// sich beides mit dem Griff nachstellen, nach oben bis zu dieser Grenze.
const MAX_BREITE = 150;
const MAX_HOEHE = 50;
const unterschriften = [];
//: Je gesetzte Unterschrift eine Funktion, die ihre Marke neu vermisst.
const neuzeichnen = new Set();
let wartendeUnterschrift = null;
let zeugenzeile = () => "";
const platzieren = async (event) => {
if (!wartendeUnterschrift) return;
const seitenEl = event.target.closest(".page");
if (!seitenEl) return;
event.preventDefault();
const nummer = Number(seitenEl.dataset.pageNumber || 0);
if (!nummer) return;
const rechteck = seitenEl.getBoundingClientRect();
const anteilX = (event.clientX - rechteck.left) / rechteck.width;
const anteilY = (event.clientY - rechteck.top) / rechteck.height;
const seite = await dokument.getPage(nummer);
const blick = seite.getViewport({ scale: 1 });
let breite = Math.min(MAX_BREITE, blick.width * 0.3);
let hoehe = (wartendeUnterschrift.hoehe / wartendeUnterschrift.breite) * breite;
if (hoehe > MAX_HOEHE) {
breite *= MAX_HOEHE / hoehe;
hoehe = MAX_HOEHE;
}
const eintrag = {
...wartendeUnterschrift,
seite: nummer,
breite,
// Der Tipp meint die Mitte der Unterschrift, nicht ihre Ecke.
x: Math.max(4, anteilX * blick.width - breite / 2),
y: Math.max(24, (1 - anteilY) * blick.height - hoehe / 2),
};
unterschriften.push(eintrag);
behaelter.classList.remove("viewer__pdfscroll--setzen");
wartendeUnterschrift = null;
// Sichtbar machen, wo sie gelandet ist -- und beweglich: der erste Tipp
// trifft selten genau die Linie, und der Textblock gehoert mit auf die
// richtige Stelle.
marke_setzen(seitenEl, eintrag, blick, zeugenzeile());
behaelter.dispatchEvent(new CustomEvent("unterschrieben", { detail: eintrag }));
};
/** Baut die bewegliche Marke einer gesetzten Unterschrift. */
const marke_setzen = (seitenEl, eintrag, blick, zeuge) => {
const marke = document.createElement("div");
marke.className = "viewer__unterschrift";
const bild = document.createElement("img");
bild.src = eintrag.vorschau;
bild.alt = "";
// Genau der Aufbau der spaeteren Datei: eine Zeile mit Namen und
// Zeitpunkt, darunter -- als eigene Zeile -- der Zeugenvermerk. In der
// Vorschau standen beide hintereinander, getrennt durch einen
// Schraegstrich; beim Positionieren sah der Block dadurch breiter und
// flacher aus als das Ergebnis.
const text = document.createElement("div");
text.className = "viewer__unterschrifttext";
const namenszeile = document.createElement("div");
namenszeile.textContent = `${eintrag.name} | ${eintrag.zeit}`;
text.append(namenszeile);
if (zeuge && eintrag === unterschriften[0]) {
const zeugenzeile = document.createElement("div");
zeugenzeile.textContent = `In TESM abgelegt durch ${zeuge}`;
text.append(zeugenzeile);
}
const griff = document.createElement("button");
griff.type = "button";
griff.className = "viewer__unterschriftgriff";
griff.title = "Größe ändern";
griff.setAttribute("aria-label", "Unterschrift vergroessern oder verkleinern");
const weg = document.createElement("button");
weg.type = "button";
weg.className = "viewer__unterschriftweg";
weg.textContent = "x";
weg.title = "Unterschrift entfernen";
weg.setAttribute("aria-label", "Unterschrift entfernen");
marke.append(bild, text, griff, weg);
seitenEl.append(marke);
const zeichnen = () => {
// Die Marke ist genau die Zeichnung: ihre Unterkante liegt auf dem
// Ankerpunkt, so wie im PDF. Der Text haengt darunter (siehe
// Gestaltung: absolut, "top: 100%") und zaehlt nicht zur Hoehe --
// sonst saesse der Block in der Vorschau um die Texthoehe zu hoch.
marke.style.left = `${(eintrag.x / blick.width) * 100}%`;
marke.style.bottom = `${(eintrag.y / blick.height) * 100}%`;
marke.style.width = `${(eintrag.breite / blick.width) * 100}%`;
// Alles Weitere wird gerechnet, nicht vom Stylesheet abgeleitet:
// Punkte mal Pixel-je-Punkt der gerade dargestellten Seite. Ueber
// Container-Einheiten ("cqw") ging das auch -- aber nur dort, wo der
// Browser sie kennt; wo nicht, erbte der Block die Schriftgroesse der
// Seite, und der Text war um die Haelfte zu breit.
const proPunkt = seitenEl.getBoundingClientRect().width / blick.width;
const groesse = schriftgroesse(eintrag.breite);
const inPixeln = groesse * proPunkt;
const oben = UNTERSCHRIFT.strichY - UNTERSCHRIFT.strich / 2;
text.style.fontSize = `${inPixeln}px`;
text.style.lineHeight = String(UNTERSCHRIFT.zeile);
text.style.marginTop = `${oben * proPunkt}px`;
text.style.borderTopWidth = `${UNTERSCHRIFT.strich * proPunkt}px`;
// Rahmenbreiten rundet der Browser auf ganze Geraetepixel: aus 1,21
// wird 1. Mit dem gerechneten Wert sass die erste Zeile deshalb einen
// Fuenftel Punkt zu hoch -- also mit dem tatsaechlich benutzten rechnen.
const strich =
(parseFloat(getComputedStyle(text).borderTopWidth) ||
UNTERSCHRIFT.strich * proPunkt) / proPunkt;
// Oberkante des Strichs, die Strichstaerke, dann so viel Luft, dass die
// erste Grundlinie dort sitzt, wo pdf-lib sie setzt: textY plus einen
// Zeilenabstand unter der Bildkante.
const innen =
UNTERSCHRIFT.textY +
UNTERSCHRIFT.zeile * groesse -
oben -
strich -
grundlinie(inPixeln) * groesse;
text.style.paddingTop = `${Math.max(0, innen) * proPunkt}px`;
};
// Beim Zoomen aendert sich Pixel-je-Punkt -- dann neu rechnen.
neuzeichnen.add(zeichnen);
zeichnen();
weg.addEventListener("click", (event) => {
event.stopPropagation();
const stelle = unterschriften.indexOf(eintrag);
if (stelle >= 0) unterschriften.splice(stelle, 1);
neuzeichnen.delete(zeichnen);
marke.remove();
});
// Verschieben und Skalieren teilen sich einen Zeiger: beim Griff aendert
// sich die Breite, sonst die Lage.
const fassen = (event) => {
if (event.target === weg) return;
event.preventDefault();
event.stopPropagation();
const skalieren = event.target === griff;
const rechteck = seitenEl.getBoundingClientRect();
const proPunkt = rechteck.width / blick.width;
const startX = event.clientX;
const startY = event.clientY;
const startBreite = eintrag.breite;
const start = { x: eintrag.x, y: eintrag.y };
const obergrenze = Math.min(MAX_BREITE, blick.width * 0.3);
marke.setPointerCapture(event.pointerId);
marke.classList.add("is-fassend");
const bewegen = (zug) => {
if (skalieren) {
const breite = startBreite + (zug.clientX - startX) / proPunkt;
eintrag.breite = Math.max(40, Math.min(obergrenze, breite));
} else {
eintrag.x = Math.max(2, start.x + (zug.clientX - startX) / proPunkt);
eintrag.y = Math.max(
// Platz fuer die beiden Textzeilen unter der Zeichnung.
UNTERSCHRIFT.textY + 2 * UNTERSCHRIFT.zeile * schriftgroesse(eintrag.breite),
start.y - (zug.clientY - startY) / proPunkt
);
}
zeichnen();
};
const loslassen = () => {
marke.classList.remove("is-fassend");
marke.removeEventListener("pointermove", bewegen);
marke.removeEventListener("pointerup", loslassen);
marke.removeEventListener("pointercancel", loslassen);
};
marke.addEventListener("pointermove", bewegen);
marke.addEventListener("pointerup", loslassen);
marke.addEventListener("pointercancel", loslassen);
};
marke.addEventListener("pointerdown", fassen);
};
behaelter.addEventListener("click", (event) => {
platzieren(event).catch((fehler) => console.error("Unterschrift", fehler));
});
// Nach dem Zoomen stehen die Marken anteilig richtig, aber die Schrift
// haengt an der Pixelgroesse der Seite -- die ist jetzt eine andere.
eventBus.on("scalechanging", () => {
for (const zeichnen of neuzeichnen) {
try {
zeichnen();
} catch (fehler) {
console.error("Unterschrift neu vermessen", fehler);
}
}
});
return {
hinein: () => {
viewer.currentScale = Math.min(MAX_ZOOM, viewer.currentScale * 1.2);
@@ -463,12 +905,23 @@ async function pdfBetrachter(behaelter, seiten, url, basis, { formulare = true }
* pdf.js schreibt die Feldwerte; gewaehlte Fotos kommen danach mit
* pdf-lib hinein -- pdf.js kann nichts in ein PDF zeichnen.
*/
speichern: async (pdflibAdresse, { abschliessen = false } = {}) => {
speichern: async (pdflibAdresse, { abschliessen = false, zeuge = "" } = {}) => {
const bytes = await dokument.saveDocument();
// Ohne Bild und ohne Abschluss braucht es pdf-lib gar nicht.
if (!bilder.size && !abschliessen) return bytes;
return nachbearbeiten(bytes, [...bilder.values()], pdflibAdresse, { abschliessen });
// Ohne Bild, ohne Unterschrift und ohne Abschluss braucht es pdf-lib nicht.
if (!bilder.size && !abschliessen && !unterschriften.length) return bytes;
return nachbearbeiten(bytes, [...bilder.values()], pdflibAdresse, {
abschliessen,
unterschriften,
zeuge,
});
},
/** Wartet der Betrachter auf den Tipp, wohin die Unterschrift soll? */
unterschriftAnnehmen: (daten, zeuge = "") => {
wartendeUnterschrift = daten;
zeugenzeile = () => zeuge;
behaelter.classList.add("viewer__pdfscroll--setzen");
},
unterschriften: () => unterschriften.map(({ name, zeit }) => ({ name, zeit })),
/** Wurde ueberhaupt etwas eingetragen? */
veraendert: () => {
const s = dokument.annotationStorage;
@@ -505,10 +958,49 @@ export function initFilePreview(wurzel = document) {
const ordnerFeld = stueck("ordner");
const nameFeld = stueck("name");
const ersetzenFeld = stueck("ersetzen");
const ersetzenKasten = stueck("ersetzenfeld");
const pruefzeile = stueck("pruefung");
// Die Ordner der geoeffneten Freigabe kommen mit der Seite; die einer
// anderen holt das Auswahlfeld bei Bedarf nach.
const eigeneOrdner = () => {
try {
return JSON.parse(rumpf.dataset.viewerOrdnerliste || "[]");
} catch {
return [];
}
};
const jetzt = stueck("jetzt");
const abbrechen = stueck("abbrechen");
const modusFeld = stueck("modus");
const zielFeld = stueck("ziel");
const unterschreibenKnopf = stueck("unterschreiben");
const unterschriftPanel = stueck("unterschriftpanel");
const vornameFeld = stueck("vorname");
const nachnameFeld = stueck("nachname");
const padLeinwand = stueck("signpad");
const padLeeren = stueck("signleeren");
const padSetzen = stueck("signsetzen");
const padAbbrechen = stueck("signabbrechen");
const padHinweis = stueck("signhinweis");
const basis = rumpf.dataset.viewerPdfjs || "";
// Der Anmeldename, nicht der volle Name: er ist eindeutig, und genau das
// soll die Zeile belegen.
const konto = rumpf.dataset.viewerKonto || "";
const bezeugen = rumpf.dataset.viewerZeuge === "1";
// Die Uhr des Servers, nicht die des Tablets: eine verstellte Uhr am Geraet
// soll nicht das Datum unter einer Unterschrift bestimmen.
const serverStart = Date.parse(rumpf.dataset.viewerZeit || "") || Date.now();
const geladenSeit = Date.now();
const jetztText = () => {
const zeitpunkt = new Date(serverStart + (Date.now() - geladenSeit));
return zeitpunkt.toLocaleString("de-DE", {
day: "2-digit",
month: "2-digit",
year: "numeric",
hour: "2-digit",
minute: "2-digit",
});
};
// Ein Format, das dieser Browser nicht kann (HEIC ausserhalb von Safari),
// soll nicht als leere Flaeche enden.
@@ -516,7 +1008,7 @@ export function initFilePreview(wurzel = document) {
if (bildBuehne.hidden || !bild.getAttribute("src")) return;
if (hinweis) {
hinweis.textContent =
"Dieses Bildformat kann Ihr Browser nicht anzeigen -- bitte herunterladen.";
"Dieses Bildformat kann Ihr Browser nicht anzeigen – bitte herunterladen.";
}
});
@@ -535,9 +1027,13 @@ export function initFilePreview(wurzel = document) {
rahmen.hidden = art !== "text";
leiste.hidden = art === "text";
if (speichern) speichern.hidden = art !== "pdf";
if (unterschreibenKnopf) unterschreibenKnopf.hidden = art !== "pdf";
if (speichern) speichern.hidden = art !== "pdf";
if (unterschriftPanel) unterschriftPanel.hidden = true;
};
const aufraeumen = () => {
pruefungZuruecksetzen();
bild.removeAttribute("src");
bilder.zuruecksetzen();
rahmen.src = "about:blank";
@@ -555,6 +1051,61 @@ export function initFilePreview(wurzel = document) {
aktuell = null;
};
/* Unterschrieben und unveraendert? Die Antwort kommt aus dem
Aenderungsprotokoll: dort steht die Pruefsumme der abgelegten Fassung.
Stimmt sie, bekommt die Seite einen gruenen Schleier -- man soll es sehen,
bevor man liest, nicht danach. */
const pruefungZuruecksetzen = () => {
pdfBehaelter.classList.remove("viewer__pdf--unveraendert", "viewer__pdf--veraendert");
if (pruefzeile) {
pruefzeile.hidden = true;
pruefzeile.textContent = "";
pruefzeile.className = "viewer__pruefung";
}
};
const pruefen = async (adresse) => {
pruefungZuruecksetzen();
if (!adresse) return;
try {
const stand = await window.tesm.api(adresse);
if (stand.status === "unveraendert" || stand.status === "veraendert") {
// Ein unterschriebenes Dokument ist abgeschlossen. Wer daraus eine
// neue Fassung machen koennte, koennte auch eine Unterschrift unter
// einen veraenderten Text setzen -- also gibt es hier nichts mehr zu
// bearbeiten. Der Server weist es zusaetzlich ab.
if (unterschreibenKnopf) unterschreibenKnopf.hidden = true;
if (speichern) speichern.hidden = true;
if (zeile) zeile.hidden = true;
}
if (stand.status === "unveraendert") {
pdfBehaelter.classList.add("viewer__pdf--unveraendert");
if (pruefzeile) {
pruefzeile.hidden = false;
pruefzeile.className = "viewer__pruefung viewer__pruefung--gut";
const namen = (stand.namen || []).join(", ");
pruefzeile.textContent =
`Unverändert seit der Unterschrift${namen ? ` von ${namen}` : ""}` +
` | Prüfsumme stimmt mit dem Änderungsprotokoll überein.`;
}
} else if (stand.status === "veraendert") {
pdfBehaelter.classList.add("viewer__pdf--veraendert");
if (pruefzeile) {
pruefzeile.hidden = false;
pruefzeile.className = "viewer__pruefung viewer__pruefung--schlecht";
pruefzeile.textContent =
"Diese Datei wurde nach der Unterschrift verändert – die Prüfsumme " +
"weicht vom Änderungsprotokoll ab.";
}
}
} catch (fehler) {
// Keine Aussage ist besser als eine falsche: ohne Antwort bleibt die
// Seite schlicht ungekennzeichnet.
console.error("Signaturpruefung", fehler);
}
};
const oeffnen = async (ausloeser) => {
aufraeumen();
const art = ausloeser.dataset.fillKind || "text";
@@ -570,6 +1121,7 @@ export function initFilePreview(wurzel = document) {
return;
}
if (hinweis) hinweis.textContent = "PDF wird geladen ...";
pruefen(ausloeser.dataset.fillPruefung || "");
try {
pdf = await pdfBetrachter(pdfScroll, pdfSeiten, quelle, basis, {
formulare: rumpf.dataset.viewerFormulare === "1",
@@ -586,7 +1138,7 @@ export function initFilePreview(wurzel = document) {
// Browsers die einzige Spur, die man hat.
const grund = String(fehler?.message || fehler || "").slice(0, 120);
hinweis.textContent =
"Die Formularansicht liess sich nicht laden -- es bleibt bei der einfachen Anzeige." +
"Die Formularansicht ließ sich nicht laden – es bleibt bei der einfachen Anzeige." +
(grund ? ` (${grund})` : "");
// Die Leiste traegt den Hinweis. "zeigen('text')" hat sie gerade
// verborgen -- ohne diese Zeile blieb der Fehlschlag unsichtbar, und
@@ -620,18 +1172,92 @@ export function initFilePreview(wurzel = document) {
if (!aktuell) return;
const teile = aktuell.pfad.split("/");
const datei = teile.pop() || "formular.pdf";
ordnerFeld.value = teile.join("/");
ordnerFuellen(eigeneOrdner(), teile.join("/"));
// Ohne Endung: die haengt der Server an. Eine Datei, die auf ".pdf.txt"
// oder auf gar nichts endet, oeffnet auf einer Freigabe nichts mehr.
// Der Zusatz haelt die Vorlage heil, auch wenn jemand blind speichert.
nameFeld.value = datei.replace(/\.pdf$/i, "") + "-ausgefuellt";
// Der Zusatz sagt, was in der Datei steht: unterschrieben schlaegt
// ausgefuellt. Und einmal reicht -- wer eine Fassung noch einmal oeffnet
// und speichert, bekam sonst "...-ausgefuellt-ausgefuellt".
const rumpfname = datei.replace(/\.pdf$/i, "");
const zusatz = pdf?.unterschriften().length ? "-unterschrieben" : "-ausgefuellt";
const bereits = new RegExp(`${zusatz}$`, "i").test(rumpfname);
// Eine unterschriebene Fassung aus einer ausgefuellten: der alte Zusatz
// haette sonst zweimal dran gestanden ("-ausgefuellt-unterschrieben").
const blank = rumpfname.replace(/-(ausgefuellt|unterschrieben)$/i, "");
nameFeld.value = bereits ? rumpfname : `${blank}${zusatz}`;
ersetzenFeld.checked = false;
ersetzenKasten?.classList.remove("is-gefragt");
};
/* Unterschreiben: Name tippen, zeichnen, ins Dokument setzen. */
const pad = padLeinwand ? unterschriftPad(padLeinwand) : null;
const panelZeigen = (offen) => {
if (!unterschriftPanel) return;
unterschriftPanel.hidden = !offen;
if (offen) {
pad?.leeren();
if (padHinweis) padHinweis.textContent = "";
vornameFeld?.focus();
}
};
// Gesetzt heisst fertig zum Ablegen: die Zeile geht von selbst auf, statt
// dass man den Knopf daneben sucht.
pdfScroll?.addEventListener("unterschrieben", () => {
if (!zeile || !zeile.hidden) return;
speichern?.click();
});
unterschreibenKnopf?.addEventListener("click", () => {
if (!pdf) return;
panelZeigen(unterschriftPanel?.hidden !== false);
});
padLeeren?.addEventListener("click", () => pad?.leeren());
padAbbrechen?.addEventListener("click", () => panelZeigen(false));
padSetzen?.addEventListener("click", () => {
if (!pdf || !pad) return;
const name = [vornameFeld?.value, nachnameFeld?.value]
.map((wert) => (wert || "").trim())
.filter(Boolean)
.join(" ");
// Beides ist noetig, und beides wird hier gesagt statt stumm abgelehnt.
if (!name) {
if (padHinweis) padHinweis.textContent = "Bitte Vor- und Nachnamen eintragen.";
vornameFeld?.focus();
return;
}
const zeichnung = pad.alsPng();
if (!zeichnung) {
if (padHinweis) padHinweis.textContent = "Bitte im Feld unterschreiben.";
return;
}
pdf.unterschriftAnnehmen(
{ ...zeichnung, name, zeit: jetztText() },
bezeugen ? konto : ""
);
panelZeigen(false);
window.tesm.showToast(
"Jetzt auf die Stelle im Dokument tippen – danach lässt sie sich noch "
+ "verschieben und in der Größe anpassen.",
"info"
);
});
speichern?.addEventListener("click", () => {
if (!pdf || !aktuell) return;
vorschlagen();
zeile.hidden = false;
if (modusFeld && pdf.unterschriften().length) {
// Mit Unterschrift gibt es nur einen Weg -- und das Feld soll nicht
// etwas anderes behaupten.
modusFeld.value = "fertig";
modusFeld.disabled = true;
}
nameFeld.focus();
nameFeld.select();
});
@@ -640,6 +1266,46 @@ export function initFilePreview(wurzel = document) {
zeile.hidden = true;
});
/* Zielfreigabe: die Ordnerliste gehoert zur gewaehlten Freigabe, nicht zur
geoeffneten. Geholt wird sie erst bei Bedarf -- alle Listen im
Seitenaufbau mitzuschicken waere Ballast fuer einen seltenen Fall. */
/** Fuellt die Ordnerauswahl -- erster Eintrag ist immer die Wurzel. */
const ordnerFuellen = (ordner, ausgewaehlt = "") => {
if (!ordnerFeld) return;
const wurzel = document.createElement("option");
wurzel.value = "";
wurzel.textContent = "Wurzelverzeichnis der Freigabe";
const eintraege = [wurzel];
for (const name of ordner) {
const option = document.createElement("option");
option.value = name;
option.textContent = name;
eintraege.push(option);
}
// Der Ordner der Vorlage kann tiefer liegen, als die Liste reicht.
if (ausgewaehlt && !ordner.includes(ausgewaehlt)) {
const option = document.createElement("option");
option.value = ausgewaehlt;
option.textContent = ausgewaehlt;
eintraege.splice(1, 0, option);
}
ordnerFeld.replaceChildren(...eintraege);
ordnerFeld.value = ausgewaehlt;
};
zielFeld?.addEventListener("change", async () => {
const vorlage = zielFeld.dataset.urlVorlage || "";
if (!vorlage) return;
try {
const antwort = await window.tesm.api(vorlage.replace("__token__", zielFeld.value));
ordnerFuellen(antwort.folders || []);
} catch (fehler) {
// Kein Beinbruch: dann bleibt es bei der Wurzel.
console.error("Ordnerliste", fehler);
ordnerFuellen([]);
}
});
jetzt?.addEventListener("click", async () => {
if (!pdf || !aktuell) return;
const ziel = speichern.dataset.url;
@@ -647,13 +1313,20 @@ export function initFilePreview(wurzel = document) {
const vorher = jetzt.textContent;
jetzt.textContent = "Speichern ...";
try {
const gesetzt = pdf.unterschriften();
const bytes = await pdf.speichern(rumpf.dataset.viewerPdflib || "", {
abschliessen: modusFeld?.value === "fertig",
// Unterschrieben heisst abgeschlossen: ein Dokument, in dem nach der
// Unterschrift noch Felder aenderbar waeren, ist keine Unterschrift
// wert.
abschliessen: modusFeld?.value === "fertig" || gesetzt.length > 0,
zeuge: bezeugen ? konto : "",
});
const daten = new FormData();
daten.append("path", aktuell.pfad);
daten.append("ordner", ordnerFeld.value.trim());
daten.append("name", nameFeld.value.trim());
if (zielFeld?.value) daten.append("ziel", zielFeld.value);
if (gesetzt.length) daten.append("unterschriften", JSON.stringify(gesetzt));
if (ersetzenFeld.checked) daten.append("ersetzen", "1");
daten.append(
"datei",
@@ -669,6 +1342,12 @@ export function initFilePreview(wurzel = document) {
// Zeile bleibt offen: meist ist es ein Name, der schon vergeben ist.
console.error("Formular speichern", fehler);
window.tesm.showToast(fehler.message || "Speichern fehlgeschlagen.", "danger");
// Genau dieser Fall hat eine Antwort auf der Zeile -- dann zeigen wir
// auch darauf, statt es bei einer Meldung zu belassen.
if (fehler.status === 409) {
ersetzenKasten?.classList.add("is-gefragt");
ersetzenFeld?.focus();
}
} finally {
jetzt.disabled = false;
jetzt.textContent = vorher;
+6 -6
View File
@@ -78,7 +78,7 @@ class Result:
UNAVAILABLE = Result(
ok=False,
stderr=(
"Systemaktionen sind in dieser Umgebung nicht verfuegbar "
"Systemaktionen sind in dieser Umgebung nicht verfügbar "
"(Helfer nicht installiert oder kein Linux-Host)."
),
code=127,
@@ -132,16 +132,16 @@ class SysOps:
False,
"",
"sudo wird durch 'NoNewPrivileges' der systemd-Unit blockiert. Ohne sudo "
"kann der Dienst den Helfer nicht aufrufen -- keine Systemaktion "
"kann der Dienst den Helfer nicht aufrufen – keine Systemaktion "
"funktioniert. In der Unit 'NoNewPrivileges=yes' entfernen und "
"'systemctl daemon-reload && systemctl restart' ausfuehren.",
"'systemctl daemon-reload && systemctl restart' ausführen.",
result.code,
)
if not result.ok and "a password is required" in result.output.lower():
return Result(
False,
"",
"sudo verlangt ein Passwort. Die sudoers-Regel fuer den Helfer fehlt oder "
"sudo verlangt ein Passwort. Die sudoers-Regel für den Helfer fehlt oder "
"greift nicht.",
result.code,
)
@@ -177,7 +177,7 @@ class SysOps:
check=False,
)
except subprocess.TimeoutExpired:
return Result(False, stderr=f"Zeitlimit ueberschritten ({verb}).", code=124)
return Result(False, stderr=f"Zeitlimit überschritten ({verb}).", code=124)
except OSError as exc:
return Result(False, stderr=str(exc), code=126)
return Result(
@@ -210,7 +210,7 @@ class SysOps:
check=False,
)
except subprocess.TimeoutExpired:
return Result(False, stderr="Zeitlimit ueberschritten.", code=124)
return Result(False, stderr="Zeitlimit überschritten.", code=124)
except OSError as exc:
return Result(False, stderr=str(exc), code=126)
return Result(
@@ -136,24 +136,24 @@ def validate_static(
try:
prefix_length = int(prefix)
except (TypeError, ValueError) as exc:
raise ValueError("Die Praefixlaenge muss eine Zahl sein (z. B. 24).") from exc
raise ValueError("Die Präfixlänge muss eine Zahl sein (z. B. 24).") from exc
if not 1 <= prefix_length <= 32:
raise ValueError("Die Praefixlaenge muss zwischen 1 und 32 liegen.")
raise ValueError("Die Präfixlänge muss zwischen 1 und 32 liegen.")
try:
interface_ip = ipaddress.ip_interface(f"{address.strip()}/{prefix_length}")
except ValueError as exc:
raise ValueError(f"{address!r} ist keine gueltige IPv4-Adresse.") from exc
raise ValueError(f"{address!r} ist keine gültige IPv4-Adresse.") from exc
gateway_clean = (gateway or "").strip()
if gateway_clean:
try:
gateway_ip = ipaddress.ip_address(gateway_clean)
except ValueError as exc:
raise ValueError(f"{gateway_clean!r} ist keine gueltige Gateway-Adresse.") from exc
raise ValueError(f"{gateway_clean!r} ist keine gültige Gateway-Adresse.") from exc
if gateway_ip not in interface_ip.network:
raise ValueError(
f"Das Gateway {gateway_clean} liegt nicht im Netz {interface_ip.network}. "
"So waere der Host nach der Aenderung nicht mehr erreichbar."
"So wäre der Host nach der Änderung nicht mehr erreichbar."
)
servers: list[str] = []
@@ -163,7 +163,7 @@ def validate_static(
try:
ipaddress.ip_address(token)
except ValueError as exc:
raise ValueError(f"{token!r} ist keine gueltige DNS-Adresse.") from exc
raise ValueError(f"{token!r} ist keine gültige DNS-Adresse.") from exc
servers.append(token)
return str(interface_ip.ip), prefix_length, gateway_clean, servers
@@ -185,7 +185,7 @@ def render_netplan(
zuruecksetzen -- ein realer Fehler des Vorgaengerprojekts.
"""
lines = [
"# Von TESM verwaltet. Diese Datei enthaelt ausschliesslich das unten",
"# Von TESM verwaltet. Diese Datei enthält ausschließlich das unten",
"# genannte Interface; alle anderen bleiben bei ihrer",
"# Distributionskonfiguration.",
"network:",
@@ -94,7 +94,7 @@ def validate_domain(value: str) -> str:
if not text:
return ""
if not DOMAIN_RE.match(text):
raise ValueError(f"{text!r} ist kein gueltiger Domainname.")
raise ValueError(f"{text!r} ist kein gültiger Domainname.")
return text
@@ -122,8 +122,8 @@ def render(config: WebConfig) -> str:
]
lines: list[str] = [
f"# Von TESM erzeugt ({config.app_key}). Aenderungen bitte in der Anwendung",
"# vornehmen -- diese Datei wird bei jeder Uebernahme neu geschrieben.",
f"# Von TESM erzeugt ({config.app_key}). Änderungen bitte in der Anwendung",
"# vornehmen – diese Datei wird bei jeder Übernahme neu geschrieben.",
"",
]
@@ -200,7 +200,7 @@ def _site_body(config: WebConfig, common_proxy: list[str], body: str, *, tls: bo
f" client_max_body_size {body};",
f" # {uploads.NGINX_ZUSCHLAG_MB} MB mehr als die Anwendung erlaubt, damit deren"
" eigene,",
" # erklaerende Fehlerseite gewinnt statt der generischen 413 von nginx.",
" # erklärende Fehlerseite gewinnt statt der generischen 413 von nginx.",
"",
" location /assets/ {",
f" alias {config.static_root.rstrip('/')}/;",
@@ -256,10 +256,10 @@ def apply_config(sysops: SysOps, content: str) -> dict[str, Any]:
if not result.ok:
return {
"ok": False,
"message": "nginx hat die Konfiguration abgelehnt -- der alte Stand gilt weiter.",
"message": "nginx hat die Konfiguration abgelehnt – der alte Stand gilt weiter.",
"detail": result.output,
}
return {"ok": True, "message": "Konfiguration uebernommen.", "detail": result.output}
return {"ok": True, "message": "Konfiguration übernommen.", "detail": result.output}
def request_certificate(
@@ -274,13 +274,13 @@ def request_certificate(
if not domain:
return {"ok": False, "message": "Es ist keine Domain konfiguriert."}
if not email:
return {"ok": False, "message": "Fuer Let's Encrypt ist eine E-Mail-Adresse noetig."}
return {"ok": False, "message": "Für Let's Encrypt ist eine E-Mail-Adresse nötig."}
result = sysops.certbot_issue(domain, email, webroot)
if not result.ok:
return {"ok": False, "message": "certbot ist fehlgeschlagen.", "detail": result.output}
return {
"ok": True,
"message": f"Zertifikat fuer {domain} ausgestellt.",
"message": f"Zertifikat für {domain} ausgestellt.",
"detail": result.output,
"cert_path": f"/etc/letsencrypt/live/{domain}/fullchain.pem",
"key_path": f"/etc/letsencrypt/live/{domain}/privkey.pem",
@@ -303,9 +303,9 @@ def create_self_signed(
"""
name = (common_name or "").strip().lower().rstrip(".")
if not name:
return {"ok": False, "message": "Es fehlt ein Name fuer das Zertifikat."}
return {"ok": False, "message": "Es fehlt ein Name für das Zertifikat."}
if not re.fullmatch(r"[A-Za-z0-9]([A-Za-z0-9.-]{0,251}[A-Za-z0-9])?", name):
return {"ok": False, "message": f"{name!r} ist als Zertifikatsname nicht zulaessig."}
return {"ok": False, "message": f"{name!r} ist als Zertifikatsname nicht zulässig."}
cleaned: list[str] = []
for entry in alt_names:
@@ -328,8 +328,8 @@ def create_self_signed(
return {
"ok": True,
"message": (
f"Selbstsigniertes Zertifikat fuer {name} erzeugt. Browser zeigen dafuer eine "
"Warnung -- fuer ein oeffentlich erreichbares System bitte Let's Encrypt nutzen."
f"Selbstsigniertes Zertifikat für {name} erzeugt. Browser zeigen dafür eine "
"Warnung – für ein öffentlich erreichbares System bitte Let's Encrypt nutzen."
),
"cert_path": paths[0],
"key_path": paths[1],
@@ -47,9 +47,16 @@
</div>
</div>
<div class="card__body">
{# Auch fuer einen Administrator die Liste zeigen: sein Kennzeichen gibt
den Verwaltungsbereich, der Rest kommt aus Gruppen -- und genau das
soll er hier ablesen koennen. "Darf alles" war bis 2.7.x richtig und
haette danach das Gegenteil dessen behauptet, was gilt. #}
{% if current_user.is_admin %}
{{ alert('Sie sind Administrator und dürfen unabhängig von Gruppen alles.', 'warning') }}
{% elif permissions %}
{{ alert('Als Administrator haben Sie den Verwaltungsbereich immer –
Benutzer, Gruppen, Einstellungen, Sicherung, Papierkorb, Diagnose.
Alles Weitere steht unten und kommt aus Ihren Gruppen.', 'info') }}
{% endif %}
{% if permissions %}
<div class="row row--tight">
{% for permission in permissions %}
<span class="badge" title="{{ permission }}">{{ tree.label_for(permission) }}</span>
@@ -181,7 +181,7 @@
<div class="palette__hint">
<span><kbd>&uarr;</kbd><kbd>&darr;</kbd> wählen</span>
<span><kbd>Enter</kbd> öffnen</span>
<span><kbd>Esc</kbd> schliessen</span>
<span><kbd>Esc</kbd> schließen</span>
</div>
</dialog>
<script type="application/json" id="palette-data">{{ palette_entries | tojson }}</script>
@@ -23,7 +23,7 @@
Name und Rechte sind gesperrt. Anders als im Vorgänger werden die Rechte
<strong>nicht</strong> bei jedem Neustart auf die Vorlage zurückgesetzt &ndash;
Anpassungen bleiben erhalten.
{% if current_user.has('groups.edit') %}
{% if current_user.has('groups.write') %}
<a class="btn btn--sm mt-2" href="{{ url_for('admin.group_detail', group_id=group.id, unlocked=1) }}">
{{ icon('unlock', size=14) }} Rechte freischalten
</a>
@@ -94,7 +94,7 @@
<div class="card__title">{{ icon('users', size=17) }} Mitglieder</div>
<div class="card__sub">Zuordnung erfolgt in der Benutzerverwaltung</div>
</div>
{% if current_user.has('users.view') %}
{% if current_user.has('users.read') %}
<a class="btn btn--sm" href="{{ url_for('admin.users') }}">Benutzerverwaltung</a>
{% endif %}
</div>
@@ -44,8 +44,11 @@
<a class="btn btn--sm btn--ghost" href="{{ url_for('logs.audit_view') }}">Zurücksetzen</a>
</form>
{# "table--stapelbar": schmal wird aus jeder Zeile ein kleiner Block. Vorher
quetschte sich das Detail mit Pruefsumme in eine Spalte von zwei
Zentimetern und lief ueber zehn Zeilen -- lesbar war das nicht. #}
<div class="table-wrap">
<table class="table table--compact" data-behavior="sortable">
<table class="table table--compact table--stapelbar" data-behavior="sortable">
<thead>
<tr>
<th class="sortable">Zeit</th>
@@ -60,12 +63,18 @@
<tbody>
{% for row in rows %}
<tr>
<td class="fs-sm nowrap" data-sort-value="{{ row.ts }}">{{ row.ts | dt }}</td>
<td class="fs-sm fw-600">{{ row.actor }}</td>
<td class="mono fs-xs">{{ row.action }}</td>
<td class="fs-sm">{{ row.target }}</td>
<td class="fs-sm muted break-all">{{ row.detail | audit_detail }}</td>
<td>
<td class="fs-sm nowrap" data-spalte="Zeit" data-sort-value="{{ row.ts }}">
{{ row.ts | dt }}
</td>
<td class="fs-sm fw-600" data-spalte="Benutzer">{{ row.actor }}</td>
<td class="mono fs-xs" data-spalte="Aktion">{{ row.action }}</td>
<td class="fs-sm" data-spalte="Ziel">{{ row.target }}</td>
{# Ohne die Minuszeichen stuende bei "white-space: pre-line" die
Einrueckung der Vorlage als leere erste Zeile in der Zelle. #}
<td class="fs-sm muted break-all td--detail" data-spalte="Detail">
{{- row.detail | audit_detail -}}
</td>
<td data-spalte="Stufe">
{# Ampel: Info grün, Hinweis gelb, Warnung rot. Vorher war Info
grau und Hinweis blau -- dabei war nicht zu sehen, was harmlos
ist und was Aufmerksamkeit braucht. "kritisch" bekommt eine
@@ -76,7 +85,7 @@
{% elif row.severity == 'notice' %}{{ pill('Hinweis', 'warning') }}
{% else %}{{ pill('Info', 'online') }}{% endif %}
</td>
<td class="mono fs-xs faint">{{ row.ip or '&ndash;' | safe }}</td>
<td class="mono fs-xs faint" data-spalte="Herkunft">{{ row.ip or '&ndash;' | safe }}</td>
</tr>
{% endfor %}
</tbody>
@@ -162,8 +162,25 @@
<dt>{{ label }}</dt><dd>{{ value if value not in (None, '') else '&ndash;' | safe }}</dd>
{%- endmacro %}
{#- Rechtematrix: einmal geschrieben, in beiden Anwendungen benutzt -#}
{#- Rechtematrix: einmal geschrieben, in beiden Anwendungen benutzt.
Seit 2.8.0 hat jede Funktion ihre eigene Zeile -- 37 statt 21. Das ist der
Sinn der Sache, macht die Tabelle aber lang, und eine lange Tabelle
verleitet dazu, oben den Bereichsschalter zu setzen und fertig. Drei
Hilfen dagegen: Unterzeilen stehen eingerueckt unter ihrer Hauptzeile, die
Funktion steht in Kleinschrift daneben, und ein Filterfeld blendet aus,
wonach man nicht sucht. -#}
{% macro permission_matrix(tree, action_meta, state, disabled=False, field_prefix='permissions') -%}
{% if not disabled %}
<div class="matrix__filter">
<label class="field field--inline">
<span class="field__label">Zeile suchen</span>
<input type="search" class="input input--sm" data-matrix-filter
placeholder="z. B. Neustart, DHCP, Sicherung" autocomplete="off">
</label>
<span class="matrix__filter-hint" data-matrix-count></span>
</div>
{% endif %}
<div class="table-wrap">
<table class="matrix" data-behavior="permission-matrix">
{% for area in tree.areas %}
@@ -172,8 +189,20 @@
<tr>
<th style="min-width:240px">{{ area.label }}</th>
{% for action in columns %}
<th title="{{ action_meta[action][1] }} &ndash; {{ action_meta[action][2] }}">
{{ action_meta[action][0] }}
<th title="{{ action_meta[action][1] }} ({{ action_meta[action][2] }}) &ndash;
{{ action_meta[action][3] }}">
<span class="matrix__spalte">
<b>{{ action_meta[action][0] }}</b>
<span>{{ action_meta[action][1] }}</span>
<small>{{ action_meta[action][2] }}</small>
{% if not disabled %}
<button type="button" class="matrix__alle" data-matrix-column="{{ action.value }}"
data-area="{{ area.key }}" title="Ganze Spalte in diesem Bereich"
aria-label="Alle {{ action_meta[action][1] }}-Rechte dieses Bereichs umschalten">
alle
</button>
{% endif %}
</span>
</th>
{% endfor %}
</tr>
@@ -182,9 +211,9 @@
<tr class="matrix__area">
<td class="matrix__killswitch">
<label class="check">
<input type="checkbox" name="{{ field_prefix }}" value="{{ area.view_key }}"
<input type="checkbox" name="{{ field_prefix }}" value="{{ area.read_key }}"
data-area-switch="{{ area.key }}"
{% if state.get(area.key, {}).get('view') %}checked{% endif %}
{% if state.get(area.key, {}).get('read') %}checked{% endif %}
{% if disabled %}disabled{% endif %}>
<span>Zugang zum Bereich {{ area.label }}{% if area.hint %} {{ hint(area.hint) }}{% endif %}</span>
</label>
@@ -192,23 +221,48 @@
{% for action in columns %}<td></td>{% endfor %}
</tr>
{% for resource in area.resources %}
<tr data-area="{{ area.key }}">
<tr data-area="{{ area.key }}"
data-suchtext="{{ (resource.label ~ ' ' ~ resource.hint) | lower }}"
{% if resource.parent %}class="matrix__unterzeile"{% endif %}>
<td>
<span class="matrix__resource-label">
{{ resource.label }}
<span class="matrix__zeile">
<b>{{ resource.short_label }}</b>
{% if not disabled %}
{# Ganze Zeile: bei 37 Zeilen mit bis zu sieben Spalten
sind das ueber 200 Kaestchen. Wer einer Rolle eine
Funktion ganz geben will, soll nicht siebenmal
klicken. Hinter der Beschriftung, nicht davor -- vorn
gelesen ergab "alle Clients" einen falschen Satz. #}
<button type="button" class="matrix__alle" data-matrix-row
title="Ganze Zeile an- oder abwählen"
aria-label="Alle Rechte dieser Zeile umschalten">alle</button>
{% endif %}
</span>
{% if resource.hint %}<small>{{ resource.hint }}</small>{% endif %}
{# Was eine Aktion in dieser Zeile bedeutet, steht in der
Zeile -- nicht in einem Titelattribut, das man nur mit der
Maus findet, und nicht in einer Legende unter einer
Tabelle, die man dafuer erst zu Ende scrollt. #}
{% for action in resource.actions if resource.action_hints.get(action) %}
<small class="matrix__bedeutung">
<b>{{ action_meta[action][0] }}</b>
{{ action_meta[action][1] }} &ndash;
{{ resource.action_hints.get(action) }}
</small>
{% endfor %}
</span>
</td>
{% for action in columns %}
<td>
{% if resource.has(action) %}
<label class="check" title="{{ resource.action_hints.get(action) or action_meta[action][2] }}">
<label class="check" title="{{ resource.action_hints.get(action) or action_meta[action][3] }}">
<input type="checkbox" name="{{ field_prefix }}"
value="{{ resource.permission(action) }}"
data-action="{{ action.value }}"
{% if state.get(resource.key, {}).get(action.value) %}checked{% endif %}
{% if disabled %}disabled{% endif %}>
<span class="sr-only">{{ resource.label }} {{ action_meta[action][1] }}</span>
<span class="sr-only">{{ resource.label }} {{ action_meta[action][2] }}</span>
</label>
{% else %}
{# Bewusst *kein* Eingabefeld: ein deaktiviertes Kästchen hat das
@@ -229,7 +283,7 @@
</div>
<div class="matrix__legend mt-3">
{% for action, meta in action_meta.items() %}
<span><b>{{ meta[0] }}</b> {{ meta[1] }} &ndash; {{ meta[2] }}</span>
<span><b>{{ meta[0] }}</b> {{ meta[1] }} ({{ meta[2] }}) &ndash; {{ meta[3] }}</span>
{% endfor %}
<span><span class="matrix__na"></span> Für diese Zeile nicht vorgesehen &ndash;
die Spalte gehört zu einer anderen Zeile desselben Bereichs.</span>
@@ -119,7 +119,13 @@ niemals hier gespeichert.', 'info') }}
<tr>
<td class="fs-sm">{{ entry.ad_group_name }}
<div class="fs-xs faint break-all">{{ entry.ad_group_dn }}</div></td>
<td>{{ pill(entry.group_name or 'unbekannt', 'accent') }}</td>
<td>
{% if entry.grants_admin %}
{{ pill('Administrator (Kennzeichen)', 'warning') }}
{% else %}
{{ pill(entry.group_name or 'unbekannt', 'accent') }}
{% endif %}
</td>
<td class="actions">
<form method="post" data-no-guard
action="{{ url_for('hostsettings.directory_mapping_delete', mapping_id=entry.id) }}">
@@ -140,22 +146,35 @@ niemals hier gespeichert.', 'info') }}
'Ohne Zuordnung erhalten Verzeichniskonten nur die Standardgruppe.', 'shield-users') }}
{% endif %}
{% if current_user.has('settings_directory.edit') %}
{% if current_user.has('settings_directory.write') %}
<form method="post" action="{{ url_for('hostsettings.directory_mapping_add') }}">
<input type="hidden" name="{{ csrf_field_name }}" value="{{ csrf_token() }}">
<div class="card__body">
<div class="form-grid">
{{ group_picker('ad_group_name', 'ad_group_dn', 'mapping', required=True) }}
{# Ohne Ziel ist die Zuordnung sinnlos -- deshalb Pflichtfeld. #}
{# Ohne Ziel ist die Zuordnung sinnlos -- deshalb Pflichtfeld.
Das Kennzeichen steht mit in derselben Liste, weil es dieselbe
Frage beantwortet: "was wird dieses Konto hier?". Vorher gab es
nur Gruppen, und "Domänen-Admins" landete deshalb in der Gruppe
*Administration* -- die Benutzer und Rechte pflegt, aber kein
Administratorkennzeichen hat und sich keines geben kann. #}
<label class="field">
<span class="field__label">
Gruppe in dieser Anwendung<span class="req" aria-hidden="true">*</span>
Ziel in dieser Anwendung<span class="req" aria-hidden="true">*</span>
</span>
<select class="select" name="app_group_id" required>
<select class="select" name="ziel" required>
{% for group in groups %}
<option value="{{ group.id }}">{{ group.name }}</option>
<option value="gruppe:{{ group.id }}">{{ group.name }}</option>
{% endfor %}
<option value="administrator">Administrator (Kennzeichen)</option>
</select>
<span class="field__hint">
„Administrator (Kennzeichen)“ macht Mitglieder dieser Verzeichnisgruppe zu
echten Administratoren: sie haben immer den ganzen Verwaltungsbereich.
Funktionsrechte kommen weiter über Gruppen. Wer aus der Verzeichnisgruppe
austritt, verliert das Kennzeichen bei der nächsten Anmeldung.
</span>
</label>
</div>
</div>
@@ -58,7 +58,7 @@ zurückgerollt. So sperrt eine falsche Eingabe den Host nicht aus.', 'warning',
{% endif %}
</section>
{% if current_user.has('settings_network.edit') and interfaces %}
{% if current_user.has('settings_network.write') and interfaces %}
<section class="card">
<div class="card__header">
<div class="flex-1">
@@ -41,7 +41,7 @@ gültige, aktivierte Lizenz. Abgelaufene Einträge werden beim Aufruf dieser Sei
<td class="muted fs-sm">{{ entry.detail }}</td>
<td class="fs-sm"><span data-relative-time="{{ entry.deleted_at }}">{{ entry.deleted_at | dt }}</span></td>
<td class="actions">
{% if current_user.has('trash.edit') %}
{% if current_user.has('trash.write') %}
<form method="post" style="display:inline" data-no-guard
action="{{ url_for('trash.restore', kind=section.key, ident=entry.id) }}">
<input type="hidden" name="{{ csrf_field_name }}" value="{{ csrf_token() }}">
@@ -2,7 +2,7 @@
{% from "tesm_core/macros.html" import field, select_field, checkbox, pill, search_box, modal, empty_state, alert %}
{% block page_title %}Benutzer{% endblock %}
{% block page_sub %}{{ users | length }} Konten &middot; Rechte kommen ausschliesslich aus Gruppen{% endblock %}
{% block page_sub %}{{ users | length }} Konten &middot; Rechte kommen ausschließlich aus Gruppen{% endblock %}
{% block topbar_extra %}
{{ search_box('users-table', 'Benutzer suchen ...', count_id='users-visible') }}
@@ -79,7 +79,7 @@
{% else %}<span class="faint">noch nie</span>{% endif %}
</td>
<td class="actions">
{% if current_user.has('users.edit') %}
{% if current_user.has('users.write') %}
<button class="btn btn--sm btn--ghost" type="button"
data-dialog-open="user-edit-{{ user.id }}" aria-label="Bearbeiten">
{{ icon('pencil', size=15) }}
@@ -137,7 +137,18 @@ Administratorkonto muss immer bestehen bleiben.', 'info') }}
</div>
</fieldset>
{% if current_user.is_admin %}
{{ checkbox('is_admin', 'Administrator (darf alles, unabhängig von Gruppen)') }}
{# Das Kennzeichen heisst seit 2.8.0 "Verwaltung" und nicht "alles":
Geraete, Neustarts, DHCP und Freigaben kommen ueber Gruppen.
Stand hier weiter "darf alles", waere die Beschriftung eine
falsche Zusage -- und niemand wuerde die Gruppe dazugeben. #}
{{ checkbox('is_admin',
'Administrator – hat immer den ganzen Verwaltungsbereich') }}
<p class="fs-xs faint">
Benutzer, Gruppen, Einstellungen, Sicherung, Papierkorb und Diagnose gelten
für ein Administratorkonto immer, auch ohne Gruppe. Alles andere – Geräte,
Neustarts, DHCP, Dateifreigaben, Protokolle – kommt über Gruppen; die
Gruppe „Funktionen (Vollzugriff)“ gibt es dafür schon.
</p>
{% endif %}
{{ checkbox('must_change_password', 'Passwortwechsel bei der ersten Anmeldung erzwingen', checked=True) }}
</div>
@@ -180,7 +191,7 @@ Administratorkonto muss immer bestehen bleiben.', 'info') }}
{% endif %}
{% endif %}
{% if current_user.has('users.edit') %}
{% if current_user.has('users.write') %}
{% for user in users %}
{% call modal('user-edit-' ~ user.id, 'Konto ' ~ user.username,
'Verzeichniskonto' if user.auth_source == 'ldap' else 'Lokales Konto') %}
@@ -211,7 +222,8 @@ Administratorkonto muss immer bestehen bleiben.', 'info') }}
</fieldset>
<div class="stack stack--tight">
{% if current_user.is_admin and user.id != current_user.id %}
{{ checkbox('is_admin', 'Administrator', checked=user.is_admin) }}
{{ checkbox('is_admin', 'Administrator – hat immer den ganzen Verwaltungsbereich',
checked=user.is_admin) }}
{% elif user.is_admin %}
{{ pill('Administrator', 'accent') }}
{% endif %}
+7 -7
View File
@@ -84,7 +84,7 @@ def _derive_key(passphrase: str, salt: bytes, params: dict[str, int]) -> bytes:
def seal(payload: dict[str, Any], passphrase: str, *, app_tag: str) -> str:
if len(passphrase or "") < MIN_PASSPHRASE_LENGTH:
raise TransferError(
f"Die Passphrase muss mindestens {MIN_PASSPHRASE_LENGTH} Zeichen haben -- sie ist "
f"Die Passphrase muss mindestens {MIN_PASSPHRASE_LENGTH} Zeichen haben – sie ist "
"der einzige Schutz dieser Datei."
)
salt = secrets.token_bytes(KDF_SALT_BYTES)
@@ -116,21 +116,21 @@ def unseal(
try:
envelope = json.loads(text)
except ValueError as exc:
raise TransferError("Die Datei ist kein gueltiges JSON.") from exc
raise TransferError("Die Datei ist kein gültiges JSON.") from exc
if not isinstance(envelope, dict):
raise TransferError("Die Datei enthaelt kein Objekt.")
raise TransferError("Die Datei enthält kein Objekt.")
if envelope.get("app") != app_tag:
raise TransferError(
f"Diese Sicherung gehoert zu einer anderen Anwendung ({envelope.get('app')!r})."
f"Diese Sicherung gehört zu einer anderen Anwendung ({envelope.get('app')!r})."
)
if int(envelope.get("format") or 0) != FORMAT_VERSION:
raise TransferError(
f"Nicht unterstuetztes Sicherungsformat ({envelope.get('format')!r}, "
f"Nicht unterstütztes Sicherungsformat ({envelope.get('format')!r}, "
f"erwartet {FORMAT_VERSION})."
)
kdf = envelope.get("kdf") or {}
if kdf.get("name") != "argon2id":
raise TransferError("Unbekanntes Schluesselableitungsverfahren.")
raise TransferError("Unbekanntes Schlüsselableitungsverfahren.")
header = {
key: envelope[key]
@@ -153,7 +153,7 @@ def unseal(
)
except (InvalidTag, KeyError, ValueError) as exc:
raise TransferError(
"Die Datei konnte nicht geoeffnet werden. Passphrase falsch oder Datei beschaedigt."
"Die Datei konnte nicht geöffnet werden. Passphrase falsch oder Datei beschädigt."
) from exc
return json.loads(plain.decode("utf-8")), header
+2 -2
View File
@@ -197,7 +197,7 @@ def yes_no(value: Any) -> str:
#: Tippfehler. Uebersetzt wird an genau einer Stelle, damit die beiden
#: Anwendungen nicht auseinanderlaufen.
ISSUER_SOURCES: dict[str, tuple[str, str]] = {
"tofu": ("Erstkontakt", "beim ersten Einspielen automatisch uebernommen"),
"tofu": ("Erstkontakt", "beim ersten Einspielen automatisch übernommen"),
"admin-confirmed": (
"Bestaetigt",
"Ausstellerwechsel von einem Administrator freigegeben",
@@ -326,7 +326,7 @@ def audit_detail(text: Any) -> Markup:
if not roh or not MITSCHRIFT.search(roh):
return Markup(escape(roh))
try:
erlaubt = bool(current_user.is_authenticated and current_user.has("logs_history.view"))
erlaubt = bool(current_user.is_authenticated and current_user.has("logs_history.read"))
except Exception: # noqa: BLE001 - ausserhalb einer Anfrage
erlaubt = False
if not erlaubt:
@@ -99,7 +99,7 @@ def update_profile():
if current_user.is_directory_account:
flash(
"Ihre Stammdaten kommen aus dem Verzeichnisdienst und werden bei jeder "
"Anmeldung uebernommen.",
"Anmeldung übernommen.",
"info",
)
return redirect(url_for("account.overview"))
@@ -123,7 +123,7 @@ def update_profile():
def upload_avatar():
upload = request.files.get("avatar")
if upload is None or not upload.filename:
flash("Keine Datei ausgewaehlt.", "danger")
flash("Keine Datei ausgewählt.", "danger")
return redirect(url_for("account.overview"))
suffix = Path(upload.filename).suffix.lower()
@@ -139,7 +139,7 @@ def upload_avatar():
data = upload.stream.read(MAX_AVATAR_BYTES + 1)
if len(data) > MAX_AVATAR_BYTES:
flash("Das Bild ist zu gross (maximal 2 MB).", "danger")
flash("Das Bild ist zu groß (maximal 2 MB).", "danger")
return redirect(url_for("account.overview"))
filename = f"{current_user.id}-{secrets.token_hex(8)}{suffix}"
@@ -215,7 +215,7 @@ def security():
def change_password():
conn = db()
if current_user.is_directory_account:
flash("Verzeichniskonten aendern ihr Passwort im Verzeichnisdienst.", "info")
flash("Verzeichniskonten ändern ihr Passwort im Verzeichnisdienst.", "info")
return redirect(url_for("account.security"))
current = request.form.get("current_password") or ""
@@ -226,7 +226,7 @@ def change_password():
flash("Das aktuelle Passwort ist nicht korrekt.", "danger")
return redirect(url_for("account.security"))
if new != repeat:
flash("Die beiden neuen Passwoerter stimmen nicht ueberein.", "danger")
flash("Die beiden neuen Passwörter stimmen nicht überein.", "danger")
return redirect(url_for("account.security"))
if passwords.constant_time_equals(current, new):
flash("Das neue Passwort muss sich vom alten unterscheiden.", "danger")
@@ -244,7 +244,7 @@ def change_password():
flash(str(exc), "danger")
return redirect(url_for("account.security"))
flash(f"Passwort geaendert. {revoked} weitere Sitzung(en) wurden beendet.", "success")
flash(f"Passwort geändert. {revoked} weitere Sitzung(en) wurden beendet.", "success")
return redirect(url_for("account.security"))
@@ -253,7 +253,7 @@ def change_password():
@reauth_required
def totp_start():
session["_totp_setup"] = totp.generate_secret()
flash("Scannen Sie den Code und bestaetigen Sie mit einem gueltigen Zahlencode.", "info")
flash("Scannen Sie den Code und bestätigen Sie mit einem gültigen Zahlencode.", "info")
return redirect(url_for("account.security"))
@@ -263,7 +263,7 @@ def totp_start():
def totp_confirm():
secret = session.get("_totp_setup", "")
if not secret:
flash("Es laeuft keine Einrichtung. Bitte neu starten.", "danger")
flash("Es läuft keine Einrichtung. Bitte neu starten.", "danger")
return redirect(url_for("account.security"))
if not totp.verify_code(secret, request.form.get("code") or ""):
flash("Der Code ist nicht korrekt. Bitte erneut versuchen.", "danger")
@@ -306,7 +306,7 @@ def totp_confirm():
def totp_disable():
if core().config.security.require_totp_for_admins and current_user.is_admin:
flash(
"Fuer Administratoren ist die Zwei-Faktor-Authentisierung in dieser "
"Für Administratoren ist die Zwei-Faktor-Authentisierung in dieser "
"Installation verpflichtend.",
"danger",
)
+20 -14
View File
@@ -48,7 +48,7 @@ def _int_list(name: str) -> list[int]:
@bp.get("/users")
@permission_required("users.view")
@permission_required("users.read")
def users():
conn = db()
return render_template(
@@ -95,7 +95,7 @@ def user_create():
@bp.post("/users/<int:user_id>")
@permission_required("users.edit")
@permission_required("users.write")
def user_update(user_id: int):
conn = db()
try:
@@ -120,7 +120,7 @@ def user_update(user_id: int):
policy=core().password_policy,
must_change=True,
)
changes.append("Passwort zurueckgesetzt")
changes.append("Passwort zurückgesetzt")
session_store.revoke_all_for_user(conn, user_id, reason="password-reset")
target = rbac.get_user(conn, user_id) or {}
if changes:
@@ -131,7 +131,7 @@ def user_update(user_id: int):
"; ".join(changes),
severity="notice",
)
flash("Aenderungen gespeichert." if changes else "Keine Aenderungen.", "success" if changes else "info")
flash("Änderungen gespeichert." if changes else "Keine Änderungen.", "success" if changes else "info")
except (rbac.ValidationError, rbac.PermissionDenied) as exc:
flash(str(exc), "danger")
return redirect(url_for("admin.users"))
@@ -153,7 +153,7 @@ def user_delete(user_id: int):
severity="warning",
)
flash(
"Konto endgueltig entfernt (Verzeichniskonto)."
"Konto endgültig entfernt (Verzeichniskonto)."
if mode == "endgueltig"
else "Konto in den Papierkorb verschoben.",
"success",
@@ -164,7 +164,7 @@ def user_delete(user_id: int):
@bp.post("/users/<int:user_id>/end-sessions")
@permission_required("users.edit")
@permission_required("users.write")
def user_revoke_sessions(user_id: int):
conn = db()
target = rbac.get_user(conn, user_id)
@@ -239,7 +239,7 @@ def directory_adopt():
@bp.get("/groups")
@permission_required("groups.view")
@permission_required("groups.read")
def groups():
conn = db()
tree = core().permissions
@@ -255,7 +255,7 @@ def groups():
@bp.get("/groups/<int:group_id>")
@permission_required("groups.view")
@permission_required("groups.read")
def group_detail(group_id: int):
conn = db()
group = rbac.get_group(conn, group_id)
@@ -274,7 +274,7 @@ def group_detail(group_id: int):
"WHERE ug.group_id=? AND u.deleted_at IS NULL ORDER BY u.username COLLATE NOCASE",
(group_id,),
),
can_edit=current_user.has("groups.edit"),
can_edit=current_user.has("groups.write"),
unlocked=request.args.get("unlocked") == "1",
)
@@ -302,7 +302,7 @@ def group_create():
@bp.post("/groups/<int:group_id>")
@permission_required("groups.edit")
@permission_required("groups.write")
def group_update(group_id: int):
conn = db()
try:
@@ -328,7 +328,7 @@ def group_update(group_id: int):
"; ".join(changes),
severity="notice",
)
flash("Aenderungen gespeichert." if changes else "Keine Aenderungen.", "success" if changes else "info")
flash("Änderungen gespeichert." if changes else "Keine Änderungen.", "success" if changes else "info")
except (rbac.ValidationError, rbac.PermissionDenied) as exc:
flash(str(exc), "danger")
return redirect(url_for("admin.group_detail", group_id=group_id))
@@ -364,7 +364,7 @@ def group_apply_preset(group_id: int):
abort(404)
preset = next((p for p in core().role_presets if p.key == group.preset_key), None)
if preset is None:
flash("Fuer diese Gruppe ist keine Vorlage hinterlegt.", "info")
flash("Für diese Gruppe ist keine Vorlage hinterlegt.", "info")
return redirect(url_for("admin.group_detail", group_id=group_id))
tree = core().permissions
with transaction():
@@ -377,7 +377,7 @@ def group_apply_preset(group_id: int):
unlock_system=True,
)
_audit(conn, "group.preset_applied", group.name, preset.key, severity="notice")
flash(f"Rechte der Vorlage {preset.name} uebernommen.", "success")
flash(f"Rechte der Vorlage {preset.name} übernommen.", "success")
return redirect(url_for("admin.group_detail", group_id=group_id))
@@ -427,9 +427,15 @@ def nav_order():
if submitted:
child_order[item.key] = extension.nav.sanitize_child_order(item.key, submitted)
with transaction() as conn:
vorher = extension.settings.get(conn, "nav_order") or extension.nav.default_order()
extension.settings.set(conn, "nav_order", order, actor=current_user.username)
extension.settings.set(conn, "nav_child_order", child_order, actor=current_user.username)
_audit(conn, "system.nav_order_changed", severity="info")
_audit(
conn,
"system.nav_order_changed",
detail=f"{', '.join(vorher)} -> {', '.join(order)}",
severity="info",
)
flash("Reihenfolge der Navigation gespeichert.", "success")
return redirect(request.referrer or url_for("index"))
@@ -28,7 +28,7 @@ bp = Blueprint("diagnostics", __name__, url_prefix="/administration/diagnostics"
@bp.get("/")
@permission_required("diagnostics.view")
@permission_required("diagnostics.read")
def overview():
extension = core()
conn = db()
@@ -82,7 +82,7 @@ def overview():
"Debug": "ja" if config.debug else "nein",
"Cookie Secure": "ja" if config.security.cookie_secure else "nein",
"HSTS": "ja" if config.security.hsts_enabled else "nein",
"2FA-Pflicht fuer Admins": "ja" if config.security.require_totp_for_admins else "nein",
"2FA-Pflicht für Admins": "ja" if config.security.require_totp_for_admins else "nein",
},
now=datetime.now(timezone.utc),
)
@@ -109,7 +109,7 @@ def housekeeping():
severity="notice",
)
flash(
f"Aufgeraeumt: {sessions_removed} Sitzungen, {rate_removed} Ratenereignisse, "
f"Aufgeräumt: {sessions_removed} Sitzungen, {rate_removed} Ratenereignisse, "
f"{len(archived)} archivierte Protokolltage.",
"success",
)
@@ -139,12 +139,12 @@ def rotate_keys():
actor_id=current_user.id,
action="system.data_key_rotated",
target=new_id,
detail=f"{migrated} Werte neu verschluesselt",
detail=f"{migrated} Werte neu verschlüsselt",
severity="notice",
)
flash(
f"Neuer Datenschluessel {new_id} aktiv, {migrated} gespeicherte Geheimnisse "
"wurden neu verschluesselt.",
f"Neuer Datenschlüssel {new_id} aktiv, {migrated} gespeicherte Geheimnisse "
"wurden neu verschlüsselt.",
"success",
)
return redirect(url_for("diagnostics.overview"))
@@ -65,7 +65,7 @@ def _license_hint(feature: str) -> str:
@bp.get("/network")
@permission_required("settings_network.view")
@permission_required("settings_network.read")
def network():
extension = core()
sysops = extension.sysops
@@ -81,12 +81,12 @@ def network():
@bp.post("/network")
@permission_required("settings_network.edit")
@permission_required("settings_network.write")
def network_apply():
extension = core()
sysops = extension.sysops
if sysops is None or not sysops.available:
flash("Systemaktionen sind in dieser Umgebung nicht verfuegbar.", "warning")
flash("Systemaktionen sind in dieser Umgebung nicht verfügbar.", "warning")
return redirect(url_for("hostsettings.network"))
interface = (request.form.get("interface") or "").strip()
@@ -127,7 +127,7 @@ def network_apply():
sysops.write_netplan(previous.stdout if previous.ok else "")
sysops.apply_netplan()
flash(
f"Uebernahme fehlgeschlagen, alter Zustand wiederhergestellt: {applied.message}",
f"Übernahme fehlgeschlagen, alter Zustand wiederhergestellt: {applied.message}",
"danger",
)
return redirect(url_for("hostsettings.network"))
@@ -140,21 +140,21 @@ def network_apply():
_start_revert_timer(extension)
_audit("settings.network_applied", interface, severity="warning")
flash(
f"Uebernommen. Bitte innerhalb von {hostnet.REVERT_SECONDS} Sekunden bestaetigen -- "
"sonst wird automatisch zurueckgerollt.",
f"Übernommen. Bitte innerhalb von {hostnet.REVERT_SECONDS} Sekunden bestätigen – "
"sonst wird automatisch zurückgerollt.",
"warning",
)
return redirect(url_for("hostsettings.network"))
@bp.post("/network/confirm")
@permission_required("settings_network.edit")
@permission_required("settings_network.write")
def network_confirm():
if core().registry.pop(PENDING_NETWORK_KEY, None) is None:
flash("Es liegt keine Aenderung zur Bestaetigung vor.", "info")
flash("Es liegt keine Änderung zur Bestätigung vor.", "info")
else:
_audit("settings.network_confirmed", severity="notice")
flash("Netzwerkeinstellungen bestaetigt.", "success")
flash("Netzwerkeinstellungen bestätigt.", "success")
return redirect(url_for("hostsettings.network"))
@@ -173,7 +173,7 @@ def _start_revert_timer(extension: Any) -> None:
conn,
actor="system",
action="settings.network_auto_reverted",
detail="Keine Bestaetigung innerhalb der Frist -- automatisch zurueckgerollt.",
detail="Keine Bestätigung innerhalb der Frist – automatisch zurückgerollt.",
severity="warning",
)
@@ -222,7 +222,7 @@ def _web_config() -> webserver.WebConfig:
@bp.get("/web")
@permission_required("settings_web.view")
@permission_required("settings_web.read")
def web():
extension = core()
config = _web_config()
@@ -241,7 +241,7 @@ def web():
@bp.post("/web")
@permission_required("settings_web.edit")
@permission_required("settings_web.write")
def web_save():
extension = core()
conn = db()
@@ -281,7 +281,7 @@ def web_save():
cert_path = (request.form.get("web_cert_path") or "").strip()
key_path = (request.form.get("web_key_path") or "").strip()
if https_enabled and not (cert_path and key_path):
flash("Fuer HTTPS werden Zertifikat und privater Schluessel gebraucht.", "danger")
flash("Für HTTPS werden Zertifikat und privater Schlüssel gebraucht.", "danger")
return redirect(url_for("hostsettings.web"))
values = {
@@ -298,7 +298,7 @@ def web_save():
with transaction():
changed = extension.settings.set_many(conn, values, actor=current_user.username)
_audit("settings.web_saved", domain, ", ".join(changed), severity="notice")
flash("Gespeichert. Uebernehmen Sie die Konfiguration, damit sie wirksam wird.", "success")
flash("Gespeichert. Übernehmen Sie die Konfiguration, damit sie wirksam wird.", "success")
return redirect(url_for("hostsettings.web"))
@@ -311,7 +311,7 @@ def web_apply():
return redirect(url_for("hostsettings.web"))
sysops = core().sysops
if sysops is None or not sysops.available:
flash("Systemaktionen sind in dieser Umgebung nicht verfuegbar.", "warning")
flash("Systemaktionen sind in dieser Umgebung nicht verfügbar.", "warning")
return redirect(url_for("hostsettings.web"))
result = webserver.apply_config(sysops, webserver.render(_web_config()))
@@ -338,7 +338,7 @@ def web_certificate():
sysops = extension.sysops
conn = db()
if sysops is None or not sysops.available:
flash("Systemaktionen sind in dieser Umgebung nicht verfuegbar.", "warning")
flash("Systemaktionen sind in dieser Umgebung nicht verfügbar.", "warning")
return redirect(url_for("hostsettings.web"))
config = _web_config()
@@ -381,7 +381,7 @@ def web_self_signed():
sysops = extension.sysops
conn = db()
if sysops is None or not sysops.available:
flash("Systemaktionen sind in dieser Umgebung nicht verfuegbar.", "warning")
flash("Systemaktionen sind in dieser Umgebung nicht verfügbar.", "warning")
return redirect(url_for("hostsettings.web"))
config = _web_config()
@@ -415,7 +415,7 @@ def web_self_signed():
@bp.get("/directory")
@permission_required("settings_directory.view")
@permission_required("settings_directory.read")
def directory_settings():
extension = core()
conn = db()
@@ -436,7 +436,7 @@ def directory_settings():
@bp.post("/directory")
@permission_required("settings_directory.edit")
@permission_required("settings_directory.write")
def directory_save():
problem = _license_hint("directory")
if problem:
@@ -454,8 +454,8 @@ def directory_save():
if values.get("ldap_security") == "none" and not values.get("ldap_allow_insecure"):
flash(
"Eine unverschluesselte Verbindung muss ausdruecklich erlaubt werden -- das Passwort "
"geht dabei im Klartext ueber das Netz.",
"Eine unverschlüsselte Verbindung muss ausdrücklich erlaubt werden – das Passwort "
"geht dabei im Klartext über das Netz.",
"danger",
)
return redirect(url_for("hostsettings.directory_settings"))
@@ -490,7 +490,7 @@ def directory_test():
@bp.get("/directory/group-search")
@permission_required("settings_directory.edit", "fileshare.edit", mode="any")
@permission_required("settings_directory.write", "fileshare.write", mode="any")
def directory_group_search():
"""Sucht Gruppen im Verzeichnis -- fuer die Auswahlfelder.
@@ -505,21 +505,30 @@ def directory_group_search():
@bp.post("/directory/mapping")
@permission_required("settings_directory.edit")
@permission_required("settings_directory.write")
def directory_mapping_add():
conn = db()
dn = (request.form.get("ad_group_dn") or "").strip()
name = (request.form.get("ad_group_name") or "").strip()
group_id = request.form.get("app_group_id")
if not dn or not group_id:
flash("Verzeichnisgruppe und Zielgruppe sind beide erforderlich.", "danger")
# Ein Feld, zwei Arten von Ziel: "gruppe:<id>" oder "administrator". Zwei
# Felder waeren zwei Zustaende, von denen einer immer falsch ist.
ziel = (request.form.get("ziel") or request.form.get("app_group_id") or "").strip()
kennzeichen = ziel == "administrator"
gruppe: int | None = None
if not kennzeichen:
nummer = ziel.split(":", 1)[1] if ziel.startswith("gruppe:") else ziel
gruppe = int(nummer) if nummer.isdigit() else None
if not dn or (gruppe is None and not kennzeichen):
flash("Verzeichnisgruppe und Ziel sind beide erforderlich.", "danger")
return redirect(url_for("hostsettings.directory_settings"))
with transaction():
conn.execute(
"INSERT INTO ldap_group_mappings (ad_group_dn, ad_group_name, app_group_id, created_at) "
"VALUES (?,?,?,datetime('now')) ON CONFLICT(ad_group_dn) DO UPDATE SET "
"ad_group_name=excluded.ad_group_name, app_group_id=excluded.app_group_id",
(dn, name or dn, int(group_id)),
"INSERT INTO ldap_group_mappings "
"(ad_group_dn, ad_group_name, app_group_id, grants_admin, created_at) "
"VALUES (?,?,?,?,datetime('now')) ON CONFLICT(ad_group_dn) DO UPDATE SET "
"ad_group_name=excluded.ad_group_name, app_group_id=excluded.app_group_id, "
"grants_admin=excluded.grants_admin",
(dn, name or dn, gruppe, int(kennzeichen)),
)
audit.log(
conn,
@@ -527,15 +536,22 @@ def directory_mapping_add():
actor_id=current_user.id,
action="settings.directory_mapping_added",
target=name or dn,
detail=(
"Ziel: Administrator (Kennzeichen)"
if kennzeichen
else f"Ziel: Gruppe {gruppe}"
),
ip=client_ip(),
severity="notice",
# Eine Zuordnung, die Administratoren erzeugt, ist mehr als eine
# Notiz wert: sie entscheidet, wer die Anlage verwaltet.
severity="warning" if kennzeichen else "notice",
)
flash("Zuordnung gespeichert.", "success")
return redirect(url_for("hostsettings.directory_settings"))
@bp.post("/directory/mapping/<int:mapping_id>/delete")
@permission_required("settings_directory.edit")
@permission_required("settings_directory.write")
def directory_mapping_delete(mapping_id: int):
with transaction() as conn:
conn.execute("DELETE FROM ldap_group_mappings WHERE id=?", (mapping_id,))
@@ -39,7 +39,7 @@ def _live_log():
@bp.get("/live")
@permission_required("logs_live.view")
@permission_required("logs_live.read")
def live():
lines = min(int(request.args.get("lines") or 400), MAX_TAIL_LINES)
needle = (request.args.get("q") or "").strip()
@@ -53,7 +53,7 @@ def live():
@bp.get("/live/content")
@permission_required("logs_live.view")
@permission_required("logs_live.read")
@fragment
def live_fragment():
lines = min(int(request.args.get("lines") or 400), MAX_TAIL_LINES)
@@ -64,7 +64,7 @@ def live_fragment():
@bp.get("/history")
@permission_required("logs_history.view", "logs_history.export", mode="any")
@permission_required("logs_history.read", "logs_history.export", mode="any")
def history():
extension = core()
rotated = []
@@ -83,7 +83,7 @@ def history():
@bp.get("/history/file/<path:name>")
@permission_required("logs_history.view")
@permission_required("logs_history.read")
def history_file(name: str):
extension = core()
target = (extension.config.log_dir / name).resolve()
@@ -102,7 +102,7 @@ def history_file(name: str):
@bp.get("/history/archive/<day>")
@permission_required("logs_history.view")
@permission_required("logs_history.read")
def history_archive(day: str):
if len(day) != 10 or day.count("-") != 2:
abort(404)
@@ -177,7 +177,7 @@ def history_purge():
@bp.get("/audit")
@permission_required("logs_audit.view", "logs_audit.export", mode="any")
@permission_required("logs_audit.read", "logs_audit.export", mode="any")
def audit_view():
conn = db()
page = max(1, int(request.args.get("page") or 1))
@@ -235,7 +235,7 @@ def audit_export():
mimetype="text/csv; charset=utf-8",
headers={
"Content-Disposition": (
f'attachment; filename="{core().config.app_key}-aenderungsprotokoll.csv"'
f'attachment; filename="{core().config.app_key}-änderungsprotokoll.csv"'
)
},
)
+13 -13
View File
@@ -100,7 +100,7 @@ def register_core_providers() -> None:
list_fn=_users_in_trash,
restore_fn=lambda conn, ident: rbac.restore_user(conn, int(ident)),
purge_fn=lambda conn, ident: rbac.purge_user(conn, int(ident)),
hint="Verzeichniskonten landen nie hier -- sie legen sich bei der naechsten "
hint="Verzeichniskonten landen nie hier – sie legen sich bei der nächsten "
"Anmeldung von selbst wieder an.",
)
)
@@ -112,7 +112,7 @@ def register_core_providers() -> None:
list_fn=_groups_in_trash,
restore_fn=lambda conn, ident: rbac.restore_group(conn, int(ident)),
purge_fn=lambda conn, ident: rbac.purge_group(conn, int(ident)),
hint="Beim endgueltigen Loeschen verschwinden auch Mitgliedschaften und Rechte.",
hint="Beim endgültigen Löschen verschwinden auch Mitgliedschaften und Rechte.",
)
)
@@ -146,7 +146,7 @@ def _purge_expired(conn: sqlite3.Connection) -> int:
@bp.get("/")
@permission_required("trash.view")
@permission_required("trash.read")
def overview():
conn = db()
removed = 0
@@ -158,11 +158,11 @@ def overview():
conn,
actor="system",
action="trash.auto_purged",
detail=f"{removed} abgelaufene Eintraege",
detail=f"{removed} abgelaufene Einträge",
severity="notice",
)
if removed:
flash(f"{removed} abgelaufene Eintraege wurden endgueltig entfernt.", "info")
flash(f"{removed} abgelaufene Einträge wurden endgültig entfernt.", "info")
sections = []
for provider in providers().values():
@@ -192,13 +192,13 @@ def _provider_or_404(key: str) -> TrashProvider:
@bp.post("/<kind>/<ident>/restore")
@permission_required("trash.edit")
@permission_required("trash.write")
def restore(kind: str, ident: str):
extension = core()
if extension.license is not None and not extension.license.feature_allowed("trash_restore"):
flash(
"Das Wiederherstellen aus dem Papierkorb erfordert eine gueltige, "
"aktivierte Lizenz. Ansehen bleibt jederzeit moeglich.",
"Das Wiederherstellen aus dem Papierkorb erfordert eine gültige, "
"aktivierte Lizenz. Ansehen bleibt jederzeit möglich.",
"danger",
)
return redirect(url_for("trash.overview"))
@@ -228,7 +228,7 @@ def purge(kind: str, ident: str):
extension = core()
if extension.license is not None and not extension.license.feature_allowed("trash_restore"):
flash(
"Das endgueltige Loeschen erfordert eine gueltige, aktivierte Lizenz.",
"Das endgültige Löschen erfordert eine gültige, aktivierte Lizenz.",
"danger",
)
return redirect(url_for("trash.overview"))
@@ -246,7 +246,7 @@ def purge(kind: str, ident: str):
ip=client_ip(),
severity="warning",
)
flash("Eintrag endgueltig entfernt.", "success")
flash("Eintrag endgültig entfernt.", "success")
except (rbac.ValidationError, rbac.PermissionDenied) as exc:
flash(str(exc), "danger")
return redirect(url_for("trash.overview"))
@@ -257,7 +257,7 @@ def purge(kind: str, ident: str):
def purge_all():
extension = core()
if extension.license is not None and not extension.license.feature_allowed("trash_restore"):
flash("Das endgueltige Loeschen erfordert eine gueltige, aktivierte Lizenz.", "danger")
flash("Das endgültige Löschen erfordert eine gültige, aktivierte Lizenz.", "danger")
return redirect(url_for("trash.overview"))
kind = request.form.get("kind") or ""
@@ -274,9 +274,9 @@ def purge_all():
actor_id=current_user.id,
action="trash.emptied",
target=kind or "alle",
detail=f"{removed} Eintraege",
detail=f"{removed} Einträge",
ip=client_ip(),
severity="warning",
)
flash(f"{removed} Eintraege endgueltig entfernt.", "success")
flash(f"{removed} Einträge endgültig entfernt.", "success")
return redirect(url_for("trash.overview"))
+1 -1
View File
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
[project]
name = "tesm-licensing"
version = "2.5.1"
version = "2.7.7"
description = "Ed25519-basiertes Lizenz- und Aktivierungsprotokoll fuer TESM und TESM-Lizenzserver"
requires-python = ">=3.11"
dependencies = ["cryptography>=42"]
Loaded 100 of 103 files, more files were not shown because too many files have changed in this diff. Show more