Show Menu
TEMAS×

Descripción general de la integración y requisitos previos

Esta información le muestra cómo crear una integración de Adobe I/O y Places Service.

Requisitos previos para el acceso de los usuarios

Compruebe con el administrador del sistema de su organización que se han completado las siguientes tareas:
  • Los lugares de servicio principal aparecen en la consola de administración de la organización.
  • Ha sido agregado a la organización.
  • Se le ha agregado como usuario al servicio principal de lugares de su organización.
    Para obtener más información, consulte Adición de un usuario o un desarrollador a sus perfiles Servicio de lugares y Inicio de plataforma de experiencia en Obtener acceso a Servicio de lugares.
  • Se le ha agregado como desarrollador a los servicios principales de lugares de su organización.
    Para obtener más información sobre cómo agregar desarrolladores, consulte Agregar un usuario o un desarrollador a los perfiles de lanzamiento de Places Service y Experience Platform en Obtener acceso a Places Service .
    Para obtener más información sobre la función de desarrollador, consulte Administrar desarrolladores .

Solicitudes de API REST

Cada solicitud a la API de REST del servicio de lugares requiere los siguientes elementos:
  • Un ID de organización
  • Clave de API
  • Un distintivo al portador
Una integración con Adobe I/O proporciona estos elementos y una forma de solicitar el token de portador mediante un token web JSON (JWT).
  • Para obtener más información sobre JWT, consulte Introducción a los tokens web JSON.
  • Para crear una integración para el servicio de lugares, consulte la sección Creación de una integración del servicio de lugares más abajo.
  • Para comprender la integración de claves de API, la generación de un JWT y los certificados de claves públicas, consulte Información general sobre la autenticación de Adobe I/O .
Si no puede iniciar sesión en la consola de Adobe I/O o si el servicio de lugares no es una opción de la página ** Crear integraciones, consulte Requisitos de organización en Información general de la API de servicios Web.

Crear una integración de servicio de lugares

Para crear una integración de servicio de lugares, realice las siguientes tareas:

Generar un par de claves pública y privada

Para crear una integración de servicio de lugares, necesita un par de claves pública y privada. Estos pares se pueden comprar o puede generar sus propias claves con firma personal.
Para generar sus propias claves con firma personal:
  1. En una ventana de terminal, copie y pegue cada una de las líneas siguientes y pulse **Enter**después de pegar cada línea:
       mkdir keys
       cd keys
       openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout places_integration_test_private.key -out    places_integration_test_public.crt
    
    
    Le recomendamos que asigne un nombre a las claves para facilitar su consulta y almacenarlas en una carpeta. Si crea varias integraciones, puede identificar y administrar fácilmente qué claves pertenecen a cada integración.
  2. Escriba la información solicitada por OpenSSL:
    Country Name (2 letter code:  // Example: US
    State or Province Name (full name):  // Example: California
    Locality Name (eg, city):  // Example: San Jose
    Organization Name (eg, company):  // Example: Places
    Organizational Unit Name (eg, section):  // Example: Engineering
    Common Name (eg, fully qualified host name):  // Example: places.com
    Email Address:  // Example:  poi@places.com
    
    
    Para obtener más información sobre OpenSSL, consulte OpenSSL .
    La información proporcionada se incorpora a las claves.
  3. Desplácese al directorio donde se encuentran los .key archivos y .crt los archivos.
    Por ejemplo, en MacOS, vaya a Macintosh HD > users > (your user name) > Keys .
El siguiente vídeo le guía a través del proceso de generación del par de claves:

Creación de una integración de servicio de lugares en la consola de Adobe I/O

Para crear una integración de servicio de lugares:
  1. Vaya a https://console.adobe.io e inicie sesión con su Adobe ID.
  2. En la sección Inicio rápido, haga clic en Crear integración .
  3. Seleccione Access an API y haga clic en Continue .
    **Access an API**es la ubicación predeterminada.
  4. Si tiene acceso a más de una organización de Experience Cloud, seleccione la organización en la lista desplegable de la parte superior derecha.
  5. Under Experience Cloud , select**Places Service** as the Adobe service to which you want to integrate and click Continue .
  6. Seleccione New integration y haga clic en Continue .
  7. En la pantalla Crear una nueva integración, escriba un nombre y una descripción.
  8. Arrastre y suelte el xxxx_public.crt archivo que ha creado arriba en la zona de **Public keys certificates**colocación.
  9. Seleccione un perfil de producto.
    Si no está seguro de qué perfil seleccionar, póngase en contacto con el administrador del sistema.
  10. At the bottom of the page, click Create integration .
  11. Después de unos segundos, en la pantalla Integración creada , compruebe que aparece el siguiente mensaje:
    Your integration has been created.
  12. La página de detalles de la integración aparece con el nombre de la integración en la parte superior.
    La ficha **Overview**aparece de forma predeterminada y muestra la clave de API, el ID de organización, el ID de cuenta técnica y otros detalles sobre las integraciones.

Registrar el ID de organización y la clave de API

  1. En la página de detalles de la integración, haga clic en la Services ficha y confirme que Places Service se muestra en Configured Services .
  2. En la **Overview**ficha, busque y registre la clave de API (ID de cliente) y el identificador de organización.
    Estos ID son necesarios para cada solicitud de API de REST del servicio de lugares.

Generar un token de JWT

En la página de detalles de la integración, haga clic en la **JWT**ficha para poder probar la integración generando un JWT y proporcionando la URL de intercambio.
Para generar un token de JWT:
  1. En un editor de texto, abra el private.key archivo creado anteriormente.
  2. On the JWT tab, copy the contents of the key and paste it in the Paste private key field.
  3. Haga clic en Generate JWT .
  4. In the Sample CURL command section, click Copy and paste the contents in your command prompt or terminal window.
  5. Ejecute el comando presionando **Enter**el teclado.
  6. Localice el "token_type": "bearer" y el "access_token" .
    El valor del autentificador de acceso al portador es lo que utilizará en las solicitudes de la API de servicio de lugares.
Los tokens de acceso de Adobe solo son válidos durante 24 horas, por lo que guarde el comando CURL de ejemplo (paso 5). Si el autentificador de acceso ya no es válido, debe volver a generar el autentificador.