Este artigo responde às perguntas mais frequentes sobre como nossa integração de cartões do Jira é construída.
Como funciona a autenticação entre Jira e Miro?
Consulte os artigos da Central de ajuda sobre
- Jira Server local
- Jira Data Center local
-
Jira Cloud
Selecione na página de configurações dos cartões do Jira.- OAuth 2.0 (3LO)
Os dados são protegidos em trânsito entre o Jira e a Miro?
Utilizamos o protocolo de segurança TLS. Ele criptografa as mensagens HTTP antes da transmissão e as descriptografa ao chegarem. Também oferecemos suporte a mutual TLS para plano Enterprise.
Vocês oferecem suporte a mutual TLS?
Sim, saiba mais.
A Miro reterá algum dos dados do Jira do cliente?
Sim, a Miro retém os dados dos cartões adicionados ao board.
Qual é o período de retenção e como os dados serão protegidos?
Para OAuth 1.0 (Jira Server ou Jira Data Center), os dados também são atualizados se os Webhooks forem configurados durante a configuração do plugin Jira Cards. O período de retenção é ilimitado. Aplicam-se apenas os protocolos gerais de segurança da Miro.
Podemos restringir as informações que são recuperadas da Miro?
Não encontramos nenhuma menção na documentação da Atlassian sobre como limitar as informações a apenas alguns campos.
É possível ter um diagrama que mostre o fluxo de dados entre o Jira e a Miro?
Informações detalhadas podem ser encontradas em este artigo do Jira Developers. Implementamos nossa integração de acordo com a documentação da Atlassian.
Como o token é gerenciado?
OAuth 1.0: Somente o token de acesso é usado. O token de acesso permanece por 5 anos, a menos que seja revogado (sem opção de personalização, pois essa política é definida pela Atlassian. Você pode revogar o token no Jira usando a interface web). Lembre-se de que cada novo token interrompe o funcionamento da integração e exige reconectá-lo.
OAuth 2.0: O token de acesso dura 1 hora. O token de atualização dura 90 dias (se você ficar 90 dias sem usar a integração, terá que reautenticar-se).
Um único token de acesso é usado para todo o acesso do cliente ao Jira?
Todo usuário da Miro que pretende importar, criar ou editar cartões do Jira deve conectar suas credenciais individuais do Jira. Todas as ações acima só podem ser realizadas em nome de credenciais individuais do Jira.
Como são protegidos os tokens de requisição, os tokens de acesso, as chaves privadas e outros segredos/credenciais do OAuth?
Durante a integração, apenas tokens de acesso são usados. Eles são armazenados com segurança no banco de dados e usados somente no lado do servidor.
Para OAuth 1.0 (Jira Server e Jira Data Center), o authToken é usado apenas para o Webhook. Ele não é o token de autenticação real usado pelo OAuth. As requisições são enviadas por uma conexão criptografada. A chave secreta é gerada automaticamente e é associada ao time.
Quais endpoints a integração usa?
POST /rest/api/2/issue - create new issue
PUT /rest/api/2/issue/id - update issue
GET /rest/api/2/user/picker?query=xx
GET /rest/api/2/myself
GET /rest/api/2/filter/favourite
GET /rest/api/2/issue/picker
GET /rest/api/2/serverInfo
GET /rest/api/2/issue/$key
GET /rest/api/2/issue/createmeta
GET /rest/api/2/issue/$key/editmeta
GET /rest/api/2/priority
GET /rest/api/2/issuetype
GET /rest/api/2/mypermissions
Para OAuth 1.0 (Jira Server e Data Center), além disso, usamos:
POST /rest/webhooks/1.0/webhook
Os cartões funcionarão com o Jira Data Center?
Sim. Somos aprovados pela Atlassian e já temos muitos clientes usando com sucesso os cartões do Jira no Data Center. O procedimento de instalação é o mesmo.
Quais IPs vocês usam para se comunicar com o sistema Jira?
A lista dos nossos endereços IP estáticos está disponível aqui.
Observe que esses endereços são usados apenas para comunicação com o sistema Jira. Os IPs do aplicativo da Miro são dinâmicos e, para garantir que todas as funcionalidades nos boards da Miro (incluindo algumas relacionadas aos cartões do Jira) funcionem corretamente, pedimos que adicione nossos domínios à sua lista de permissões.
Podemos integrar o Jira à Miro, mas bloquear itens do Jira com Nível de segurança definido como Privado?
Não, isso não é possível. Os níveis de segurança no Jira não se correlacionam com a Miro.
É possível conectar a Miro ao Jira se você usa um Jira Server?
Como a Miro é uma ferramenta online, você só pode conectar ao Jira quando sua instância estiver acessível pela internet pública.
É possível conectar várias instâncias do Jira ao mesmo tempo?
Sim. No entanto, tenha em mente que conectar uma instância do Jira diz respeito a estabelecer o vínculo inicial, enquanto uma conexão ativa refere-se à instância vinculada atualmente em uso. Uma conexão ativa define de onde os cartões do Jira são importados quando você abre o aplicativo Jira Cards, e para qual instância os usuários estão autorizados. Para um dado usuário, pode haver apenas uma (1) conexão ativa por vez. Com OAuth 2.0, um usuário pode editar qualquer cartão do Jira associado a qualquer instância vinculada para a qual já esteja autenticado. Para qualquer outro protocolo de autenticação, um time inteiro compartilha uma instância ativa e só pode importar e interagir com cartões dessa instância. Você pode definir várias configurações em nível de organização e alternar entre conexões ativas no nível do time.
Qual é o processo de migração do Server para o Cloud?
Como a URL base do Jira inevitavelmente mudará durante a migração para o Jira Cloud, a integração será interrompida sem alterações do nosso lado. Entre em contato com o Suporte da Miro para obter assistência: entre em contato com o Suporte da Miro.
A Miro criará um Webhook por time, por projeto ou por instância da Miro?
Se você ativar o Webhook automático nas configurações da Miro, a criação de Webhooks ocorrerá automaticamente. Se você usar autorização em nível de time com o Jira, a Miro cria Webhooks por time. Se você usar autorização em nível de organização, a Miro cria Webhooks por organização.
O plugin Jira Cards oferece suporte a projetos Next-Gen?
Sim.
Observe que, atualmente, não há campo/link de Epic ao criar um cartão do Jira para um projeto Next-Gen no lado da Miro.
Os campos personalizados do Jira são suportados?
Sim, suportamos quase todos os campos personalizados de tipos básicos. Se você tiver um campo de tipo de dados complexo, ele pode não ser suportado e causar comportamento inesperado ao atualizar ou criar cartões do Jira no board.
O que acontecerá com os cartões do Jira existentes caso mudemos para outra instância do Jira?
Atualmente, quando você move itens do Jira de um projeto para outro no Jira, eles não são mais atualizados na Miro.
Como solução alternativa, sugerimos que você copie a URL do item do Jira (Ctrl/Cmd+C) e cole-a em um board do Miro (Ctrl/Cmd+V). Assim, o cartão do Jira exibirá os novos valores e será atualizado automaticamente.
Se um board for movido para outro time da Miro, o que acontecerá com os cartões do Jira no board?
Os cartões do Jira permanecerão no board, mas ninguém poderá modificá-los (mesmo que a mesma instância do Jira esteja configurada para o time de destino).
Ao clicar em um cartão, você verá a mensagem: "O cartão do Jira foi importado de outra conta". Se quiser tornar os cartões editáveis, importe-os novamente para o board.
Há custo adicional para a integração Jira Cards?
Os Jira Cards estão disponíveis em todos os planos pagos e no plano Education sem custo adicional (Starter, Business, Education e Enterprise).
Um usuário pode acessar todos os Jira Cards no board?
As permissões da integração Jira Cards garantem que os usuários possam criar e editar apenas os cartões em projetos do Jira aos quais tenham acesso.
Como todos os widgets em um board da Miro são visíveis para qualquer pessoa com acesso ao board, se alguém não tiver credenciais do Jira ou não tiver as credenciais corretas, poderá visualizar o cartão do Jira recolhido no board (com título e alguns outros campos), mas não conseguirá expandi-lo para rever seu conteúdo totalmente nem modificá-lo.
A Atlassian encerrou o suporte ao Jira Server?
Sim, a Atlassian encerrou o suporte ao Jira Server em fevereiro de 2024.
O Miro Planner/cartões do Jira oferecem suporte aos campos personalizados do Jira: tipos de item personalizados e dependências personalizadas?
Sim, ambos são suportados. Se os campos Tipos de item personalizados e Dependências personalizadas estiverem configurados no Jira, e o Miro Planner estiver autenticado para essa instância do Jira, esses campos personalizados ficam disponíveis no Planner.
A Miro oferece suporte ao OAuth 2.0 para o Jira Data Center?
Sim. Consulte Conectar ao Jira Data Center usando OAuth 2.0.
Como importar itens do Jira para Tabelas e Timeline?
Você pode arrastar e soltar um ou mais cartões do Jira diretamente em uma Tabela ou Timeline. Atualmente, essa é a única forma de fazer isso.
Quais campos da Tabela estão vinculados ao Jira?
Campos do sistema do Jira:
- Título
- Descrição
- Data de término (Due Date no Jira)
- Responsável
- Status
Campos personalizados do Jira: - Qualquer campo personalizado que você adicionar usando Adicionar campos do Jira, além dos seguintes campos mapeados automaticamente: Data inicial, Estimativa. Para adicionar campos personalizados a uma Tabela, clique no botão de mais (+) no topo da Tabela e selecione Adicionar campos do Jira. Em seguida, escolha qualquer campo personalizado que queira sincronizar.
Quais campos na Tabela não sincronizam com o Jira?
Clique em uma célula para ver quais campos sincronizam com o Jira. Qualquer campo que sincroniza aparece com o logotipo do Jira. Todos os outros campos da Tabela são armazenados somente na Miro e não sincronizam com o Jira.
Por que não consigo editar um campo na Tabela ou na Linha do tempo a partir dos cinco campos do Jira suportados acima?
O campo pode não estar presente na tela de edição do Jira.
Como verificar se o campo está presente na tela de edição:
Na Miro, abra o painel lateral do cartão do Jira. Verifique se o campo aparece no painel lateral. Se o campo não aparecer, você deve adicioná-lo à tela de edição no Jira.
Há alguns casos raros em que os campos são editáveis no Jira, mas não aparecem na tela de edição do Jira. Nesse caso, esses campos não podem ser editados na Miro.
O campo que você não consegue editar é Start date ou Estimate? Se sim:
O campo pode não estar presente no Jira ou pode estar ausente na tela de edição (consulte o ponto anterior)
Pode haver um problema de mapeamento para Data inicial ou Estimativa, pois são campos personalizados do Jira.
Mapeamos esses campos de acordo com a seguinte lógica:
- Data inicial: Verificamos campos com os nomes: Start Date, StartDate, Target Start
- Estimativa: Verificamos campos com os nomes: Story Points, Story point estimate, Story Point, StoryPoints, StoryPoint
- Se o campo Data inicial ou Estimativa não estiver nomeado como um dos nomes acima, isso pode explicar por que a edição não está funcionando.
Por que editar a Data inicial ou a Estimativa na Table ou Timeline do Miro não funciona ou atualiza o campo errado no Jira?
No momento, dependemos de mapeamento automatizado para os campos Start Date e Estimate no Jira. Como esses são campos personalizados no Jira, pode haver casos em que vários campos na sua configuração do Jira correspondam aos critérios mencionados acima.
Selecionamos a primeira correspondência de acordo com a ordem dos nomes de campo mencionados acima:
Por exemplo, se um ticket do Jira possuir os campos Story Points e Story point estimate, mapeamos o primeiro na lista acima, que é Story Points. Portanto, qualquer alteração no campo Estimate na tabela atualizará o campo Story Points no Jira, e não o Story point estimate.
No momento, não há solução alternativa para isso. Se você enfrentar esse problema, envie feedback para a sua equipe de Suporte para que possamos entender melhor suas necessidades enquanto desenvolvemos funcionalidades de mapeamento de campos mais avançadas.
Por que não consigo importar cartões do Jira de 2 instâncias diferentes para uma Table ou Timeline?
Atualmente, suportamos apenas uma instância do Jira por Tabela/Linha do tempo. Depois que um cartão do Jira é importado para uma Tabela/Linha do tempo, a Tabela/Linha do tempo fica vinculada a essa instância específica do Jira.
Mesmo que todos os registros do Jira sejam excluídos, o vínculo com a instância original do Jira permanece. Para importar cartões de outra instância do Jira, é preciso criar uma nova Tabela/Linha do tempo.
Por que não consigo ver ou editar os campos Status e Assignee dos meus registros do Jira em uma Tabela ou Linha do tempo?
Atualmente, os campos Status e Assignee do Jira não são suportados nas Tabelas nem na Linha do tempo. Decidimos desabilitar esses campos nas Tabelas e na Linha do tempo para gerenciar expectativas, evitar confusão e possíveis perdas de dados. Os campos Status e Assignee do Jira e seus conteúdos existem, mas não aparecem nas Tabelas nem na Linha do tempo.
Você ainda pode editar esses campos diretamente nos cartões do Jira usando o painel lateral. Basta arrastar a linha da Tabela ou da Linha do tempo para o canvas para fazer o cartão do Jira reaparecer.
Mais informações: