Inloggen bij Zammad met een API-token

Geschreven door Michał, de ontwikkelaar van Zamio · Bijgewerkt:

Zamio logt in bij Zammad met een persoonlijk API-token in plaats van een wachtwoord. U voert het één keer in en hoeft daarna niet meer aan inloggen te denken. Op deze pagina leest u wat de beheerder moet inschakelen en wat elke agent doet.

Waarom een token en geen wachtwoord

Ik heb voor tokens gekozen vanwege de veiligheid, en omdat het op een telefoon het meest praktisch is:

  • Uw wachtwoord komt nooit in de app. Het werkt ook als u bij Zammad inlogt via SSO of tweestapsverificatie gebruikt.
  • Beperkte machtigingen. Het token krijgt alleen ticket.agent, en dat is genoeg voor alles wat de app doet.
  • U kunt het altijd intrekken in Zammad zonder uw wachtwoord te wijzigen, bijvoorbeeld als u uw telefoon kwijtraakt.
  • Het blijft op het apparaat. Het token wordt bewaard in de iOS-sleutelhanger (Keychain) of de Android Keystore. Het wordt niet in een cloud opgeslagen. De app maakt rechtstreeks verbinding van uw telefoon met de Zammad van uw bedrijf.

Voor beheerders: token-toegang toestaan

  1. Open in Zammad de beheerinstellingen (tandwielpictogram) en ga naar Instellingen → Systeem → API.
  2. Schakel API-token-toegang (API Token Access) in.

Ziet een agent Token-toegang nog steeds niet in zijn profiel, controleer dan of zijn rol de machtiging user_preferences.access_token heeft (Beheren → Rollen).

Voor agents: een token aanmaken

  1. Klik in Zammad in de browser linksonder op uw initialen of avatar en kies Profiel → Token-toegang (Profile → Token Access).
  2. Klik op Aanmaken (Create).
  3. Naam: iets waaraan u ziet waar het gebruikt wordt, bijv. Zamio – iPhone.
  4. Machtigingen: vink ticket.agent aan.
  5. Vervaldatum: optioneel. Zonder vervaldatum werkt het token tot u het verwijdert.
  6. Klik op Aanmaken en kopieer het token meteen. Zammad toont het maar één keer.

Tip: open Zammad in de browser op de telefoon zelf en maak daar het token aan. Dan plakt u het gewoon in de app en hoeft u het niet naar uzelf te mailen of via een chat te sturen.

Inloggen in Zamio

  1. Server-URL: het adres waarmee u Zammad in de browser opent, bijvoorbeeld https://support.bedrijf.nl, zonder iets na het domein.
  2. API-token: plak het token.

Dat is alles. U blijft ingelogd tot u uitlogt, of tot het token verloopt of wordt verwijderd.

Telefoon kwijt of medewerker vertrekt

Verwijder het token in Zammad onder Profiel → Token-toegang. De app verliest direct de toegang tot Zammad. Account en wachtwoord blijven ongewijzigd.

Problemen oplossen

“Ongeldig API-token”
Het token is niet volledig gekopieerd, is verlopen of is verwijderd. Een bestaand token kunt u niet opnieuw bekijken, dus maak een nieuw aan en verwijder het oude.
Ik zie “Token-toegang” niet in mijn profiel
De beheerder heeft API-token-toegang niet ingeschakeld, of uw rol mist user_preferences.access_token. Zie het gedeelte voor beheerders hierboven.
De app kan geen verbinding maken met de server
Controleer het adres: https:// aan het begin, geen pad na het domein, en hetzelfde adres als in de browser. Is Zammad alleen bereikbaar op het bedrijfsnetwerk of via VPN, dan moet de telefoon ook op dat netwerk zitten.
Er ontbreken tickets of groepen
De app ziet precies wat uw Zammad-account ziet. Ontbreekt er iets, controleer dan uw groepen en rollen in Zammad.

Bent u ingelogd, dan is de volgende stap pushmeldingen instellen.