Ir para o conteúdo

Conexão HTTP

Introdução

Uma conexão HTTP, criada usando o conector HTTP, estabelece acesso sobre o protocolo HTTP ou HTTPS a um serviço como uma API REST, API GraphQL ou formulário da web. Uma vez que uma conexão é configurada, é possível criar instâncias de atividades HTTP associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

Nota

Este conector suporta a Habilitar Re-autenticação em Caso de Mudança política de organização. Se habilitado, uma mudança na URL Base ou Nome de Usuário nesta conexão requer que os usuários reentrem a Senha para a conexão.

Importante

Com o lançamento do conector HTTP v2, recomendamos converter conexões e atividades HTTP existentes para HTTP v2. Saiba mais sobre os benefícios do conector HTTP v2 em nosso post no blog sobre HTTP v2 ou veja uma comparação das funcionalidades dos conectores HTTP e HTTP v2.

A intenção de longo prazo da Jitterbit é descontinuar o conector HTTP, o que será anunciado de acordo com a política de fim de vida da Jitterbit. No momento, não há um cronograma para descontinuação e o conector HTTP continua totalmente suportado. Recomendamos que você converta conexões e atividades HTTP existentes para HTTP v2 sempre que possível.

Criar ou editar uma conexão HTTP

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

Uma conexão HTTP existente pode ser editada a partir destes locais:

Configurar uma conexão HTTP

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

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 único para cada conexão HTTP e não deve conter barras (/) ou dois-pontos (:). Este nome também é usado para identificar o endpoint HTTP, que se refere tanto a uma conexão específica quanto às suas atividades.

  • URL Base: Insira uma URL base válida para a conexão. Para usar criptografia SSL, basta usar https:// na URL. Não inclua parâmetros de consulta ou caminhos, a menos que sejam usados para todas as atividades associadas (Você poderá especificar caminhos e parâmetros exclusivos durante a configuração da atividade.). A URL final será concatenada a partir da URL Base fornecida aqui juntamente com quaisquer caminhos especificados durante a configuração da atividade.

  • Nome de usuário e Senha: Se aplicável, insira um nome de usuário e uma senha que permitirão o acesso ao servidor HTTP. Você pode deixar esses campos em branco para autenticação anônima se nenhum nome de usuário ou senha for necessário.

  • Certificado: Use o menu para selecionar um certificado disponível para autenticar com o servidor HTTP. Você pode gerenciar certificados SSL do lado do cliente no Console de Gerenciamento em Personalizações > Certificados do Cliente.

  • Tentar Novamente: Funcional apenas ao usar um ambiente associado a um grupo de agentes privados, esta configuração é usada para tentar novamente uma solicitação quando um endpoint HTTP retorna um desses códigos de status: 500, 502, 503 ou 504.

    Esta configuração entra em vigor quando usada com agentes privados versão 10.22 ou posterior.

    Nota

    Para agentes privados versão 10.30 a 10.33, a configuração RecoverableStatusCode e a lista de códigos de erro devem ser adicionadas manualmente ao arquivo de configuração do agente privado.

    Selecione a caixa de seleção Tentar Novamente para expandir opções de configuração adicionais.

    • Intervalo de Tentativa (Segundos): Insira o número de segundos (máximo de 5 segundos) a esperar antes de reenviar uma solicitação ao endpoint HTTP.

    • Máximo de Tentativas: Insira o número máximo de vezes (recomendado não mais que 5 vezes) para tentar enviar uma solicitação ao endpoint HTTP. Se a solicitação ainda falhar após o número máximo de tentativas, uma exceção com uma mensagem de erro será retornada no log de operações. Além disso, o agente privado registrará cada tentativa no arquivo de log jitterbit.log.

      Cada tentativa é tratada como parte da mesma execução de operação, onde apenas um único registro aparece no log de operações. Quaisquer ações de operação configuradas para executar operações subsequentes são acionadas com base no status final da operação após tentar até o número máximo de tentativas.

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

    • Opção de Segurança: Se aplicável, selecione Usar Autenticação HTTP Básica para autenticar com o host usando autenticação HTTP básica sem criptografia SSL. Observe que, se esta opção for utilizada, a senha fornecida é enviada em texto claro. (A menos que seja necessário, isso não é recomendado.)

      Se esta opção não for utilizada, por padrão, o Harmony negocia com o endpoint para determinar quais métodos de autenticação são suportados e usa as credenciais fornecidas contra um dos protocolos. Além do HTTP Básico, o Harmony suporta estas opções de autenticação HTTP:

      • HTTP Digest

      • HTTP Digest com autenticação com um sabor do IE

    • Ignorar Linhas: Se houver cabeçalhos e/ou rodapés nos dados de origem que você deseja ignorar, insira o número de linhas a serem ignoradas nos campos Primeiro e Último.

      Nota

      Esta configuração não tem efeito quando atividades HTTP são referenciadas de um script usando as funções ReadFile ou WriteFile.

    • Configurações de Proxy: Se você deseja especificar um proxy personalizado, use o menu suspenso para selecionar uma dessas opções:

      • Padrão: As configurações de proxy estão habilitadas, usando a configuração de proxy do agente privado se existir. Se as configurações de proxy não forem especificadas na configuração do agente, então a configuração Padrão tem o mesmo resultado que a configuração Desativar.

      • Desativar: As configurações de proxy estão desativadas para esta conexão específica, ignorando a configuração de proxy do agente privado se existir.

      • Personalizado: As configurações de proxy estão habilitadas para esta conexão específica usando as informações personalizadas fornecidas aqui. Esta opção ignora a configuração de proxy do agente privado se existir e, em vez disso, usa informações de proxy personalizadas. Quando Personalizado é selecionado, campos adicionais ficam disponíveis para você configurar. Para detalhes sobre esses campos, consulte Habilitando proxy para agentes privados.

        Nota

        Campos adicionais com um ícone de variável suportam variáveis com 10.66 agentes e posteriores.

    • Propriedades HTTP Avançadas: Se aplicável, defina estas opções avançadas:

      • Content-Type: Insira o tipo de conteúdo da estrutura de solicitação que é esperada pela API específica. Se o método utilizado não aceitar dados estruturados, ou se a API não exigir que o tipo de conteúdo seja especificado, você pode deixar este campo em branco. Exemplos de tipos de conteúdo incluem text/plain, application/json, application/x-www-form-urlencoded, etc.

      • Habilitar Codificação de Conteúdo: Se selecionado, o cabeçalho Accept-Encoding é enviado com a codificação suportada pelo Harmony. Atualmente, Gzip é suportado.

      • Habilitar Codificação de Transferência Chunked: Se selecionado, o cabeçalho Transfer-Encoding: chunked é enviado. Use esta opção se você estiver transferindo grandes conjuntos de dados.

      • Enviar Expect 100-continue: Se selecionado, o cabeçalho Expect: 100-continue é enviado. Com esta opção, nenhum dado é enviado até que o servidor HTTP tenha validado os cabeçalhos. Use esta opção se você estiver enviando grandes quantidades de dados, mas não quiser usar a codificação de transferência chunked.

      • Permitir Cifras Fracas: Selecione esta caixa de seleção para se comunicar com servidores HTTP que usam cifras fracas (DES/3DES e RC4).

      • Codificação de Aceitação HTTP Gzip: Selecionado por padrão, esta opção informa ao servidor HTTP que o Harmony pode aceitar uma resposta comprimida em Gzip. Em troca, o Harmony segue o padrão RFC 1952 e descomprime automaticamente as respostas HTTP em Gzip. Se o servidor não usar Gzip, o Harmony verifica que a resposta não está comprimida e a trata normalmente.

      • Apenas Aplicável ao Usar HTTPS: Use o menu para alterar a seleção de Negociar (padrão) para uma versão específica de SSL ou TLS, se necessário, selecionando entre SSLv3, TLSv1.0, TLSv1.1, TLSv1.2 ou TLSv1.X. Se o TLS 1.3 for necessário, selecione TLSv1.X.

  • Cabeçalhos de Requisição (Uma Linha por Cabeçalho): Qualquer texto inserido nesta caixa é enviado como um cabeçalho HTTP. Especifique cada cabeçalho em uma linha, a menos que o cabeçalho esteja formatado de acordo com o padrão HTTP. Este campo também suporta o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit substituindo variáveis entre colchetes [ ] por seus valores.

  • Teste: Clique para verificar a conexão enviando uma requisição HTTP GET sem autorizaçã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 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 pede para você confirmar que deseja excluir a conexão.

Próximos passos

Após a criação de uma conexão HTTP, você coloca um tipo de atividade na tela de design para criar instâncias de atividade que serão 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 mais detalhes, veja Menus de ações em Conceitos básicos do conector.

  • GET: Recupera informações sobre um recurso em um serviço acessível pelo protocolo HTTP ou HTTPS e pode ser usado como fonte ou alvo em uma operação.

  • PUT: Substitui um recurso existente em um serviço acessível pelo protocolo HTTP ou HTTPS e pode ser usado como fonte ou destino em uma operação.

  • POST: Cria um novo recurso em um serviço acessível pelo protocolo HTTP ou HTTPS e pode ser usado como fonte ou destino em uma operação.

  • DELETE: Exclui um recurso em um serviço acessível pelo protocolo HTTP ou HTTPS e pode ser usado como fonte ou destino em uma operação.

  • Custom: Executa um método HTTP especificado em um serviço acessível pelo protocolo HTTP ou HTTPS e pode ser usado como fonte ou destino em uma operação.