Guía de credenciales

El servicio de consultas de Adobe Experience Platform le permite conectarse con clientes externos. Puede conectarse a estos clientes externos utilizando credenciales que caducan o que no caducan.

NOTE
El panel de credenciales no está disponible automáticamente para todos los usuarios. Póngase en contacto con el equipo de su cuenta de Adobe para solicitar que la ficha Credenciales se incluya en el área de trabajo del servicio de consultas en caso de que lo necesite. Si se solicita, este cambio es para toda la organización y está a cargo del equipo de ingeniería de Adobe. No es una configuración controlada por los usuarios.

Credenciales que caducan expiring-credentials

Puede utilizar credenciales que caducan para configurar rápidamente una conexión con un cliente externo.

La ficha Credenciales del panel Consultas con la sección Credenciales que caducan resaltada.

La sección Credenciales que caducan proporciona la siguiente información:

  • Host: Nombre del host al que conectar a su cliente. Esto incorpora el nombre de su organización, tal como se ve en la cinta superior de la interfaz de usuario de Platform.
  • Puerto: número de puerto del host al que se va a conectar.
  • Base de datos: Nombre de la base de datos a la que conectar un cliente.
  • Nombre de usuario: El nombre de usuario usado para conectarse al servicio de consultas.
  • Contraseña: La contraseña utilizada para conectarse al servicio de consultas. Las contraseñas de la IU se han cifrado en hash por motivos de seguridad. Seleccione el icono de copia ( El icono de copia. ) para copiar sus credenciales completas sin hash en el portapapeles.
  • Comando PSQL: Un comando que ha insertado automáticamente toda la información relevante para conectarse al servicio de consultas mediante PSQL en la línea de comandos.
  • Caduca: La fecha y hora de caducidad de las credenciales que caducan. La duración de validez predeterminada del token es de 24 horas, pero se puede cambiar en la configuración avanzada del Admin Console.
TIP
Para cambiar la duración de la sesión de la conexión de credenciales que caduca al servicio de consultas, vaya al Admin Console y seleccione las siguientes opciones en la pantalla: Configuración > Privacidad y seguridad > Configuración de autenticación > Configuración avanzada > Duración máxima de la sesión.
Pestaña de configuración del Admin Console con las opciones Privacidad y seguridad, Autenticación y Duración máxima de la sesión resaltadas.
Consulte la documentación de ayuda de Adobe para obtener más información sobre la configuración avanzada que ofrece Admin Console.

Conectarse a los datos del Customer Journey Analytics en sesiones de consulta connect-to-customer-journey-analytics

Utilice la extensión de BI de Customer Journey Analytics con Power BI o Tableau para acceder a las vistas de datos de su Customer Journey Analytics con SQL. Al integrar el servicio de consultas con la extensión de BI, puede acceder a las vistas de datos directamente dentro de las sesiones del servicio de consultas. Esta integración optimiza la funcionalidad de las herramientas de BI que utilizan el servicio de consultas como interfaz PostgreSQL. Esta funcionalidad elimina la necesidad de duplicar vistas de datos en las herramientas de BI, garantiza la creación de informes coherentes en todas las plataformas y simplifica la integración de datos de Customer Journey Analytics con otras fuentes en las plataformas de BI.

Consulte la documentación para aprender a conectar Query Service a diversas aplicaciones cliente de escritorio, como Power BI o Tableau

IMPORTANT
Se requieren un proyecto del espacio de trabajo del Customer Journey Analytics y una vista de datos para utilizar esta funcionalidad.

Para acceder a los datos del Customer Journey Analytics en Power BI o Tableau, seleccione el menú desplegable Base de datos y, a continuación, seleccione prod:cja de las opciones disponibles. A continuación, copie los parámetros de credenciales de Postgres (host, puerto, base de datos, nombre de usuario y otros) para usarlos en la configuración de Power BI o Tableau.

Pestaña de credenciales del servicio de consulta con la lista desplegable de base de datos resaltada.

NOTE
Al conectar Power BI o Tableau a Customer Journey Analytics, se consume el derecho de "sesiones simultáneas" del servicio de consultas. Si se requieren sesiones y consultas adicionales, se puede adquirir un complemento adicional del paquete de usuarios de consultas ad hoc para obtener cinco sesiones simultáneas adicionales y una consulta simultánea adicional.

También puede acceder a los datos del Customer Journey Analytics directamente desde el Editor de consultas o la CLI de Postgres. Para ello, haga referencia a la base de datos cja al escribir la consulta. Consulte la guía de creación de consultas del Editor de consultas para obtener más información sobre cómo escribir, ejecutar y guardar consultas.

Consulte la guía de extensión de BI para obtener instrucciones completas sobre el acceso a las vistas de datos del Customer Journey Analytics con SQL.

Credenciales que no caducan non-expiring-credentials

Puede utilizar credenciales que no caduquen para configurar una conexión más permanente con un cliente externo.

NOTE
Las credenciales que no caducan tienen las siguientes limitaciones:
  • Los usuarios deben iniciar sesión con su nombre de usuario y contraseña en el formato de {technicalAccountId}:{credential}. Encontrará más información en la sección Generar credenciales.
  • De manera predeterminada, las credenciales que no caducan tienen permisos para ejecutar solamente SELECT consultas. Para ejecutar CTAS o ITAS consultas, agregue manualmente los permisos "Administrar conjunto de datos" y "Administrar esquemas" a la función asociada con la credencial que no caduca. El permiso "Administrar esquemas" se encuentra en la sección "Modelado de datos", y el permiso "Administrar conjuntos de datos" se encuentra en la sección "Administración de datos" de [Adobe Developer Console] (https://developer.adobe.com/console/).
  • Los clientes de terceros pueden tener un rendimiento diferente del esperado al enumerar objetos de consulta. Por ejemplo, algunos clientes de terceros como DB Visualizer no mostrarán el nombre de la vista en el panel izquierdo. Sin embargo, se puede obtener acceso al nombre de vista si se llama en una consulta SELECT. Del mismo modo, PowerUI podría no enumerar las vistas temporales creadas a través de SQL para su selección en la creación de paneles.

Requisitos previos

Para poder generar credenciales que no caduquen, debe completar los siguientes pasos en Adobe Admin Console:

  1. Inicie sesión en Adobe Admin Console y seleccione la organización correspondiente en la barra de navegación superior.
  2. Seleccione un perfil de producto.
  3. Configure los permisos Sandboxes y Administrar integración de servicio de consultas para el perfil del producto.
  4. Agregue un nuevo usuario a un perfil de producto para que se le concedan los permisos configurados.
  5. Agregue el usuario como administrador de perfil de producto para permitir la creación de una cuenta para cualquier perfil de producto activo.
  6. Agregue el usuario como desarrollador de perfiles de producto para crear una integración.

Para obtener más información acerca de cómo asignar permisos, lea la documentación sobre control de acceso.

Todos los permisos necesarios ahora están configurados en Adobe Developer Console para que el usuario utilice la función de credenciales que caducan.

Generar credenciales generate-credentials

Para crear un conjunto de credenciales que no caduquen, vuelva a la interfaz de usuario de Platform y seleccione Consultas en el panel de navegación izquierdo para acceder al área de trabajo de Consultas. A continuación, seleccione la ficha Credenciales seguida de Generar credenciales.

El panel Consultas con la ficha Credenciales y las credenciales de generación resaltadas.

Aparece un cuadro de diálogo que le permite generar credenciales. Para crear credenciales que no caduquen, debe proporcionar los siguientes detalles:

  • Nombre: El nombre de las credenciales que está generando.
  • Descripción: (Opcional) Una descripción de las credenciales que está generando.
  • Asignado a: Usuario al que se asignarán las credenciales. Este valor debe ser la dirección de correo electrónico del usuario que está creando las credenciales.
  • Contraseña (opcional) Una contraseña opcional para sus credenciales. Si no se ha establecido la contraseña, el Adobe generará automáticamente una contraseña.

Una vez que haya proporcionado todos los detalles necesarios, seleccione Generar credenciales para generar sus credenciales.

El cuadro de diálogo Generar credenciales está resaltado.

IMPORTANT
Cuando se selecciona Generar credenciales, se descarga un archivo JSON de configuración en el equipo local. Dado que la Adobe no registra las credenciales generadas, debe almacenar de forma segura el archivo descargado y mantener un registro de las credenciales.
Además, si las credenciales no se utilizan durante 90 días, se eliminarán las credenciales.

El archivo JSON de configuración contiene información como el nombre de la cuenta técnica, el ID de la cuenta técnica y las credenciales. Se proporciona en el siguiente formato.

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

Una vez guardadas las credenciales generadas, seleccione Cerrar. Ahora puede ver una lista de todas las credenciales que no caducan.

Se ha resaltado la pestaña Credenciales del panel Consultas con la sección Credenciales que no caducan.

Puede editar o eliminar las credenciales que no caducan. Para editar una credencial que no caduque, seleccione el icono de lápiz ( Un icono de lápiz. ). Para eliminar una credencial que no caduque, seleccione el icono Eliminar ( Un icono de papelera. ).

Al editar una credencial que no caduca, aparece un modal. Puede proporcionar los siguientes detalles para actualizar:

  • Nombre: El nombre de las credenciales que está generando.
  • Descripción: (Opcional) Una descripción de las credenciales que está generando.
  • Asignado a: Usuario al que se asignarán las credenciales. Este valor debe ser la dirección de correo electrónico del usuario que está creando las credenciales.

Cuadro de diálogo Actualizar cuenta.

Una vez que haya proporcionado todos los detalles necesarios, seleccione Actualizar cuenta para completar la actualización de sus credenciales.

Usar credenciales para conectarse a clientes externos use-credential-to-connect

Puede utilizar las credenciales que caducan o no caducan para conectarse con clientes externos, como Aqua Data Studio, Looker o Power BI. El método de entrada para estas credenciales variará según el cliente externo. Consulte la documentación del cliente externo para obtener instrucciones específicas sobre el uso de estas credenciales.

La imagen indica la ubicación de cada parámetro encontrado en la interfaz de usuario, excepto la contraseña de las credenciales que no caducan. Aunque los archivos de configuración JSON proporcionan credenciales que no caducan, puede ver las credenciales que caducan en la pestaña Credentials de la interfaz de usuario.

La ficha Credenciales de Queries Workspace con la sección Credenciales de caducidad resaltada.

En la tabla siguiente se describen los parámetros que suelen ser necesarios para conectarse a clientes externos.

NOTE
Al conectarse a un host mediante credenciales que no caducan, sigue siendo necesario utilizar todos los parámetros enumerados en la sección CREDENCIALES QUE CADUCAN, excepto la contraseña y el nombre de usuario.
El formato para escribir el nombre de usuario y la contraseña utiliza valores separados por dos puntos, tal como se ve en este ejemplo username:{your_username} y password:{password_string}.
Parámetro
Descripción
Ejemplo
Servidor/Host

El nombre del servidor/host al que se está conectando.

  • Este valor se usa tanto para credenciales que caducan como para credenciales que no caducan y adopta la forma de server.adobe.io. El valor se encuentra en Host en la sección CREDENCIALES QUE CADUCAN.
acme.platform.adobe.io
Puerto

El puerto del servidor/host al que se está conectando.

  • Este valor se usa tanto para credenciales que caducan como para credenciales que no caducan y se encuentra en Puerto en la sección CREDENCIALES QUE CADUCAN.
80
Database

La base de datos a la que se está conectando.

  • Este valor se usa tanto para credenciales que caducan como para credenciales que no caducan y se encuentra en Base de datos en la sección CREDENCIALES QUE CADUCAN.
prod:all
Nombre de usuario

El nombre de usuario del usuario que se está conectando al cliente externo.

  • Este valor se utiliza tanto para credenciales que caducan como para credenciales que no caducan. Adopta la forma de una cadena alfanumérica antes de @AdobeOrg. Este valor se encuentra en Nombre de usuario.
ECBB80245ECFC73E8A095EC9@AdobeOrg
Contraseña

La contraseña del usuario que se está conectando al cliente externo.

  • Si usa credenciales que caducan, se encuentra en Contraseña en la sección CREDENCIALES QUE CADUCAN.
  • Si utiliza credenciales que no caducan, este valor son los argumentos concatenados de technicalAccountID y la credencial tomada del archivo JSON de configuración. El valor de contraseña adopta la forma: {technicalAccountId}:{credential}.
  • Una contraseña de credencial que caduca tiene más de mil caracteres como cadena alfanumérica. No se dará ningún ejemplo.
  • Una contraseña de credencial que no caduca es la siguiente:
    4F2611B8613DK3670V495N55:3d182fa9e0b54f33a7881305c06203ee

Pasos siguientes

Ahora que comprende cómo funcionan las credenciales que caducan y las que no caducan, puede utilizar estas credenciales para conectarse a clientes externos. Para obtener más información detallada acerca de los clientes externos, lea la guía conectar clientes al servicio de consultas.

recommendation-more-help
ccf2b369-4031-483f-af63-a93b5ae5e3fb