Integration overview and prerequisites

Esta información le muestra cómo crear una integración de Adobe I/O y un servicio de lugares.

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 Añadir un usuario o un desarrollador a los perfiles del servicio de lugares y Experience Platform Launch en Obtener acceso al serviciode 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 Añadir un usuario o un desarrollador a sus perfiles de Servicio de lugares y Experience Platform Launch en Obtener acceso a Serviciode lugares.

    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 manera de solicitar el token del portador mediante un token web JSON (JWT).

  • Para obtener más información sobre JWT, consulte Introducción a los tokensweb 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 Adobe I/O Authentication Overview.
IMPORTANTE

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 serviciosWeb.

Crear una integración de servicio de lugares

Para crear una integración de servicio de lugares, complete 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
    
    IMPORTANTE

    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.

    IMPORTANTE

    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:

vídeo de integración

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 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. En la parte inferior de la página, haga clic en 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 token de acceso al portador es lo que utilizará en las solicitudes de la API de servicio de lugares.

IMPORTANTE

Los tokenes de acceso de Adobe solo son válidos durante 24 horas, por lo que guarde el comando CURL de ejemplo (paso 5). Si el token de acceso ya no es válido, debe volver a generar el token.

En esta página