Possíveis problemas com os cartões do Jira e o complemento do Jira

O aplicativo Jira Cards está instalado, mas seu time da Miro não está conectado ao Jira.

Siga este guia de instalação: como configurar e desinstalar os cartões do Jira. Se você não for um admin do time, peça ao admin para fazer isso. 

Falha na solicitação ao Jira: tempo limite ocorreu/host desconhecido/conexão negada.

O Jira só é acessível na sua intranet (você está usando os endereços IP errados para se comunicar com o sistema do Jira).

Certifique-se de incluir na lista de endereços IP, domínios e subdomínios para fornecer à nossa integração o nível de acesso necessário. 

Se você estiver no servidor do Jira e em uma versão antiga, verifique se nenhuma funcionalidade em Dark Block (funcionalidades em negrito) bloqueia o acesso da Miro.

Aplicável ao OAuth 1.0. Somente (servidor e data center do Jira).

O link do aplicativo no seu Jira não está configurado corretamente.

- Você perdeu algumas etapas na configuração do link ou do webhook.

- Você instalou o Addon do Jira em vez de configurar o link para os cartões do Jira.

Tente instalar a integração do Jira Cards do zero. 

Se você optar por criar o Webhook manualmente, tente criá-lo automaticamente.

Aplicável ao OAuth 1.0. Somente (servidor e data center do Jira).

O link do aplicativo na sua instância do Jira não está configurado corretamente ou o token expirou. Verifique o link do aplicativo e reconecte a integração.

- O link do aplicativo no Jira foi reconfigurado.

- O token expirou.

- O token foi revogado.

Certifique-se de que seu link do aplicativo esteja configurado corretamente e tente conectar a Miro aos cartões do Jira novamente.

Se você estiver usando um Jira altamente protegido ou estiver usando um proxy, certifique-se de incluir na lista de endereços IP, domínios e subdomínios para fornecer à nossa integração o nível de acesso necessário. 

Se você estiver no servidor do Jira e em uma versão antiga, verifique se nenhuma funcionalidade em Dark Block (funcionalidades em negrito) bloqueia o acesso da Miro.

Aplicável ao OAuth 1.0. Somente (servidor e data center do Jira).

O link do seu aplicativo pede mais valores do que apenas URL, chave do consumidor, nome do consumidor, chave pública.

Você está olhando para a guia Autenticação de saída do menu de configuração.

- Alterne para a autenticação de entrada. A autenticação de saída não requer configuração.

- Se você não conseguir pular a etapa, adicione quaisquer valores temporários. Você poderá removê-los mais tarde: quando na página com os links do seu aplicativo, clique para o link Editar os cartões da Miro e remova os valores temporários. 

Aplicável ao OAuth 1.0. Somente (servidor e data center do Jira).

O URL do Jira não é
válido/Digite o URL base do Jira / Solicitação incorreta.
Deserialização.

Seu Jira está em uma rede privada/o firewall da sua empresa bloqueia as conexões de rede externa.

Adicione nossos endereços IP (e portas) do Gateway NAT à sua lista de permissões. 
*Observe que, se você verificar nossos endereços IP usando o nslookup, os resultados retornarão os endereços do nosso balanceador de carga, que podem variar e mudar ao longo do tempo.

Você usa um proxy/Seus URLs externos e internos do Jira não correspondem.

Certifique-se de preencher o campo URL do Jira com o endereço que podemos acessar. Portanto, configure um proxy reverso que nos permita acessar e/ou siga as etapas deste guia do Atlassian. Com esta solução, a integração poderá conectar e encaminhar as solicitações entre o seu Jira e a Miro com sucesso, se seus URLs externos e internos forem diferentes.
Você também pode querer prolongar o valor de tempo limite no seu servidor proxy.A
lista de pontos de extremidade pode ser encontrada aqui: Perguntas frequentes sobre os cartões do Jira

Há um problema com o seu certificado SSL (os certificados autoassinados não são compatíveis).

Verifique o certificado SSL ativo no servidor do Jira. Esta ferramenta pode ser útil: insira seu URL do Jira e veja os resultados da verificação de
conexão.Exemplo: o certificado pode estar correto (o certificado em verde), mas a cadeia de certificados do servidor pode estar incompleta (Troca de chaves em amarelo), portanto, nosso sistema recebe uma resposta de que o certificado precisa ser
atualizado.Consulte este site para resolver os problemas.

Seu Jira está em Logon único (pode também resultar em erro de autenticação de entrada não configurada).

Certifique-se de que seu processo de Logon único não seja aplicado às solicitações de conexão da nossa integração. Para isso, os seguintes pontos de extremidade devem ser excluídos dos processos de Logon único:

POST {JIRA_URL}/plugins/servlet/oauth/request-token
 POST {JIRA_URL}/plugins/servlet/oauth/access-token
 GET {JIRA_URL}/rest/api/2/serverInfo

Comportamento inesperado durante a instalação

Você usa as versões do Jira 6.4 ou inferiores.

Nossos cartões não funcionarão com essas versões devido a este bug do Jira. Atualize seu Jira para a versão mais recente.

Falha na autorização do aplicativo. Tente autorizar o aplicativo novamente. 

Uma perda momentânea de conexão. Clique em para Conectar novamente. 

Aplicável ao OAuth 1.0. Somente (servidor e data center do Jira).

Erro do Jira: "Você não tem permissões para criar o Webhook da Miro"."

Você não tem permissões de admin no Jira. Peça ao seu admin do Jira para fazer upgrade da sua função para Admin para que possa configurar a integração.

Falha na solicitação do Jira: falha na criação do caminho do PKIX: não foi possível encontrar o caminho de certificação válido para o destino solicitado

Há algum problema com o seu certificado do servidor.
 
Como uma solução, sugerimos que você entre em contato com seu departamento de TI e peça para que verifique os certificados ao seu lado (recarregue os servidores da web; certifique-se de que os certificados sejam publicamente confiáveis, etc.). 

Incapacidade de autorizar no Jira via a Miro.
Erro: exceções (por exemplo, io.netty.handler.timeout.ReadTimeoutException)

Isso pode ocorrer devido a uma configuração incorreta da infraestrutura do Jira quando a configuração da infraestrutura indica suporte para o protocolo HTTP/2, mas nenhuma transferência de dados ocorre ao tentar usá-la. Verifique suas configurações HTTP/2 nos arquivos de configuração do seu servidor web para garantir que elas estejam configuradas corretamente.

Se necessário, desabilite temporariamente o suporte do HTTP/2 na configuração do seu servidor para garantir a compatibilidade com versões anteriores e o serviço ininterrupto até que o problema seja resolvido.

Os cartões do Jira não estão sendo atualizados.

Aplicável ao OAuth 1.0. Somente (servidor e data center do Jira).

Você está usando um Webhook manual.

Desabilite a integração e reconecte-a usando um Webhook automático. Se tudo estiver funcionando bem com um Webhook automático, isso significa que um Webhook manual foi configurado incorretamente.

Além disso, consulte Como configurar o Webhook para os cartões do Jira. 

Aplicável ao OAuth 1.0. Somente (servidor e data center do Jira).

Se você estiver usando um Webhook automático:

A primeira etapa de solução de problemas é reconectar a integração. Se isso não ajudar, pode haver várias razões pelas quais os cartões do Jira não estão mais vivos:

- Um board da Miro foi movido/baixado por backup para um time de outro.

- Os problemas do Jira que não eram atualizados foram movidos de um projeto para outro no Jira.

- Você não tem acesso aos projetos nos quais os itens do Jira estão localizados.

- Os cartões que não estão atualizados não estão localizados na mesma instância do Jira que você está usando no seu navegador.

Aplicável ao OAuth 1.0. Somente (servidor e data center do Jira).

Os cartões do Jira pararam de atualizar sem quaisquer alterações feitas sob sua responsabilidade, e ao tentar reconectar o link do aplicativo no seu Jira não está configurado corretamente.

A mensagem de erro pode aparecer quando a Miro não consegue solicitar um Jira conectado devido a um erro de autorização. Isso pode acontecer se o usuário que configurou a integração revogar seu token ou se o Jira estiver de alguma forma configurado com uma duração mínima do token emitido, portanto, ele simplesmente se torna inválido após esse período e deve ser reconectado para obter um novo token de autorização válido com o qual a Miro acessa o Jira.

A opção Editar cartão retorna uma janela em branco

Aplicável ao OAuth 1.0. Somente (servidor e data center do Jira).

Você usa o Jira ver. 7.6 e superior.

Por razões de segurança, o Atlassian pode não permitir que o conteúdo seja inserido nos iFrames, o que também pode afetar as janelas pop-up para editar seus cartões do Jira. Você pode usar essas instruções como uma solução alternativa.

Não foi possível adicionar os cartões do Jira

Aplicável ao OAuth 1.0. Somente (servidor e data center do Jira).

Você criou um Webhook manual e não salvou as informações de configuração.

Verifique se o campo URL do Jira está preenchido nas Configurações da Miro. Certifique-se de clicar em Conectar.

O ícone Editar não é exibido.

Aplicável ao OAuth 1.0. Somente (servidor e data center do Jira).

Você usa as versões do servidor do Jira 7.6 ou superior.

O ícone Editar pode não ser exibido devido a uma atualização de segurança nesta versão.

Seu perfil não tem permissão para editar o problema do Jira em questão.

Verifique se você consegue acessar o modo de edição após abrir o problema no Jira.

Você recebe a mensagem: Você não está conectado e não tem as permissões necessárias para agir de acordo com o problema selecionado como convidado. Faça o login

Devido à forma como nossa integração usa cookies, seu Jira pode não permitir que você faça login a partir desta página.

Faça login no Jira em outra guia do
navegador.Certifique-se de verificar se os cookies de terceiros são permitidos no seu navegador.

Seu Jira está em SSO e seu IDP não permite a autenticação por iframes.

Se você estiver trabalhando no aplicativo para desktop da Miro, recomendamos alternar para a versão do navegador da Miro em miro.com.

Nenhuma opção de converter/criar um cartão do Jira na Miro quando você escolhe alguns projetos específicos:

- Sem dados no campo Tipo de problema

- O botão Converter/Criar está inativo.

Você não tem acesso ao projeto no Jira. Verifique se você pode receber o acesso.

Não foi possível criar o item do Jira ao tentar converter/criar um novo cartão do Jira: 

Você não tem permissão para criar os itens do Jira.

Entre em contato com seu admin do Jira e peça para que ele conceda a permissão necessária no Jira. É assim que deve ser parecido:

Alguns campos personalizados não são mostrados no menu Converter em item do Jira/Editar problema do Jira.

Não é possível criar o item do Jira. Os campos necessários (...) não são compatíveis erro ao criar um problema do Jira na Miro

Os campos não estão habilitados no seletor de cartões do Jira do board.

Use nosso seletor do Jira no aplicativo para configurar os campos personalizados seguindo as etapas deste guia.

Se o botão Selecionar campos para exibir nos cartões não mostrar os campos personalizados do seu Jira, é possível que algumas das telas configuradas para os projetos da sua instância do Jira protejam os campos da Miro.

Vá para Configurações do projeto > Telas > Esquema de tela padrão e verifique se os campos necessários são permitidos.

A Miro não é compatível com campos de tipo de dados complexos.

A Miro é compatível com os campos personalizados básicos, mas não com os complexos. Configure os campos do cartão do Jira e remova os campos que não são compatíveis.

Você não pode escolher o relator ao editar/criar um cartão do Jira

Não há campo de relator nos metadados Criar do Jira: o campo não está disponível na tela Criar do Jira para o projeto selecionado.

Vá para Configurações do projeto > Telas e verifique se o campo Relator está presente na tela Criar.

Você não tem a permissão necessária para definir o relator para os problemas no projeto selecionado. 

Peça ao admin do Jira para verificar seus níveis de acesso e garantir que você tenha permissão para definir/alterar o campo Relator no projeto selecionado. Para fazer isso, é necessário fazer login no Jira > ir para Configurações > Problemas > Esquemas de permissão > e verificar o campo Modificar relator (adicione o acesso do aplicativo: Qualquer usuário conectado caso você não tenha esse nome na lista):

O campo relator não é editável para a trilha de auditoria e está definido para quem criou o problema.

O campo não disponível é um comportamento esperado.

Alguns campos são exibidos em um modo de edição de um cartão, mas não aparecem nos cartões do Jira nos boards.

A Miro não recebe as atualizações do Jira.

• Alterar para outra rede
• Reconectar a integração

Aplicável ao OAuth 1.0. Somente (servidor e data center do Jira).

O Jira não está disponível no erro nas configurações do aplicativo do Jira Cards

1. Peça ao admin do time para desabilitar e reconectar a integração.

2. Seu Jira está protegido (firewall, bloqueadores de segurança, etc.) e não pode ser alcançado pela Miro.

Se ao mesmo tempo os cartões do Jira forem sincronizados entre a Miro e o Jira, isso significa que seu Jira pode nos enviar webhooks. É por isso que você pode ver as atualizações nos seus boards.

Como solução, sugerimos que você debata o problema com seu departamento de TI e peça para que verifique duas vezes se a Miro é permitida. 

Se você estiver no servidor do Jira e em uma versão antiga, verifique se nenhuma funcionalidade em Dark Block (funcionalidades em negrito) bloqueia o acesso da Miro.

Aplicável ao OAuth 1.0. Somente (servidor e data center do Jira).

Erro do webhook do Jira nas configurações do aplicativo do Jira Cards

- Você alterou/excluiu um Webhook no Jira- A Miro recebe a resposta de "Solicitação incorreta" do seu Jira.

Ao usar Ctrl + V (para Windows)/Cmd + V (para Mac) para colar um link de um problema do Jira no board, ele não é convertido em um cartão do Jira, mas é colado como um URL.

O board ainda está carregando. Pode acontecer em boards ou boards maiores que as imagens ou documentos em PDF. 

Aguarde pelo menos 10 segundos após abrir o board e deixe o board carregar completamente. Em seguida, tente colar o link novamente.

A descrição não está visível nos cartões do Jira no board.

Para ver os dados do cartão, clique no cartão e escolha expandir para ver os dados do cartão na barra lateral do seu board. 

"Mostrando 0 de 0 sprints correspondentes" ao tentar pesquisar e encontrar os sprints disponíveis.

1. Isso acontece quando você não tem sprints ativos/futuros (todos eles são fechados/concluídos). 

2. Seu filtro no Jira não inclui nenhum projeto. Adicione um projeto necessário ao JQL do filtro do board. Portanto, os sprints serão exibidos no Jira e na Miro.

Aplicável ao OAuth 1.0. Somente (servidor e data center do Jira).

Falha a conexão SSL com ...

Esse erro significa que a Miro não tem acesso ao seu Jira.Entre em

contato com os admins do time da Miro e peça para que verifiquem se seu campo URL base do Jira nas configurações dos cartões do Jira contém o endereço ao qual podemos nos conectar.

Certifique-se de que você tenha a permissão "Navegar pelos usuários" definida no nível global no Jira. Saiba mais sobre como gerenciar as permissões globais. 

Infelizmente, como nosso plugin usa cookies, o Jira não permitirá que você faça login a partir desta página.

Faça login no Jira em outra guia do navegador.

Após clicar no botão Instalar na página do complemento, você pode ver o seguinte erro:

Uma perda momentânea de conexão.

Neste caso, basta tentar instalar novamente um minuto depois.

Durante ou após a configuração do complemento do Jira, não é possível avançar para a próxima página em alguma etapa.

Algo nos seus cookies ou cache interrompe o processo.

Limpe a memória do seu navegador para o domínio atlassian.com e tente novamente.

Após a instalação bem-sucedida, os usuários do Jira que não estão registrados na Miro estão vendo o menu de login da Miro em vez do board anexado.

As políticas do Jira bloqueiam algumas funcionalidades do plugin. 

Infelizmente, esse comportamento é causado pela atualização da API do Jira mais recente e não pode ser alterado no momento.

O complemento não lembra sua autorização e pede para fazer login o tempo todo.  

Ao tentar adicionar boards a um problema do Jira, um seletor de boards mostra o erro "Infelizmente, a integração está indisponível".

Os cookies de terceiros são bloqueados no seu navegador.

Como uma solução, siga as instruções sobre como habilitar os cookies no seu navegador. Isso acontece principalmente com o Mozilla e o Safari devido às suas novas políticas de
segurança.Para o Safari, esta solução também pode ajudar.