Generación de credenciales API

Generación de credenciales API

Este artículo proporciona una guía paso a paso sobre cómo generar y gestionar credenciales de API para el portal de Lenovo Device Orchestration (LDO). Abarca el proceso de creación de un ID de cliente y clave secreta, la obtención de un Token de portador para autenticación y el acceso a diferentes terminales de API. Además, explica cómo utilizar la documentación de Swagger para explorar y probar los métodos de API disponibles.
Debe tener una cuenta de Administración de organización en el portal LDO para generar credenciales de API.

Generar credenciales de API

Antes de utilizar las APIs de LDO, debe generar credenciales de API en su cuenta. Siga estos pasos:
  1. Haga clic en Información del dispositivo desde el menú desplegable de navegación superior.
  2. Navegue a Configuración / Configuración de información del dispositivo.
  3. Haga clic en Credenciales API para abrir el panel de credenciales. Si no hay credenciales de API, deberá generarlas.
  4. Haga clic en Generar. Se generarán un ID de cliente y una clave secreta. Puede copiarlos al portapapeles.
    1. Almacene estas credenciales en un lugar seguro y regenérelas periódicamente según las políticas de seguridad de su organización.
    2. Si desea cambiar las credenciales de API existentes, debe generar unas nuevas.
  5. Haga clic en Volver a generar.
  6. En la ventana Volver a generar secreto, haga clic en Volver a generar.
  7. Se emitirá un nuevo ID de cliente y una clave secreta.
  1. El ID de cliente y la clave secreta no expiran hasta que se genere un nuevo par.
  2. Después de generar las credenciales, utilice la URL correspondiente a la región donde se encuentran los dispositivos de su organización:
    1. NAEA: https://auth.naea1.uds.lenovo.com
    2. EU:
      https://auth.euwe1.uds.lenovo.com
Al generar un nuevo par de ID de cliente y clave secreta, el anterior se invalida automáticamente.

Obtener un Token de portador

El Token de portador es un tipo de token de acceso que utiliza Auth 2.0 con un período de expiración de 30 minutos. Para obtener un nuevo token de acceso, su aplicación debe enviar este token junto con su ID de cliente al servidor de autenticación. Este proceso de verificación garantiza que solo la aplicación autorizada (aquella para la que se emitió el token de portador) pueda solicitar nuevos tokens de acceso.
  1. Generar un Token API de portador  mediante API Externa.
  2. URL: Base URL + /api/v1/auth/<organization_name>/token
  3. La URL base depende de su región: NA o EU
  4. El cuerpo de la solicitud debe estar en formato x-www-form-urlencoded y debe contener:
    1. grant_type: client_credentials
    2. client_secret: clave secreta (obtenida de la página de credenciales API)
    3. client_id: ID (obtenido de la página de credenciales API)
Genere un nuevo Token de portador cuando expire después de 30 minutos.


Explorar operaciones de API con Swagger

El archivo de especificación de Swagger contiene una carpeta con un archivo index.html y otros archivos JavaScript.
  1. Descargue el archivo ZIP Swagger Specification desde el sitio de soporte, que contiene detalles sobre cada API.
  2. Extraiga los archivos en una carpeta.
  3. Haga doble clic para abrir index.html. Verá la página principal de las APIs de LDO Información del dispositivo (LDI es legado) en Swagger.
  4. Genere un Token de portador.

Probar APIs

  1. Seleccione un método de API en Swagger.
  2. Ingrese el Token de portador en la llamada.
  3. Haga clic en Probar.

Ejemplos de métodos de API

Autenticación: Sesión de token de API

Lenovo SDK snapshot


Respuesta HTTP

Caso negativo de API: Testeo Groovy ACME

Solicitud HTTP

Respuesta HTTP

    • Related Articles

    • Configuración de la integración LDO ServiceNow

      Requisitos previos Antes de configurar la integración entre LDO y ServiceNow, asegúrese de cumplir con los siguientes requisitos para establecer una sincronización adecuada: Alineación de terminología En LDO, un dispositivo físico (como una laptop, ...

    • Generación de Tickets de Soporte

      Tickets de soporte LDO es una herramienta potente repleta de funciones para la gestión de dispositivos empresariales. Una funcionalidad destacada para usuarios con dispositivos Lenovo es el sistema de Tickets de Soporte de LDO Información del ...

    • Configurar cuentas de organización

      Acceso a su cuenta Cuando se crea el portal de su organización, se generará una única cuenta administrativa. El responsable de IT (Administrador de la organización) especificado a Lenovo durante la venta recibirá un correo electrónico de Lenovo ...

    • Errores de pantalla azul

      Los fallos del sistema en dispositivos Windows se conocen comúnmente como Pantalla Azul de la Muerte. LDO Información del dispositivo utiliza inteligencia artificial para analizar hardware, controladores y eventos del sistema operativo para resaltar ...

    • Informe Ahorro de energía

      Este informe proporciona a los IT Admin información precisa sobre el ahorro total de energía en toda la organización, derivado de los programas de Gestión de energía planificados. Presenta dos vistas: Panel y Dispositivos individuales. Panel Muestra ...