Jira Automation
Créez des tickets Jira à partir des alertes et des résumés cside avec une destination webhook et une règle Jira Automation déclenchée par un webhook entrant, quel que soit votre plan.
Vous pouvez transformer n’importe quelle notification cside en ticket Jira en pointant une destination webhook vers une règle Jira Automation. Cela fonctionne avec tous les plans, et c’est ainsi que vous pouvez envoyer dans Jira des résumés comme PCI Report Available et Script Blocked by CSP, puisque l’intégration Jira ne livre pas les résumés.
Jira Automation attend son secret dans un en-tête X-Automation-Webhook-Token. Les webhooks cside ne pouvant pas envoyer d’en-têtes personnalisés, ajoutez plutôt le secret à la fin de l’URL du webhook, comme le documente Atlassian pour les expéditeurs qui ne peuvent pas en envoyer. Sans lui, Jira rejette chaque requête avec une erreur HTTP 400.
Jira Automation ou l’intégration Jira ?
L’intégration Jira connecte cside à Jira via OAuth et crée un ticket par alerte, avec un tableau de détails et un lien vers le tableau de bord. Elle est incluse dans le plan Enterprise et ne gère que les déclencheurs immédiats.
Une règle Jira Automation alimentée par un webhook fonctionne avec tous les plans et pour tous les déclencheurs, y compris les résumés. C’est vous qui décidez dans Jira à quoi ressemble le ticket.
Ce dont vous aurez besoin
- L’autorisation de créer des règles d’automatisation dans votre projet Jira
- Une notification config cside pour les alertes que vous voulez recevoir dans Jira
Créer la règle dans Jira
Ajouter un déclencheur webhook entrant
Dans votre projet Jira, ouvrez Project settings > Automation et créez une règle. Choisissez le déclencheur Incoming webhook et réglez Execute this rule with sur No work items from the webhook (certains sites Jira l’appellent encore No issues from the webhook).
Créer le ticket
Ajoutez une action Create work item et choisissez le projet et le type de ticket. Renseignez les champs à partir du payload cside :
- Summary :
{{webhookData.summary}} - Description :
{{webhookData.description}}
Ne renseignez que les champs présents sur l’écran de création du projet. Jira ignore les autres et les signale dans le journal d’audit.
Activer la règle et copier l’URL et le secret
Enregistrez et activez la règle. Le déclencheur affiche alors une URL de webhook et un secret. Copiez les deux.
Ajouter la destination webhook dans cside
Construire l’URL
Ajoutez une barre oblique et le secret à la fin de l’URL du webhook :
https://api-private.atlassian.com/automation/webhooks/jira/a/<id>/<id>/<secret>Ajouter la destination
Ouvrez le tableau de bord et naviguez vers Team Settings > Notifications. Modifiez la notification config, cliquez sur Add destination sous Send To, sélectionnez Webhook et remplissez :
- URL : l’URL de l’étape précédente
- Secret : n’importe quelle valeur. cside l’utilise pour signer la requête avec un en-tête
x-cside-signature, que Jira ne vérifie pas - Format : JSON
Cliquez sur Save & Test.
Confirmez que ça fonctionne
Save & Test envoie un exemple de payload. Pour la plupart des déclencheurs, son summary commence par [Test]. Ouvrez l’Audit log de la règle dans Jira : vous devriez y voir une nouvelle exécution et un ticket créé.
Jira répond par un code HTTP 200 même lorsque le secret est incorrect, donc un test réussi dans cside ne prouve pas que la règle s’est exécutée. C’est le journal d’audit qui le confirme.
| Ce que vous voyez | Ce que cela signifie |
|---|---|
| Le test cside échoue avec HTTP 400 | Le secret manque dans l’URL. Jira répond Missing token |
| Le test cside échoue avec HTTP 404 | L’URL est incorrecte, ou la règle a été supprimée |
| Le test cside réussit, mais le journal d’audit n’affiche aucune exécution | Le secret dans l’URL est incorrect. Copiez-le à nouveau depuis le déclencheur |
| Journal d’audit : Summary is required | Le champ Summary s’est résolu en une valeur vide. Utilisez {{webhookData.summary}} |
| Journal d’audit : Fields ignored | Un champ de l’action n’est pas sur l’écran de création, ou l’utilisateur d’automatisation n’a pas l’autorisation de le renseigner. Retirez le champ de l’action |
Mapper d’autres champs
Chaque webhook JSON cside contient summary et description à la fois au premier niveau et dans son objet data, car Jira Automation traite de façon particulière une clé data de premier niveau. C’est pourquoi {{webhookData.summary}} fonctionne pour chaque événement. Les autres champs varient selon l’événement ; consultez la référence du payload.
Pour mapper d’autres champs, ajoutez une Log action avec {{webhookData}} avant Create work item, envoyez un test et lisez le journal d’audit pour voir exactement ce que Jira a reçu. Référencez les champs tels qu’ils y apparaissent.
Protéger le secret
Le secret fait désormais partie de l’URL de la destination, donc toute personne qui peut consulter ou modifier vos paramètres de notification peut le lire. S’il fuite, générez un nouveau secret sur le déclencheur Jira et mettez à jour l’URL dans cside.
Ce que cela ne fait pas encore
- cside ne peut pas envoyer l’en-tête
X-Automation-Webhook-Token, qu’Atlassian recommande plutôt que le secret dans l’URL - cside ne relance pas un webhook de résumé que Jira rejette, et l’historique des livraisons n’est pas affiché dans le tableau de bord. Utilisez Save & Test et le journal d’audit Jira pour confirmer la configuration
Étapes suivantes
Thanks for your feedback!