Hosts SFTP

OBSERVAÇÃO

A Adobe Experience Platform Launch foi reformulada como um conjunto de tecnologias de coleta de dados no Adobe Experience Platform. Como resultado, várias alterações de terminologia foram implementadas na documentação do produto. Consulte o seguinte documento para obter uma referência consolidada das alterações de terminologia.

O Adobe Experience Platform permite fornecer builds de biblioteca de tags para um servidor SFTP seguro que você hospeda, fornecendo maior controle sobre como as builds são armazenadas e gerenciadas. Este guia aborda como configurar um host SFTP para uma propriedade de tag na interface do usuário da coleta de dados.

OBSERVAÇÃO

Você também pode optar por usar um host gerenciado pelo Adobe. Consulte o guia sobre Hosts gerenciados pelo Adobe para obter mais informações.

Para obter informações sobre os benefícios e limitações das bibliotecas de auto-hospedagem, consulte o guia de auto-hospedagem.

Configurar uma chave de acesso para o servidor

O Platform se conecta com seu site SFTP usando uma chave criptografada. Há algumas etapas para configurar isso corretamente:

Criar um par de chaves públicas/privadas

Você deve ter um par de chaves pública/privada instalado no servidor SFTP. Você pode gerar essas chaves no servidor ou em outro lugar e instalá-las no servidor. Consulte a documentação do GitHub sobre como gerar chaves SSH para obter mais informações.

Criptografar suas chaves

A chave privada é usada para criptografar a chave pública. Será necessário fornecer a chave privada durante o processo de criação do host SFTP. Consulte a seção sobre como criptografar valores no guia API Reator para obter instruções sobre como criptografar chaves públicas. Use a chave GPG do ambiente de produção, a menos que você saiba que precisa de uma específica. Por fim, você pode criptografar sua chave privada de qualquer computador e não precisa instalar o GPG no servidor para concluir essa etapa.

lista de permissões endereços IP da plataforma

Talvez seja necessário aprovar um conjunto de endereços IP a serem usados no firewall da empresa para permitir que a Platform alcance seu servidor SFTP e se conecte a ele. Esses endereços IP são:

  • 184.72.239.68
  • 23.20.85.113
  • 54.226.193.184
OBSERVAÇÃO

A estrutura das builds de tag mudou com o tempo. Eles usam links simbólicos (symlinks) internamente para manter a compatibilidade com versões anteriores, para que os códigos incorporados anteriores continuem a funcionar com a estrutura de build mais recente. O servidor SFTP deve aceitar o uso de symlinks a fim de servir como destino válido para builds de tag.

Para obter informações mais detalhadas, consulte o artigo a seguir do Medium sobre como configurar servidores SFTP para fornecer um build.

Criar um host SFTP

Na interface do usuário da coleta de dados, selecione Hosts no painel de navegação esquerdo, seguido de Adicionar host.

Imagem que mostra o botão Adicionar host selecionado na interface do usuário

A caixa de diálogo de criação do host é exibida. Forneça um nome para o host e em Tipo, selecione SFTP.

Imagem que mostra a opção de hospedagem SFTP selecionada

Configurar o host SFTP

A caixa de diálogo é expandida para incluir opções de configuração adicionais para o host SFTP. Elas são explicadas abaixo.

Imagem mostrando os detalhes necessários para uma conexão de host SFTP

Campo Configuração Descrição
Não Usar Symlinks Por padrão, todos os hosts SFTP usam links simbólicos (symlinks) para fazer referência à biblioteca builds que são salvas no servidor. No entanto, nem todos os servidores suportam o uso de links simbólicos. Quando essa opção é selecionada, o host usa uma operação de cópia para atualizar os ativos de criação diretamente, em vez de usar links simbólicos.
URL do servidor SFTP O caminho base do URL do seu servidor.
Path O caminho a ser anexado ao URL do servidor base para esse host.
Porta ​ A porta deve ser uma das seguintes:
  • 21
  • 22
  • 80
  • 200-299
  • 443
  • 2000-2999
  • 4343
  • 8080
  • 8888
Como prática recomendada de segurança, a Adobe limita o número de portas que podem ser usadas para tráfego de saída. As portas selecionadas geralmente são permitidas por meio de firewalls corporativos e incluem alguns intervalos para oferecer flexibilidade.
Nome de usuário O nome de usuário a ser usado ao acessar o servidor.
Chave privada criptografada A chave privada criptografada que você criou em um etapa anterior.

Selecionar Salvar para criar o host com a configuração selecionada.

Imagem que mostra o host SFTP sendo salvo

Quando você seleciona Salvar, a conexão e a capacidade de entregar os arquivos ao servidor SFTP são testadas. A Platform cria uma pasta, grava um arquivo nessa pasta, verifica se o arquivo está lá e depois faz a limpeza. Se a conta de usuário no servidor SFTP (aquele anexado ao certificado seguro fornecido para a Platform) não tiver as permissões necessárias para executar essa ação, o host entrará em um status "Falha".

Próximas etapas

Este guia cobriu como configurar um servidor SFTP auto-hospedado para uso em tags. Depois que o host tiver sido estabelecido, você poderá associá-lo a um ou mais de seus ambientes para publicar bibliotecas de tags. Para obter mais informações sobre o processo de alto nível de ativação das funcionalidades de tags em suas propriedades da Web ou móveis, consulte o visão geral da publicação.

Nesta página