Logowanie do Zammad tokenem API

Autor: Michał, twórca Zamio · Aktualizacja:

Zamio loguje się do Zammad osobistym tokenem API, a nie hasłem. Wpisujesz go raz i przestajesz myśleć o logowaniu. Na tej stronie opisuję, co musi włączyć administrator, a co robi każdy agent.

Dlaczego token, a nie hasło

Wybrałem token ze względów bezpieczeństwa i dlatego, że na telefonie to najwygodniejsze rozwiązanie:

  • Hasło nigdy nie trafia do aplikacji. Działa to też wtedy, gdy logujesz się do Zammad przez SSO albo masz włączone logowanie dwuetapowe.
  • Ograniczone uprawnienia. Token dostaje tylko ticket.agent i to wystarcza do wszystkiego, co robi aplikacja.
  • Możesz go w każdej chwili unieważnić w Zammad bez zmiany hasła, np. gdy zgubisz telefon.
  • Zostaje na urządzeniu. Token jest przechowywany w pęku kluczy iOS albo w Android Keystore. Nie trafia do żadnej chmury. Aplikacja łączy się bezpośrednio z telefonu z Zammad Twojej firmy.

Dla administratora: włącz dostęp przez token

  1. W Zammad otwórz ustawienia administracyjne (ikona koła zębatego) i przejdź do Ustawienia → System → API.
  2. Włącz dostęp przez token API (API Token Access).

Jeśli agent dalej nie widzi w profilu pozycji Dostęp tokenem, sprawdź, czy jego rola ma uprawnienie user_preferences.access_token (Zarządzaj → Role).

Dla agenta: utwórz token

  1. W Zammad w przeglądarce kliknij swoje inicjały lub awatar w lewym dolnym rogu i wybierz Profil → Dostęp tokenem.
  2. Kliknij Utwórz.
  3. Nazwa: coś, co powie Ci, gdzie token jest używany, np. Zamio – iPhone.
  4. Uprawnienia: zaznacz ticket.agent.
  5. Data wygaśnięcia: opcjonalna. Bez niej token działa, dopóki go nie usuniesz.
  6. Kliknij Utwórz i od razu skopiuj token. Zammad pokazuje go tylko raz.

Wskazówka: otwórz Zammad w przeglądarce na samym telefonie i tam utwórz token. Wtedy tylko wklejasz go do aplikacji i nie musisz wysyłać go sobie mailem ani komunikatorem.

Zaloguj się w Zamio

  1. Adres serwera: adres, pod którym otwierasz Zammad w przeglądarce, np. https://helpdesk.firma.pl, bez niczego po domenie.
  2. Token API: wklej token.

Gotowe. Zostajesz zalogowany, dopóki się nie wylogujesz albo token nie wygaśnie lub nie zostanie usunięty.

Zgubiony telefon albo odejście pracownika

Usuń token w Zammad w Profil → Dostęp tokenem. Aplikacja od razu traci dostęp do Zammad. Konto i hasło zostają bez zmian.

Rozwiązywanie problemów

„Nieprawidłowy token API”
Token został skopiowany niecały, wygasł albo został usunięty. Istniejącego tokenu nie da się podejrzeć, więc utwórz nowy, a stary usuń.
Nie widzę „Dostęp tokenem” w profilu
Administrator nie włączył dostępu przez token API albo Twoja rola nie ma uprawnienia user_preferences.access_token. Zobacz sekcję dla administratora powyżej.
Aplikacja nie może połączyć się z serwerem
Sprawdź adres: https:// na początku, brak ścieżki po domenie i ten sam adres co w przeglądarce. Jeśli Zammad jest dostępny tylko w sieci firmowej albo przez VPN, telefon też musi być w tej sieci.
Brakuje ticketów albo grup
Aplikacja widzi dokładnie to, co widzi Twoje konto w Zammad. Jeśli czegoś brakuje, sprawdź swoje grupy i role w Zammad.

Po zalogowaniu następny krok to konfiguracja powiadomień push.