SFTP

Com o conector SFTP, você pode se conectar a um servidor SFTP e realizar operações de transferência de arquivos.

Antes de começar

No seu projeto do Google Cloud, faça o seguinte:

• Verifique se a conectividade de rede está configurada. Para mais informações, consulte Conectividade de rede.
• Conceda o papel do IAM roles/connectors.admin ao usuário que está configurando o conector.
• Conceda os papéis do IAM roles/secretmanager.viewer e roles/secretmanager.secretAccessor à conta de serviço que você quer usar para o conector.
• Ative secretmanager.googleapis.com (API Secret Manager) e connectors.googleapis.com (API Connectors). Para mais informações, consulte Como ativar serviços.

Criar uma conexão SFTP

Uma conexão é específica a uma fonte de dados. Isso significa que, se você tiver muitas fontes de dados, precisará criar uma conexão separada para cada uma. Para criar uma conexão, faça o seguinte:

1. No console do Cloud, acesse a página Integration Connectors > Conexões e selecione ou crie um projeto do Google Cloud.

   Acessar a página "Conexões"

2. Clique em + Criar novo para abrir a página Criar conexão.
3. Na seção Local, selecione um local na lista Região e clique em Próxima.

   Para conferir a lista de todas as regiões com suporte, consulte Locais.

4. Na seção Detalhes da conexão, faça o seguinte:
   1. No campo Conector, selecione SFTP.
   2. No campo Versão do conector, selecione a versão desejada.
   3. No campo Nome da conexão, insira um nome para a instância de conexão. O nome da conexão pode conter letras minúsculas, números ou hífens. O nome precisa começar com uma letra e terminar com uma letra ou um número, e não pode ter mais de 49 caracteres.
   4. Como opção, insira uma Descrição para a instância de conexão.
   5. Se quiser, ative o Cloud Logging e selecione um nível de registro. Por padrão, o nível de registro é definido como Error.
   6. No campo Conta de serviço, selecione uma conta que tenha os papéis necessários.
   7. (Opcional) Defina as Configurações do nó de conexão.
   • Número mínimo de nós: digite o número mínimo de nós de conexão.
   • Número máximo de nós: digite o número máximo de nós de conexão.

   Um nó é uma unidade (ou réplica) de uma conexão que processa transações. Mais nós são necessários para processar mais transações para uma conexão e, por outro lado, menos nós são necessários para processar menos transações. Para entender como os nós afetam os preços do conector, consulte Preços dos nós de conexão. Se você não inserir qualquer valor, por padrão, os nós mínimos serão definidos como 2 (para melhor disponibilidade) e os nós máximos serão definidos como 50.

   8. (Opcional) No campo Caminho remoto, insira o caminho da pasta no servidor SFTP para realizar as operações de entidade, como List, Create, Update ou Delete.

   Se você estiver acessando entidades (arquivos ou pastas) na pasta raiz ou nas subpastas imediatas da pasta raiz, não será necessário definir um valor para esse campo. No entanto, se você quiser acessar entidades aninhadas que estejam em uma profundidade de dois níveis ou mais da pasta raiz, defina o valor desse campo como o caminho base da pasta que tem as entidades que você quer acessar. Por exemplo, se você quiser acessar o arquivo /folder_A/folder_B/folder_C/test.png, defina o caminho remoto como /folder_A/folder_B/folder_C.

   9. Outra opção é clicar em + Adicionar rótulo para adicionar um rótulo à conexão na forma de um par de chave-valor.
   10. Clique em Próxima.
5. Na seção Destinos, insira os detalhes do host remoto (sistema de back-end) ao qual você quer se conectar e clique em Próxima.

No campo Tipo de destino, selecione o tipo desejado:

• Para especificar o nome do host ou o endereço IP de destino, selecione Endereço do host e insira o endereço no campo Host 1.
• Para estabelecer uma conexão particular, selecione Anexo de endpoint e escolha o anexo necessário na lista Anexo de endpoint.

Para estabelecer uma conexão pública com os sistemas de back-end com mais segurança, considere configurar endereços IP de saída estáticos para suas conexões e configure as regras de firewall para autorizar apenas os endereços IP estáticos específicos.

6. Na seção Autenticação, selecione um Tipo de autenticação e insira os detalhes relevantes. Clique em Próxima.

   A conexão SFTP oferece suporte aos seguintes tipos de autenticação:

   • Nome de usuário e senha
   • SSH_PUBLIC_KEY

   Para entender como configurar esses tipos de autenticação, consulte Configurar autenticação.

7. Revise os detalhes de conexão e autenticação e clique em Criar.

Configurar a autenticação

Digite os detalhes com base na autenticação que você quer usar.

• Nome de usuário e senha
  • Nome de usuário: o nome de usuário do SFTP a ser usado para a conexão.
  • Senha: o Secret do Secret Manager que contém a senha associada ao nome de usuário do SFTP.

• SSH_PUBLIC_KEY
  • Nome de usuário: a conta de usuário do SFTP usada para autenticação.
  • Chave privada SSH: chave privada usada para autenticação SSH.
  • Senha da chave privada SSH: senha longa/senha que protege a chave privada, se houver.
  • Tipo de chave privada SSH: formato da chave privada SSH.

Usar a conexão SFTP em uma integração

Depois de criar a conexão, ela fica disponível na integração da Apigee e no Application Integration. É possível usar a conexão em uma integração pela tarefa "Conectores".

• Para entender como criar e usar a tarefa "Conectores" na integração da Apigee, consulte Tarefa "Conectores".
• Para entender como criar e usar a tarefa "Conectores" na Application Integration, consulte Tarefa "Conectores".

[{
"Success":"true"
}]

[{
"Success":"true"
}]

Limitações do sistema

O conector SFTP pode processar uma transação por segundo, por nó, e limita qualquer transação além desse limite. Por padrão, o Integration Connectors aloca dois nós (para melhor disponibilidade) para uma conexão.

Para informações sobre os limites aplicáveis aos Integration Connectors, consulte Limites.

Criar conexões usando o Terraform

Use o recurso do Terraform para criar uma conexão.

Para saber como aplicar ou remover uma configuração do Terraform, consulte Comandos básicos do Terraform.

Para conferir um modelo de exemplo do Terraform para criação de conexão, consulte modelo de exemplo.

Ao criar essa conexão usando o Terraform, defina as seguintes variáveis no arquivo de configuração do Terraform:

    {
      "type": "object",
      "properties": {
        "FilePath": {
          "type": "string",
          "readOnly": false
        },
        "Filename": {
          "type": [
            "string",
            "null"
          ],
          "readOnly": false,
          "description": "The name of the file or directory."
        },
        "FileSize": {
          "type": [
            "number",
            "null"
          ],
          "readOnly": false,
          "description": "The size of the file."
        },
        "LastModified": {
          "type": [
            "string",
            "null"
          ],
          "readOnly": false
        },
        "IsDirectory": {
          "type": [
            "boolean",
            "null"
          ],
          "readOnly": false
        },
        "Permissions": {
          "type": [
            "string",
            "null"
          ],
          "readOnly": false
        },
        "Owner": {
          "type": [
            "string",
            "null"
          ],
          "readOnly": false
        },
        "OwnerId": {
          "type": [
            "string",
            "null"
          ],
          "readOnly": false
        },
        "Group": {
          "type": [
            "string",
            "null"
          ],
          "readOnly": false
        },
        "GroupId": {
          "type": [
            "string",
            "null"
          ],
          "readOnly": false
        }
      }
    }
  

Receber ajuda da comunidade do Google Cloud

Poste suas dúvidas e converse sobre esse conector na comunidade do Google Cloud em Fóruns do Cloud.

A seguir

• Entenda como suspender e retomar uma conexão.
• Entenda como monitorar o uso do conector.
• Saiba como ver os registros do conector.