Para administradores: configurar Fichas da Lucid para o Jira

Configure sua instância do Jira Cloud para sincronização em tempo real

Você precisará de permissões de administrador do Jira e do Lucidspark para concluir as seguintes etapas. Exigimos que o administrador que configurar esta integração tenha uma licença do Lucidspark. Também recomendamos usar uma conta de serviço do Jira ou uma conta de administrador do Jira.

Para configurar a instância do Jira Cloud para sincronização em tempo real com a Lucid, um administrador da conta pode concluir as seguintes etapas na Lucid: 

1. Na página inicial da Lucid, clique em Administrador no canto inferior esquerdo do menu de navegação.
2. Clique em Integração de aplicativos no menu à esquerda. 
3. No menu suspenso, selecione Lucidspark.
4. Localize o bloco Fichas da Lucid para o Jira Cloud e clique em Configurações.
5. Selecione Adicionar nova instância.
   

Isso abrirá a página de configurações do Jira Cloud, onde você precisa seguir estas etapas:

1. No menu suspenso "Autorizar para", selecione sua instância do Jira para o Lucidspark.
2. Clique em Aceitar.
   
3. Clique em Conectar para autenticar com as credenciais da sua instância do Jira.
4. Selecione Enviar.

A integração agora está configurada para sincronização em tempo real. 

Ativar instância do Jira Data Center

Siga os passos abaixo para configurar uma instância do Jira Data Center. Recomendamos usar o OAuth 2.0 para novas integrações. Se a sua conta foi conectada anteriormente usando Application Links (OAuth 1.0), você não precisa mudar, sua conexão existente continuará funcionando. Se precisar de suporte para o OAuth 1.0, consulte esta publicação da comunidade.

Embora os menus do Jira exibidos nesta seção possam variar dependendo da sua versão do Jira Data Center, o processo geral de configuração é o mesmo.

Certifique-se de que sua instância do Jira esteja acessível pelos servidores da Lucid

Certifique-se de que você tenha um DNS acessível publicamente e permita solicitações de entrada dos IPs estáticos listados abaixo.

Se você estiver no ambiente FedRAMP, certifique-se de permitir as solicitações de entrada e de saída dos IPs estáticos listados abaixo.

Conectar o Lucidspark ao Jira Data Center usando o OAuth 2.0

Você precisará de permissões de administrador do Jira e do Lucidspark, além de uma licença do Lucidspark, para concluir as etapas a seguir.

Etapa 1: criar um aplicativo OAuth 2.0 no Jira Data Center

Na sua instância do Jira Data Center, crie um link de aplicativo OAuth 2.0 de entrada:

1. No Jira, navegue até Configurações do Jira.
2. Acesse Aplicativos.
3. Escolha Links de aplicativos.
4. Selecione Criar link.
5. Escolha Aplicativo externo com a direção “Entrada”.
6. Selecione Continuar.
7. Defina o nome do aplicativo.
   • O nome que você escolher deve ser algo que represente a funcionalidade das Fichas da Lucid para o Jira; como "Lucidspark".
   • Defina a URL de redirecionamento como “https://lucid.app/jiradatacenter/oauth2/callback”.
8. Defina as permissões do aplicativo para incluir ADMIN.
9. Salve e copie a ID do cliente e o segredo do cliente gerados.

Passo 2: Configure a conexão na Lucid

1. Na Lucid, selecione Administrador no menu no canto inferior esquerdo da página inicial.
2. No menu à esquerda, selecione Integração de aplicativos.
3. No menu suspenso, clique em Lucidspark.
4. Localize o bloco “Fichas da Lucid para o Jira Data Center”.
5. Clique em Configurações no quadro (ou em Instalar se você ainda não tiver configurado a integração).
6. Selecione Adicionar nova instância (ou Iniciar configuração se você ainda não configurou a integração antes).
7. Verifique se o URL de redirecionamento corresponde ao que você configurou no Jira no link do aplicativo.
8. Insira o ID e o segredo do cliente do Jira.
9. Digite o URL da sua instância do Jira Data Center.
   • Por exemplo, isso pode ser algo como “https://jira.yourcompany.com”.
   • Se um proxy reverso estiver configurado para interceptar o tráfego de entrada antes que ele chegue à sua instância, você pode fornecer a URL desse proxy reverso. Esse proxy reverso deve permitir o tráfego de entrada dos nossos endereços IP listados aqui.

Etapa 3: Autorize a conexão

1. Clique em Habilitar para iniciar o fluxo de autorização OAuth 2.0.

Você será redirecionado para sua instância do Jira Data Center para aprovar o acesso. Após aprovar, você será redirecionado de volta ao Lucid. A integração agora está configurada para sincronização em tempo real.

Quando a configuração do administrador estiver concluída, os usuários finais poderão fazer a autenticação com suas próprias credenciais do Jira para importar e criar problemas do Jira no Lucidspark. Cada usuário será redirecionado para a tela de consentimento do Jira Data Center durante a primeira conexão.

Para contas que usam autenticação SSO com o Jira

Os servidores da Lucid precisam conseguir acessar sua instância do Jira Data Center. Se a sua instância do Jira Data Center estiver protegida por um fornecedor de SSO, isso poderá causar problemas, já que o SSO foi projetado para autenticar usuários em um navegador e muitas vezes não pode ser concluído por um serviço de back-end fazendo chamadas de API.

A resolução desse problema depende da sua configuração específica de rede e SSO. Você precisará configurar sua infraestrutura de SSO ou de rede para que o tráfego de servidor para servidor do Lucid ignore a interceptação de SSO. As abordagens comuns incluem a exclusão baseada em caminho na camada de SSO ou o roteamento do tráfego do Lucid totalmente fora do SSO. 

Usando OAuth 1.0 com SSO

Para links de aplicativo OAuth 1.0, consulte a solução alternativa da Atlassian nesta publicação da comunidade.

Configure sua instância do Atlassian Government Cloud para sincronização em tempo real

Você precisará de permissões de administrador no Jira e no Lucidspark para concluir as seguintes etapas. Exigimos que o administrador que estiver configurando esta integração tenha uma licença do Lucidspark. Também recomendamos usar uma conta de administrador do Jira.

Para configurar a instância do Atlassian Government Cloud para sincronização em tempo real com o Lucid, um administrador da conta pode concluir as seguintes etapas no Lucid: 

1. Na página inicial da Lucid, clique em Administrador no canto inferior esquerdo do menu de navegação.
2. Clique em Integração de aplicativos no menu à esquerda. 
3. No menu suspenso, selecione Lucidspark.
4. Clique em Adicionar nova instância do Atlassian Government Cloud.
5. Leia as permissões e clique em Aceitar.

A integração agora está configurada para sincronização em tempo real. 

Perguntas frequentes

Por que eu habilitaria a integração com o Jira Cloud ou Atlassian Government Cloud como administrador se ela não é obrigatória?
A partir de janeiro de 2023, o Lucidspark utiliza webhooks para sincronizar dados do Jira. Esta atualização permite que os murais recebam atualizações do Jira em tempo real. O Lucidspark só criará e gerenciará webhooks após uma autenticação única por meio das etapas de configuração da integração neste artigo. Se a integração for instalada individualmente por um usuário antes que essas etapas sejam concluídas, a integração funcionará, mas as fichas sincronizarão as atualizações do Jira aproximadamente a cada 2 minutos, em vez de em tempo real.

O que devo fazer se receber uma mensagem de erro ao tentar configurar a integração das Fichas da Lucid no Jira Data Center?
Ao configurar a integração do Jira Data Center, se você encontrar um erro de aplicativo, consulte esta publicação da comunidade: Dicas para resolver erros comuns ao configurar as Fichas da Lucid para o Jira Data Center.

Como funciona essa integração e de quais permissões preciso?
Para obter uma explicação detalhada de como essa integração funciona e suas permissões com base no fato de você ter credenciais de usuário ou administrador do Jira, consulte nosso recurso Fichas da Lucid para o Jira Technical FAQs. Este recurso inclui uma análise detalhada sobre como as credenciais de administrador são usadas, webhooks e seus benefícios e como os dados do Jira são protegidos.

Por que estou sendo redirecionado para lucid.app quando tento configurar a integração das Fichas da Lucid para o Jira com minha instância do Atlassian Government Cloud?
Para evitar ser redirecionado para lucid.app, você precisará usar o SSO para fazer login na sua instância do Atlassian Government Cloud antes de configurar a integração das Fichas da Lucid para o Jira.

Recursos

Para obter mais assistência para usar esta integração com sucesso, explore os recursos adicionais abaixo. Os recursos estão disponíveis apenas em inglês.

Publicações da comunidade

Resolução de problemas do Jira: não é possível editar um campo na Lucid - mensagem de erro “Edição não compatível”
Resolução de problemas do Jira: diferentes idiomas sendo adicionados como colunas à Tabela Dinâmica

Dar feedback sobre este artigo