Guide de l’interface de programmation d’applications (API) Intel® Endpoint Management Assistant (Intel® EMA)

Documentation

Information et documentation de produit

000055621

24/10/2024

Le Guide de l’API Intel® EMA fournit aux administrateurs informatiques et aux développeurs un aperçu de l’interface de programmation d’applications (API) Intel® Endpoint Management Assistant (Intel® EMA).

Note: Les fichiers PDF nécessitent Adobe Acrobat Reader*.

Taille : 207 Ko
Date : août 2024

Le document PDF fournit des informations générales aux développeurs sur l’interface de programmation d’applications (API) Intel® EMA. Des informations détaillées sur les URI d’API individuelles (telles que les descriptions et les paramètres) sont contenues dans les deux fichiers HTML suivants. Latestswagger.html contient les chemins d’accès de l’API qui pointent toujours vers la dernière version publiée de l’API. En outre, le fichier de détails de l’URI de l’API de la version 9, V9swagger.html, est également fourni. Pour afficher ces informations détaillées sur les URI de l’API, téléchargez le fichier HTML souhaité et ouvrez-le dans un navigateur (Chrome fonctionne mieux).

Détails supplémentaires Intel EMA API :
L’API Intel® Endpoint Management Assistant (Intel® EMA) est un ensemble d’interfaces de programmation conçues pour permettre aux développeurs et aux administrateurs informatiques d’interagir avec Intel® EMA. Cette API facilite la gestion et la surveillance des terminaux, automatise les tâches administratives et intègre les fonctionnalités Intel® EMA dans d’autres solutions logicielles.

Environnement requis :
Intel® EMA serveur doit être installé et en cours d’exécution.
Des autorisations d’accès API et des informations d’identification appropriées sont requises.

Principales caractéristiques et capacités :

Gestion des appareils :
Gérer et surveiller les périphériques de point d’extrémité à distance.
Automatisation : automatisez les tâches administratives telles que les mises à jour logicielles, les redémarrages des appareils et les modifications de configuration.
Intégration : intégrez Intel® EMA fonctionnalités dans d’autres solutions logicielles et flux de travail.
Sécurité : gérez en toute sécurité les appareils avec des mécanismes d’authentification et d’autorisation.

Cas d’utilisation :
Provisionnement automatisé des appareils : provisionnez et configurez automatiquement de nouveaux appareils.
Dépannage à distance : diagnostiquez et résolvez à distance les problèmes sur les terminaux.
Déploiement de logiciels : automatisez le déploiement des mises à jour et correctifs logiciels.
Surveillance de la conformité : Assurez-vous que les appareils sont conformes aux politiques et normes de l’organisation.

Commencer:

Configuration logicielle requise :
Intel® EMA serveur doit être installé et en cours d’exécution.
Autorisations d’accès : les autorisations d’accès et les informations d’identification appropriées de l’API sont requises. Ces autorisations sont décrites en détail dans le fichier JSON Swagger.
Génération de clés API : générez une clé API à partir de la console Intel® EMA.
Configuration : configurez les paramètres réseau et assurez-vous que le serveur Intel® EMA est accessible.

Authentification et sécurité :

Authentification par jeton :
Utilise un nom d’utilisateur et un mot de passe associé pour un compte de serveur EMA.
Authentification Active Directory : utilise les informations d’identification d’Active Directory. Elle ne peut être utilisée que lorsqu’Intel® EMA est installé avec le mode d’authentification de domaine Windows* et que le serveur Intel® EMA est joint à un domaine Active Directory.
Authentification des identifiants client : conçu pour l’accès API au serveur EMA. Vous devez créer un compte d’authentification client et une clé secrète client sur le serveur EMA.
Authentification Microsoft* Entra : introduite dans la Intel® EMA 1.9.0, elle permet d’authentifier l’interface Web Intel® EMA à l’aide d’Azure Active Directory, connu sous le nom de Microsoft Entra.

Bonnes pratiques en matière de sécurité :
Utiliser le protocole HTTPS : utilisez toujours le protocole HTTPS pour chiffrer les données en transit.
Moindre privilège : accorde les autorisations minimales nécessaires aux utilisateurs de l’API.
Hachage des mots de passe : ne stockez pas les mots de passe dans des fichiers texte clair.
Gestion et dépannage des erreurs :

Codes d’erreur courants :
400 Bad Request : paramètres d’entrée non valides.
401 Non autorisé : informations d’authentification non valides ou manquantes.
404 Not Found : Ressource introuvable.
Erreur 500 interne du serveur : le serveur a rencontré une condition inattendue.

Conseils de dépannage :
Vérifier la clé API : Assurez-vous que la clé API est valide et dispose des autorisations nécessaires.
Valider l’entrée : Vérifiez que les paramètres d’entrée sont corrects et correctement formatés.
Problèmes de réseau : assurez-vous qu’il n’y a pas de problèmes de connectivité réseau entre le client et le serveur Intel® EMA.