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?
Veja os artigos da Central de ajuda para
- Servidor Jira on-premise
- Jira Data Center local
-
Jira Cloud
Selecione a partir da página de configurações dos cartões do Jira.- OAuth 2.0 (3LO)
Os dados são seguros em trânsito entre o Jira e a Miro?
Utilizamos o protocolo de segurança TLS. Ele criptografa mensagens HTTP antes da transmissão e as descriptografa ao chegar. Também oferecemos suporte a TLS mútuo para o plano Enterprise.
Você oferece suporte a TLS mútuo?
Sim, saiba mais.
A Miro retém algum dado do Jira do cliente?
Sim, a Miro retém os dados dos cartões que são adicionados ao board.
Qual é o período de retenção e como os dados serão protegidos?
Para OAuth 1.0. (Jira Server ou Data Center), os dados também são atualizados se os Webhooks estiverem configurados durante o processo de configuração do plugin de cartões do Jira. O período de retenção é ilimitado. Apenas os protocolos gerais de segurança da Miro são aplicados.
Podemos restringir as informações que são recuperadas do Miro?
Não encontramos nenhuma menção na documentação da Atlassian sobre como limitar as informações a apenas alguns campos.
Podemos ter um diagrama mostrando o fluxo de dados entre o Jira e o Miro?
Informações detalhadas podem ser encontradas neste artigo dos desenvolvedores do Jira. 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 persiste por 5 anos, a menos que seja revogado (não há opção para personalizar, pois essa política é definida pelo lado da Atlassian. Você pode revogar o token no lado do Jira usando a interface do usuário na web). Lembre-se de que cada novo token interrompe a integração e requer reconexão.
OAuth 2.0: O token de acesso dura 1 hora. O token de atualização dura 90 dias (se você passar 90 dias sem usar a integração, terá que se reautenticar).
Um único token de acesso é usado para todo o acesso ao Jira do cliente?
Cada usuário da Miro que pretenda importar, criar ou editar cartões do Jira deve conectar suas credenciais individuais do Jira. Todas as ações mencionadas só podem ser realizadas em nome das credenciais individuais do Jira.
Como são protegidos os tokens de requisição, tokens de acesso, chaves privadas e outros segredos/credenciais do OAuth?
Durante a integração, apenas tokens de acesso são utilizados. Eles são armazenados com segurança dentro do banco de dados e usados somente no lado do servidor.
Para OAuth 1.0. (Jira Server e 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 conforme o time.
Quais endpoints sua integração utiliza?
POST /rest/api/2/issue - criar novo item
PUT /rest/api/2/issue/id - atualizar item
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 Datacenter) adicionalmente, utilizamos:
POST /rest/webhooks/1.0/webhook
Os cartões funcionam com o Jira Datacenter?
Sim. Somos aprovados pela Atlassian, e já temos muitos clientes usando com sucesso os cartões do Jira com o Datacenter. O procedimento de instalação é o mesmo.
Quais IPs vocês utilizam para se comunicar com o sistema Jira?
A lista dos nossos endereços IP estáticos pode ser encontrada aqui.
Observe que esses são os endereços usados apenas para se comunicar com o sistema Jira. Os IPs do aplicativo Miro são dinâmicos e, para garantir que todas as funcionalidades nos boards Miro (incluindo algumas relacionadas aos cartões do Jira) sejam executadas com sucesso, pedimos que adicione nossos domínios à sua lista de permissões.
Podemos integrar o Jira com o Miro, mas bloquear itens do Jira com Nível de Segurança definido como "Privado"?
Não, essa não é uma opção. Níveis de Segurança no Jira não se correlacionam com o Miro.
Podemos conectar a Miro ao Jira se usarmos um servidor Jira?
Como a Miro é uma ferramenta online, você só pode se conectar ao Jira quando sua instância estiver aberta para a internet pública.
Podemos conectar várias instâncias do Jira ao mesmo tempo?
Sim. No entanto, tenha em mente que conectar uma instância Jira é sobre estabelecer o link 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 de cartões do Jira, e para qual instância os usuários estão autorizados. Para um determinado 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, toda a equipe compartilha uma instância ativa e só pode importar e interagir com cartões dessa instância. Você pode definir várias configurações a nível de organização e alternar entre conexões ativas no nível do time.
Qual é o processo de migração de Servidor para Cloud?
Como sua URL base do Jira inevitavelmente mudará durante a migração para a nuvem, a integração será interrompida se não fizermos alterações do nosso lado. Por favor, entre em contato com o suporte da Miro para obter assistência.
A Miro criará um webhook por time, por projeto ou por instância da Miro?
Se você ativar o Webhook Automático nas suas configurações do Miro, a criação do webhook ocorre automaticamente. Se você usar autorização de nível de time com o Jira, então a Miro cria webhooks por time. Se você usar autorização de nível de organização, então a Miro cria webhooks por organização.
O plugin de cartões do Jira suporta projetos Next-Gen?
Sim, funciona.
Observe que atualmente não há um link/campo Epic ao criar um cartão do Jira para um projeto Next-Gen no lado da Miro.
Campos personalizados do Jira são suportados?
Sim, oferecemos suporte para quase todos os campos personalizados de tipos básicos. Se você tiver um campo de tipo de dado complexo, ele pode não ser suportado e pode causar comportamentos inesperados 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 no lado da Miro.
Como solução alternativa, sugerimos que você copie a URL de um item do Jira (Ctrl/Cmd+C) e cole-a em um board Miro (Ctrl/Cmd+V). Assim, um cartão do Jira mostrará novos valores e será atualizado automaticamente.
Se um board for movido para outro time 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 seja 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, por favor, importe-os novamente para o board.
Há um custo adicional para a integração dos cartões do Jira?
Os cartões do Jira estão disponíveis em todos os planos pagos e de Educação sem custo adicional (planos Starter, Business, Education e Enterprise).
Um usuário pode acessar todos os cartões do Jira no board?
As permissões para a integração dos cartões do Jira garantem que os usuários só possam criar e editar cartões em projetos do Jira aos quais tenham acesso.
Como todos os widgets em um board da Miro são visíveis para todos que têm acesso ao board, se alguém não tiver credenciais do Jira ou tiver credenciais erradas, poderá visualizar o cartão do Jira colapsado em um board da Miro (com título e alguns outros campos) mas não poderá expandir o cartão para revisá-lo ou modificá-lo completamente.
A Atlassian interrompeu o suporte ao Jira Server?
Sim, a Atlassian interrompeu o suporte ao Jira Server em fevereiro de 2024.
O Miro Planner/cartões do Jira suporta os campos personalizados: tipos de itens personalizados e dependências personalizadas do Jira?
Sim, ambos são suportados. Se os campos tipos de itens personalizados e dependências personalizadas estiverem configurados no Jira, e o Miro Planner estiver autenticado para essa instância do Jira, então esses campos personalizados estarão disponíveis no planner.
A Miro suporta OAuth 2.0 para o Jira Data Center?
Como posso importar itens do Jira para Tabelas e Linha do Tempo?
Você pode arrastar e soltar um ou mais cartões do Jira diretamente em uma Tabela ou Linha do Tempo. No momento, esta é a única maneira de fazê-lo.
Quais campos na Tabela se ligam ao Jira?
Campos do sistema do Jira:
- Título
- Descrição
- Data de término (Data de Vencimento no Jira)
- Responsável
- Status
Campos personalizados do Jira:
- Data de início
- Estimativa
Clique em uma célula para ver quais campos sincronizam com o Jira. Qualquer campo que sincroniza será exibido com um logo do Jira. Todos os outros campos são armazenados somente na Miro e não sincronizam com o Jira.
Por que não posso editar um campo na Tabela ou Linha do Tempo dos cinco campos do Jira mencionados acima?
O campo pode não estar presente na tela de edição no Jira.
Uma maneira fácil de verificar se o campo está presente na tela de edição ou não:
Na Miro, abra o painel lateral do cartão do Jira. Verifique se o campo está presente no painel lateral. Se o campo não estiver presente, você deve adicionar o campo à tela de edição no Jira.
Há alguns casos raros em que os campos são editáveis no Jira, mas não estão presentes na tela de edição do Jira. Nessa situação, esses campos não podem ser editados no Miro.
O campo que você não pode editar é Data de início ou Estimativa? Se sim:
O campo pode não estar presente no Jira ou estar ausente na tela de edição (consulte o ponto anterior).
Pode haver um problema de mapeamento para Data de início ou Estimativa, pois são campos personalizados do Jira.
Nós mapeamos esses campos de acordo com esta lógica:
- Data de início: 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 de início ou Estimativa não tiver um dos nomes mencionados acima, isso pode explicar por que a edição não está funcionando.
Por que a edição do Start Date ou Estimate na tabela Miro ou Timeline não funciona ou atualiza o campo errado no Jira?
Atualmente, dependemos de mapeamento automatizado para os campos Start Date e Estimate no Jira. Como esses campos são 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 tiver campos tanto de Story Points quanto de Story point estimate, nós correspondemos ao primeiro na lista acima, que é Story Points. Portanto, quaisquer alterações no campo Estimate na tabela atualizarão 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ê encontrar esse problema, envie feedback para sua equipe de suporte para que possamos entender melhor suas necessidades, enquanto desenvolvemos capacidades de mapeamento de campo mais avançadas.
Por que não posso importar cartões do Jira de 2 instâncias diferentes para uma Tabela ou Timeline?
Atualmente, suportamos apenas uma instância do Jira por Tabela/Timeline. Assim que um cartão do Jira é importado para uma Tabela/Timeline, ela é vinculada à instância específica do Jira.
Mesmo que todos os registros do Jira sejam deletados, o link para a instância original do Jira permanece. Para importar cartões de uma instância diferente do Jira, é necessário criar uma nova Tabela/Timeline.
Por que não consigo ver ou editar os campos de Status e Responsável para meus registros do Jira em uma Tabela ou Timeline?
Atualmente, os campos de Status e Responsável do Jira não são suportados em Tabelas e Timeline. Decidimos desabilitar esses campos em Tabelas e Timeline para gerenciar expectativas, evitar confusão e possível perda de dados. Os campos de Status e Responsável do Jira e seus conteúdos existem, mas não aparecem em Tabelas ou Timeline.
Você ainda pode editar esses campos diretamente nos cartões do Jira usando o painel lateral. Basta arrastar a linha da Tabela ou Timeline para o canvas para fazer seu cartão do Jira reaparecer.
Mais informações: