Contas externas external-accounts
Uma conta externa é uma configuração que permite configurar e testar o acesso a um servidor externo ao Adobe Campaign.
Essas contas externas podem ser usadas em workflows da campanha para acessar e gerenciar dados.
Você pode configurar os seguintes tipos de contas externas:
- SFTP. Para obter mais informações, consulte esta seção.
- Amazon Storage Service (S3). Para obter mais informações, consulte esta seção.
- Adobe Experience Manager. Para obter mais informações, consulte esta seção.
- Adobe Analytics. Para obter mais informações, consulte esta seção.
- Google reCAPTCHA. Para obter mais informações, consulte esta seção.
- Armazenamento do Microsoft Azure Blob. Para obter mais informações, consulte esta seção.
- OAuth 2.0 Para obter mais informações, consulte nesta seção.
Contas externas podem ser configuradas pelos administradores no menu Administration > Application settings > External accounts.
Criação de uma conta externa creating-an-external-account
O Adobe Campaign vem com um conjunto de contas externas predefinidas. Para configurar conexões com sistemas externos, como servidores FTP usados para transferir arquivos, você pode criar suas próprias contas externas.
As contas externas são usadas por processos técnicos, como workflows técnicos ou workflows da campanha. Ao configurar uma transferência de arquivos em um workflow ou uma troca de dados com qualquer outro aplicativo (Adobe Target, Experience Manager etc.), você precisa selecionar uma conta externa.
-
Clique no botão Create.
-
Insira um rótulo. O rótulo e a ID serão usadas ao selecionar contas externas em workflows.
-
Selecione o tipo de configuração que você deseja criar.
-
Configure o acesso à conta especificando credenciais, o endereço do servidor, o número da porta e ou chaves, quando relevante.
As informações necessárias geralmente são fornecidas pelo provedor do servidor ao qual você está se conectando.
-
Salve sua conta.
A conta externa é criada e adicionada à lista de contas. Agora está disponível para suas transferências de dados/arquivos ou configurações de roteamento em atividades de workflow e propriedades de entregas.
Conta externa SFTP sftp-external-account
Tipos de contas externas diferentes exigem que informações diferentes sejam especificadas.
Para uma conta externa SFTP, forneça os seguintes detalhes:
- Endereço do servidor. Por exemplo, ftp.domain.com.
- Número da porta. Por exemplo, 22.
- Credenciais do servidor SFTP: nome da conta e senha usados para a conexão com o servidor.
Recomendações para servidores SFTP hospedados no Adobe adobe-hosted-sftp-server-recommendations
Ao gerenciar arquivos e dados para fins de ETL, esses arquivos são armazenados em um servidor SFTP hospedado fornecido pela Adobe. Este SFTP foi projetado para ser um espaço de armazenamento temporário no qual você pode controlar a retenção e exclusão de arquivos.
Quando não for usado ou monitorado corretamente, esse espaço poderá preencher rapidamente o espaço físico disponível no servidor e causar problemas graves. Isso pode resultar na perda ou corrupção de dados na sua plataforma.
Para evitar esses problemas, a Adobe recomenda seguir as práticas recomendadas abaixo:
- Mantenha o mínimo de dados possível.
- Use a autenticação baseada em chave para evitar a expiração da senha. Os formatos compatíveis são apenas OpenSSH e SSH2. Será necessário fornecer a chave pública para que a equipe de suporte da Adobe possa carregá-la no servidor do Campaign.
- Mantenha os dados apenas pelo tempo necessário. 15 dias é o limite máximo de tempo.
- Use workflows para excluir corretamente os dados (gerencie a retenção de workflows consumindo os dados).
- Use em lotes em uploads de SFTP e em workflows.
- Manipule erros/exceções.
- Ocasionalmente, conecte-se no SFTP para verificar diretamente o que encontra-se lá.
- Lembre-se de que o gerenciamento de disco SFTP é predominantemente sua responsabilidade.
Além disso, observe que os IPs públicos dos quais você está tentando iniciar a conexão SFTP devem ser adicionados ao incluo na lista de permissões na instância do Campaign. A adição de endereços IP no incluo na lista de permissões pode ser solicitada por meio de um tíquete de suporte, além de fornecer a chave pública para uso na autenticação.
Servidores SFTP podem ser gerenciados no Painel de controle. Para obter mais informações, consulte a documentação do Painel de controle.
Conta do OAuth 2.0 oauth-account
Para uma conta externa OAuth 2.0, forneça os seguintes detalhes:
- A Tipo de concessão: somente credenciais do cliente é compatível.
- A URL seguro da API: digite o endpoint de autorização.
- Credenciais confidenciais do OAuth 2.0: esta seção destina-se às credenciais de natureza confidencial. Os valores de credencial serão mascarados na tela após serem adicionados; nesse ponto, eles não serão legíveis nem editáveis. Se o ponto de extremidade de autorização exigir que uma credencial específica seja inserida no cabeçalho de autorização HTTP em vez do parâmetro do corpo de POST, você poderá selecionar a opção Incluir no cabeçalho dessa credencial.
- Credenciais não confidenciais do OAuth 2.0: esta seção destina-se às credenciais de natureza não confidencial. Os valores de credencial estarão visíveis na tela após serem adicionados; eles também serão editáveis. Se o ponto de extremidade de autorização exigir que uma credencial específica seja inserida no cabeçalho de autorização HTTP em vez do parâmetro do corpo de POST, você poderá selecionar a opção Incluir no cabeçalho dessa credencial.
Depois de inserir as informações da conta, clique em Testar conexão para verificar se a conta externa foi configurada corretamente.
Conta externa do Amazon S3 amazon-s3-external-account
O campo de servidor do Amazon S3 deve ser preenchido da seguinte forma:
<S3 bucket name>.s3.amazonaws.com/<s3 object path>
Para armazenar o arquivo no modo criptografado do S3, marque a caixa Keep files in S3 encrypted.
As informações necessárias geralmente são fornecidas pelo provedor do servidor ao qual você está se conectando.
Especifique o AWS Region associado ao seu ponto de extremidade. Você pode verificar as regiões compatíveis e as versões de assinatura na documentação oficial do Amazon S3.
Recomendações para a conta do Amazon S3 amazon-s3-account-recommendations
Para ajudar você a configurar a conta do Amazon S3, siga estas recomendações:
- Crie uma política de bucket estrita para restringir o acesso a buckets do S3. A política de bucket pode ser configurada durante a criação de um bucket. Para obter mais informações, consulte a documentação do Amazon S3.
- Ao criar uma conta externa, ative a criptografia para armazenar dados confidenciais no bucket do S3, marcando a caixa Keep files in S3 encrypted.
- Conceda permissões de bucket para especificar quem pode acessar o objeto em um bucket. Para obter mais informações sobre permissão de buckets, consulte a documentação do Amazon S3.
Conta externa do Adobe Experience Manager. adobe-experience-manager-external-account
Contas externas do Adobe Experience Manager são usadas ao integrar o Campaign ao Experience Manager.
O processo e os requisitos relacionados a essa integração estão disponíveis neste documento.
Como você está configurando essa nova conta externa, é necessário fornecer os seguintes detalhes:
-
Servidor: insira o URL do servidor Adobe Experience Manager. Por exemplo:
code language-none http://aem.domain.com:4502 -
Credenciais da conta do AEM: use a conta que acessará a instância do Adobe Experience Manager. Ela deve ser uma parte da conta do grupo remoto de campanhas no Experience Manager.
Conta externa do Google reCAPTCHA google-recaptcha-external-account
O mecanismo Google reCAPTCHA permite proteger sua landing page contra spam e abuso causado por bots. Esse mecanismo não é intrusivo para os clientes, pois não requer nenhuma interação deles e se baseia em interações com seu site. Para registrar seu site, consulte esta página. Você deve escolher o tipo V3 reCAPTCHA.
Para adicionar o Google reCAPTCHA V3 à sua landing page, configure-o na sua conta externa. Para obter mais informações sobre como adicioná-lo à sua landing page, consulte esta seção.
Para uma conta externa do Google reCAPTCHA V3, forneça os seguintes detalhes:
-
Um Label e ID da sua conta externa
-
Type: Google reCAPTCHA
-
Seu Site key e Site secret
-
Um Threshold entre 0 e 1
O valor Threshold 0,0 significa que provavelmente é um bot e 1,0 é provavelmente uma boa interação. Por padrão, você pode usar um limite de 0,5.
Conta externa de armazenamento do Microsoft Azure Blob microsoft-azure-external-account
O conector de armazenamento Azure Blob pode ser usado para importar ou exportar dados para o Adobe Campaign usando uma atividade de workflow Transfer file. Para obter mais informações, consulte esta seção.
Para uma conta externa de armazenamento do Microsoft Azure Blob, forneça os seguintes detalhes:
- Um Label e ID da sua conta externa
- Type: armazenamento do Microsoft Azure Blob
- Seu Account name e Account key. Para saber onde encontrar o nome e a chave da sua conta, consulte esta página.
- Seu Endpoint suffix. Ele pode ser encontrado no Connection string do menu Access keys no Portal do Azure. Para obter mais informações, consulte esta página.
- Seu nome Container. Se você estiver planejando usar mais de um contêiner, crie quantas contas externas forem os contêineres.
- A opção Concurrency permite ajustar a velocidade das transferências de arquivos.
Após a configuração, clique em Test connection para vincular o Adobe Campaign ao armazenamento do Microsoft Azure Blob.
Recomendações para o armazenamento do Microsoft Azure Blob azure-blob-recommendations
Criptografia
O Adobe Campaign usa uma conexão segura (HTTPS) para acessar sua conta de armazenamento do Microsoft Azure Blob.
Chave da conta
Ao configurar sua conta externa, você deve usar um dos Account key disponíveis no Portal do Azure. Para obter mais informações sobre onde encontrar suas chaves de conta, consulte esta página.
Otimizar a velocidade de transferência de arquivos
A opção Concurrency permite ajustar a velocidade das transferências de arquivos.
Ela representa o número de threads que serão usados para executar a transferência de arquivos. Cada um desses threads baixará uma parte de aproximadamente 1 MB do blob. Em seguida, eles serão enfileirados para serem gravados em disco. Observe que, ao aumentar o número de threads, você também aumentará a carga dos recursos usados pelo aplicativo durante a transferência de arquivos.
Após a conclusão da transferência de arquivos, você poderá encontrar métricas de desempenho nos logs de Workflow.
Tentativas
Por padrão, a transferência de arquivos para o Blob do Azure terá até quatro tentativas. Se o serviço do Armazenamento do Azure retornar um código de erro, como 503 (servidor ocupado) ou 500 (tempo limite da operação), ele pode indicar que você está se aproximando ou excedendo a escalabilidade da sua conta de armazenamento. Isso pode ocorrer ao usar uma nova conta ou ao executar testes.
Se o erro persistir, será possível aumentar o número de tentativas criando uma opção no menu avançado Administration > Application Settings > Options.
Se implementada, a opção deverá ser criada da seguinte maneira:
ID: AzureBlob_Max_Retries
Date type: Integer
Default: <the number of retries needed>