Integração com o Jira Cloud - Amazon Quick
O que é possível fazerAntes de começarCrie um token da API JiraConfigurar a integração com o JiraConfigurar autenticaçãoAções disponíveisCompartilhe integraçõesGerencie as integrações do Jira

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Integração com o Jira Cloud

Conecte o Amazon Quick à sua instância do Jira Cloud para gerenciar problemas, projetos e outros objetos do Jira. Você pode criar, atualizar e consultar conteúdo do Jira sem sair do seu ambiente Amazon Quick. Essa integração requer o nível Amazon Quick Pro ou superior.

O que é possível fazer

Com a integração com o Jira Cloud, você pode realizar ações em suas instâncias do Jira por meio da API REST do Jira.

Conector de ação

Crie, atualize e consulte problemas, projetos e outros objetos do Jira por meio da API REST do Jira.

nota

Essa integração suporta somente a execução de ações. Você não pode usá-lo para criar bases de conhecimento ou acessar dados do Jira para fins de pesquisa.

Antes de começar

Você precisa do seguinte para configurar a integração com o Jira:

  • Instância do Jira Cloud com as permissões apropriadas.

  • Conta de usuário do Jira ou credenciais do token da API.

  • Amazon Quick Author ou superior.

  • Acesso administrativo para configurar OAuth aplicativos (para autenticação do usuário).

Crie um token da API Jira

Para usar a autenticação por chave de API, crie um token de API na sua conta Atlassian.

  1. Acesse as configurações da sua conta Atlassian e escolha Segurança.

  2. Crie um novo token de API para a integração com o Amazon Quick.

  3. Copie o token gerado para usar em sua configuração de integração com o Amazon Quick.

  4. Anote o URL da instância do Jira Cloud e o endereço de e-mail do usuário. O URL da sua instância do Jira Cloud é um valor especial para chamadas de API que podem ser encontradas navegando até. https://your-domain.atlassian.net/_edge/tenant_info

Importante

O Jira Cloud pode retornar respostas de sucesso HTTP 200 mesmo quando os tokens da API são revogados ou configurados incorretamente. Para obter mais informações, consulte JRACLOUD-82932. Se sua integração parecer estar se conectando com sucesso, mas as ações falharem inesperadamente, verifique se seu token de API é válido e não foi revogado.

Configurar a integração com o Jira

Siga estas etapas para conectar o Amazon Quick à sua instância do Jira Cloud.

  1. No console do Amazon Quick, escolha Integrações.

  2. Clique em Adicionar (mais o botão “+”).

  3. Preencha os detalhes da integração:

    • Nome - Insira um nome descritivo para sua integração com o Jira.

    • Descrição (opcional) - Descreva a finalidade dessa integração.

  4. Escolha o tipo de conexão (autenticação de usuário ou serviço).

  5. Conclua as configurações de conexão com base no método de autenticação:

    • Para autenticação do usuário (OAuth):

      • URL base - o URL da sua instância do Jira Cloud. Isso deve ser fornecido no seguinte formato:https://api.atlassian.com/ex/jira/instanceid. Você instanceid pode ser encontrado navegando atéhttps://your-domain.atlassian.net/_edge/tenant_info.

      • ID do cliente - Seu ID de cliente do OAuth aplicativo Atlassian.

      • Segredo do cliente - O segredo do seu cliente do OAuth aplicativo Atlassian.

      • URL do token - endpoint do OAuth token Atlassian.

      • URL de autenticação - ponto final de autorização da Atlassian OAuth .

      • URL de redirecionamento - URI de OAuth redirecionamento.

    • Para autenticação de serviço (chave de API):

      • URL base - o URL da sua instância do Jira Cloud.

      • Chave de API - Seu token de API do Jira.

      • E-mail - Endereço de e-mail associado à sua conta de usuário do Jira.

  6. Selecione Criar e continuar.

  7. Selecione usuários com os quais compartilhar a integração.

  8. Clique em Next.

Configurar autenticação

A integração com o Jira Cloud oferece suporte a dois métodos de autenticação. Escolha o método que funciona melhor para sua organização.

Autenticação do usuário (OAuth)

Use OAuth quando quiser que as ações sejam executadas sob identidades de usuário individuais. Configure esses campos:

  • URL base - o URL da sua instância do Jira Cloud.

  • ID do cliente - Seu ID de cliente do OAuth aplicativo Atlassian.

  • Segredo do cliente - O segredo do seu cliente do OAuth aplicativo Atlassian.

  • URL do token - endpoint do OAuth token Atlassian.

  • URL de autenticação - ponto final de autorização da Atlassian OAuth .

  • URL de redirecionamento - URI de OAuth redirecionamento.

OAuth Escopos necessários:

  • read:jira-user- Leia as informações do usuário.

  • read:jira-work- Leia questões, projetos e itens de trabalho.

  • write:jira-work- Crie e modifique problemas e itens de trabalho.

  • manage:jira-project- Gerenciar as configurações do projeto.

  • manage:jira-configuration- Gerenciar a configuração do Jira.

  • manage:jira-webhook- Gerencie webhooks.

  • read:sprint:jira-software- Leia as informações do sprint.

  • write:sprint:jira-software- Crie e modifique sprints.

  • delete:sprint:jira-software- Exclua sprints.

  • write:board-scope:jira-software- Gerencie as configurações da placa.

Autenticação de serviço (chave de API)

Use a autenticação por chave de API para service-to-service conexões. Configure esses campos:

  • URL base - o URL da sua instância do Jira Cloud.

  • Chave de API - Seu token de API do Jira.

  • E-mail - Endereço de e-mail associado à sua conta de usuário do Jira.

nota

Devido a um comportamento conhecido do Jira Cloud, a integração pode parecer estar se conectando com sucesso mesmo com tokens de API revogados ou inválidos. Se as ações falharem inesperadamente após a configuração, verifique se seu token de API ainda é válido nas configurações da sua conta Atlassian.

Ações disponíveis

Depois de criar sua integração com o Jira, você pode usar essas ações para interagir com o Jira Cloud:

  • Crie, leia, atualize e exclua problemas do Jira.

  • Gerencie transições de problemas e fluxos de trabalho.

  • Problemas de consulta usando JQL (Jira Query Language).

  • Gerencie projetos, componentes e versões.

  • Adicione comentários e anexos às edições.

  • Gerencie atribuições de usuários e observadores.

  • Acesse os metadados do projeto e da emissão.

nota

As ações que você pode usar dependem das permissões configuradas na sua instância do Jira Cloud e do seu método de autenticação.

Compartilhe integrações

Você pode compartilhar seu conector de ação do Jira com outros usuários em sua organização.

  1. Depois de criar a integração, escolha Compartilhar integração.

  2. Selecione os usuários ou grupos com os quais você deseja compartilhar a integração.

  3. Defina as permissões apropriadas para acesso compartilhado.

  4. Confirme suas configurações de compartilhamento.

Gerencie as integrações do Jira

Você pode realizar essas tarefas de gerenciamento para suas integrações com o Jira:

  • Editar configurações de integração - Atualize as configurações de autenticação ou a configuração da instância do Jira.

  • Compartilhe o acesso à integração - Disponibilize a integração para outros usuários em sua organização.

  • Monitore métricas de uso - Visualize a atividade de integração e as métricas de uso da API.

  • Analise as ações disponíveis - Veja a lista completa das ações disponíveis do Jira.

  • Excluir integração - remova a integração e revogue a autenticação associada.