Installer Tiqo en 5 minutes

1. 1

   Créer votre compte

   Ouvrez la page de connexion, saisissez votre adresse e-mail professionnelle et cliquez sur le lien de connexion reçu par e-mail. Pas de mot de passe, pas de carte bancaire : l'essai de 14 jours démarre à la création de l'espace.

2. 2

   Créer l'espace de travail

   L'assistant d'installation vous demande le nom de votre organisation ou de votre service informatique, par exemple « Mairie de Villeneuve — DSI ». Il reste modifiable dans les paramètres.

3. 3

   Copier la clé API et le secret HMAC

   L'assistant affiche l'URL de l'API, la clé API (tiqo_live_…) et le secret HMAC. Copiez-les dans votre gestionnaire de mots de passe.

   Affichés une seule fois

   La clé et le secret ne seront plus jamais affichés. En cas de perte, régénérez-les depuis Paramètres > Clé API : l'ancienne clé cesse aussitôt de fonctionner et le plugin doit recevoir la nouvelle paire.
4. 4

   Télécharger le plugin

   Téléchargez tiqo-glpi-plugin-1.0.0.zip (version 1.0.0, pour GLPI 10, 11 et 12 : la même archive pour les trois). Le plugin est gratuit et libre (GPL-3.0-or-later) : son code source complet est inclus dans l'archive. Son dépôt public est github.com/Tiqo-app/tiqo-glpi-plugin : il est encore vide ; la première version y sera publiée prochainement. Chaque version y sera ensuite aussi proposée sur la page Releases du dépôt, avec la même archive et la même empreinte. La fiche dans le catalogue des plugins GLPI suivra. Pour vérifier le téléchargement, récupérez aussi son empreinte tiqo-glpi-plugin-1.0.0.zip.sha256, à placer à côté de l'archive :

   bash

   sha256sum -c tiqo-glpi-plugin-1.0.0.zip.sha256   # tiqo-glpi-plugin-1.0.0.zip: OK

5. 5

   Décompresser dans plugins/tiqo

   Sur le serveur GLPI, décompressez l'archive dans le dossier plugins de GLPI, pour obtenir plugins/tiqo. Si vous utilisez plutôt le dossier marketplace, décompressez-la dans ce dossier, pour obtenir marketplace/tiqo. Par défaut, ce dossier est <racine de GLPI>/marketplace, à côté de plugins, sur GLPI 10, 11 et 12 ; si votre installation définit GLPI_MARKETPLACE_DIR (variable d'environnement ou config/local_define.php), utilisez ce dossier. Dans tous les cas, le dossier du plugin doit s'appeler exactement tiqo, comme le dossier contenu dans l'archive : ne le renommez pas.

   bash

   cd /var/www/glpi/plugins          # adaptez au chemin de votre GLPI
   unzip /tmp/tiqo-glpi-plugin-1.0.0.zip   # l'archive téléchargée à l'étape 4
   ls tiqo/setup.php                   # ce fichier doit exister
   chown -R www-data:www-data tiqo     # utilisateur du serveur web (Debian, Ubuntu)

   Image Docker officielle de GLPI

   Seul /var/glpi est un volume : les fichiers décompressés dans /var/www/glpi/plugins sont perdus quand le conteneur est recréé, par exemple lors d'une mise à jour de l'image. Sur GLPI 11 et 12, décompressez l'archive dans /var/glpi/marketplace (l'image y fait pointer GLPI_MARKETPLACE_DIR), qui se trouve sur le volume. Sur GLPI 10, montez un dossier de l'hôte sur /var/www/glpi/plugins/tiqo, ou décompressez de nouveau le plugin après chaque mise à jour de l'image.
6. 6

   Installer et activer le plugin

   Dans GLPI, ouvrez Configuration > Plugins, repérez Tiqo, cliquez sur Installer puis sur Activer. En ligne de commande, sous l'utilisateur du serveur web (remplacez glpi par un compte administrateur ; les mêmes commandes sur GLPI 10, 11 et 12) :

   bash

   cd /var/www/glpi
   sudo -u www-data php bin/console plugin:install tiqo --username=glpi
   sudo -u www-data php bin/console plugin:activate tiqo

   Mise à jour depuis une version précédente de Tiqo

   Remplacez le dossier tiqo par celui de la nouvelle archive, puis, dans Configuration > Plugins, cliquez sur Mettre à jour puis sur Activer. La configuration, la clé et les analyses déjà faites sont conservées. Les nouvelles options (base de connaissances, solutions à la clôture) restent désactivées tant que vous ne les activez pas.

   Après une mise à jour majeure de GLPI lui-même

   Lors d'un changement de version majeure de GLPI (10.0 → 11.0, 11.0 → 12.0), GLPI 11 et 12 suspendent tous les plugins, Tiqo compris, jusqu'à ce qu'un administrateur les relance : plus de suivi [Tiqo] ni de panneau d'ici là. Une fois la mise à jour de la base de GLPI terminée, ouvrez Configuration > Plugins et cliquez sur Reprendre l’exécution de tous les plugins actifs, ou lancez, sous l'utilisateur du serveur web :

   bash

   cd /var/www/glpi
   sudo -u www-data php bin/console db:update                # mise à jour de la base de GLPI, si ce n'est pas fait
   sudo -u www-data php bin/console plugin:resume_execution  # reprend l'exécution des plugins actifs

   Tiqo reste installé et activé : il ne demande ni mise à jour ni conversion de données, sauf si son dossier tiqo a aussi été remplacé. Une mise à jour corrective dans la même branche (11.0.x → 11.0.y) relance les plugins d'elle-même.
7. 7

   Coller l'URL, la clé et le secret

   Ouvrez Configuration > Plugins > Tiqo (cliquez sur le nom du plugin). Dans Connexion à l'API Tiqo, collez l'URL de l'API, la clé API et le secret HMAC copiés à l'étape 3, puis cliquez sur Enregistrer. L'URL doit commencer par https://. Les secrets sont chiffrés avec la clé de GLPI et ne sont plus jamais réaffichés ; laissez un champ vide pour conserver la valeur enregistrée. Sur GLPI 12, GLPI vous redemande d'abord votre mot de passe avant d'ouvrir cette page, comme pour Configuration > Générale.

   

8. 8

   Tester la connexion

   Cliquez sur Tester la connexion. Le plugin enregistre le formulaire puis appelle l'API : vous voyez le nom de votre espace, votre offre, les tickets analysés ce mois-ci et au total, et la date de fin d'essai. Dans l'application Tiqo, la dernière étape de l'assistant affiche aussi l'instance GLPI dès son premier appel.

9. 9

   Créer un ticket de test

   Créez un ticket, par exemple « Impossible de me connecter au Wi-Fi ». Dans les secondes qui suivent, un suivi privé [Tiqo] apparaît dans la chronologie et le panneau Tiqo s'affiche dans la fiche du ticket (rechargez la page si elle était déjà ouverte). Rien n'est envoyé au demandeur.

   

Chaque erreur est écrite dans files/_log/tiqo.log sur le serveur GLPI, sans contenu de ticket ni secret. La page du plugin affiche le même message que le journal.