Conectar ao Jira on-premise com servidores de autorização de terceiros usando OAuth2.0

Quem pode fazer isso: Admins da empresa
Quais planos: Enterprise

✏️ Conectar o Jira usando um servidor de autorização só é habilitado no nível da organização.

Este artigo fornece as etapas para conectar Miro ao Jira com um servidor de autorização de terceiros, no local, usando OAuth2.0. 

Para aprender os detalhes técnicos sobre esta configuração, consulte o artigo de referência para Jira on-premise com autorização de terceiros usando OAuth 2.0.

Pré-requisitos

• Verifique se você tem as seguintes permissões:
  • Admin da empresa Miro
  • (Opcional) Admin do sistema Jira, se você quiser usar webhooks automáticos.
• No seu servidor de autorização, crie um app OAuth 2.0.
• Configurar o URL de redirecionamento no seu aplicativo OAuth 2.0 para o seguinte URL:
  https://integrations.miro.com/api/external-auth/oauth2/callback
• Certifique-se de ter os seguintes detalhes do seu aplicativo OAuth 2.0 prontos para configurar na Miro:
  • URL de autorização
  • URL do token
  • ID do cliente
  • Segredo do cliente
  • Escopo

Conectar-se ao Jira local com servidores de terceiros usando OAuth 2.0

1. No seu painel da Miro, selecione seu avatar no canto superior direito e vá para admin console | Configurações.
2. Vá para Aplicativos e integrações > Aplicativos > Guia Gerenciar aplicativos .
3. Certifique-se de que Permitir apenas aplicativos da lista abaixo esteja habilitado.
4. Na coluna App, para cartões do Jira selecione Configurações.
5. Clique em Adicionar nova conexão.
6. Em configuração do Jira, clique em Jira Data Center.
7. Em Método de autenticação, selecione OAuth 2.0 via Servidor de Autorização de Terceiros.
8. No campo Jira URL, insira o URL da sua instância do Jira.

   ✏️ Você pode adicionar seu URL base externo do Jira ou seu URL interno do Jira. Se você usar uma URL interna do Jira, então deve especificar o URL do seu gateway de API externo na etapa 10.

   ✏️ Em geral, usar uma URL interna permite ajustar a funcionalidade de navegação para a fonte.

9. (Opcional) Para tornar esta conexão a conexão padrão para todos os times da sua organização, marque Tornar Padrão.
10. (Opcional) Se você usar um gateway de API para fazer solicitações ao Jira, então para URL base do Jira API Gateway, insira seu URL de gateway de API externo.
11. Insira os seguintes detalhes do seu aplicativo OAuth 2.0:
    • URL de autorização
    • URL do token
    • ID do cliente
    • Segredo do cliente
    • Escopo
12. (Opcional) Para receber atualizações em tempo real do Jira na Miro, marque Criar webhook automaticamente.

    ✏️ Você pode adicionar o webhook manualmente depois.

13. Clique em Conectar.
14. Siga o fluxo de autenticação para o seu servidor de autorização. Se solicitado, faça login no seu ambiente.
    Quando sua conexão é concluída, sua instância do Jira é listada em Instâncias conectadas com a seguinte tag: Servidor de autenticação.

Garanta que seu time possa se autenticar

Agora que você conectou sua instância do Jira no nível da organização, pode começar a usar o Jira no nível do time.

1. No seu painel da Miro, selecione seu avatar no canto superior direito e vá para Console de Admin.
2. Selecione Times > Seu time.
   O controle deslizante do seu time abre.
3. Selecione a guia Apps.
4. Na lista de aplicativos, selecione cartões do Jira.
5. Em Configurações do admin, verifique se sua configuração do Jira mostra a etiqueta GLOBAL CONNECTION e exibe a URL correta da instância do Jira. Em seguida, faça um dos seguintes:
   • Se sim, você completou este procedimento. Você pode pular para E agora?
   • Se não, selecione Alterar configuração > Configurações da organização global > sua instância do Jira.
6. Selecione Salvar configurações.

O que vem a seguir?

Cada membro do time deve autorizar sua conta de usuário. Para garantir que cada usuário obtenha tokens de acesso e atualização, quando um membro do time tentar uma ação relacionada ao Jira em um board da Miro, será solicitado que autorizem sua conta.

Perguntas frequentes