Siga o passo a passo abaixo para realizar a transferência de base de dados criptografada - caso ainda não tenha realizado a criptografia de dados PII de seus clientes contidos na base que deseja utilizar, clique aqui - para sua conta DMP e iniciar o uso do CRM Onboard da Tail ou para transferência de dados para Datastore em sua conta CDP.
DICA 1: para este processo, conte com sua equipe de desenvolvimento e infraestrutura, ou com profissionais que tenham o domínio técnico necessário, para operações via SFTP.
DICA 2: com as informações de acesso ao servidor e autenticação, é possível realizar uma aplicação para automatizar o envio de dados via SFTP para a Tail. Converse com sua equipe de infraestrutura a respeito e garanta informações sempre atualizadas em sua conta DMP e/ou CDP.
ETAPA 1 - Login de acesso
1) Solicite ao seu contato na Tail a criação do seu login de acesso. A autenticação do SFTP é feita por meio de chave pública e chave privada. Porém, junto à Tail encaminhe obrigatoriamente apenas chave pública, pois é esta que será utilizada no processo de autenticação. Mantenha a chave privada confidencial, ela será utilizada apenas no momento da autenticação, ok?
Um par de chave pública/privada pode ser gerada utilizando o utilitário:
ssh-keygen
ETAPA 2 - Acesso ao servidor e autenticação
Tendo o acesso em mãos, você precisa acessar o servidor da Tail usando seu usuário e senha. Utilize o cliente de SFTP "lftp"(LFTP).
TAIL DMP - Informações:
hostname: sftp.dmp.tailtarget.com
porta: 6622
protocolo: SFTP
Para acesso com chave privada:
lftp -u <USERNAME>,password sftp://sftp.dmp.tailtarget.com:6622
Note que é necessário informar uma palavra qualquer no lugar da senha, pois o placement é obrigatório, porém o acesso será feito pela chave privada localizada em ~/.ssh/
Exemplo de integração com shell script para envio automatizado de arquivo:
lftp -u <USERNAME>,password sftp://sftp.dmp.tailtarget.com:6622 -e "put $LOG.tar.gz; bye"
TAIL CDP - Informações:
hostname: sftp.refinaria.tailtarget.com
porta: 6622
protocolo: SFTP
ETAPA 3 - Envio de arquivos
- O sistema suporta as seguintes extensões de arquivos: .log, .csv, .tsv, também é possível enviar os arquivos compactados com os seguintes formatos: .tar, .tar.gz, .zip.
- O arquivo deve ser enviado via SFTP para a raiz do servidor, não é possível criar sub diretórios no ambiente de sftp.
Versão de arquivo na extensão .md5
Após o envio com sucesso do arquivo, é necessário enviar um outro arquivo com o mesmo nome do arquivo original, porém adicionada a extensão .md5 que contenha o MD5 do arquivo original.
Devem ser enviados então 2 arquivos:
arquivo original: database.csv
arquivo md5: database.csv.md5
Exemplos de como gerar o md5 do arquivo:
Windows:
FCIV -md5 path\database.csv
(caso não tenha o fciv instalado, siga as instruções de instalação em: https://support.microsoft.com/en-us/kb/841290)
Linux:
md5sum path/database.csv
Mac:
md5 path/database.csv
- O sistema somente irá processar o arquivo original após o recebimento do seu respectivo md5.
- É possível fazer o envio do arquivo md5 até 60 minutos após o envio do seu respectivo arquivo original, caso o md5 não seja enviado dentro desse tempo, o arquivo original será apagado.
- Não é possível apagar arquivos após o envio, se não desejar processar um arquivo após ele ter sido enviado, simplesmente não envie o md5 que ele será excluído em até 60 minutos.
- Não é possível transferir arquivos do SFTP para a máquina do cliente, o sistema é apenas para escrita, a leitura não é permitida.
Criptografia de arquivos
É possível enviar os arquivos criptografados com os seguintes formatos: .gpg, .pgp, para isso basta instalar uma ferramenta que permita encriptar arquivos em um dos formatos suportados.
Recomendados GnuPG que é software livre e você pode realizar download e instalação em seu sistema operacional.
Após realizar a instalação do GnuPG ou de sua ferramenta favorita, faça download aqui da chave pública da Tail para utilizar ao encriptar seus arquivos.
Exemplo de como importar criptografar o arquivo:
Execute o comando abaixo para importar a chave pública da Tail
gpg --import public-key.asc
O resultado será semelhante ao texto abaixo
gpg: key 786747BBF9170FC0: public key imported
gpg: Total number processed: 1
gpg: imported: 1
Para criptografar o arquivo
gpg --recipient tail-dmp --encrypt database.csv
O resultado é o arquivo database.csv.gpg na pasta em que o comando foi executado.
IMPORTANTE: O Arquivo gpg também deve ter seu respectivo MD5 ex: database.csv.gpg.md5
Acompanhamento de status do envio
Após o arquivo ser detectado pelo sistema, ela será removido da área de SFTP do cliente e enviado para processamento. Um novo arquivo vazio, com o mesmo nome do arquivo original, adicionado de uma extensão será criado no local para indicar o status do processo.
Os seguintes status podem ser encontrados:
.RECEIVED - O arquivo foi recebido com sucesso e foi enviado para processamento
.INVALID_FILE_FORMAT - A extensão do arquivo original não é válida, o arquivo foi excluído
.INVALID_MD5_CHECKSUM - O conteúdo do arquivo .md5 não corresponde ao arquivo original, o arquivo foi excluído.
O arquivo contendo o status do processamento ficará disponível no SFTP por 60 minutos.
Para o processo de CRM Onboard na DMP, também é possível ver o Status do MD5 diretamente no Dashboard de sua conta! Tendo a resposta .RECEIVED, o arquivo já aparecerá na tela de "Status dos arquivos enviados para enriquecimento" e na fila de processamento.
Qualquer dúvida no processo, entre em contato conosco! Envie um email para: academy@tail.digital