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 expiring-credentials
Você pode usar credenciais com expiração para configurar rapidamente uma conexão com um cliente externo.
A seção Credenciais que estão expirando fornece as seguintes informações:
- Host: o nome do host ao qual conectar seu 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 (
- 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. A duração padrão da validade do token é de 24 horas, mas pode ser alterada nas configurações avançadas do Admin Console.
Conectar-se aos dados do Customer Journey Analytics nas sessões de consulta connect-to-customer-journey-analytics
Use a extensão Customer Journey Analytics BI com Power BI Tableau para acessar suas visualizações de dados do Customer Journey Analytics com SQL. Ao integrar o Serviço de consulta à extensão BI, você pode acessar suas visualizações de dados diretamente nas sessões do Serviço de consulta. Essa integração simplifica a funcionalidade das ferramentas de BI que usam o Serviço de consulta como interface PostgreSQL. Essa funcionalidade elimina a necessidade de duplicar visualizações de dados em ferramentas de BI, garante a geração de relatórios consistentes entre plataformas e simplifica a integração de dados de Customer Journey Analytics com outras origens em plataformas de BI.
Consulte a documentação para saber como conectar o Serviço de consulta a uma variedade de aplicativos de cliente de desktop, como Power BI ou Tableau
Para acessar seus dados de Customer Journey Analytics no Power BI ou Tableau, selecione o menu suspenso Banco de Dados e, em seguida, prod:cja nas opções disponíveis. Em seguida, copie os parâmetros de credenciais do Postgres (Host, Porta, Banco de Dados, Nome de Usuário e outros) para uso na sua configuração do Power BI ou Tableau.
Você também pode acessar seus dados de Customer Journey Analytics diretamente do Editor de consultas ou da CLI do Postgres. Para fazer isso, faça referência ao banco de dados cja ao gravar sua consulta. Consulte o guia de criação de consultas do Editor de consultas para obter mais informações sobre como gravar, executar e salvar consultas.
Consulte o guia de extensão de BI para obter instruções completas sobre como acessar suas visualizações de dados de Customer Journey Analytics com o SQL.
Credenciais sem expiração non-expiring-credentials
Você pode usar credenciais sem expiração para configurar uma conexão mais permanente com um cliente externo.
- Os usuários devem fazer logon com seu nome de usuário e senha no formato de
{technicalAccountId}:{credential}. Encontre mais informações na seção Gerar credenciais. - Por padrão, as credenciais sem expiração recebem permissões para executar somente consultas
SELECT. Para executar consultasCTASouITAS, adicione manualmente as permissões "Gerenciar conjunto de dados" e "Gerenciar esquemas" à função associada à credencial sem expiração. A permissão "Gerenciar Esquemas" pode ser encontrada na seção "Modelagem de Dados", e a permissão "Gerenciar Conjuntos de Dados" está localizada na seção "Gerenciamento de Dados" da [Adobe Developer Console] (https://developer.adobe.com/console/). - Os clientes de terceiros podem ter um desempenho diferente do esperado ao listar objetos de consulta. Por exemplo, alguns clientes de terceiros, como DB Visualizer, não exibirão o nome da exibição no painel esquerdo. No entanto, o nome da exibição pode ser acessado se for chamado em uma consulta
SELECT. Da mesma forma, PowerUI pode não listar as exibições temporárias criadas por meio do SQL para seleção na criação do painel.
Pré-requisitos
Antes de gerar credenciais sem expiração, você deve concluir as seguintes etapas no Adobe Admin Console:
- Faça logon no Adobe Admin Console e selecione a Organização relevante na barra de navegação superior.
- Selecione um perfil de produto.
- Configure as permissões Sandboxes e Gerenciar Integração do Serviço de Consulta para o perfil do produto.
- Adicione um novo usuário a um perfil de produto para que ele tenha suas permissões configuradas.
- Adicione o usuário como um administrador de perfil de produto para permitir a criação de uma conta para qualquer perfil de produto ativo.
- Adicione 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 Adobe Developer Console para que o usuário use o recurso de credenciais com vencimento.
Gerar credenciais generate-credentials
Para criar um conjunto de credenciais sem expiração, volte para a interface do usuário da Platform e selecione Consultas na navegação à esquerda para acessar o espaço de trabalho Consultas. Em seguida, selecione a guia Credenciais 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 sendo geradas.
- Descrição: (opcional) uma descrição para as 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.
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 (
Ao editar uma credencial sem expiração, um modal é exibido. Você pode fornecer os seguintes detalhes para atualizar:
- Nome: o nome das credenciais sendo geradas.
- Descrição: (opcional) uma descrição para as 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 use-credential-to-connect
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 exibir suas credenciais que estão expirando na guia Credenciais da interface.
A tabela abaixo descreve os parâmetros normalmente necessários para se conectar a clientes externos.
O formato para inserir seu nome de usuário e senha usa valores separados por dois pontos, como neste exemplo
username:{your_username} e password:{password_string}.O nome do servidor/host ao qual você está se conectando.
- Este valor é usado para credenciais com e sem expiração e assume a forma de
server.adobe.io. O valor está em Host na seção CREDENCIAIS QUE EXPIRAM.
acme.platform.adobe.ioA porta do servidor/host ao qual você está se conectando.
- Este valor é usado para credenciais com e sem expiração e é encontrado na Porta da seção CREDENCIAIS DE EXPIRAÇÃO.
80O banco de dados ao qual você está se conectando.
- Este valor é usado para credenciais que estão ou não expirando e foi encontrado no Banco de Dados na seção CREDENCIAIS QUE ESTÃO EXPIRANDO.
prod:allO nome de usuário do usuário que está se conectando ao cliente externo.
- Esse valor é usado para credenciais com e sem expiração. Assume a forma de uma sequência alfanumérica antes de
@AdobeOrg. Este valor está em Username.
ECBB80245ECFC73E8A095EC9@AdobeOrgA senha do usuário que está se conectando ao cliente externo.
- Se você estiver usando credenciais com vencimento, elas poderão ser encontradas em Senha na seção CREDENCIAIS QUE EXPIRAM.
- Se você estiver usando credenciais sem expiração, esse valor serão os argumentos concatenados de technicalAccountID e a credencial retirada do arquivo JSON de configuração. O valor da senha tem o formato:
{technicalAccountId}:{credential}.
- Uma senha de credencial que expira tem mais de mil caracteres alfanuméricos. Nenhum exemplo será dado.
- Uma senha de credencial sem expiração é a seguinte:
4F2611B8613DK3670V495N55:3d182fa9e0b54f33a7881305c06203ee
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.