Aller au contenu

Connectez Jira REST à Zeta Test Management

La connexion Jira actuelle utilise l'API Jira-REST. Configurer et tester la connexion d'abord avec une instance non productive ou un projet d'essai destiné à elle. Votez pour la portée de support spécifique de votre version Jira et les opérations requises avant de lancer.

Exigences et modèle de sécurité

  • Une adresse de base de l'instance Jira accessible via HTTPS
  • Un projet Jira ainsi que sa clé de projet ou son ID de projet
  • Un compte technique distinct ou un jeton d'accès personnel avec des droits minimum requis
  • Autorisation de lire les métadonnées requises et d'exécuter les opérations prévues
  • Un projet d'essai représentatif pour l'acceptation des champs, valeurs de statut, commentaires et pièces jointes

Ne pas enregistrer de vrais jetons dans des captures d'écran ou de la documentation. Utiliser les détenteurs de place, limiter la validité et les droits et établir un processus d'échange et de révocation.

Configurer Jira REST

  1. Dans les paramètres du projet, ouvrez la configuration de la base de données de bogues et sélectionnez Jira.
  2. Activez la connexion et entrez l'adresse de base HTTPS de votre instance Jira, comme https://jira.example.org. Le connecteur complète le chemin REST /rest/api/2/ lui-même.
  3. Saisissez la clé de projet Jira ou l'ID de projet requis.
  4. Dans les paramètres avancés, sélectionnez le mode d'authentification approprié et testez la connexion.

Jira Cloud: Basic avec des jetons API

Sélectionnez Basic, utilisez l'adresse e-mail du compte Atlassian comme nom d'utilisateur et utilisez un jeton API Atlassian comme mot de passe. Réglez Jira-IsCloudJira sur true. Un mot de passe normal Atlassian n'appartient pas à cette configuration.

Centre de données Jira: porteur avec jeton d'accès personnel

Sélectionnez Bearer et entrez le jeton d'accès personnel dans le champ de jeton de sécurité. Le connecteur l'envoie comme jeton porteur. Vérifiez que les jetons d'accès personnels sont publiés dans votre version Data Center et dans votre politique de sécurité.

En-tête HTTP personnalisé

Sélectionnez CustomHeader si une passerelle de sécurité en amont ou un environnement cible nécessite votre propre en-tête. Saisissez le jeton dans le champ de jeton de sécurité et configurez Jira-AuthHeaderName et Jira-AuthHeaderPrefix au besoin. Prenez le nom de l'en-tête et préfixez exactement à partir de la configuration de la cible partagée.

Les paramètres techniques pour la détection en mode et en nuage sont Jira-AuthMode et Jira-IsCloudJira. Documenter la variante choisie, mais jamais la valeur secrète.

authentification et débogage

Si une connexion échoue, vérifiez dans cet ordre :

  1. L'adresse de base est-elle correcte, accessible via HTTPS et libre d'un chemin de fin REST supplémentaire ?
  2. Jira-AuthMode correspond-il aux champs remplis et Jira Cloud ou Data Center ?
  3. L'API ou le jeton d'accès est-il valide, n'est-il pas expiré et n'est-il pas révoqué?
  4. Le compte peut-il lire le projet cible et ses métadonnées ainsi que réaliser les opérations prévues?
  5. Les clés du projet ou l'ID du projet, les types d'émission, les champs obligatoires et les valeurs de statut votent-ils?
  6. La position de confiance proxy, pare-feu, DNS et TLS permet-elle la connexion ?
  7. Les protocoles Zeta Test Management et Jira contiennent-ils un message d'état ou d'erreur utilisable?

Ne pas modifier simultanément plusieurs paramètres. Heure du document, adresse de destination sans secrets, mode d'authentification, statut HTTP et opération affectée. Remplacez immédiatement les jetons compromis.

Attribuer des champs pour les nouveaux Jira-Issues

Disposer les données recueillies dans Zeta Test Management sur les champs du type Jira Issue prévu. Vérifiez au moins le résumé, la description, le type d'émission, la priorité et tous les champs personnalisés requis dans Jira. Le réglage du cloud peut également influencer la façon dont les valeurs utilisateur sont résolues.

Charger les listes de sélection et les métadonnées de champ avec le compte technique prévu, puis créer un processus d'essai. Vérifiez le résultat directement dans Jira. N'utilisez que les assignations de champs qui peuvent être prouvées pour supporter le connecteur et la configuration cible spécifique; en particulier les commentaires, les pièces jointes et les champs personnalisés doivent être supprimés séparément.