Ir para o conteúdo

Conexão Jira

Introdução

Uma conexão Jira, criada usando o conector Jira, estabelece acesso a Jira. Depois que uma conexão for configurada, você poderá 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 do Jira é criada usando o conector do Jira em um destes locais:

Uma conexão Jira existente pode ser editada nestes locais:

Configurar uma Conexão Jira

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

A interface usada 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 uma conexão global.

Autenticação Baseada em Credenciais

Quando Autenticação baseada em credenciais é selecionado como o Mecanismo de autenticação, esta interface é apresentada:

Configuração de conexão Jira

Dica

Campos com ícone de variável Ícone de variável suporte usando variáveis globais, variáveis do projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone da variável para exibir uma lista das variáveis existentes para escolher.

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

  • Nome do host: Insira o nome do host do Jira. O nome pode ser precedido por https:// ou http://. Se não for fornecido, https:// é assumido.

  • 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).

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

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

    • Jira Cloud: Conecte-se ao Jira Software Cloud.

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

  • Versão do Jira Server: Quando Jira On-premise for selecionado como Tipo de instância, selecione a versão do Jira Server ou do Jira Data Center a ser usada, 8.22.3 ou 9.4.3.

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

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

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

  • Usar configurações de proxy (somente 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 autenticar a conexão usando o cliente Secure Sockets Layer (SSL).

      Importante

      Ao usar esta opção, um certificado deve ser adicionado ao Jitterbit Java repositório de chaves.

    • 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: Quando Usar SSL estiver selecionado, use o menu para selecionar o protocolo de segurança a ser usado, TLSv1.2 ou TLSv1.3. Para obter mais informações sobre esses protocolos, consulte RFC 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 pelos agentes 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 solicita 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 (consulte Dependências, exclusão e remoção de componentes). Uma mensagem solicita que você confirme que deseja excluir a conexão.

OAuth

Quando OAuth é selecionado como o Mecanismo de Autenticação, esta interface é apresentada:

Configuração de conexão Jira

Dica

Campos com ícone de variável Ícone de variável suporte usando variáveis globais, variáveis do projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone da variável para exibir uma lista das variáveis existentes para escolher.

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

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

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

    • Jira Cloud: Conecte-se ao Jira Software Cloud.

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

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

  • Versão do Jira Server: Quando Jira On-premise for selecionado como Tipo de instância, selecione a versão do Jira Server ou do Jira Data Center a ser usada, 8.22.3 ou 9.4.3.

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

    • Aplicativos em nuvem: O aplicativo nesta categoria (Jitterbit App) é um aplicativo OAuth 2.0 fornecido pela Jitterbit. Este aplicativo fica visível somente ao usar um Grupo de Agentes em Nuvem e quando Jira Cloud é selecionado como Tipo de instância.

    • Aplicativos privados: Esta categoria exibe os aplicativos do conector Jira configurados no Management Console Registros de aplicativos página. Para configurar um aplicativo do conector Jira na página Registros de aplicativos, você deve primeiro configurar um OAuth 2.0 de três pernas para a instância do Jira.

  • Faça login com Jira: Clique para autenticar com o Aplicativo OAuth selecionado. Ao usar um Aplicativo Privado, você será direcionado para o URL especificado no URL de Autenticação configurado do aplicativo conector (consulte 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 a autenticação bem-sucedida, estes campos ficam disponíveis:

    • Receber notificação de inatividade: Quando Ativar expiração de inatividade do token de atualização estiver ativado na Política de token aba (em Opções avançadas, selecione para receber uma notificação email (e uma notificação em todo o Portal Harmony ) após o período definido de dias de inatividade do usuário.

      • 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 estiver ativado na Política de token aba (em Opções avançadas, selecione para receber uma notificação email (e uma notificação em todo o Portal Harmony ) assim que o número definido de dias antes da expiração do aplicativo OAuth 2.0 for atingido.

      • 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 Receber Notificação de Inatividade ou Receber Notificação de Expiração é definido, a notificação é enviada aos administradores da organização Harmony (membros de uma papel com a permissão Admin e o usuário que implantou o projeto pela última vez.

  • Usar configurações de proxy (somente 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 autenticar a conexão usando o cliente Secure Sockets Layer (SSL).

      Importante

      Ao usar esta opção, o SSL deve ser configurado para o cliente JMS e um certificado deve ser adicionado ao Jitterbit Java repositório de chaves.

    • 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 usado, TLSv1.2 ou TLSv1.3. Para obter mais informações sobre esses protocolos, consulte 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 pelos agentes no grupo de agentes associado ao ambiente atual. Este conector oferece suporte à 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 solicita que você confirme que deseja descartar as alterações.

  • Excluir: Depois de abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (consulte Dependências, exclusão e remoção de componentes). Uma mensagem solicita 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 quadro de design para criar instâncias de atividade a serem usadas como fontes (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).

As ações de menu para uma conexão e seus tipos de atividade podem ser acessados no painel do projeto e na paleta de componentes de design. Para obter detalhes, consulte Menus de ações em Noções básicas do conector.

Estes tipos de atividades estão disponíveis:

  • Procurar: Recupera dados de objeto de um projeto Jira e deve ser usado como fonte em uma operação.

  • Emitir: Cria, atualiza ou exclui um problema em um projeto Jira e deve ser usado como destino em uma operação.

  • Criar: Cria dados de objeto em um projeto Jira e deve ser usado como destino em uma operação.

  • Atualizar: Atualiza os dados do objeto em um projeto Jira e deve ser usado como destino em uma operação.

  • Painel de pesquisa: Recupera dados do painel do Jira e deve ser usado como fonte em uma operação.

  • Excluir: Exclui dados de objeto do Jira e deve ser usado como destino em uma operação.

  • Transição: Recupera ou atualiza problemas do Jira e deve ser usado como destino em uma operação.

  • Filtro de pesquisa: Recupera dados de filtro do Jira e deve ser usado como origem em uma operação.