Eviworx
Docs
EN Zur Website

Quickstart

Dieser Guide hilft dir, nach der Installation schnell produktiv zu werden. Er führt dich durch die wichtigsten Konfigurationsschritte — vom ersten Login bis zur voll konfigurierten ITSM-Plattform.

⏱️
Geschätzte Zeit: 15-30 Minuten

Voraussetzung: Alle 12 Container laufen und sind "healthy". Siehe Installation.

Phase 1: Erste Anmeldung & Sicherheit

1
Erste Anmeldung

URL: https://your-domain.com

E-Mail: admin@company.com

Passwort: ADMIN_INITIAL_PASSWORD

(Default: ChangeMeNowXx, konfigurierbar via ENV)

2
Passwort ändern & MFA

→ Benutzermenü → Einstellungen → Sicherheit (Passwort)

→ Benutzermenü → Einstellungen → Sicherheit → MFA (TOTP)

TOTP-Apps: Google Authenticator, Microsoft Authenticator, Authy

3
🔑 Lizenz prüfen / aktivieren

→ Admin-Center → System → Produktlizenz

⏱️ Trial: 30 Tage, max. 3 Agents

License Key + Secret in .env eintragen oder direkt in der UI aktivieren.

Lizenz-Dokumentation →

Phase 2: Grundkonfiguration

4
Allgemeine Einstellungen

→ Admin-Center → System → Allgemein

  • Firmenname setzen
  • Application-URL konfigurieren (für QR-Codes, E-Mails)
  • Sprache wählen (DE, EN, ES, FR, IT)
5
Rollen konfigurieren

→ Admin-Center → Identität & Zugriff → Benutzer / Rollen

  • System-Rollen prüfen: Admin, Agent, Approver, End User, DSB
  • Eigene Rollen mit eigenen Berechtigungen anlegen
  • Eigene Rollen stehen überall zur Auswahl, wo Rollen vergeben werden, z. B. bei Formularen
6
Benutzer erstellen

→ Admin-Center → Identität & Zugriff → Benutzer → Neuer Benutzer

  • Benutzer manuell anlegen oder Einladungsemail versenden
  • Rolle zuweisen
  • Optional: Agent Groups konfigurieren (Kapazitätssteuerung)
7
Kategorien anlegen

→ Admin-Center → Service-Konfiguration → Kategorien

  • Ticket-Kategorien: Hardware, Software, Network, Access...
  • Incident-Kategorien (mit Evidence-Checklisten)
  • Asset-Kategorien und AssetType-Policies

Phase 3: Kommunikation einrichten

8
E-Mail konfigurieren

→ Admin-Center → Kommunikation → E-Mail & Postfächer

  • IMAP/SMTP: Klassische E-Mail-Integration
  • Microsoft Graph API: Für Microsoft 365 Mailboxen
  • E-Mail-Signaturen konfigurieren
  • TLS-Zertifikatsprüfung (tlsVerify) ist standardmäßig aktiv; nur bei selbstsignierten Zertifikaten deaktivieren
  • E-Mail-Test versenden zur Verifizierung
9
Notifications konfigurieren

→ Admin-Center → Kommunikation → Benachrichtigungsvorlagen (global) · Benutzermenü → Einstellungen → Benachrichtigungen (persönlich)

  • Kanäle: E-Mail, Microsoft Teams (Bot Framework), Webex, Web-Push
  • Quiet Hours definieren (keine Benachrichtigungen z.B. nachts)
10
Entra ID SSO (optional)

→ Admin-Center → Identität & Zugriff → Microsoft Entra ID

  • Client ID, Tenant ID, Client Secret eingeben
  • Group-to-Role Mapping konfigurieren

Phase 4: ITSM einrichten

11
Erstes Ticket erstellen

→ „Neues Ticket"-Button (bzw. Service Desk → Alle Tickets)

  • Titel, Beschreibung, Kategorie ausfüllen
  • Agent zuweisen
  • Follower hinzufügen (CC-Behandlung)
12
Workflows einrichten

→ Automation → Workflows → Templates → Neues Template

  • Drag-&-Drop-Editor öffnet sich
  • 8 Node-Typen: Manual Task, Approval, Automated Action, Notification, Parallel Gateway, Conditional Branch, Data Collection, Timer Event
  • Unterbrochene automatische Schritte werden erneut ausgeführt; pausierte Workflows laufen erst nach dem Fortsetzen weiter
13
SLA-Management

→ Admin-Center → Service-Konfiguration → SLA & Eskalation

  • SLA-Policies definieren (Response/Resolution-Zeiten)
  • Business Hours konfigurieren
  • Eskalationsstufen festlegen
14
CronJobs konfigurieren

→ Automation → CronJobs

  • 28 Action-Types verfügbar
  • Scheduled Reports, SLA-Monitor, Cleanup-Jobs
  • Überwachung der Agent-Auslastung

Phase 5: Dashboards & Monitoring

📊
Unified Workplace
Zentrales Dashboard mit konfigurierbaren Widgets. Dein Startpunkt nach dem Login.
🖥️
NOC Dashboard
Network Operations Center Ansicht für Echtzeit-Überwachung und Incident-Tracking.
📈
Analytics
Interaktive Analytics-Seite mit Auswertungen über alle ITSM-Module.

Phase 6: Erweiterte Features

Custom Reports
Erstelle eigene Reports mit dem Report-Builder. Zeitgesteuert (Scheduled) oder on-demand. Export als CSV oder PDF.
Agent Groups & Kapazität
Agent Groups mit maximaler Auslastung pro Agent. Erreicht ein Agent seine Grenze, wird automatisch benachrichtigt (ASSIGNMENT_CAPACITY_REACHED). Die Auslastung zeigt ein Widget im Dashboard.
Incident DSGVO-Flow
Datenschutzverletzung bei Incidents melden. Eigene Rolle: Datenschutzbeauftragter (DSB). Evidence-Checklisten per Entity.
Asset Handover & Inventur
QR/PDF-basierte Handover-Prozesse. Inventur-Funktionen mit Workflow-Integration und Notifications.

System-Status prüfen

Der aktuelle System-Status aller Container, Health-Checks und Ports ist einsehbar unter:

  • UI: Admin-Center → System → System-Status (/admin/system-status)
  • CLI: docker compose ps
  • Backend Health: curl -k https://your-domain.com/api/health/live
🏗️
Architektur

Alle 12 Container im Detail, Kommunikationsflüsse und Security-Architektur.

🔌
API-Referenz

REST API Dokumentation mit Beispielen für alle Module.

🔐
Sicherheit

FIPS 140-2 kompatible Algorithmen, Zero-Trust, Audit-Chain, RBAC und MFA im Detail.

💬
Support

Fragen? Probleme? → info@eviworx.com

← Installation
Lizenzierung →