Guia de credenciais

O Adobe Experience Platform Query Service permite conectar-se com clientes externos. Você pode se conectar a esses clientes externos usando credenciais que estão expirando ou credenciais que não estão expirando.

Credenciais de expiração

Você pode usar as credenciais que estão expirando para configurar rapidamente uma conexão com um cliente externo.

O Credenciais de expiração fornece as seguintes informações:

  • Host: O nome do host ao qual você se conectará. Para conexão com o Serviço de query, isso incluirá o nome da Organização IMS que você está usando no momento.
  • Port: O número da porta do host à qual você se conectará.
  • Banco de dados: O nome do banco de dados ao qual você se conectará.
  • Nome do usuário: O nome de usuário que você usará para se conectar ao Serviço de query.
  • Senha: A senha que você usará para se conectar ao Serviço de query.
  • comando PSQL: Um comando que inseriu automaticamente todas as informações relevantes para você se conectar ao Serviço de query usando PSQL na linha de comando.
  • Expira: A data de expiração das credenciais que expiram. As credenciais expiram 24 horas após serem geradas.

Credenciais que não expiram

Você pode usar credenciais que não estão expirando para configurar uma conexão mais permanente com um cliente externo.

Pré-requisitos

Antes de gerar credenciais que não estão expirando, você deve concluir as seguintes etapas no Adobe Admin Console:

  1. Faça logon Adobe Admin Console e selecione a Org relevante na barra de navegação superior.
  2. Selecione um perfil de produto.
  3. Configure ambas as Sandboxes e Gerenciar integração do serviço de consulta permissões para o perfil do produto.
  4. Adicionar um novo usuário a um perfil de produto assim, as permissões configuradas são concedidas a eles.
  5. Adicionar o usuário como administrador do perfil de produto para permitir a criação de uma conta para qualquer perfil de produto ativo.
  6. Adicionar o usuário como desenvolvedor de perfil de produto para criar uma integração.

Para saber mais sobre como atribuir permissões, leia a documentação em controle de acesso.

Todas as permissões necessárias agora estão configuradas no Console do desenvolvedor do Adobe para que o usuário use o recurso de credenciais que está expirando.

Gerar credenciais

Para criar um conjunto de credenciais que não estão expirando, retorne à interface do usuário da plataforma e selecione Queries na navegação à esquerda para acessar o Queries espaço de trabalho. Em seguida, selecione o Credenciais guia seguida por Gerar credenciais.

Uma caixa de diálogo é exibida e permite gerar credenciais. Para criar credenciais que não estão expirando, você deve fornecer os seguintes detalhes:

  • Nome: O nome das credenciais que você está gerando.
  • Descrição: (Opcional) Uma descrição das credenciais que você está gerando.
  • Atribuído a: O usuário ao qual as credenciais serão atribuídas. Esse valor deve ser o endereço de email do usuário que está criando as credenciais.
  • Senha (Opcional) Uma senha opcional para suas credenciais. Se a senha não for definida, o Adobe gerará automaticamente uma senha para você.

Depois de fornecer todos os detalhes necessários, selecione Gerar credenciais para gerar suas credenciais.

IMPORTANTE

Uma vez Gerar credenciais for selecionado, um arquivo JSON de configuração será baixado no computador local. Como o Adobe faz not registre as credenciais geradas, armazene com segurança o arquivo baixado e mantenha um registro da credencial.

Além disso, se as credenciais não forem usadas por 90 dias, elas serão expurgadas.

O arquivo JSON de configuração contém informações como nome técnico da conta, ID da conta técnica e credencial. Ele é fornecido no formato a seguir.

{"technicalAccountName":"9F0A21EE-B8F3-4165-9871-846D3C8BC49E@TECHACCT.ADOBE.COM","credential":"3d184fa9e0b94f33a7781905c05203ee","technicalAccountId":"4F2611B8613AA3670A495E55"}

Depois de salvar suas credenciais geradas, selecione Fechar. Agora você pode ver uma lista de todas as suas credenciais que não estão expirando.

Você pode editar ou excluir suas credenciais que não expiram. Para editar uma credencial que não esteja expirando, selecione o ícone de lápis (). Para excluir uma credencial que não esteja expirando, selecione o ícone excluir ().

Ao editar uma credencial que não esteja expirando, um modal é exibido. Você pode fornecer os seguintes detalhes para atualizar:

  • Nome: O nome das credenciais que você está gerando.
  • Descrição: (Opcional) Uma descrição das credenciais que você está gerando.
  • Atribuído a: O usuário ao qual as credenciais serão atribuídas. Esse valor deve ser o endereço de email do usuário que está criando as credenciais.

Depois de fornecer todos os detalhes necessários, selecione Atualizar conta para concluir a atualização de suas credenciais.

Usar credenciais para se conectar a clientes externos

Você pode usar as credenciais que estão expirando ou que não estão expirando para se conectar a clientes externos, como o Aqua Data Studio, o Looker ou o Power BI. O método de entrada dessas credenciais varia dependendo do cliente externo. Consulte a documentação do cliente externo para obter instruções específicas sobre o uso dessas credenciais.

A imagem indica o local de cada parâmetro encontrado na interface do usuário, exceto a senha das credenciais que não expiram. Embora as credenciais que não expiram sejam fornecidas pelos arquivos de configuração JSON, você pode visualizar suas credenciais que expiram no Credenciais na interface do usuário.

A tabela abaixo descreve os parâmetros normalmente necessários para se conectar a clientes externos.

OBSERVAÇÃO

Ao se conectar a um host usando credenciais que não estão expirando, ainda é necessário usar todos os parâmetros listados na variável CREDENCIAIS DE EXPIRAÇÃO exceto por senha e nome de usuário.

Parâmetro Descrição
Servidor/Host O nome do servidor/host ao qual você está se conectando.
  • Esse valor é usado para credenciais que expiram e credenciais que não expiram e assume a forma de server.adobe.io. O valor é encontrado em Host no CREDENCIAIS DE EXPIRAÇÃO seção.
Porta A porta do servidor/host ao qual você está se conectando.
  • Esse valor é usado para credenciais que expiram e credenciais que não expiram e é encontrado em Port no CREDENCIAIS DE EXPIRAÇÃO seção. Um exemplo de valor para a porta seria 80.
Banco de dados O banco de dados ao qual você está se conectando.
  • Esse valor é usado para credenciais que estão expirando e credenciais que não estão expirando e foi encontrado em Banco de dados no CREDENCIAIS DE EXPIRAÇÃO seção. Um exemplo de valor para o banco de dados seria prod:all.
Nome do usuário O nome de usuário do usuário que está se conectando ao cliente externo.
  • Esse valor é usado para credenciais que estão expirando e credenciais que não estão expirando. Ele assume o formato de uma sequência alfanumérica antes de @AdobeOrg. Esse valor é encontrado em Nome do usuário.
Senha A senha do usuário que está se conectando ao cliente externo.
  • Se você estiver usando credenciais que estão expirando, isso poderá ser encontrado em Senha no CREDENCIAIS DE EXPIRAÇÃO seção.
  • Se você estiver usando credenciais que não estão expirando, esse valor será o argumento concatenado de technicalAccountID e a credencial obtida do arquivo JSON de configuração. O valor da senha assume o formulário: {technicalAccountId}:{credential}.

Próximas etapas

Agora que você entende como as credenciais que estão expirando e que não estão expirando funcionam, pode usar essas credenciais para se conectar a clientes externos. Para obter mais informações detalhadas sobre clientes externos, leia o conectar clientes ao guia Serviço de query.

Nesta página