Se connecter à Zammad avec un token API

Rédigé par Michał, le développeur de Zamio · Mis à jour:

Zamio se connecte à Zammad avec un token API personnel plutôt qu'avec un mot de passe. Vous le saisissez une fois et vous n'avez plus à penser à la connexion. Cette page explique ce que l'administrateur doit activer et ce que fait chaque agent.

Pourquoi un token et pas un mot de passe

J'ai choisi les tokens pour la sécurité, et parce que c'est l'option la plus pratique sur un téléphone :

  • Votre mot de passe ne passe jamais par l'application. Cela fonctionne aussi si vous vous connectez à Zammad via SSO ou avec l'authentification à deux facteurs.
  • Des permissions limitées. Le token reçoit uniquement ticket.agent, ce qui suffit pour tout ce que fait l'application.
  • Vous pouvez le révoquer à tout moment dans Zammad sans changer votre mot de passe, par exemple si vous perdez votre téléphone.
  • Il reste sur l'appareil. Le token est conservé dans le trousseau iOS (Keychain) ou dans l'Android Keystore. Il n'est stocké dans aucun cloud. L'application se connecte directement de votre téléphone au Zammad de votre entreprise.

Pour les administrateurs : autoriser l'accès par token

  1. Dans Zammad, ouvrez les paramètres d'administration (icône d'engrenage) et allez dans Paramètres → Système → API.
  2. Activez l'accès par token API (API Token Access).

Si un agent ne voit toujours pas Accès par token dans son profil, vérifiez que son rôle dispose de la permission user_preferences.access_token (Gérer → Rôles).

Pour les agents : créer un token

  1. Dans Zammad, dans le navigateur, cliquez sur vos initiales ou votre avatar en bas à gauche et choisissez Profil → Accès par token (Token Access).
  2. Cliquez sur Créer.
  3. Nom : quelque chose qui indique où il sert, par exemple Zamio – iPhone.
  4. Permissions : cochez ticket.agent.
  5. Date d'expiration : facultative. Sans elle, le token fonctionne jusqu'à ce que vous le supprimiez.
  6. Cliquez sur Créer et copiez le token tout de suite. Zammad ne l'affiche qu'une seule fois.

Astuce : ouvrez Zammad dans le navigateur du téléphone lui-même et créez le token là. Il ne vous reste plus qu'à le coller dans l'application, sans devoir vous l'envoyer par e-mail ou par messagerie.

Se connecter à Zamio

  1. URL du serveur : l'adresse que vous utilisez pour Zammad dans le navigateur, par exemple https://support.entreprise.fr, sans rien après le domaine.
  2. Token API : collez le token.

C'est tout. Vous restez connecté jusqu'à ce que vous vous déconnectiez, ou que le token expire ou soit supprimé.

Téléphone perdu ou départ d'un employé

Supprimez le token dans Zammad, sous Profil → Accès par token. L'application perd immédiatement l'accès à Zammad. Le compte et le mot de passe ne changent pas.

Dépannage

« Token API invalide »
Le token a été copié en partie, a expiré ou a été supprimé. Un token existant ne peut pas être affiché à nouveau : créez-en un nouveau et supprimez l'ancien.
Je ne vois pas « Accès par token » dans mon profil
L'administrateur n'a pas activé l'accès par token API, ou votre rôle n'a pas user_preferences.access_token. Voir la section pour les administrateurs ci-dessus.
L'application n'arrive pas à se connecter au serveur
Vérifiez l'adresse : https:// au début, aucun chemin après le domaine, et la même adresse que dans le navigateur. Si Zammad n'est accessible que sur le réseau de l'entreprise ou via VPN, le téléphone doit aussi être sur ce réseau.
Des tickets ou des groupes manquent
L'application voit exactement ce que voit votre compte Zammad. S'il manque quelque chose, vérifiez vos groupes et vos rôles dans Zammad.

Une fois connecté, l'étape suivante est la configuration des notifications push.