Zammad

Tags: infrasystem, container, magrathea, productive, malte, ssoenabled

Hier findet sich die technische Dokumentation des Chaotikum Ticketsystems. Die Nutzungshinweise finden sich hier..

Services

Signatur des Debian-Pakets

Krypto-Policy-Problem: Seit 01.02.2026 lehnt APT (genauer: der Verifier Sequoia/sqv) SHA-1 in bestimmten OpenPGP-Signaturen hart ab. Hier muss sich Zammad darum kümmern, einen neueren Key zu generieren und den gibt es noch nicht. Deswegen habe ich in der Datei /etc/crypto-policies/back-ends/apt-sequoia.config die Deadline für SHA1 und SHA224 um ein Jahr auf 2027-02 verlängert.

Setup von gruppen

Wir nutzen grundsätzlich Mailinglisten auf denen die für eine zammad Gruppe genutzte mail Adresse ein subscriber ist. So können Die Mails z.B. sowohl vom Dienst als auch von anderen Personen auf der Liste gelesen werden. Das hat verschiedene Vorteile, z.b. kann das später entkoppelt werden o.ä. ohne mail Adressen zu ändern. Zudem kann auf der Mailinglisten Seite für gute Datenschutz übersicht dokumntiert werden, welche Listen dazu führen, dass man Mails an zammad schreibt.

Wer also eine Zammad Gruppe aufsetzt, setzt einen LDAP-Account als Service Account (das sind die kursiven, an denen kann man sich orientieren) auf auf, der die Mail-Adresse erzeugt. Dann über mlmmj eine Mailingliste auf welche dieser account und ggf. weitere kommen.

Das ist leider aktuell glaube ich nicht zu 100% umgesetzt, sollte aber zukünftig immer so gemacht werden.

Spam

Es gibt ein Makro zum schließen von Spam, bitte das nutzen.

Update-Nachsorge

Beim Update hängt sich manchmal das Elasticsearch auf, weil nach dem Update das Plugin ingest-attachment nicht mehr dazu passt. Dann muss man das neu installieren:

/usr/share/elasticsearch/bin/elasticsearch-plugin remove ingest-attachment
/usr/share/elasticsearch/bin/elasticsearch-plugin install ingest-attachment 

Manchmal hilft es auch, den Suchindex komplett neu zu bauen:

zammad run rake zammad:searchindex:rebuild

Installation Protocol

# Anleitung Zammad https://docs.zammad.org/en/latest/install/package.html
# Additional software dependencies
apt install curl apt-transport-https gnupg

# Anleitung Elasticsearch https://docs.zammad.org/en/latest/install/elasticsearch.html
apt install apt-transport-https wget curl gnupg
echo "deb [signed-by=/etc/apt/trusted.gpg.d/elasticsearch.gpg] https://artifacts.elastic.co/packages/7.x/apt stable main" | tee -a /etc/apt/sources.list.d/elastic-7.x.list > /dev/null
curl -fsSL https://artifacts.elastic.co/GPG-KEY-elasticsearch | gpg --dearmor | tee /etc/apt/trusted.gpg.d/elasticsearch.gpg> /dev/null
apt update
apt install elasticsearch
/usr/share/elasticsearch/bin/elasticsearch-plugin install ingest-attachment

# RAM für Elasticsearch begrenzen
# WICHTIG! Sonst verwendet das alles an RAM, was es finden kann
echo "-Xms500m" > /etc/elasticsearch/jvm.options.d/heapsize.options
echo "-Xmx500m" >> /etc/elasticsearch/jvm.options.d/heapsize.options

# Service aktivieren und starten
systemctl daemon-reload
systemctl enable elasticsearch.service

# Settings in /etc/elasticsearch/elasticsearch.yml ergänzen:
# # recommended settings from https://docs.zammad.org/en/latest/install/elasticsearch.html
# # Tickets above this size (articles + attachments + metadata)
# # may fail to be properly indexed (Default: 100mb).
# #
# # When Zammad sends tickets to Elasticsearch for indexing,
# # it bundles together all the data on each individual ticket
# # and issues a single HTTP request for it.
# # Payloads exceeding this threshold will be truncated.
# #
# # Performance may suffer if it is set too high.
# http.max_content_length: 400mb
#
# # Allows the engine to generate larger (more complex) search queries.
# # Elasticsearch will raise an error or deprecation notice if this value is too low,
# # but setting it too high can overload system resources (Default: 1024).
# #
# # Available in version 6.6+ only.
# indices.query.bool.max_clause_count: 2000

# Install Zammad
curl -fsSL https://dl.packager.io/srv/zammad/zammad/key | gpg --dearmor | tee /etc/apt/trusted.gpg.d/pkgr-zammad.gpg> /dev/null
echo "deb [signed-by=/etc/apt/trusted.gpg.d/pkgr-zammad.gpg] https://dl.packager.io/srv/deb/zammad/zammad/stable/debian 11 main"| tee /etc/apt/sources.list.d/zammad.list > /dev/null
apt update
apt install zammad

# Set the Elasticsearch server address
$ zammad run rails r "Setting.set('es_url', 'http://localhost:9200')"

# Build the search index
$ zammad run rake zammad:searchindex:rebuild

# make nginx listen for remote connections
# edit /etc/nginx/sites-available/zammad.conf
# remove server_name localhost
# remove listen [::]:80
# remove listen :80
# add listen 192.168.1.59:80

SSO

Single Sign On (SSO) mit Keycloak kann in der Anwendung vom Admin Account konfiguriert werden. Zammad nutzt SAML.

Die ID muss da diese lustige URL sein. Nicht ändern.

Wartung

In das Textfeld einfach das Datum der Wartung eintragen, am besten in der Form yyyy-mm-dd.

[dynamischer Inhalt des Wiki-Plugins „NEWPAGE” — im Mirror nicht verfügbar]