Hosts SFTP

Last update: Fri Dec 12 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Tópicos:

Criado para:

Desenvolvedor

O Experience Platform permite que você forneça builds de bibliotecas de tags para um servidor SFTP seguro que você hospeda, fornecendo maior controle sobre como seus builds são armazenados e gerenciados. Este guia aborda como configurar um host SFTP para uma propriedade de tag na interface do usuário do Experience Platform ou na interface da coleção de dados.

NOTE

Em vez disso, você também pode optar por usar um host gerenciado pela Adobe. Consulte o manual sobre hosts gerenciados pela 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 access-key

O Experience 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 criptografar valores no guia da API do 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.

Incluir na lista de permissões endereços IP da Experience Platform

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

34.227.138.75
44.194.43.191
3.215.163.18

NOTE

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 create

Selecione Hosts na navegação à esquerda, seguido por Add Host.

Imagem mostrando o botão Adicionar Host sendo selecionado na interface

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

Imagem mostrando a opção de hospedagem do SFTP selecionada

Configurar o host SFTP configure

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 de configuração

Descrição

Don’t Use Symlinks

Por padrão, todos os hosts SFTP usam links simbólicos (symlinks) para fazer referência às builds da biblioteca que são salvas no servidor. No entanto, nem todos os servidores suportam o uso de symlinks. Quando essa opção é selecionada, o host usa uma operação de cópia para atualizar os ativos de build diretamente, em vez de usar symlinks.

SFTP Server URL

O caminho base de URL do servidor.

Path

O caminho a ser anexado ao URL do servidor base para este host.

Port

A porta deve ser uma das seguintes:

21
22
201
200
2002
2018
2022
2200
2222
2333
2939
443
4343
80
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.

Username

O nome de usuário a ser usado ao acessar o servidor.

Encrypted Private Key

A chave privada criptografada criada em uma etapa anterior.

Selecione Save para criar o host com a configuração selecionada.

Imagem mostrando o host SFTP sendo salvo

Quando você seleciona Save, a conexão e a capacidade de entregar os arquivos ao servidor SFTP são testadas. O Experience 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 o Experience 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 abordou 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 dos seus ambientes para a publicação de bibliotecas de tags. Para obter mais informações sobre o processo de alto nível de ativação das funcionalidades de tag nas suas propriedades da Web ou móveis, consulte a visão geral de publicação.

recommendation-more-help

12b4e4a9-5028-4d88-8ce6-64a580811743