API Documentation

Récupère la liste complète des membres du workspace avec leur rôle, date d'ajout, et informations de profil. Les admins obtiennent en plus la date de dernière activité issue des journaux d'audit.

Récupère les journaux d'audit paginés (50 entrées par page). Chaque entrée contient l'action effectuée, l'utilisateur, l'adresse IP source et un horodatage. Filtrable par fenêtre de temps et par type d'action.

Envoie une invitation par email à un nouveau membre. Le destinataire recevra un lien pour rejoindre le workspace. Si l'utilisateur possède déjà un compte, il sera directement ajouté. Les champs profil (prénom, nom, poste) sont optionnels.

Liste les assets avec pagination, recherche full-text et filtrage par type. La recherche porte sur le hostname, l'adresse IP, le domaine et le nom. Les types de filtre correspondent aux catégories OCSF (server, workstation, mobile, etc.).

Récupère les détails complets d'un asset : système d'exploitation, interfaces réseau, agents de sécurité installés (EDR, backup, etc.), logiciels, vulnérabilités connues et métadonnées matérielles.

Supprime définitivement un asset et toutes ses données associées (interfaces réseau, agents, logiciels, vulnérabilités). Cette action est irréversible et génère une entrée dans le journal d'audit.

Importe des assets en masse depuis un fichier CSV via multipart/form-data. Le format du CSV dépend de la source sélectionnée. Les assets existants sont mis à jour par correspondance sur le hostname ou l'identifiant source. Retourne le nombre de lignes traitées, matchées et créées.

Analyse les écarts de couverture sécurité sur l'ensemble du parc : assets sans EDR, sans sauvegarde, sans conformité, etc. Retourne pour chaque type d'écart le nombre d'assets concernés et la liste détaillée.

Liste l'ensemble des contrôles de maturité cybersécurité avec leur statut actuel, commentaire personnalisé et date de dernière mise à jour. Les contrôles couvrent les domaines : gouvernance, protection, détection, réponse et récupération.

Met à jour le statut d'un contrôle de maturité. Les statuts possibles sont : todo (à faire), in_progress (en cours), done (terminé), na (non applicable). Chaque changement est historisé et tracé dans les journaux d'audit.

Récupère l'historique complet des changements de statut d'un contrôle spécifique. Chaque entrée indique le statut, l'utilisateur ayant effectué la modification et la date. Utile pour les rapports d'audit et le suivi de progression.

Récupère les données du tableau de bord de l'extension : histogramme des signalements sur 30 jours, top 10 des utilisateurs les plus actifs, top 10 des domaines signalés, et KPIs globaux (total signalements, vrais/faux positifs).

Liste les clés d'enrôlement utilisées pour déployer l'extension via GPO, Intune ou MDM. Chaque clé affiche son label, le nombre d'installations actives, le quota maximum et son statut (active/révoquée/expirée). La valeur complète de la clé n'est jamais réaffichée.

Crée une nouvelle clé d'enrôlement. La clé complète est retournée uniquement dans cette réponse — elle ne pourra plus être consultée ensuite. Vous pouvez définir un label descriptif, un quota d'installations maximum et une durée de validité en jours.

Révoque une clé d'enrôlement (suppression logique). Les installations existantes utilisant cette clé ne sont pas affectées, mais aucune nouvelle installation ne pourra l'utiliser. Génère une entrée dans le journal d'audit.

Liste toutes les installations de l'extension enrôlées dans le workspace. Pour chaque installation : identifiant unique, nom d'utilisateur du poste, navigateur, statut de connexion et date de dernier contact. Permet de surveiller le déploiement et détecter les postes inactifs.

Récupère la politique de whitelist appliquée à toutes les installations de l'extension. Contient la liste des domaines autorisés (non signalés comme phishing) et l'option de verrouillage qui empêche les utilisateurs de modifier leur whitelist locale.

Met à jour la politique de whitelist du tenant. Les domaines listés ne seront jamais signalés comme phishing par l'extension. Si lockWhitelist est activé, les utilisateurs ne peuvent pas ajouter de domaines à leur whitelist personnelle. Les changements sont propagés aux extensions lors de leur prochaine synchronisation.

Récupère la configuration actuelle du workspace : nom affiché, identifiant slug, liste des solutions activées (assets, maturity, extension, secrets) et date de création.

Modifie les paramètres du workspace. Seul le propriétaire (owner) peut effectuer cette action. Permet de renommer le workspace ou d'activer/désactiver des solutions. Les solutions désactivées restent en base mais ne sont plus accessibles dans l'interface.

Liste toutes les clés API du workspace. Pour des raisons de sécurité, seul le préfixe de chaque clé est affiché (les 8 premiers caractères). Inclut le rôle associé, le label, la date de dernière utilisation et le statut (active/révoquée/expirée).

Liste les intégrations configurées pour le workspace avec leur statut de connexion (connected, disconnected, error) et la date de dernière synchronisation. Permet de vérifier l'état de santé des connecteurs avant un import ou une synchronisation.

Endpoint de health check. Retourne un statut "ok" si l'API est opérationnelle. Ne nécessite pas d'authentification particulière — utile pour le monitoring, les sondes de disponibilité et le polling.

Récupère les statistiques de disponibilité et de latence de l'API sur les N derniers jours (défaut 7, max 30). Les données sont agrégées par heure : uptime %, latence moyenne, nombre de checks et erreurs. Alimenté automatiquement par un cron toutes les 5 minutes.