Ir para o conteúdo

Conexão Jira

Introdução

Uma conexão Jira, criada usando o conector Jira, estabelece acesso ao Jira. Uma vez que uma conexão é configurada, é possível criar instâncias de atividades do Jira associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).

Criar ou editar uma conexão Jira

Uma nova conexão Jira é criada usando o conector Jira a partir de uma destas localizações:

Uma conexão Jira existente pode ser editada a partir destas localizações:

Configurar uma conexão Jira

Cada elemento da interface da tela de configuração da conexão Jira é descrito abaixo.

A interface utilizada na configuração da conexão Jira depende da opção Mecanismo de Autenticação selecionada:

Nota

Autenticação baseada em Credenciais deve ser usada para configurar um endpoint global.

Autenticação baseada em credenciais

Quando Autenticação baseada em Credenciais é selecionada como o Mecanismo de Autenticação, a interface descrita abaixo é apresentada.

Dica

Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de variável para exibir um menu com as variáveis existentes para escolher.

  • Nome da conexão: Insira um nome para identificar a conexão. O nome deve ser exclusivo para cada conexão Jira e não deve conter barras / ou dois pontos :. Este nome também é usado para identificar o endpoint Jira, que se refere tanto a uma conexão específica quanto às suas atividades.

  • Mecanismo de autenticação: Selecione Autenticação baseada em Credenciais para autenticar usando um nome de usuário e um token de API ou senha (descrito abaixo).

  • Tipo de instância: Selecione um tipo de instância na lista, seja Jira Cloud ou Jira On-premise:

    • Jira Cloud: Conectar ao Jira Software Cloud.

    • Jira On-premise: Conectar ao Jira Server ou Jira Data Center.

  • Hostname: Insira o hostname do Jira. O nome pode ser precedido por https:// ou http://. Se não fornecido, assume-se https://.

  • Nome de usuário: Insira o nome de usuário do Jira.

  • Versão do Jira Server: Quando Jira On-premise é selecionado como o Tipo de instância, selecione a versão do Jira Server ou Jira Data Center a ser usada, uma das seguintes: 9.17.2, 9.17.1, 9.17.0, 9.12.12, 9.12.9, 9.12.8, 9.12.7, 9.4.3 ou 8.22.3 (não recomendado).

  • Tipo de autenticação: Selecione o tipo de autenticação para a instância do Jira, seja Token de API ou Senha. Esta opção é visível apenas quando Jira On-premise é selecionado como o Tipo de Instância. Se Jira Cloud for selecionado como o Tipo de Instância, você deve inserir um token de API para autenticação.

  • Token de API: Insira o token de API para a instância do Jira.

  • Senha: Insira a senha para a instância do Jira.

  • Usar Configurações de Proxy (Apenas Agente Privado): Ao usar um agente privado, esta configuração pode ser selecionada para usar as configurações de proxy do agente privado.

  • Configurações Opcionais: Clique para expandir configurações opcionais adicionais:

    • Usar SSL: Ao usar um agente privado, selecione para autenticar a conexão usando o Secure Sockets Layer (SSL) do cliente.

      Importante

      Ao usar esta opção, um certificado deve ser adicionado ao Jitterbit Java KeyStore.

    • Habilitar Verificador de Nome de Host: Ao usar um certificado autoassinado, selecione para evitar que a solicitação HTTP seja bloqueada pelo conector.

    • Protocolo de Segurança: Quando Usar SSL é selecionado, use o menu para selecionar o protocolo de segurança a ser utilizado, seja TLSv1.2 ou TLSv1.3. Para mais informações sobre esses protocolos, consulte o RFC 6347 (TLS v1.2) ou 8446 (TLS v1.3).

  • Testar: Clique para verificar a conexão usando a configuração fornecida. Quando a conexão é testada, a versão mais recente do conector é baixada pelo(s) agente(s) no grupo de agentes associado ao ambiente atual. Este conector suporta suspender o download da versão mais recente do conector usando a política de organização Desativar Atualização Automática do Conector.

  • Salvar Alterações: Clique para salvar e fechar a configuração da conexão.

  • Descartar Alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem pede para você confirmar que deseja descartar as alterações.

  • Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (veja Dependências de componentes, exclusão e remoção). Uma mensagem solicita que você confirme que deseja excluir a conexão.

OAuth

Quando OAuth é selecionado como o Mecanismo de Autenticação, a interface descrita abaixo é apresentada.

Dica

Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de variável para exibir um menu com as variáveis existentes para escolher.

  • Nome da conexão: Insira um nome para identificar a conexão. O nome deve ser exclusivo para cada conexão Jira e não deve conter barras / ou dois pontos :. Este nome também é usado para identificar o endpoint Jira, que se refere tanto a uma conexão específica quanto às suas atividades.

  • Mecanismo de autenticação: Selecione OAuth para autenticar usando um aplicativo de OAuth 2.0 de 3 etapas. Quando este mecanismo de autenticação é selecionado, o campo Aplicativo OAuth fica disponível (descrito abaixo). Esta opção requer o uso da versão do agente 10.83 / 11.21 ou posterior.

  • Tipo de instância: Selecione um tipo de instância na lista, seja Jira Cloud ou Jira On-premise:

    • Jira Cloud: Conectar ao Jira Software Cloud.

    • Jira On-premise: Conectar ao Jira Server ou Jira Data Center.

  • Nome do host: Quando Jira On-premise é selecionado como o Tipo de instância, insira o nome do host Jira. O nome pode ser precedido por https:// ou http://. Se não fornecido, assume-se https://.

  • Versão do Jira Server: Quando Jira On-premise é selecionado como o Tipo de Instância, selecione a versão do Jira Server ou Jira Data Center a ser utilizada, uma das seguintes: 9.17.2, 9.17.1, 9.17.0, 9.12.12, 9.12.9, 9.12.8, 9.12.7, 9.4.3, ou 8.22.3 (não recomendado).

  • Aplicativo OAuth: Use o menu para selecionar um aplicativo OAuth 2.0 de uma dessas categorias:

    • Aplicativos em Nuvem: O aplicativo nesta categoria (Jitterbit App) é um aplicativo OAuth 2.0 fornecido pela Jitterbit. Este aplicativo é visível apenas ao usar um grupo de agentes em nuvem e quando Jira Cloud é selecionado como o Tipo de Instância.

    • Aplicativos Privados: Esta categoria exibe aplicativos de conector Jira configurados na página Registros de Aplicativos do Console de Gerenciamento. Para configurar um aplicativo de conector Jira na página Registros de Aplicativos, você deve primeiro configurar um aplicativo OAuth 2.0 de 3 etapas para a instância do Jira.

  • Entrar com Jira: Clique para autenticar com o aplicativo OAuth selecionado. Ao usar um Aplicativo Privado, você será direcionado para a URL especificada na URL de Autenticação configurada do aplicativo de conector (veja Registros de Aplicativos). Ao usar o Jitterbit App, você será direcionado para permitir que o Jitterbit App acesse a instância do Jira. Após autenticar com sucesso, esses campos ficam disponíveis:

    • Receber Notificação de Inatividade: Quando Ativar expiração de inatividade do token de atualização está habilitado na aba Política de Token do registro do aplicativo (sob Opções Avançadas), selecione para receber uma notificação por email (e uma notificação através do portal Harmony) após o número definido de dias de inatividade do usuário ter passado.

      • Dias para Notificação de Inatividade: Insira o número de dias inativos para acionar a notificação. O padrão é 30 dias.

    • Receber Notificação de Expiração: Quando Ativar expiração do token de atualização está habilitado na aba Política de token do registro do aplicativo (sob Opções avançadas), selecione para receber uma notificação por email (e uma notificação através do portal Harmony) uma vez que a quantidade de dias definida antes da expiração do aplicativo OAuth 2.0 tenha sido atingida.

      • Dias para Notificação de Expiração: Insira o número de dias para acionar a notificação. O padrão é 30 dias.

      Nota

      Quando a Receber Notificação de Inatividade ou Receber Notificação de Expiração está configurada, a notificação é enviada aos administradores da organização Harmony (membros de um papel com a permissão Admin e o usuário que implantou o projeto por último.

  • Usar Configurações de Proxy (Apenas Agente Privado): Ao usar um agente privado, esta configuração pode ser selecionada para usar configurações de proxy do agente privado.

  • Configurações Opcionais: Clique para expandir configurações opcionais adicionais:

    • Usar SSL: Ao usar um agente privado, selecione para autenticar a conexão usando Secure Sockets Layer (SSL) do cliente.

      Importante

      Ao usar esta opção, o SSL deve ser configurado para o cliente JMS e um certificado deve ser adicionado ao Jitterbit Java KeyStore.

    • Ativar Verificador de Nome de Host: Ao usar um certificado autoassinado, selecione para evitar que a solicitação HTTP seja bloqueada pelo conector.

    • Protocolo de Segurança: No menu, selecione o protocolo de segurança a ser utilizado, seja TLSv1.2 ou TLSv1.3. Para mais informações sobre esses protocolos, consulte os RFCs 6347 (TLS v1.2) ou 8446 (TLS v1.3).

  • Teste: Clique para verificar a conexão usando a configuração fornecida. Quando a conexão é testada, a versão mais recente do conector é baixada pelo(s) agente(s) no grupo de agentes associado ao ambiente atual. Este conector suporta a suspensão do download da versão mais recente do conector usando a Desativar Atualização Automática do Conector política da organização.

  • Salvar Alterações: Clique para salvar e fechar a configuração da conexão.

  • Descartar Alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem pede que você confirme que deseja descartar as alterações.

  • Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (veja Dependências de componentes, exclusão e remoção). Uma mensagem pede que você confirme que deseja excluir a conexão.

Próximos passos

Após a criação de uma conexão Jira, você coloca um tipo de atividade na tela de design para criar instâncias de atividade a serem usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

As ações do menu para uma conexão e seus tipos de atividade estão acessíveis no painel do projeto e na paleta de componentes de design. Para detalhes, veja Menus de ações em Noções básicas sobre conectores.

Estes tipos de atividade estão disponíveis:

  • Pesquisar: Recupera dados de objeto de um projeto Jira e é destinado a ser usado como uma fonte em uma operação.

  • Problema: Cria, atualiza ou exclui um problema em um projeto Jira e é destinado a ser usado como um alvo em uma operação.

  • Criar: Cria dados de objeto em um projeto Jira e é destinado a ser usado como um alvo em uma operação.

  • Atualizar: Atualiza os dados do objeto em um projeto Jira e é destinado a ser usado como um alvo em uma operação.

  • Painel de Busca: Recupera dados do painel do Jira e é destinado a ser usado como uma fonte em uma operação.

  • Excluir: Exclui os dados do objeto do Jira e é destinado a ser usado como um alvo em uma operação.

  • Transição: Recupera ou atualiza problemas do Jira e é destinado a ser usado como um alvo em uma operação.

  • Filtro de Busca: Recupera dados de filtro do Jira e é destinado a ser usado como uma fonte em uma operação.