Conectores, configuração e autenticação

Alcance e critérios de compatibilidade

Uma Connection reúne endereço, metadados, método de autenticação e custódia das credenciais. Um componente de Mapping seleciona essa conexão e define a operação sobre um recurso. O Worker executa a operação com suas capacidades e permissões efetivas. São três contratos distintos: criar uma conexão não garante que um provedor ofereça todas as formas de leitura, gravação ou recuperação.

Use esta matriz para preparar os dados do formulário Connections. Os identificadores em código ajudam a reconhecer configurações e interpretar erros. Um asterisco indica um campo obrigatório no catálogo do formulário; outros campos podem se tornar obrigatórios pela autenticação, pelo protocolo ou pela validação do provedor. As portas são valores iniciais, não orientações para abrir acesso de rede indiscriminadamente. O endpoint precisa pertencer ao ambiente autorizado da organização.

Matriz do catálogo de conexões

A matriz reúne as entradas declaradas pelo formulário. A oferta efetiva da instalação vem do catálogo disponível e pode ser menor. Ela não afirma que uma identidade vinculada funcione fora de sua nuvem nem que qualquer Worker tenha o driver instalado. PostgreSQL aparece na interface; o registro genérico de conectores não é o único mecanismo de integração com PostgreSQL.

Interpretação dos métodos

O catálogo geral de autenticação também define oracle_wallet, oci_resource_principal, web_identity e instance_profile. Eles não são opções independentes nas entradas desta matriz; sua existência não permite selecioná-los para qualquer conector. Para Amazon S3, aws_iam contempla a identidade já vinculada ao runtime.

Variações que mudam a preparação

Em BigQuery, Database significa Project ID e Schema significa Dataset. Em Oracle, Database aparece como Service name. Databricks exige HTTP path e Catalog. Snowflake solicita Database e Warehouse; Role e Schema completam o contexto. Nome de banco, caminho HTTP e identificador de projeto têm significados diferentes, mesmo sendo textos.

Salesforce parte da API version v65.0; exige a URL My Domain e a configuração correspondente de aplicativo e integração. Dynamics 365 solicita Directory (tenant) ID e deriva o scope do ambiente. Odoo identifica explicitamente sua API JSON-2 da versão 19 ou posterior. SharePoint acrescenta Site ID ou caminho relativo do site. Essas diferenças pertencem ao contrato do conector, não a uma opção genérica de SQL.

A entrada FTP / SFTP permite selecionar o protocolo. SFTP inicia na porta 22; FTP e FTPS, na 21. A chave SSH só fica disponível para SFTP. A opção TLS é ajustada conforme o protocolo: FTP não equivale a uma conexão criptografada. Mantenha a política de transporte exigida pela organização.

Custódia e preparação segura

Dova Worker Agent mantém o segredo no ambiente do cliente. Customer vault armazena uma referência ao segredo em um cofre externo. Passwordless usa uma identidade de execução sem armazenar um segredo reutilizável. Dova Vault é uma modalidade de exceção com entrada criptografada que não volta a mostrar o valor. Managed reference identifica referências gerenciadas existentes.

Os provedores de referências reconhecidos pelo formulário incluem AWS Secrets Manager, Azure Key Vault, Google Secret Manager, HashiCorp Vault, CyberArk Conjur e Kubernetes Secret. Cada um valida seu próprio formato de referência. Uma URI válida não comprova que o Worker consiga resolvê-la: confira identidade, rede e autorização do cofre. Nunca substitua uma referência pelo valor do segredo em nomes, descrições ou arquivos de evidência.

O seletor de autenticação depende da custódia. Passwordless filtra os métodos sem segredo; a modalidade protegida oferece os métodos correspondentes. Se uma combinação não tiver métodos válidos, ajuste a custódia ou o conector conforme o projeto, sem forçar valores ocultos do formulário.

Prova de conceito de conectividade e resultados esperados

Prepare um recurso isolado com dois registros sintéticos e uma identidade limitada à leitura. Crie a conexão no tenant de testes, preencha endpoint e metadados, selecione a custódia e salve. Execute a verificação de conexão pela interface. Registre conector, Worker, horário e resultado, sem material secreto. Depois selecione a Connection no componente de origem correspondente e leia somente o recurso de teste.

O resultado esperado tem dois níveis: a verificação confirma as condições que o conector testa; a leitura confirma o acesso ao objeto e a projeção dos dois registros. Uma conexão aprovada não comprova uma gravação aprovada. Para avaliar um destino, use outro recurso descartável, teste o modo escolhido e compare chaves, quantidade e conteúdo. Esta sequência é uma prática reproduzível, não um resultado de conectividade já obtido no seu ambiente.

Diagnóstico e limites

Em uma rejeição de autenticação, confira método, identidade, validade e permissões. Para um objeto inexistente, confirme catálogo, banco, esquema ou caminho. Em um timeout, revise primeiro o Worker e seu acesso de rede. Se faltar um modo de gravação, consulte as capacidades efetivas do conector: o componente genérico não garante todos os modos de cada provedor. Um timeout não comprova credenciais incorretas; não copie respostas que possam conter dados da origem.

Continue com componentes de Mapping, transformações e permissões por ação.