Introdução à Integração com o Jira

This page is not available in the language you requested. You have been redirected to the English version of the page.

Link to this page copied to clipboard

Not for use with personal data

Configurar a Integração com o Jira é rápido e fácil. Este documento irá guiá-lo através da configuração necessária para permitir que toda a sua organização utilize essa poderosa integração.

Conectando ao Jira Cloud

Para começar, uma conexão autenticada com a sua instância do Jira deve ser estabelecida por um Administrador do Portal de Contas axe. Essa conexão será usada por toda a sua organização, por isso é importante que o usuário que estabeleça a conexão tenha acesso a todos os projetos para os quais você deseja enviar issues.

Navegue até a página "CONFIGURAÇÃO" dentro do Portal de Contas axe
Clique no link "Integrações" dentro da navegação "Configuração"
Clique no botão "Adicionar nova conexão ao Jira Cloud"
Uma nova janela pop-up (consentimento OAuth) será aberta na qual será solicitado que você faça login (se você já tiver uma sessão ativa no Jira, essa etapa será pulada)
Uma vez autenticado no Jira, será solicitado que você escolha uma instância do Jira para conectar na lista de seleção "Usar aplicativo em"
Clique em "Aceitar" depois de escolher uma instância do Jira
A janela pop-up se fechará e um diálogo de confirmação será exibido
Confirme a instância do Jira à qual deseja se conectar no dropdown
Clique em "Concluir"
Uma mensagem "Conectado ao Jira com sucesso" aparecerá assim que estiver conectado

Conectando ao Jira Data Center

Navegue até a página "CONFIGURAÇÃO" dentro do Portal de Contas axe
Clique no link "Integrações" dentro da navegação "Configuração"
Clique no botão "Adicionar nova conexão ao Jira Data Center"
Clique no botão "Configurar configurações" (sob o texto "Conexão não configurada")
Forneça a URL do seu Jira Data Center (por exemplo, https://jira.mycompany.com)
Forneça sua Chave do Consumidor (deve corresponder ao que você inserir no Jira).
No Jira Data Center...
- Clique no botão "Configurações" (ícone de engrenagem no canto superior direito da página)
- Clique no link "Aplicações"
- Clique no link "Links de Aplicações"
- Insira https://www.deque.com como a URL no campo de texto
- Clique no botão "Criar Novo Link"
- Clique no botão "Continuar"
  - Se você vir um aviso como "Nenhuma resposta foi recebida do URL que você inseriu" ou sobre redirecionamentos, você pode ignorá-lo com segurança. O próprio URL não é usado para nenhum tipo de validação; ele é simplesmente um campo obrigatório para configurar a conexão corretamente
- Forneça um Nome da Aplicação (por exemplo, "Integração Jira Deque"; você precisará fornecer este mesmo valor na página de Configurações do Jira Data Center)
- Marque a checkbox "Criar link de entrada"
- Clique no botão "Continuar"
- Insira um valor no campo Chave do Consumidor (por exemplo, "DequeOAuthKey")
- Insira um valor no campo Nome do Consumidor campo (por exemplo, „Integração Deque Jira“)
- Insira a chave pública exibida na página „Configurações do Jira Data Center“ no campo Chave Pública .
De volta à página de Configurações do Jira Data Center no portal de Contas axe...
- insira a mesma Chave do Consumidor que foi inserida no Jira Data Center
- Clique no botão „Salvar“
- Clique no botão „Conectar à Integração“
- Na janela pop-up, faça login no Data Center se ainda não estiver conectado
- Clique em „Permitir“
- Feche a janela

Pré-requisito para Conexão do Jira Cloud de Instância On-Premises Deque

Registrar o App Cliente do Jira

Navegue para https://developer.atlassian.com/console/myapps/
Clique no botão „Criar“ e escolha integração „OAuth 2.0“
Forneça um nome (por exemplo, „Acme Corp - axe on-prem - Integração Jira Cloud“)
Marque Concordo em estar vinculado pelos termos de desenvolvedor da Atlassian e clique no botão „Criar“
Na aba „Distribuição“, clique em „Editar“ e selecione „Compartilhamento“ para "Estado de Distribuição"
- Defina „Nome do Fornecedor“ como „Deque“
- Defina „Política de Privacidade“ como "https://www.deque.com/privacy-policy/"
- Defina „Seu aplicativo armazena dados pessoais?“ como „Não“
- Salvar alterações
Na aba „Permissões“, clique no botão „Adicionar“ (ao lado de "Jira API")
Quando estiver pronto para configuração (aguarde alguns instantes), o botão „Adicionar“ será substituído por um novo botão „Configurar“
- Se o botão „Configurar“ não aparecer, tente recarregar a página
Clique em „Configurar“
Clique em „Editar Escopos“
- marque as seguintes caixas de seleção: "read:jira-work", "read:jira-user", "write:jira-work" e "manage:jira-webhook"
Na aba „Autorização“, clique no botão „Adicionar“
Defina „URL de Retorno“ como "https://axe.deque.com/jira-direct/connected"
Clique no botão „Salvar Alterações“
Baixe esta imagem (clique com o botão direito > salvar imagem como):
Na aba „Configurações“, clique em „Mudar avatar“ e selecione o logo do axe que você acabou de salvar
Na seção „Detalhes de autenticação“, salve o „ID do Cliente“ e o „Segredo“ pois eles são usados como parte da sua instalação on-prem
Uma vez que sua instalação on-prem da Deque esteja completa, siga os passos acima para estabelecer a conexão com o Jira cloud

Desconectando uma Conexão Ativa

Clicar em „Desconectar do Jira“ invalidará a sessão de autenticação ativa previamente estabelecida com o Jira. Além disso, os usuários não poderão mais enviar problemas para a instância do Jira que foi desconectada.

Para reconectar uma conexão desconectada, clique no botão „Conectar ao Jira“ que o guiará pelos passos de conexão mais uma vez.

note

A criação de múltiplas conexões ativas com a mesma instância do Jira deve ser evitada. Em vez disso, um usuário com todas as permissões necessárias no Jira (permissões, projetos, etc.) deve estabelecer a conexão.

Excluindo uma Conexão

Uma vez que uma conexão tenha sido desconectada, você pode excluí-la clicando em „Excluir Conexão Jira“.

note

Ainda é possível conectar-se a uma instância que foi previamente desconectada e excluída. Basta seguir os passos para estabelecer uma nova conexão.

Templates

Uma vez que uma conexão tenha sido estabelecida, templates podem ser criados para padronizar como os problemas do axe são mapeados para os campos do Jira. Os templates ajudam a garantir uma criação consistente de problemas em toda a sua organização.

Para informações detalhadas sobre como criar, gerenciar e usar templates, consulte nossa documentação de Templates.

Enviando Problemas para o Jira

Depois de estabelecer uma conexão com o Jira e criar templates, você pode começar a enviar problemas do axe para o Jira. O processo permite enviar problemas individuais ou grupos de problemas para criar tickets no Jira.