Pular para conteúdo

Conecte Jira REST ao Zeta Test Management

A conexão Jira atual usa a API Jira-REST. Configure e teste a conexão primeiro com uma instância não produtiva ou um projeto de teste destinado a ela. Vote no escopo específico de suporte para sua versão Jira e as operações necessárias antes de sair.

Requisitos e modelo de segurança

  • Um endereço base da instância Jira acessível via HTTPS
  • Um projeto Jira, bem como sua chave de projeto ou ID do projeto
  • Uma conta técnica separada ou um token de acesso pessoal com direitos mínimos exigidos
  • Permissões para ler os metadados necessários e executar as operações pretendidas
  • Um projeto de teste representativo para a aceitação de campos, valores de status, comentários e anexos

Não gravar os tokens reais nas imagens ou documentação. Use os placeholders, limite a validade e direitos e defina um processo para troca e revogação.

Configurar o Jira REST

  1. Nas configurações do projeto, abra a configuração do banco de dados de bugs e selecione Jira.
  2. Ative a conexão e digite o endereço base HTTPS de sua instância Jira, como https://jira.example.org. O conector complementa o caminho REST /rest/api/2/ em si.
  3. Digite a chave do projeto Jira ou o ID do projeto requerido.
  4. Nas configurações avançadas, selecione o modo de autenticação apropriado e teste a conexão.

Jira Cloud: Básico com tokens de API

Selecione Basic, use o endereço de e-mail da conta Atlassian como seu nome de usuário e use um token de API Atlassian como sua senha. Definir Jira-IsCloudJira para true. Uma senha Atlassiana normal não pertence a esta configuração.

Jira Data Center: Carregador com token de acesso pessoal

Selecione Bearer e digite o token de acesso pessoal no campo token de segurança. O conector envia-o como um símbolo portador. Verifique se tokens de acesso pessoal são liberados na sua versão do Data Center e política de segurança.

Cabeçalho HTTP personalizado

Selecione CustomHeader se um gateway de segurança ou ambiente de destino requer seu próprio cabeçalho. Digite o token no campo de token de segurança e configure Jira-AuthHeaderName e Jira-AuthHeaderPrefix conforme necessário. Pegue o nome do cabeçalho e prefixo exatamente a partir da configuração de destino compartilhada.

As configurações técnicas para detecção de modo e nuvem são Jira-AuthMode e Jira-IsCloudJira. Documente a variante escolhida, mas nunca o valor secreto.

Autenticação e depuração

Se uma ligação falhar, verifique nesta ordem:

  1. O endereço de base é correto, acessível via HTTPS e livre de um caminho final REST adicional?
  2. O Jira-AuthMode corresponde aos campos preenchidos e ao Jira Cloud ou Data Center?
  3. A API ou token de acesso é válida, não expirada e não revogada?
  4. A conta pode ler o projeto alvo e seus metadados, bem como realizar as operações pretendidas?
  5. Chaves de projeto ou ID do projeto, tipos de problema, campos obrigatórios e valores de status votam?
  6. A posição de confiança proxy, firewall, DNS e TLS permite a conexão?
  7. Os protocolos Zeta Test Management e Jira contêm um status ou mensagem de erro utilizável?

Não alterar múltiplos parâmetros simultaneamente. Hora do documento, endereço de destino sem segredos, modo de autenticação, estado HTTP e operação afetada. Substituir os tokens comprometidos imediatamente.

Atribuir campos para novos Jira-Issues

Organize os dados coletados no Zeta Test Management para os campos do tipo de problema Jira pretendido. Verifique pelo menos resumo, descrição, tipo de problema, prioridade e todos os campos personalizados necessários em Jira. A configuração da nuvem também pode influenciar como os valores do usuário são resolvidos.

Carregar listas de seleção e meta-dados de campo com a conta técnica pretendida e, em seguida, criar um processo de teste. Verifique o resultado diretamente em Jira. Use apenas atribuições de campo que possam ser comprovadas para suportar o conector e a configuração específica do alvo; em particular, comentários, anexos e campos personalizados devem ser removidos separadamente.