Como configurar um conector

Entenda os detalhes da configuração de um conector no Tulip.

Neste artigo, você aprenderá* Como configurar um conector* O que significa cada entrada no modal de configuração

Visão geral

Os conectores permitem integrações entre sistemas e bancos de dados externos. Há dois tipos de conectores que discutiremos neste artigo: HTTP e SQL.

Confira o artigo "What Are Connectors?" (O que são conectores?) para saber exatamente quais são os conceitos e detalhes que um conector abrange.

Como configurar um novo conector

A configuração de um novo conector não exige um amplo conhecimento de APIs ou bancos de dados, mas é útil ter familiaridade com os tipos de conexão.

Para criar um conector, navegue até a página Conectores em Aplicativos. Clique em + Create Connector (Criar conector ) no canto superior direito. Dê um nome e uma descrição ao seu conector e, em seguida, escolha se é uma conexão HTTP ou SQL. Lembre-se: um conector HTTP se integra a um servidor de API, enquanto um conector SQL se conecta a um banco de dados externo.

Depois de clicar no botão Create ( Criar ) no modal Create Connector (Criar conector ), você será levado a uma página inicial para esse conector específico.

Aqui, você notará uma notificação vermelha de que esse conector está off-line no momento.

Para que o conector fique on-line, você precisa clicar no botão Production & Testing & Development para especificar o servidor ao qual deseja se conectar.

O que é preciso saber antes

Antes de começar, é importante observar que os conectores HTTP e SQL têm parâmetros de autenticação para garantir que qualquer pessoa que faça uma solicitação a um endpoint ou banco de dados tenha permissão para isso. Essas medidas estão em vigor para proteger seus dados e garantir o acesso seguro.

As seções a seguir o orientam sobre como configurar os conectores HTTP e SQL.

HTTP

Um conector HTTP se comunica com servidores de API. Os conectores HTTP da Tulip fazem interface com a maioria dos tipos de APIs, incluindo REST e SOAP.

Configuração

Para configurar um conector, você precisa ter em mãos algumas informações sobre o servidor ao qual está tentando se conectar. Essas informações incluem:

• O URL do host
• Se o servidor usa ou não um TLS
• Qualquer cabeçalho ou certificado necessário para autenticação

Você pode encontrar essas informações na documentação da API do servidor ao qual está se conectando. Isso geralmente requer uma pesquisa por "[nome do servidor] documentação da API".

Vamos explicar como fazer essa configuração:

Modal de configuração

Em execução - Faça solicitações para o host do conector. O host do Cloud Connector é fornecido pela Tulip e faz solicitações por meio da Tulip Cloud. Qualquer host de conector local que você tenha registrado em sua conta também aparecerá.Host - O endereço de rede, ou seja, um nome de host ou endereço IP, ao qual a Tulip se conecta.Porta - Seu servidor escuta as solicitações em uma porta de rede específica, fornecida pelo seu provedor de servidor. O padrão quase sempre é bom.TLS (Transport Layer Security) - A Tulip usa um TLS para criptografar seu tráfego ao se conectar ao servidor. Se a url começar com https, é TLS.

Autenticação

Headers - Fornece autenticação da origem dos dados, integridade dos dados e proteção contra repetição.Certs (Certificates) - Um certificado de servidor é enviado do servidor para o cliente no início de uma sessão e é usado pelo cliente para autenticar o servidor.

Os seguintes tipos de autenticação estão disponíveis para conectores HTTP:

Sem autentic ação - Nenhuma autenticação é necessária ou a autenticação está em outros cabeçalhos de solicitação, como x-auth-token.Autenticação básica - Autenticação básica, compartilha seu nome de usuário e senha.OAuth 2 (token de portador) - Os tokens de portador são o tipo predominante de token de acesso usado, eles consistem em uma cadeia de caracteres opaca, sem a intenção de ter significado para os clientes que a utilizam.OAuth 2 (operador) - Normalmente usado para clientes que exigem acesso a um conjunto limitado de recursos em nome de um usuário. Por exemplo, um aplicativo móvel que requer acesso aos contatos ou eventos do calendário de um usuário. Essa função concede ao cliente acesso a apenas um subconjunto específico de recursos, e o usuário deve conceder explicitamente permissão para que o cliente acesse esses recursos.OAuth 2 (Admin) - Usado para clientes que precisam de acesso a uma variedade maior de recursos ou funções administrativas. Essa função concede ao cliente amplo acesso à conta e aos recursos do usuário. Por exemplo, um cliente com acesso OAuth 2 (Admin) pode gerenciar as configurações da conta de um usuário, criar ou excluir recursos ou executar outras tarefas administrativas.OAuth 1.0 - Versão anterior do OAuth que lida principalmente com fluxos de trabalho da Web.

:::(Info) (OBSERVAÇÃO) Você pode configurar os cabeçalhos e certificados em um momento posterior. Os cabeçalhos também podem ser configurados na função de conector :::

Para saber mais sobre conectores HTTP, consulte Uma visão geral dos conectores HTTP.

SQL

Um conector SQL se comunica com bancos de dados externos. A configuração do conector é bastante simples, mas você precisará de algumas informações para torná-la rápida e perfeita.

Configuração

Para configurar um conector SQL, você precisará das seguintes informações:
* O tipo de banco de dados SQL * URL do servidor * Se o servidor usa ou não TLS * Seu nome de usuário e senha para autenticação

Vamos explicar como fazer essa configuração:

Modal de configuração

Em execução - Faça solicitações para o host do conector. O host do Cloud Connector é fornecido pela Tulip e faz solicitações por meio da Tulip Cloud. Qualquer host de conector local registrado em sua conta também aparecerá.Tipo - O tipo de banco de dados SQL ao qual você deseja se conectar. Escolha entre Microsoft SQL Server, MySQL, PostgreSQL ou OracleDB.Servidor - O endereço de rede, um nome de host ou endereço IP, ao qual a Tulip se conecta.Porta - Seu servidor escuta as solicitações em uma porta de rede específica, fornecida pelo seu provedor de servidor.SSL (Secure Sockets Layer) - Usado para criptografar conexões entre seus aplicativos clientes e suas instâncias que executam o servidor.Banco de dados - O nome do seu banco de dados.Usuário - Nome de usuário para o banco de dados.Senha - Senha para o banco de dados.

Autenticação

O processo de autenticação do SQL requer as credenciais de login de nome de usuário e senha do banco de dados ao qual você deseja se conectar.

Para obter mais informações sobre os conectores SQL, consulte [An Overview of SQL Connectors].

Colocando o conector on-line

Depois de inserir todos os campos corretamente, clique no botão Testar no canto inferior direito do Modal de configuração. O conector leva alguns segundos para testar e certificar a conexão com o servidor. Se você inserir informações precisas durante a configuração, o status será alterado para Online.

Se o conector ainda aparecer off-line, revise as informações que você inseriu e verifique se estão corretas.

Para obter mais informações, consulte também nosso guia Solução de problemas de conectores.

Leitura adicional

• Introdução aos Hosts de Conectores Tulip

Encontrou o que estava procurando?

Você também pode ir para community.tulip.co para postar sua pergunta ou ver se outras pessoas tiveram uma pergunta semelhante!