Relier Klepsi à Jira

Un administrateur de l'organisation Atlassian ouvre admin.atlassian.com, puis Annuaire et Comptes de service. Cliquez sur Créer un compte de service et nommez-le Klepsi.

Un compte de service n'est rattaché à personne. Il survit aux départs, et ses droits se lisent d'un coup d'œil.

L'assistant demande ensuite un rôle par application :

• Jira Service Management : Utilisateur (agent). Ce rôle est nécessaire pour lire les tickets. Un client du portail ne voit que ses propres demandes.
• Customer Service Management, Assets, Studio et Jira Administration : Aucun.

Laissez le champ Groupes vide, puis cliquez sur Créer.

Le rôle d'agent ne suffit pas : le compte doit être membre de chaque projet dont Klepsi doit lire les tickets. Dans Jira, ouvrez le projet, puis Paramètres du projet et Personnes (Accès sur un projet géré par l'équipe).

Cliquez sur Ajouter des personnes, cherchez Klepsi ou collez son adresse, choisissez le rôle Service Desk Team (Agent sur un projet géré par l'équipe) et validez avec Ajouter 1 personne. Recommencez pour chaque projet.

Revenez sur la fiche du compte Klepsi dans admin.atlassian.com et cliquez sur Créer des identifiants. Choisissez Jeton d'API, pas OAuth 2.0.

Nommez le jeton Klepsi et prenez l'expiration la plus longue proposée, un an aujourd'hui. Notez la date dans votre agenda : passé ce jour, Klepsi ne lit plus rien.

Relevez au passage l'adresse affichée sous E-mail, en @serviceaccount.atlassian.com. Elle servira dans Klepsi.

Choisissez l'application Jira et cochez deux portées classiques : read:jira-user et read:jira-work. Rien d'autre.

Ne cochez pas read:servicedesk-request : elle ouvre l'API Service Desk, que Klepsi n'utilise pas.

Si seules des portées granulaires sont proposées, prenez read:jira-user, read:issue-details:jira, read:jql:jira et read:project:jira.

L'écran de vérification reprend le nom, l'échéance et les portées. Créez le jeton.

Il ne s'affiche qu'une seule fois. Collez-le dans Klepsi (étape 8) et rangez-le dans votre coffre de mots de passe. S'il est perdu, il ne se retrouve pas : on en crée un autre.

Un jeton de compte de service ne fonctionne pas sur l'adresse habituelle du site. Il passe par la passerelle d'Atlassian, qui a besoin de l'identifiant du site, le cloudId.

Ouvrez cette adresse dans un navigateur, en remplaçant societe par le nom de votre site :

Dans Klepsi, ouvrez Paramètres, onglet Intégrations, puis Ajouter une connexion :

• Libellé : un nom pour vous, par exemple « JSM Société ». Le texte grisé n'est qu'un exemple, le champ est vide.
• Outil : Jira / Jira Service Management.
• URL du site : https://societe.atlassian.net. Elle sert à construire les liens vers les tickets.
• URL de l'API : https://api.atlassian.com/ex/jira/<cloudId>. Obligatoire avec un jeton de compte de service : l'URL du site le refuse.
• Adresse du compte : l'adresse en @serviceaccount.atlassian.com relevée à l'étape 4.
• Jeton d'API : le jeton copié à l'étape 6.

Cliquez sur Enregistrer, puis sur Tester la connexion. Klepsi affiche le nom du compte qu'il a reconnu.

Ouvrez ensuite la fiche de chaque projet Klepsi concerné. Dans le bloc Tickets, choisissez la Connexion et indiquez les Clés de projets Jira. L'Organisation JSM et le Complément JQL sont facultatifs, pour ne garder que les demandes d'un client.

Faites un essai à la saisie : le champ Ticket doit proposer des tickets dès les premières lettres.