Générer des identifiants API

Générer des identifiants API

Cet article fournit un guide étape par étape pour générer et gérer des identifiants API dans le portail Lenovo Device Orchestrations (LDO). Il décrit le processus de création d’un identifiant client (Client ID) et d’une clé secrète (Secret Key), l’obtention d’un jeton Bearer pour l’authentification, ainsi que l’accès aux différents points de terminaison de l’API. Il explique également comment utiliser la documentation Swagger pour explorer et tester les méthodes API disponibles.

Notes
Vous devez disposer d’un compte d’Administrateur d’organisation dans le portail LDO pour générer des identifiants API.

Générer des identifiants API

Avant d’utiliser les API LDO, vous devez générer des identifiants API dans votre compte LDO. Procédez comme suit :
  1. Cliquez sur Informations sur le dispositif > dans le menu déroulant de navigation supérieure.
  2. Accédez à Configuration > Paramètres des informations sur le dispositif.
  3. Cliquez sur Données d'identification API pour ouvrir le panneau des identifiants. Si aucun identifiant n’est présent, vous devez en générer.
  4. Cliquez sur Générer.
    Un identifiant client (Client ID) et une clé secrète (Secret Key) sont générés. Vous pouvez les copier dans le presse-papiers.
    1. Conservez ces identifiants dans un emplacement sécurisé et régénérez-les régulièrement selon les politiques de sécurité de votre organisation.
    2. Si vous souhaitez modifier les identifiants existants, vous devez en générer de nouveaux.
  5. Cliquez sur Régénérer.
  6. Dans la fenêtre Régénérer la clé secrète, cliquez sur Régénérer.
  7. Un nouvel identifiant client et une nouvelle clé secrète seront émis.
    1. Les identifiants restent valides jusqu’à ce qu’une nouvelle paire soit générée.
    2. Après avoir généré vos identifiants, utilisez l’URL appropriée en fonction de la région où se trouvent les dispositifs de votre organisation.
      1. NAEA: https://auth.naea1.uds.lenovo.com 
      2. EU: https://auth.euwe1.uds.lenovo.com
selectedImg

Notes
Après avoir généré une nouvelle paire d’identifiant client et de clé secrète, l’ancienne paire devient invalide.

Obtenir un jeton Bearer

Le jeton Bearer est un type de jeton d’accès utilisant OAuth 2.0, avec une période d’expiration de 30 minutes.
Pour obtenir un nouveau jeton d’accès, votre application doit envoyer ce jeton Bearer, accompagné de votre identifiant client, au serveur d’authentification. Ce processus de vérification garantit que seule l’application autorisée (celle pour laquelle le jeton Bearer a été initialement émis) peut demander de nouveaux jetons d’accès.
  1. Générer un jeton Bearer via une API externe
  2. URL : URL de base + /api/v1/auth/<organization_name>/token
  3. L’URL de base dépend de votre région (NA ou EU).
  4. Le corps de la requête doit être au format x-www-form-urlencoded et contenir les éléments suivants :
    1. grant_type : client_credentials
    2. client_secret : clé secrète (depuis la page des identifiants API)
    3. client_id : identifiant client (depuis la page des identifiants API)
Notes
Générez un nouveau jeton Bearer à chaque expiration, soit toutes les 30 minutes.
selectedImg

selectedImg

Explorer les opérations API avec Swagger

L’archive de spécification Swagger contient un dossier avec un fichier index.html et d’autres fichiers JavaScript.
  1. Téléchargez le fichier Zip de spécification Swagger, qui fournit des détails sur chaque API.
  2. Extrayez les fichiers dans un dossier.


  3. Double-cliquez sur le fichier index.html pour l’ouvrir. La page d’accueil des API LDO Device Insights (LDI correspond à l’ancienne version) s’affiche dans Swagger.

    selectedImg
  4. Générez un jeton Bearer.

Tester les API

  1. Sélectionnez une méthode API dans Swagger.
  2. Utilisez le jeton Bearer dans l’appel.
  3. Cliquez sur Try it out.

Exemples de méthodes API

Authentification – Session de jeton API

Lenovo SDK snapshot

selectedImg
selectedImg

HTTP Response

Negative API Sample:  Groovy ACME Test


HTTP Request
selectedImg
HTTP Response
selectedImg

    • Related Articles

    • Générer des tickets de support

      Tickets de support LDO est un outil puissant doté de fonctionnalités pour la gestion des dispositifs en entreprise. Une fonctionnalité particulièrement utile pour les utilisateurs de dispositifs Lenovo est le Système de tickets de support. Les ...

    • Journal des modifications de l'inventaire des logiciels

      Cette fonctionnalité permet de suivre les logiciels/applications installés/désinstallés. Naviguez vers Rapports > Journal des modifications de l'inventaire des logiciels. Vous verrez deux onglets qui donnent accès aux listes des logiciels installés ...

    • Afficher l'inventaire des accesoires

      La page Inventaire des accessoires fournit un aperçu de toutes les stations d’accueil actuellement ou précédemment connectées aux dispositifs de l'organisation. Elle affiche des informations essentielles, notamment : Famille de produits, Nom du ...

    • Ajouter des dispositifs Windows

      Lenovo Device Orchestration prend en charge un processus automatisé qui simplifie l'intégration des appareils Windows. Les utilisateurs peuvent facilement télécharger le fichier .zip contenant les fichiers nécessaires et l'appliquer aux appareils. ...

    • Rapport état des correctifs déployés

      Lorsqu'un correctif est installé avec succès sur un dispositif Windows, il est retiré de la section des Correctifs et ajouté sur la liste de la page État des correctifs. Ce rapport fournit des détails sur les correctifs déployés. Pour générer un ...