75 lines
3.7 KiB
Markdown
Executable File
75 lines
3.7 KiB
Markdown
Executable File
> **Dieses Repo ist Historie.** Groundcontrol (`mscadm/groundcontrol`) hat den
|
|
> Code seit 2026-07-28 uebernommen; das ITSM lebt dort als Modul *Service Desk*
|
|
> weiter (siehe ADR-010). Neue Arbeit bitte im Groundcontrol-Repo.
|
|
|
|
# ITSM
|
|
|
|
ITSM-Plattform (Service-Katalog, Tickets, Wissensdatenbank, CMDB) -- AES ist ein
|
|
buchbarer Service darin. Eigenstaendiges Produkt, mandantenfaehig.
|
|
|
|
**Stack:** Rust (axum + tokio-postgres + askama), PostgreSQL 16.
|
|
Rust-Rewrite 2026-07-15; zuvor Python/Flask -- Bestandsdaten (inkl. Passwort-
|
|
Hashes) werden ohne Migration weiterverwendet, alte Werkzeug-PBKDF2-Hashes
|
|
werden beim ersten Login transparent auf Argon2id umgestellt.
|
|
|
|
## ITIL-Ausrichtung (v3-Prozesse / v4-Practices)
|
|
|
|
- **Rollen:** admin (Service Owner/IT-Leitung), change_manager (Change
|
|
Enablement/CAB), agent (Service Desk), user (Requester/Self-Service:
|
|
eigene Tickets, nur freigegebene Wissensartikel).
|
|
- **Incident/Service Request:** getrennte Kategorien; Statusmodell mit
|
|
erzwungenen Uebergaengen (Offen -> In Bearbeitung -> Warten/Geloest ->
|
|
Geschlossen; Reopen von Geloest).
|
|
- **Prioritaet:** automatisch aus der Impact-x-Urgency-Matrix (v3 SO 4.2.5.4).
|
|
- **Change Enablement:** Standard (vorautorisiert) / Normal (CAB-Freigabe
|
|
durch change_manager/admin) / Emergency (sofort, nachtraegliche
|
|
ECAB-Freigabe). Umsetzung + Repo-Aenderungen erst nach Freigabe.
|
|
- **Problem Management:** Incident-Problem-Verknuepfung, Known-Error-Status.
|
|
- **SLA (Service Level Management):** Antwort-/Loesungsfristen mit
|
|
Zeitstempeln (erste Reaktion, Loesung, Schliessung), Ueberfaelligkeit.
|
|
- **Knowledge Management:** Freigabe-Workflow (Entwurf -> Freigegeben).
|
|
- **SACM/CMDB:** CIs, Beziehungen, Ticket-CI-Verknuepfung.
|
|
- **Continual Improvement:** Dashboard mit SLA-Erfuellung, MTTR, Verteilungen.
|
|
|
|
## Sicherheit
|
|
|
|
- Serverseitige Sessions in PostgreSQL (Cookie enthaelt nur ein Zufallstoken,
|
|
DB speichert dessen SHA-256; Logout/Sperrung widerruft sofort).
|
|
- CSRF-Schutz fuer alle zustandsaendernden Requests (Formular-Feld/Header).
|
|
- Login-Rate-Limit (pro E-Mail und IP, DB-gestuetzt), Audit-Log aller
|
|
sicherheitsrelevanten Aktionen (ISO 27001 A.12.4 / DSGVO Art. 30).
|
|
- Argon2id-Passwoerter, Policy: min. 12 Zeichen.
|
|
- Security-Header (CSP ohne Inline-JS, X-Frame-Options, nosniff, HSTS bei
|
|
ITSM_HTTPS=1); X-Forwarded-For nur bei ITSM_TRUSTED_PROXY_COUNT > 0.
|
|
- SSRF-Guard fuer Service-Endpoint-URLs (Link-Local/Metadaten blockiert,
|
|
Anlegen admin-only); Erreichbarkeitspruefung parallel + gecacht.
|
|
- Repo-Bearbeitung aus Tickets (Forge-Contents-API, phase-008): nur
|
|
admin/change_manager, nur aus freigegebenen Change-Tickets, jede Aenderung
|
|
zwingend im Worklog dokumentiert.
|
|
- DSGVO-Retention: automatische Bereinigung von Tickets/Audit-Log gemaess
|
|
Mandanten-Fristen; Login-Versuche nach 7 Tagen, abgelaufene Sessions sofort.
|
|
|
|
## Dokumentation
|
|
|
|
- `docs/ARCHITEKTUR.md` — technische Architektur (Module, Datenmodell, Request-Fluss, RBAC-Matrix, ITIL-Abbildung)
|
|
- `docs/BETRIEB.md` — Betriebshandbuch (ENV, Deployment/Update, Backup, Troubleshooting)
|
|
- `docs/adr/` — Architecture Decision Records (ADR-001 bis ADR-008)
|
|
- Prozess-Doku nach AES-Regelwerk (Projektbeschreibung, Phasen-/Forensik-Reports, Tasks):
|
|
`mscadm/AES`, Branch `dev`, Verzeichnis `projects/itsm/`
|
|
|
|
## Betrieb
|
|
|
|
# Entwicklung
|
|
DATABASE_URL=postgresql://itsm:pw@localhost:5432/itsm cargo run
|
|
|
|
# Produktion: siehe deploy/docker-compose.yml (Multi-Stage-Build,
|
|
# kein Code-Pull beim Container-Start mehr)
|
|
|
|
ENV-Variablen: siehe src/config.rs. Schema-Migrationen laufen idempotent beim
|
|
Start (schema.sql). Backup: deploy/backup.sh (taeglicher pg_dump, 14 Tage).
|
|
|
|
## Tests
|
|
|
|
cargo test # ITIL-Statusmodell, Prioritaetsmatrix, Change-Gate,
|
|
# Argon2/Werkzeug-Hash-Verifikation, SSRF-Guard, Policy
|