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 suportar qualquer um dos métodos de autenticação padrão do setor, como 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 no 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 destino seguindo as etapas descritas no conexão de destino tutorial.

Quando criação de um destino por meio do Destination SDK, o customerAuthenticationConfigurations define o que os clientes veem na variável 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 da /authoring/destinations terminal. 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 do cliente descritas nesta página, sempre defina o authenticationRule parâmetro em entrega de destino para "CUSTOMER_AUTHENTICATION", conforme 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 o customerAuthenticationConfigurations por meio da /destinations como 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 o customerAuthenticationConfigurations por meio da /destinations como mostrado abaixo:

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

Autenticação OAuth 2 oauth2

Os usuários selecionam Conectar ao destino para acionar o fluxo de autenticação do OAuth 2 para o seu destino, como 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 endpoint de destino, leia a seção dedicada Página de autenticação OAuth 2 do Destination SDK.

Para configurar OAuth2 autenticação para seu destino, configure a variável customerAuthenticationConfigurations por meio da /destinations como mostrado abaixo:

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

Autenticação Amazon S3 s3

Amazon S3 a autenticação é compatível com 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 Amazon S3 autenticação para seu destino, configure a variável customerAuthenticationConfigurations por meio da /destinations como mostrado abaixo:

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

Autenticação do Azure Blob blob

Azure Blob Storage a autenticação é compatível com 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 Azure Blob autenticação para seu destino, configure a variável customerAuthenticationConfigurations parâmetro no /destinations como mostrado abaixo:

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

Azure Data Lake Storage autenticação adls

Azure Data Lake Storage a autenticação é compatível com destinos baseados em arquivo no Experience Platform.

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

Para configurar Azure Data Lake Storage (ADLS) para seu destino, configure a variável customerAuthenticationConfigurations parâmetro no /destinations como mostrado abaixo:

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

SFTP com autenticação de senha

SFTP a autenticação com senha é compatível com 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 customerAuthenticationConfigurations parâmetro no /destinations como mostrado abaixo:

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

SFTP com autenticação de chave SSH

SFTP autenticação com SSH A chave é compatível com 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 customerAuthenticationConfigurations parâmetro no /destinations como mostrado abaixo:

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

Google Cloud Storage autenticação gcs

Google Cloud Storage a autenticação é compatível com destinos baseados em arquivo no Experience Platform.

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

Para configurar Google Cloud Storage autenticação para seu destino, configure a variável customerAuthenticationConfigurations parâmetro no /destinations como 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: