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 usuário 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 do Experience 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. 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 de autenticação do Destination SDK 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

A autenticação SFTP com senha tem suporte 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

A autenticação SFTP com a chave SSH tem suporte 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: