Centro de suporte da Workiva

Com o conector SFTP, você pode usar os comandos em uma cadeia para gerenciar arquivos e diretórios em um servidor SFTP (Secure Arquivo Transfer Protocol). Por exemplo, com esse conector, você pode usar modelos para criar uma cadeia para fazer o download seguro de um arquivo de um servidor SFTP e, em seguida, carregá-lo em uma tabela Wdata.

Pré-requisitos

Para usar o Conector SFTP, sua organização precisa ter acesso ao seu próprio servidor SFTP. A Workiva não pode hospedar nem fornecer esses servidores.

Para proteger a conexão com o servidor SFTP, o conector suporta autenticação básica de nome de usuário e senha ou autenticação de chave pública/chave privada. Para configurar a conexão, você precisará de:

• O nome do host ou o endereço IP do servidor
• A porta em que o servidor é executado
• O nome de usuário usado para acessar o servidor
• As credenciais de autenticação do nome de usuário
  • Para autenticação básica, sua senha
  • Para autenticação de chave pública, o arquivo de chave privada como PEM ou PPK e sua senha (se aplicável). Saiba mais sobre chaves privadas.

Configurar o conector SFTP

Observação: Para tornar o conector disponível para uso nas cadeias de sua organização, um administrador de segurança da organização primeiro o habilita em Configuração.

1. Em Construtor de cadeia, clique em Conexões compare_arrows e, em seguida, Criar no canto superior direito.
2. Em Connector Connection, selecione SFTP Connector e seu executor.
   
3. Em Informações básicas, digite um nome e uma descrição exclusivos para ajudar a identificar a conexão.
4. Se estiver usando a autenticação de chave pública, em Resources, carregue o arquivo de chave privada do servidor. 
5. Em Propriedades, digite os detalhes da conexão:
   

   Propriedade	Detalhes
   Anfitrião	Digite o nome do host ou o endereço IP do servidor SFTP, como, por exemplo, 34.23.34.45 ou sftp.example.net.
   Porto	Digite a porta em que o servidor é executado.
   Nome de usuário	Digite o nome de usuário usado para fazer login no servidor.
   Senha	Para autenticação básica, digite a senha para Nome de usuário. Para autenticação de chave pública, deixe em branco.
   Chave privada	Para autenticação de chave pública, digite o nome do arquivo da chave privada carregada em Recursos.
   Senha da chave privada	Para autenticação de chave pública, digite a senha do arquivo de chave privada. Se a chave privada não tiver senha, deixe em branco.
   Tempo limite de conexão	Digite o número de minutos para aguardar a conexão com o servidor SFTP. Se o servidor estiver lento ou tiver uma carga alta, insira um número grande.

   Observação: Todas as credenciais confidenciais são automaticamente criptografadas e armazenadas com criptografia Advanced Encryption Standard (AES) 256.

6. Selecione os ambientes para usar a conexão e clique em Salvar.
7. Se sua rede exigir uma lista de permissão de domínios de saída, permita o endereço IP listado no documento Permitir anfitriões e e-mails para a Workiva.
8. Para testar a conexão, crie e execute uma cadeia com o comando Listar diretório do conector SFTP e verifique se ele retorna uma saída válida.

Solução de problemas

Se a conexão com o servidor SFTP falhar:

• Verifique se as credenciais de autenticação do conector estão corretas. Por exemplo, use as mesmas credenciais para se conectar ao servidor por meio de um aplicativo cliente SFTP, como ArquivoZilla ou WinSCP.
• Verifique se a senha não começa com um sinal de "arroba" (@).
• Se a conexão expirar, aumente o tempo limite da conexão .
• Se a sua rede exigir uma lista de permissão de saída de domínios, siga o documento Allow hosts and emails for Workiva.

Chaves privadas

Se o aplicativo cliente SFTP não permitir que você gere um par de chaves públicas/privadas, use uma ferramenta como PuTTYgen ou ssh-keygen.Para chaves privadas, oferecemos suporte aos seguintes formatos:

• Chaves geradas pelo PuTTy, que normalmente terminam em uma extensão .ppk.
• Chaves RSA usando o padrão PKCS#1 no formato PEM, que normalmente termina em uma extensão . pem.

Você também pode visualizar suas chaves RSA em um editor de texto. Se o texto contiver -----BEGIN RSA PRIVATE KEY----- e -----END RSA PRIVATE KEY-----, esses formatos serão compatíveis com a Workiva. Se essas linhas estiverem faltando ou contiverem termos diferentes, você precisará converter a chave para esse formato ou gerar uma nova.

Arquitetura