Disponível para: Jira Cloud, Jira Server (local) e Datacenter (também protegido por LDAP)
Configurado por: Admin do time da Miro e admin do sistema Jira com permissões administrativas de projeto
✏️ O método de autenticação OAuth1.0 não será mais suportado na Miro a partir de 1º de julho de 2025. OAuth1.0 é um protocolo de autenticação obsoleto no Jira e não deve ser usado. Esta mudança faz parte de uma transição mais ampla para o OAuth2.0, que é recomendado em conformidade com as melhores práticas de segurança. Os usuários são aconselhados a migrar para o OAuth2.0 para garantir suporte contínuo e compatibilidade com os serviços da Miro.
Configurando a Miro no Jira
⚠️ Se surgirem questões técnicas, consulte nosso artigo sobre Possíveis problemas e como resolvê-los.
💡 Saiba mais sobre os cartões do Jira nos artigos Perguntas frequentes sobre cartões do Jira e Como configurar webHook para cartões do Jira.
✏️ Observe que os menus do Jira podem diferir dependendo da versão do Jira que você está usando, no entanto, o fluxo geral deve ser o mesmo. As instruções abaixo também podem ser encontradas no Suporte da Atlassian.
Etapa 1 - Link do aplicativo
Primeiro, crie um link de aplicativo e configure-o.
- Vá para Configurações do Jira > Produtos > Integrações > Links de Aplicação > Criar link:
Observe que a interface do Jira pode variar dependendo da sua versão do Jira
- Escolha link direto do aplicativo e insira https://miro.com/ no campo URL do aplicativo.
Importante: você deve inserir o URL neste formato exato. Clique em Continuar.
Criando o link
- No próximo menu, basta clicar em Continuar novamente.
- No menu link de revisão, verifique cuidadosamente se o URL ainda é exatamente https://miro.com/ e insira o nome do aplicativo de sua escolha. Role para baixo e, na parte inferior, marque a caixa Criar link de entrada. Pule o restante dos campos e clique em Continuar.
Apenas o campo Nome do aplicativo deve ser preenchido
- Aqui você verá os campos para os valores da Miro. Para obter os valores, faça login na Miro.
- Para integração a nível de time, vá para Configurações do time > Aplicativos e integrações > Cartões do Jira.
- Para a integração no nível da organização, vá para Configurações da empresa > Aplicativos > Gerenciar aplicativos > Cartões do Jira > Configurações.
Se você não tiver cartões do Jira na sua lista de Apps, role até o topo da seção, clique em Instalar aplicativos e prossiga para instalar o aplicativo do Marketplace da Miro. Depois de ver os cartões do Jira na lista, clique para abri-lo.
A guia do plugin será aberta e você poderá ver Passo 1 para obter os valores necessários:Valores dos cartões do Jira
Copie os valores e adicione-os ao menu Review Link da Atlassian.
- Você verá a mensagem de processamento por um momento ou dois:
A última etapa da criação do link
Isso conclui as etapas do lado da Atlassian. O link aparecerá na lista dos seus links de Aplicação.
Etapa 2 - Conexão
Volte às suas configurações do cartão do Jira na Miro, e escolha uma das duas opções: criar um webhook manualmente ou automaticamente. Se escolher manualmente, desmarque a opção. Consulte mais informações em este artigo. Recomendamos fortemente o uso do webhook automático, assim você não precisará redefini-lo em caso de grandes atualizações no plugin.
Por fim, insira seu URL do Jira e clique em Conectar:
Conectando cartões do Jira
Para obter o URL do Jira, copie o URL base da sua instância do Jira. Aceitamos os seguintes formatos:
https://name.domain/
https://name.domain:port/
https://IPaddress/
https://IPaddress:port/
Se o seu URL do Jira não for aceito, consulte este artigo. Verifique também se a Miro tem acesso suficiente ao seu Jira para estabelecer a conexão.
Agora você conectou sua instância do Jira ao seu time na Miro.
⚠️ Embora a Atlassian tenha descontinuado o suporte para o Jira Server a partir de fevereiro de 2024, a Miro continuará a dar suporte à integração dos cartões do Jira para o Jira Server no futuro previsível.
- Ir para https://your-jira-server/plugins/servlet/applinks/listApplicationLinks. Se "links de aplicativos" não estiver selecionado, clique nele.
Links de Aplicação do Jira Server
- Clique em Criar link. Selecione "produto Atlassian" e forneça o URL da Aplicação, "https://miro.com". Clique em Continuar.
Configurando a URL da Aplicação
- Você será levado para a caixa de diálogo "Vincular aplicativos". Adicione um Nome do Aplicativo (por exemplo, Miro cartão do Jira) e selecione "Aplicativo genérico" para Tipo de Aplicativo.
Você deverá ver a URL da sua aplicação Jira em "Você está criando um link de:", e deverá ver https://miro.com em "Para esta aplicação:". Clique em Continuar.Configurando detalhes de aplicativos vinculados
- A configuração do link será processada. Quando terminar, você verá seu novo link na área "Links de Aplicação" do Jira Server.
Seu aplicativo configurado no Jira Server
- Em seguida, você precisará configurar os detalhes do seu aplicativo. Clique no ícone de lápis do seu aplicativo para editar os detalhes do aplicativo.
- Na caixa de diálogo Configurar, clique na opção Autenticação de entrada. Preencha a Consumer Key, Consumer Name, Public Key e, opcionalmente, uma descrição.
- Para integração no nível do time, esta informação está disponível em Configurações do time > Aplicativos e Integrações > Cartões do Jira.
- Para integração ao nível de organização, estas informações estão disponíveis em Configurações da empresa > Apps > Gerenciar apps > Cartões do Jira > Configurações.
Configurando detalhes de autenticação de entrada no Jira Server
Detalhes do link do aplicativo Jira na Miro
- Role até o final das opções de autenticação de entrada e clique em Salvar. Seu status de verificação deve estar confirmado agora, e este servidor do Jira pode ser usado na Miro para trabalhar com cartões do Jira. Certifique-se de escolher "Jira Server" e "OAuth 1.0" no lado da Miro.
Autorização de usuário
Após a integração ser conectada, cada um de seus usuários finais precisa conectar seu perfil pessoal do Jira para estabelecer as permissões adequadas - isso garante que o acesso de cada usuário no lado da Miro seja exatamente o mesmo que no lado da sua instância do Jira. Quando os usuários finais tentarem importar ou editar um cartão do Jira pela primeira vez, será solicitado que façam login no Jira usando suas credenciais individuais de usuário.
Após isso, os usuários podem adicionar tarefas como cartões na lousa. Todas as alterações feitas no Jira são refletidas nos cartões do Jira no board.
✏️ Se um usuário não tiver credenciais do Jira e tiver acesso ao board no qual o cartão foi adicionado, ele verá o título do cartão, tipo de item, prioridade, responsável e todos os atributos configurados para serem mostrados no cartão do Jira. No entanto, eles não poderão expandir o cartão para ver outros atributos e editá-lo, a menos que autorizem. Se o usuário não conectar suas credenciais do Jira, ele não verá o avatar do responsável e a aparência geral do cartão será diferente.
Usando uma instância do Jira para vários Times da Miro
Você pode instalar Cartões no nível de time ou no nível da organização. Se você tem vários times, pode aproveitar as configurações no nível da organização para evitar repetir o procedimento de configuração para cada time. O link de aplicativo existente é usado para todos os times.
Após conectar seu time ou organização a uma instância do Jira, um novo Webhook é criado nos Webhooks do Jira para aquele time ou organização da Miro. Criar um WebHook estabelece um canal para solicitações de atualização.
Se você especificar as configurações no nível da organização, os times que já estão conectados mantêm suas configurações atuais. No entanto, eles podem alternar para as configurações no nível da organização a qualquer momento.
Além disso, se necessário, os times podem substituir as configurações em nível de organização para se conectar a uma instância diferente do Jira.
Se você é um cliente Enterprise que deseja migrar várias conexões em nível de time para a conexão padrão em nível de organização, entre em contato com o seu time da conta.
⚠️ Se você deseja conectar vários times separadamente, recomendamos dar ao Webhook de cada time um nome único. Vá para a sua página de Webhooks do Jira e edite cada webhook recém-criado.
Não é possível conectar várias instâncias do Jira a um único time da Miro.
Desabilitar o plugin
Para integração em nível de time, vá para Configurações do time > Aplicativos e integrações > Cartões do Jira. Em seguida, selecione Remover para o time.
Para a integração no nível da organização, para restringir o uso do aplicativo Jira, vá para Configurações da empresa > Aplicativos > Gerenciar aplicativos > Cartões do Jira. Em seguida, mova a opção para a posição desligada.
⚠️ Se você desabilitar o Jira para a organização, então usuários de todos os times Enterprise não conseguirão usar cartões do Jira. Para saber mais sobre o gerenciamento e a restrição de aplicativos, consulte Gerenciamento de aplicativos.
Mais informações: Consulte Como usar cartões do Jira.