Aller au contenu principal
Retour au catalogue des connecteurs

Connecteur

Jira

Intégration sortante de ticketing : Vigicap y dépose des tickets.

Vos actions partent dans Jira sous forme de tickets, dans le projet que vous indiquez pour chaque client, avec leur titre et leur description. Le statut du ticket est ensuite relu : une fois le ticket terminé dans Jira, Vigicap propose la clôture de l'action et ne la clôture jamais seul. Aucun niveau ReCyF n'est proposé. Pousser un ticket ne mesure pas la posture d'un client.

01

Ce qu'il faut créer dans l'outil

L'accès se crée dans Jira, pas dans Vigicap.

Où le générer

Compte Atlassian → Sécurité → Jetons d'API. Les deux types fonctionnent : un jeton sans portées, ou un jeton à portées avec read:jira-user, read:me, read:jira-work et write:jira-work (aucune portée manage:). Un jeton à portées n'étant accepté que sur api.atlassian.com, Vigicap bascule automatiquement sur cette adresse si votre site refuse l'authentification. Limitez le compte côté Jira aux projets concernés (Parcourir les projets + Créer des tickets). L'URL du site est https://votre-site.atlassian.net. La clé de projet est le préfixe de ses tickets (ex. OPS dans OPS-123).

Rôle minimal

Jeton d'API Atlassian d'un compte applicatif, porté ou non. PORTÉES, si le jeton en a : read:jira-user et read:me (test de connexion via /myself), read:jira-work (lecture du projet et relecture du ticket), write:jira-work (création) — aucune portée manage:, qui donnerait l'administration des projets et des workflows. Un jeton porté n'étant accepté que sur api.atlassian.com, les appels y basculent automatiquement ; l'adresse du site reste celle des liens remis au consultant. ÉCRITURE : le jeton porte les droits du compte qui l'a créé — Jira ne cloisonne pas un jeton par projet, donc le compte doit être limité côté Jira aux projets concernés (Browse projects + Create issues) plutôt que le jeton côté Vigicap. LECTURE : le même jeton relit l'issue ; aucune portée distincte n'existe, ce qui est précisément pourquoi la phrase précédente est écrite telle quelle.

Formulation reprise du modèle de rôles de l'éditeur, et vérifiée avant publication.

02

Ce qu'il faut saisir dans Vigicap

  • Adresse du compte Atlassian
  • Jeton d'APIsecret

03

Le routage par client

Ces champs-ci se renseignent client par client : ils disent sous quel compte de l'outil de ticketing le ticket doit atterrir. Une valeur erronée ne fait pas échouer l'envoi — elle le fait réussir chez quelqu'un d'autre, ce pour quoi Vigicap les vérifie au moment où vous les saisissez.

  • Clé de projet

    Projet dans lequel les tickets sont créés — le préfixe de ses références.

    ex. OPS

  • Type de ticketfacultatif

    Par défaut Task. Doit exister dans le schéma de types du projet.

    Task

04

Ce qu'il fait, et ce qu'il ne fait pas

Objectifs ReCyF pré-remplis

Ce connecteur n'alimente aucun objectif ReCyF, et ce n'est pas une lacune : il ne mesure pas la posture d'un client.

Ce qui part vers l'outil

Ce connecteur ÉCRIT : il crée un ticket à partir d'une action du plan.

Ce qui en revient

L'état d'un ticket déjà créé revient : son statut, sa date de clôture, sa dernière activité. Un ticket clos devient une PROPOSITION qu'un consultant valide — jamais une action clôturée d'office. Une agence qui clôt son propre ticket ne doit pas pouvoir se noter elle-même dans le document que lit un auditeur.

Comment Vigicap traite vos accès.

Vérification

Ce connecteur a été exécuté de bout en bout contre une instance réelle de l'outil, pas seulement testé contre une simulation.