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 com ou sem expiração.

Credenciais expiradas

Você pode usar credenciais com expiração para configurar rapidamente uma conexão com um cliente externo.

A variável Credenciais que expiram fornece as seguintes informações:

• Host: O nome do host ao qual conectar o cliente. Ele incorpora o nome da sua organização, como visto na faixa superior da interface do usuário da Platform.
• Porta: o número da porta do host ao qual se conectar.
• Banco de dados: O nome do banco de dados ao qual conectar um cliente.
• Nome de usuário: o nome de usuário usado para se conectar ao Serviço de consulta.
• Senha: a senha usada para se conectar ao Serviço de consulta. As senhas na interface do usuário receberam hash por questões de segurança. Selecione o ícone de cópia () para copiar suas credenciais completas e sem hash para a área de transferência.
• comando PSQL: um comando que inseriu automaticamente todas as informações relevantes para você se conectar ao Serviço de consulta usando PSQL na linha de comando.
• Expira: a data e a hora de expiração das credenciais que estão expirando. A duração padrão da validade do token é de 24 horas, mas pode ser alterada nas configurações avançadas do Admin Console.

Credenciais sem expiração

Você pode usar credenciais sem expiração para configurar uma conexão mais permanente com um cliente externo.

Pré-requisitos

Antes de gerar credenciais sem expiração, você deve concluir as seguintes etapas no Adobe Admin Console:

1. Efetue logon no Adobe Admin Console e selecione a Organização relevante na barra de navegação superior.
2. Selecione um perfil de produto.
3. Configure os dois 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 para que tenham suas permissões configuradas.
5. Adicionar o usuário como administrador de 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 Adobe Developer para que o usuário use o recurso de credenciais que estão expirando.

Gerar credenciais

Para criar um conjunto de credenciais sem expiração, retorne à interface do usuário da Platform e selecione Consultas na navegação à esquerda, para acessar a Consultas espaço de trabalho. Em seguida, selecione o Credenciais guia seguida por Gerar credenciais.

Uma caixa de diálogo é exibida com a permissão para gerar credenciais. Para criar credenciais sem expiração, você deve fornecer os seguintes detalhes:

• Nome: O nome das credenciais que você está gerando.
• Descrição: (opcional) uma descrição das credenciais geradas.
• 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.

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

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

Depois de salvar as credenciais geradas, selecione Fechar. Agora você pode ver uma lista de todas as suas credenciais sem expiração.

Você pode editar ou excluir suas credenciais sem expiração. Para editar uma credencial sem expiração, selecione o ícone de lápis (). Para excluir uma credencial sem expiração, selecione o ícone excluir ().

Ao editar uma credencial sem expiração, 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 geradas.
• 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 das suas credenciais.

Usar credenciais para se conectar a clientes externos

Você pode usar as credenciais com ou sem expiração para se conectar com clientes externos, como Aqua Data Studio, Looker ou Power BI. O método de entrada dessas credenciais varia de acordo com o 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, exceto a senha das credenciais sem expiração. Embora as credenciais sem expiração sejam fornecidas pelos arquivos de configuração JSON, você pode visualizar as credenciais que estão expirando no Credenciais na interface do usuário.

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

Próximas etapas

Agora que você entende como as credenciais com e sem expiração funcionam, é possível usá-las para se conectar a clientes externos. Para obter mais informações detalhadas sobre clientes externos, leia o guia conectar clientes ao Serviço de consulta.