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¶
- Nas configurações do projeto, abra a configuração do banco de dados de bugs e selecione Jira.
- 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. - Digite a chave do projeto Jira ou o ID do projeto requerido.
- 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:
- O endereço de base é correto, acessível via HTTPS e livre de um caminho final REST adicional?
- O
Jira-AuthModecorresponde aos campos preenchidos e ao Jira Cloud ou Data Center? - A API ou token de acesso é válida, não expirada e não revogada?
- A conta pode ler o projeto alvo e seus metadados, bem como realizar as operações pretendidas?
- Chaves de projeto ou ID do projeto, tipos de problema, campos obrigatórios e valores de status votam?
- A posição de confiança proxy, firewall, DNS e TLS permite a conexão?
- 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.