Serverbetrieb mit Docker und LDAP
Neben der lokalen Version (ein Programm auf dem eigenen Rechner, ohne Anmeldung) kann OmniPressix als gemeinsamer Server laufen: ein Docker-Container im Firmennetz, alle öffnen ihn im Browser und melden sich mit ihrem Firmen-Benutzernamen an (LDAP, also z. B. OpenLDAP oder Active Directory). Es ist dasselbe Programm; im Container läuft es mit -server.
Was sich im Serverbetrieb ändert:
- Ohne Anmeldung gibt es nur die Anmeldeseite. Nach der Anmeldung zeigt die Kopfzeile den Namen und ein Symbol zum Abmelden statt „Programm beenden“.
- Vorlagen liegen gemeinsam im Volume
/data/templates– alle angemeldeten Benutzer sehen und bearbeiten dieselben Vorlagen. Das Protokoll (docker logs) hält fest, wer sich angemeldet und wer welche Vorlage gespeichert oder gelöscht hat. - Fotos (Passbilder) werden im Volume unter
/data/fotos/benutzer/<Anmeldename>gespeichert, jeder Benutzer sieht nur seine eigenen. Sie bleiben dort, bis der Benutzer sie im Bereich „Fotos“ löscht („Alle Fotos löschen“). Weil das personenbezogene Daten sind: Volume und Sicherungen entsprechend schützen und nicht mehr gebrauchte Fotos löschen lassen. - Vorlagen enthalten auch die geladenen Kartendaten (CSV/ODS) und die Schriften. Weil alle Benutzer jede Vorlage sehen, sind diese Daten für alle sichtbar: Vorlagen nur mit Daten speichern, die jeder sehen darf (Volume und Sicherungen schützen). PDFs werden nicht auf dem Server gespeichert, sie gehen nur für die Erzeugung des PDFs durch das Programm.
- Der automatische Zwischenstand im Browser ist je Benutzer getrennt und wird beim Abmelden gelöscht (vorher wird gefragt). Läuft die Anmeldung nur ab, bleibt er erhalten und ist nach dem erneuten Anmelden wieder da.
- Die Anmeldung gilt 12 Stunden (
OMNIPRESSIX_SESSION_TTL). Nach einem Neustart des Containers muss man sich neu anmelden. - Nach 5 falschen Passwörtern für einen Benutzernamen (bzw. 20 von einer Adresse) ist die Anmeldung 5 Minuten gesperrt.
Schnell ausprobieren (mit Test-LDAP)#
Ohne eigenes Verzeichnis lässt sich alles mit dem mitgelieferten Test-LDAP ausprobieren:
cd docker/test-ldap
docker compose up --build
Dann http://localhost:8080 öffnen und als erika / erika-pw anmelden. max / max-pw ist nicht in der Gruppe omnipressix und wird abgelehnt. Nur zum Testen: Die Passwörter stehen offen in der Datei, die LDAP-Verbindung ist unverschlüsselt. Aufräumen mit docker compose down -v.
Einrichten#
Alles für Docker liegt im Ordner docker/. Gebaut wird trotzdem aus dem Hauptordner, weil dort der Quellcode liegt – die Compose-Dateien sind schon so eingestellt.
- Im Ordner
docker/die Dateiomnipressix.env.examplenachomnipressix.envkopieren und an das eigene Verzeichnis anpassen (Erklärung der Werte steht in der Datei und unten).omnipressix.enventhält das Passwort des Dienstkontos und ist deshalb in.gitignore. - Bauen und starten: ``
cd docker docker compose up -d --build`Ohne Compose, im Hauptordner:docker build -f docker/Dockerfile -t omnipressix .unddocker run -d -p 8080:8080 --env-file docker/omnipressix.env -v omnipressixfree-daten:/data omnipressix` - Prüfen:
docker logs docker-omnipressix-1sollte „LDAP-Anmeldung aktiv“ zeigen; eine Warnung nennt den Grund, falls der LDAP-Server nicht erreichbar ist oder das Dienstkonto nicht passt.docker pszeigt nach etwa 30 Sekunden „healthy“. - HTTPS: Passwörter dürfen nicht unverschlüsselt vom Browser zum Server gehen. Entweder einen Reverse Proxy mit Zertifikat davorschalten (nginx, Traefik, Caddy, …) und
OMNIPRESSIX_TRUST_PROXY=truesetzen, oder Zertifikat und Schlüssel in den Container einbinden undOMNIPRESSIX_TLS_CERT/OMNIPRESSIX_TLS_KEYsetzen. Der Port 8080 sollte dann nur für den Proxy erreichbar sein.
Das Abbild ist klein (ohne Shell, „distroless“), läuft nicht als root und prüft sich selbst (HEALTHCHECK). Die Vorlagen im Volume sichern: z. B. über „Alle exportieren“ im Vorlagen-Fenster oder mit docker cp. Mit docker cp den Unterordner .versions mitnehmen, wenn auch die früheren Stände erhalten bleiben sollen.
Einstellungen (Umgebungsvariablen)#
Die Variablen heißen OMNIPRESSIX_…. Bis Version 4.0 hießen sie OMNIPRESSIXFREE_…: Diese alten Namen funktionieren weiter, sind aber veraltet – das Programm schreibt beim Start einen Hinweis ins Protokoll („Die Umgebungsvariable OMNIPRESSIXFREE_… ist veraltet, bitte OMNIPRESSIX_… verwenden“), einmal je Variable. Sind beide gesetzt, gilt die neue. Das gilt auch für die Varianten …_FILE (Docker Secrets). Die Umstellung ist also nur ein Umbenennen der Zeilen in der .env-Datei bzw. in docker-compose.yml; ein Neustart genügt.
| Variable | Bedeutung |
|---|---|
OMNIPRESSIX_AUTH | ldap = Anmeldung über LDAP; keine = ohne Anmeldung (nur in einem abgeschotteten Netz). Ohne Angabe startet der Serverbetrieb nicht. |
OMNIPRESSIX_LDAP_URL | ldaps://ldap.firma.de:636 (verschlüsselt) oder ldap://…:389 |
OMNIPRESSIX_LDAP_STARTTLS | true = bei ldap:// auf Verschlüsselung umschalten |
OMNIPRESSIX_LDAP_CA_FILE | eigene Zertifizierungsstelle als PEM-Datei (per Volume einbinden) |
OMNIPRESSIX_LDAP_INSECURE_SKIP_VERIFY | true = Zertifikat nicht prüfen – nur zum Testen |
OMNIPRESSIX_LDAP_BIND_DN | Dienstkonto zum Suchen der Benutzer (Variante A) |
OMNIPRESSIX_LDAP_BIND_PASSWORD | dessen Passwort, oder …_BIND_PASSWORD_FILE mit Pfad zu einer Datei (Docker Secret) |
OMNIPRESSIX_LDAP_BASE_DN | hier liegen die Benutzer, z. B. ou=people,dc=firma,dc=de |
OMNIPRESSIX_LDAP_USER_FILTER | Suchfilter, %s = eingegebener Name. Standard (uid=%s), Active Directory: (sAMAccountName=%s) |
OMNIPRESSIX_LDAP_USER_DN | Variante B ohne Dienstkonto: uid=%s,ou=people,dc=firma,dc=de bzw. bei AD %s@firma.local |
OMNIPRESSIX_LDAP_GROUP_DN | nur Mitglieder dieser Gruppe(n) dürfen sich anmelden, mehrere mit ; trennen |
OMNIPRESSIX_LDAP_ADMIN_GROUP_DN | optional, Rolle Administrator: Mitglieder dürfen alles; mehrere Gruppen mit ; trennen; siehe Rollen: Administrator und „nur lesen und drucken“ |
OMNIPRESSIX_LDAP_READONLY_GROUP_DN | optional, Rolle Leser: Mitglieder dürfen nur lesen und drucken; mehrere Gruppen mit ; trennen |
OMNIPRESSIX_LDAP_NAME_ATTR | Attribut mit dem angezeigten Namen, Standard displayName (sonst cn) |
OMNIPRESSIX_LDAP_TIMEOUT | Wartezeit für den LDAP-Server, Standard 10s |
OMNIPRESSIX_SESSION_TTL | Dauer einer Anmeldung, Standard 12h |
OMNIPRESSIX_TRUST_PROXY | true hinter einem Reverse Proxy |
OMNIPRESSIX_TLS_CERT, OMNIPRESSIX_TLS_KEY | HTTPS direkt im Programm |
OMNIPRESSIX_SETTINGS_DIR | Ordner für die Einstellungen der Benutzer (je Benutzer eine Datei, nur mit Anmeldung), Standard settings; im Abbild unter /data ablegen, damit sie Updates überstehen |
OMNIPRESSIX_ADDR, OMNIPRESSIX_TEMPLATES_DIR, OMNIPRESSIX_PHOTOS_DIR | im Abbild schon auf 0.0.0.0:8080, /data/templates und /data/fotos gesetzt |
OMNIPRESSIX_TEMPLATE_VERSIONS | wie viele frühere Stände je Vorlage aufgehoben werden, Standard 20, 0 = keine (Frühere Stände) |
OMNIPRESSIX_PRINT_LOG | Druckprotokoll, im Abbild /data/druckprotokoll.jsonl (liegt also im Volume); aus schaltet es ab |
OMNIPRESSIX_PRINT_LOG_MAX_MB | Größe in MB, ab der das Druckprotokoll beiseitegelegt wird, Standard 20, 0 = nie |
Variante A – Dienstkonto (empfohlen): Das Programm meldet sich mit BIND_DN an, sucht den Benutzer unter BASE_DN mit USER_FILTER und prüft dann dessen Passwort. Das funktioniert mit jedem Anmeldenamen-Attribut und auch dann, wenn normale Benutzer keine Gruppen lesen dürfen. Das Dienstkonto braucht nur Leserechte.
Variante B – direkt: Ohne Dienstkonto wird der Anmeldename in USER_DN eingesetzt. Für die Gruppenprüfung muss der Benutzer die Gruppe dann selbst lesen dürfen; bei Active Directory (%s@firma.local) zusätzlich BASE_DN und USER_FILTER setzen.
Kartendaten aus dem Verzeichnis#
Mit Dienstkonto und Suchbasis können Administratoren Kartendaten direkt aus dem Verzeichnis laden, siehe Aus dem Verzeichnis laden. Das Dienstkonto braucht Leserechte auf die Personenobjekte (und die Gruppen). Leser sehen den Knopf nicht.
Rollen: Administrator und „nur lesen und drucken“#
Mit zwei Gruppen aus dem Active Directory (oder einem anderen LDAP-Verzeichnis) lassen sich zwei Rollen vergeben:
| Rolle | Variable | darf |
|---|---|---|
| Administrator | OMNIPRESSIX_LDAP_ADMIN_GROUP_DN | alles: gestalten, Vorlagen speichern, importieren und löschen, Schriften, Formate |
| Leser | OMNIPRESSIX_LDAP_READONLY_GROUP_DN | nur lesen und drucken: Kartendaten und Fotos laden, Vorlagen laden und exportieren, Karten als PDF erzeugen oder drucken |
Beispiel für Active Directory (Gruppen mit ihrem DN, mehrere je Rolle mit ; getrennt):
OMNIPRESSIX_LDAP_ADMIN_GROUP_DN=CN=OmniPressix-Admins,OU=Gruppen,DC=firma,DC=local
OMNIPRESSIX_LDAP_READONLY_GROUP_DN=CN=OmniPressix-Leser,OU=Gruppen,DC=firma,DC=local
Wer darf sich anmelden, wer bekommt welche Rolle:
- Anmelden darf, wer in der Administrator-Gruppe, der Leser-Gruppe oder in
OMNIPRESSIX_LDAP_GROUP_DNsteht. Alle anderen werden wie bisher abgelehnt. Die Gruppen müssen nicht ineinander enthalten sein. - Mit Administrator-Gruppe: Alle Mitglieder sind Administratoren, jeder andere angemeldete Benutzer ist Leser. Wer in beiden Gruppen steht, ist Administrator.
- Nur mit Leser-Gruppe (ohne Administrator-Gruppe): Mitglieder sind Leser, alle übrigen (die über
OMNIPRESSIX_LDAP_GROUP_DNkommen) dürfen alles. Das Programm verlangt dann…_GROUP_DN, sonst gäbe es niemanden mit allen Rechten, und meldet es beim Start. - Ohne beide Gruppen ändert sich nichts: Jeder angemeldete Benutzer darf alles.
- Die Rolle wird bei jeder Anmeldung gelesen; ein Wechsel der Gruppe gilt ab der nächsten Anmeldung (die Sitzung dauert höchstens
OMNIPRESSIX_SESSION_TTL, Standard 12 h). Lässt sich die Mitgliedschaft nicht klären (Fehler im Verzeichnis), bleibt der Benutzer angemeldet, aber als Leser; der Grund steht im Protokoll (docker logs). Es gelten dieselben Gruppentypen und Regeln wie bei den Gruppen unten; ohne Dienstkonto muss der Benutzer die Gruppen selbst lesen dürfen.
Was der Leser sieht: Die Kopfzeile zeigt „Nur lesen und drucken“. Es fehlen Kartenseite, Felder, Ebenen, Zeichnen und Schriften links, das Eigenschaften-Panel rechts, Rückgängig, „Neu“ und „Speichern“; Felder lassen sich nicht anklicken, Bearbeitungs-Tastenkürzel und die entsprechenden Befehle der Suche (Strg+K) gibt es nicht. Übrig bleiben Kartendaten (importieren, ansehen, bearbeiten, Karten zum Drucken auswählen), Fotos, Vorlagen (laden und exportieren, ohne Speichern, Importieren und Löschen) und Drucken. Eine Vorlage laden und die Karten drucken ist der vorgesehene Ablauf; Bilder, die auf das Fenster gezogen werden, sind für Leser immer Fotos, Schriften und Layout-Dateien werden abgewiesen.
Wichtig – was die Sperre schützt: Das Programm erzwingt die Rolle bei allem, was auf dem Server liegt und für alle gilt: Eine Anfrage zum Speichern oder Löschen von Vorlagen ohne Administratorrolle beantwortet es mit „403 Verboten“, auch wenn jemand die Knöpfe umgeht. Das Gestalten im Browser (Felder bearbeiten) sperrt dagegen nur die Oberfläche: Es ist die eigene Arbeitskopie im Browser, die nichts auf dem Server ändert, und ließe sich mit den Entwicklerwerkzeugen des Browsers entsperren – ein Leser könnte dann an seiner Kopie arbeiten und drucken, aber keine Vorlage für andere verändern. Soll das Drucken fremder Layouts ausgeschlossen werden, helfen nur Vorlagen im Schreibschutz und das Druckprotokoll, das jeden Auftrag mit Benutzer festhält.
Gruppen: Erkannt werden direkte Mitglieder von groupOfNames und AD-Gruppen (member), groupOfUniqueNames (uniqueMember) und posixGroup (memberUid). Verschachtelte Gruppen zählen nicht.
Beispiel Active Directory (Variante A):
OMNIPRESSIX_LDAP_URL=ldaps://dc1.firma.local:636
OMNIPRESSIX_LDAP_BIND_DN=CN=svc-omnipressix,OU=Dienste,DC=firma,DC=local
OMNIPRESSIX_LDAP_BIND_PASSWORD_FILE=/run/secrets/ldap_passwort
OMNIPRESSIX_LDAP_BASE_DN=OU=Mitarbeiter,DC=firma,DC=local
OMNIPRESSIX_LDAP_USER_FILTER=(&(objectClass=user)(sAMAccountName=%s))
OMNIPRESSIX_LDAP_GROUP_DN=CN=OmniPressix,OU=Gruppen,DC=firma,DC=local
Wenn die Anmeldung nicht klappt: Die Anmeldeseite sagt aus Sicherheitsgründen nur „Benutzername oder Passwort falsch“; den genauen Grund (Dienstkonto falsch, Suchbasis falsch, nicht in der Gruppe, Zertifikat abgelaufen, …) zeigt docker logs.