Anmeldung bei Zammad mit einem API-Token

Verfasst von Michał, dem Entwickler von Zamio · Aktualisiert:

Zamio meldet sich bei Zammad mit einem persönlichen API-Token statt mit einem Passwort an. Sie geben ihn einmal ein und müssen sich danach nicht mehr um die Anmeldung kümmern. Diese Seite beschreibt, was der Administrator aktivieren muss und was jeder Agent tut.

Warum ein Token und kein Passwort

Ich habe mich aus Sicherheitsgründen für Tokens entschieden, und weil es auf dem Handy die praktischste Lösung ist:

  • Ihr Passwort kommt nie in die App. Das funktioniert auch, wenn Sie sich bei Zammad per SSO anmelden oder die Zwei-Faktor-Authentifizierung nutzen.
  • Eingeschränkte Berechtigungen. Der Token bekommt nur ticket.agent, und das reicht für alles, was die App tut.
  • Sie können ihn jederzeit widerrufen, direkt in Zammad und ohne Ihr Passwort zu ändern, zum Beispiel wenn Sie Ihr Handy verlieren.
  • Er bleibt auf dem Gerät. Der Token liegt im iOS-Schlüsselbund (Keychain) oder im Android Keystore und wird in keiner Cloud gespeichert. Die App verbindet sich direkt von Ihrem Handy mit dem Zammad Ihres Unternehmens.

Für Administratoren: Token-Zugang erlauben

  1. Öffnen Sie in Zammad die Admin-Einstellungen (Zahnrad-Symbol) und gehen Sie zu Einstellungen → System → API.
  2. Schalten Sie API-Token-Zugang (API Token Access) ein.

Sieht ein Agent den Token-Zugang in seinem Profil trotzdem nicht, prüfen Sie, ob seine Rolle die Berechtigung user_preferences.access_token hat (Verwalten → Rollen).

Für Agenten: Token erstellen

  1. Klicken Sie in Zammad im Browser unten links auf Ihre Initialen oder Ihr Profilbild und wählen Sie Profil → Token-Zugang (Profile → Token Access).
  2. Klicken Sie auf Erstellen (Create).
  3. Name: etwas, woran Sie erkennen, wo der Token genutzt wird, z. B. Zamio – iPhone.
  4. Berechtigungen: ticket.agent anhaken.
  5. Ablaufdatum: optional. Ohne Ablaufdatum gilt der Token, bis Sie ihn löschen.
  6. Klicken Sie auf Erstellen und kopieren Sie den Token sofort. Zammad zeigt ihn nur ein einziges Mal an.

Tipp: Öffnen Sie Zammad direkt im Browser auf dem Handy und erstellen Sie den Token dort. Dann fügen Sie ihn einfach in die App ein und müssen ihn nicht per E-Mail oder Chat an sich selbst schicken.

Bei Zamio anmelden

  1. Server-URL: die Adresse, unter der Sie Zammad im Browser aufrufen, zum Beispiel https://support.firma.de, ohne etwas nach der Domain.
  2. API-Token: den Token einfügen.

Das war's. Sie bleiben angemeldet, bis Sie sich abmelden oder der Token abläuft bzw. gelöscht wird.

Handy verloren oder Mitarbeiter verlässt das Unternehmen

Löschen Sie den Token in Zammad unter Profil → Token-Zugang. Die App verliert sofort den Zugriff auf Zammad. Konto und Passwort bleiben unverändert.

Fehlerbehebung

„Ungültiger API-Token“
Der Token wurde unvollständig kopiert, ist abgelaufen oder wurde gelöscht. Einen vorhandenen Token können Sie nicht erneut anzeigen. Erstellen Sie also einen neuen und löschen Sie den alten.
Ich sehe „Token-Zugang“ nicht in meinem Profil
Der Administrator hat den API-Token-Zugang nicht aktiviert, oder Ihrer Rolle fehlt user_preferences.access_token. Siehe den Abschnitt für Administratoren oben.
Die App kann keine Verbindung zum Server herstellen
Prüfen Sie die Adresse: https:// am Anfang, kein Pfad nach der Domain und dieselbe Adresse wie im Browser. Ist Zammad nur im Firmennetz oder per VPN erreichbar, muss auch das Handy in diesem Netz sein.
Tickets oder Gruppen fehlen
Die App sieht genau das, was Ihr Zammad-Konto sieht. Fehlt etwas, prüfen Sie Ihre Gruppen und Rollen in Zammad.

Wenn Sie angemeldet sind, ist der nächste Schritt das Einrichten der Push-Benachrichtigungen.