Configurando Connectors

Cada conector tem propriedades específicas de conexão. Essas propriedades são variáveis intrínsecas a cada tipo de conector, que representam diferentes configurações necessárias para que a conexão aconteça.

Por exemplo, um conector do tipo Database deve conter valores informando o nome do banco de dados, usuário e senha para acesso, database schema a ser utilizado, endereço do banco, entre outros.

Os valores dessas propriedades devem ser especificados previamente como variáveis de ambiente, na seção Environment Variables de um ambiente, dentro do menu Environments do Manager.

Como cada tipo de conector tem variáveis de ambiente diferentes, listamos os campos que você precisa preencher para cada conector. Acessando a página de informações técnicas, você consegue selecionar o grupo de conectores e encontrar o tipo específico que você precisa.

No exemplo da imagem abaixo, estamos estabelecendo as variáveis de ambiente para um Oracle Connector.

Agora o novo conector já pode ser registrado no menu API Connectors do Manager.

Para disponibilizar um novo conector a partir do qual criar recursos, clique no botão flutuante + (Create Connector) e selecione o tipo do novo conector.

No exemplo acima, há três tipos disponíveis: MySQL e Oracle (dentro do grupo Database) e AWS Lambda (dentro do grupo Cloud Providers).

Ao selecionar o tipo, duas informações obrigatórias devem ser informadas: Name e Description.

Após o preenchimento, as informações Connector ID e Factor (necessárias para a aplicação ser iniciada) são geradas.

Para executar o conector, é necessário baixá-lo na máquina. Para isso, é um pré-requisito ter Java 8 (ou superior) ou Docker instalado. Na mesma tela, você vê as instruções para baixar o conector pela linha de comando. São duas opções: Command JAR (no caso de Java) e Command image (para Docker).

Com a aplicação rodando, é necessário preencher a informação faltante na tela do Manager (endpoint) para cadastrar o conector (clicando em Register Connector), conforme a imagem abaixo. Nesta páginaOn this page, o endpoint é o endereço da máquina onde o conector está rodando.

Após o cadastro bem-sucedido, as demais informações de configuração serão exibidas:

É necessário apontar qual environment será configurado, e é possível escolher um ou mais environments. No caso de múltiplos environments, todas as variáveis de todos os ambientes devem ter o mesmo nome. Por exemplo: se apontarmos o "environment 1" e o "environment 2", é preciso que a variável "user" esteja cadastrada em ambos.

Quando pelo menos um environment for apontado, as variáveis ficarão disponíveis nos campos para serem selecionadas. Após o preenchimento dos campos, a opção Test Connection para validar as informações será habilitada.

Caso existam mais environments para o mesmo conector, os status de conexão de cada um serão exibidos em sequência, com mensagem de erro de conexão se houver algum. Após essa etapa, o conector pode ser salvo e estará apto para ser configurado no recurso de uma API. Leia mais sobre isso aqui.

Existe também a possibilidade de configurações extras de segurança para o conector, como os interceptores de Rate Limit, Payload Size e IP Filtering. O conector só utilizará essas configurações caso elas estejam corretamente preenchidas — ou seja, nenhuma delas é obrigatória.

Para configurar o interceptor de Rate Limit, é necessário informar a quantidade de requisições permitidas para um determinado intervalo em segundos, minutos, horas, dias ou meses. Em Payload Size, a informação é esperada em kB, possibilitando um payload de requisição que seja menor do que o configurado. Já o IP Filtering obedece tanto à configuração manual de IPs quanto ao padrão CIDR — as requisições serão respondidas apenas se o IP de origem estiver configurado.