Configuração de autenticação do cliente

O Experience Platform oferece grande flexibilidade nos protocolos de autenticação disponíveis para parceiros e clientes. Você pode configurar seu destino para oferecer suporte a qualquer um dos métodos de autenticação padrão do setor, como o OAuth2, autenticação de token do portador, autenticação de senha e muito mais.

Esta página explica como configurar seu destino usando seu método de autenticação preferido. Com base na configuração de autenticação usada ao criar o destino, os clientes verão diferentes tipos de páginas de autenticação ao se conectarem ao destino na interface do Experience Platform.

Para entender onde esse componente se encaixa em uma integração criada com o Destination SDK, consulte o diagrama na documentação das opções de configuração ou consulte as seguintes páginas de visão geral da configuração de destino:

Antes de exportar dados da Platform para o seu destino, os clientes devem criar uma nova conexão entre o Experience Platform e o seu destino, seguindo as etapas descritas no tutorial conexão de destino.

Ao criar um destino por meio do Destination SDK, a seção customerAuthenticationConfigurations define o que os clientes veem na tela de autenticação. Dependendo do tipo de autenticação de destino, os clientes devem fornecer vários detalhes de autenticação, como:

  • Para destinos que usam a autenticação básica, os usuários devem fornecer um nome de usuário e uma senha diretamente na página de autenticação da interface de usuário do Experience Platform.
  • Para destinos que usam autenticação de portador, os usuários devem fornecer um token de portador.
  • Para destinos que usam a autorização OAuth2, os usuários são redirecionados para a página de logon do seu destino, onde podem fazer logon com as credenciais.
  • Para destinos do Amazon S3, os usuários devem fornecer sua chave de acesso e chave secreta Amazon S3.
  • Para destinos do Azure Blob, os usuários devem fornecer sua cadeia de conexão Azure Blob.

Você pode configurar os detalhes de autenticação do cliente por meio do ponto de extremidade /authoring/destinations. Consulte as seguintes páginas de referência de API para obter exemplos detalhados de chamadas de API, onde é possível configurar os componentes mostrados nesta página.

Este artigo descreve todas as configurações de autenticação de cliente compatíveis que você pode usar para o seu destino e mostra o que os clientes verão na interface do usuário do Experience Platform com base no método de autenticação definido para o seu destino.

IMPORTANT
A configuração de autenticação do cliente não exige a configuração de nenhum parâmetro. Você pode copiar e colar os trechos mostrados nesta página em suas chamadas de API ao criar ou atualizar uma configuração de destino, e seus usuários verão a tela de autenticação correspondente na interface do usuário da plataforma.
IMPORTANT
Todos os nomes e valores de parâmetros suportados pelo Destination SDK fazem distinção entre maiúsculas e minúsculas. Para evitar erros de diferenciação entre maiúsculas e minúsculas, use os nomes e valores dos parâmetros exatamente como mostrado na documentação.

Tipos de integração compatíveis supported-integration-types

Consulte a tabela abaixo para obter detalhes sobre quais tipos de integrações suportam a funcionalidade descrita nesta página.

Tipo de integração
Suporte à funcionalidade
Integrações em tempo real (streaming)
Sim
Integrações baseadas em arquivo (lote)
Sim

Configuração da regra de autenticação authentication-rule

Ao usar qualquer uma das configurações de autenticação de cliente descritas nesta página, sempre defina o parâmetro authenticationRule na entrega de destino para "CUSTOMER_AUTHENTICATION", como mostrado abaixo.

{
   "destinationDelivery":[
      {
         "authenticationRule":"CUSTOMER_AUTHENTICATION",
         "destinationServerId":"{{destinationServerId}}"
      }
   ]
}

Autenticação básica basic

A autenticação básica é compatível com integrações em tempo real (transmissão) no Experience Platform.

Ao configurar o tipo de autenticação básica, os usuários devem inserir um nome de usuário e senha para se conectarem ao seu destino.

Renderização da interface do usuário com autenticação básica

Para configurar a autenticação básica para o seu destino, configure a seção customerAuthenticationConfigurations por meio do ponto de extremidade /destinations, conforme mostrado abaixo:

"customerAuthenticationConfigurations":[
   {
      "authType":"BASIC"
   }
]

Autenticação do portador bearer

Ao configurar o tipo de autenticação de portador, os usuários precisam inserir o token de portador que obtêm do seu destino.

Renderização da interface do usuário com autenticação do portador

Para configurar a autenticação de tipo de portador para o seu destino, configure a seção customerAuthenticationConfigurations por meio do ponto de extremidade /destinations, conforme mostrado abaixo:

"customerAuthenticationConfigurations":[
   {
      "authType":"BEARER"
   }
]

Autenticação OAuth 2 oauth2

Os usuários selecionam Conectar-se ao destino para acionar o fluxo de autenticação do OAuth 2 para o seu destino, conforme mostrado no exemplo abaixo para o destino de Públicos-alvo personalizados do Twitter. Destination SDK Para obter informações detalhadas sobre como configurar a autenticação OAuth 2 para o seu ponto de extremidade de destino, leia a página dedicada da autenticação OAuth 2.

Renderização da interface do usuário com autenticação OAuth 2

Para configurar a autenticação do OAuth2 para o seu destino, configure a seção customerAuthenticationConfigurations por meio do ponto de extremidade /destinations, conforme mostrado abaixo:

"customerAuthenticationConfigurations":[
   {
      "authType":"OAUTH2"
   }
]

Autenticação Amazon S3 s3

A autenticação Amazon S3 tem suporte para destinos baseados em arquivo no Experience Platform.

Ao configurar o tipo de autenticação do Amazon S3, os usuários precisam inserir suas credenciais S3.

Renderização da interface do usuário com autenticação S3

Para configurar a autenticação do Amazon S3 para o seu destino, configure a seção customerAuthenticationConfigurations por meio do ponto de extremidade /destinations, conforme mostrado abaixo:

"customerAuthenticationConfigurations":[
   {
      "authType":"S3"
   }
]

Autenticação do Azure Blob blob

A autenticação Azure Blob Storage tem suporte para destinos baseados em arquivo no Experience Platform.

Ao configurar o tipo de autenticação Blob do Azure, os usuários são solicitados a inserir a cadeia de conexão.

Renderização da interface do usuário com autenticação Blob

Para configurar a autenticação do Azure Blob para o seu destino, configure o parâmetro customerAuthenticationConfigurations no ponto de extremidade /destinations conforme mostrado abaixo:

"customerAuthenticationConfigurations":[
   {
      "authType":"AZURE_CONNECTION_STRING"
   }
]

Autenticação Azure Data Lake Storage adls

A autenticação Azure Data Lake Storage tem suporte para destinos baseados em arquivo no Experience Platform.

Ao configurar o tipo de autenticação Azure Data Lake Storage, os usuários são solicitados a inserir as credenciais da Entidade de Serviço do Azure e suas informações de locatário.

Renderização da interface do usuário com Azure Data Lake Storage autenticação

Para configurar a autenticação do Azure Data Lake Storage (ADLS) para o seu destino, configure o parâmetro customerAuthenticationConfigurations no ponto de extremidade /destinations conforme mostrado abaixo:

"customerAuthenticationConfigurations":[
   {
      "authType":"AZURE_SERVICE_PRINCIPAL"
   }
]

SFTP com autenticação de senha

Há suporte para autenticação SFTP com senha para destinos baseados em arquivo no Experience Platform.

Ao configurar o SFTP com tipo de autenticação de senha, os usuários devem inserir o nome de usuário e a senha do SFTP, bem como o domínio e a porta SFTP (a porta padrão é 22).

Renderização da interface do usuário com SFTP com autenticação de senha

Para configurar a autenticação SFTP com senha para o seu destino, configure o parâmetro customerAuthenticationConfigurations no ponto de extremidade /destinations conforme mostrado abaixo:

"customerAuthenticationConfigurations":[
   {
      "authType":"SFTP_WITH_PASSWORD"
   }
]

SFTP com autenticação de chave SSH

Há suporte para a autenticação SFTP com a chave SSH para destinos baseados em arquivo no Experience Platform.

Ao configurar o SFTP com tipo de autenticação de chave SSH, os usuários precisam inserir o nome de usuário SFTP e a chave SSH, bem como o domínio e a porta SFTP (a porta padrão é 22).

Renderização da interface do usuário com SFTP com autenticação de chave SSH

Para configurar a autenticação SFTP com chave SSH para o seu destino, configure o parâmetro customerAuthenticationConfigurations no ponto de extremidade /destinations conforme mostrado abaixo:

"customerAuthenticationConfigurations":[
   {
      "authType":"SFTP_WITH_SSH_KEY"
   }
]

Autenticação Google Cloud Storage gcs

A autenticação Google Cloud Storage tem suporte para destinos baseados em arquivo no Experience Platform.

Ao configurar o tipo de autenticação Google Cloud Storage, os usuários devem inserir a Google Cloud Storage ID da chave de acesso e a chave de acesso secreta.

Renderização da interface do usuário com autenticação do Google Cloud Storage

Para configurar a autenticação do Google Cloud Storage para o seu destino, configure o parâmetro customerAuthenticationConfigurations no ponto de extremidade /destinations conforme mostrado abaixo:

"customerAuthenticationConfigurations":[
   {
      "authType":"GOOGLE_CLOUD_STORAGE"
   }
]

Próximas etapas next-steps

Depois de ler este artigo, você terá uma melhor compreensão de como configurar a autenticação de usuário na sua plataforma de destino.

Para saber mais sobre os outros componentes de destino, consulte os seguintes artigos:

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6