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:

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.

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.

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.

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.

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.

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.

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.

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.

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).

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).

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.

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: