Cloudinventory

Inventaire Cloud

Prérequis (auto-hébergé)

Version GLPI	PHP minimum	Recommandé
10.0.x	8.1	8.2
11.0.x	8.2	8.4

Une souscription GLPI Network BASIC (ou supérieur) est requis. Ce plugin est également disponible pour toutes les instances Cloud de GLPI Network.

Installer le plugin

• Allez sur le marketplace. Téléchargez et installez le plugin CloudInventory.

À savoir

Les fournisseurs et types de ressources actuellement pris en charge sont :

• OVHcloud

  • Instances Public Cloud

  • VPS (Serveurs Privés Virtuels)

  • Serveurs dédiés (Bare Metal)

• Scaleway

  • Instances Compute (Machines Virtuelles)

  • Serveurs Bare Metal

  • Instances Apple Silicon

• Amazon Web Services (AWS)

  • Instances EC2 (Elastic Compute Cloud)

• Microsoft Azure

  • Machines Virtuelles

• Google Cloud Platform (GCP)

  • Google Compute Engine (Machines Virtuelles)

• Alibaba Cloud

  • Elastic Compute Service (ECS)

Identifiants des fournisseurs

Chaque fournisseur peut être configuré individuellement via l'interface du plugin. La configuration comprend généralement :

• Les identifiants d'accès API (clés, secrets)

• Les paramètres de région, de projet ou d'abonnement

OVH

Créer des identifiants

• Pour obtenir des identifiants, cliquez sur le lien suivant :

  • Pour l'Europe https://eu.api.ovh.com/createToken/

  • Pour l'Amérique du Nord https://ca.api.ovh.com/createToken/

  • Pour les États-Unis https://api.us.ovhcloud.com/createToken/

• Connectez-vous avec votre compte

Pour accéder au formulaire Créer des clés API

• Remplissez les informations suivantes :

  • Un Nom d'application (obligatoire)

  • Une Description d'application (optionnel)

  • Une période de validité.

  • Les Droits pour restreindre l'utilisation de l'application à certaines API

    GLPI a seulement besoin du droit GET sur * (pour autoriser toutes les API OVHcloud)

• Après soumission, OVH vous fournira :

  • Application Key

  • Application Secret

  • Consumer Key

Configuration GLPI

Allez dans Administration > Inventaire Cloud > +Ajouter

Amazon

Créer des identifiants

Consultez la documentation sur la gestion des identifiants : Documentation des identifiants AWS

Ou suivez simplement ces instructions :

• Allez sur la page IAM et connectez-vous avec votre compte : IAM

• Allez dans l'onglet Utilisateur : Onglet Utilisateur

• Consultez cette page : Page des identifiants de sécurité

Après validation du formulaire, Amazon vous fournira les informations suivantes :

• Application Key

• Application Secret

Configuration GLPI

Allez dans Administration > Inventaire Cloud > +Ajouter

Scaleway

Créer des identifiants

Consultez la documentation sur la gestion des identifiants : Comment créer une clé API

Ou suivez simplement ces instructions :

• Allez sur la console Scaleway et connectez-vous avec votre compte : https://console.scaleway.com/login

• Cliquez sur Gestion des identités et des accès (IAM) en haut à droite de votre Tableau de bord d'organisation

• Cliquez sur l'onglet Clés API.

• Cliquez sur Générer une clé API.

• Choisissez le propriétaire de la clé API (utilisateur IAM ou application IAM).

• Entrez une description (facultatif) et une date d'expiration pour la clé API.

• Sélectionnez si la clé API sera utilisée pour le stockage d'objets → choisissez Non

Après validation du formulaire, Scaleway vous fournira les informations suivantes :

• Access Key

• Secret key

Configuration GLPI

Allez dans Administration > Inventaire Cloud > +Ajouter

Google

Créer des identifiants

Consultez la documentation sur la gestion des identifiants : Comment gérer votre clé

Ou suivez simplement ces instructions :

• Allez sur la page Comptes de service dans la Console Google Cloud

• Sélectionnez le Projet sur lequel votre Machine virtuelle a été créée

• Créez un nouveau Compte de service

• Remplissez les informations requises, puis cliquez sur Terminé

• Sélectionnez votre compte dans la liste

• Choisissez le type JSON

Maintenant, votre fichier de clé a été téléchargé sur votre ordinateur

Configuration GLPI

Allez dans Administration > Inventaire Cloud > +Ajouter

Alibaba

Créer des identifiants

Consultez la documentation sur la gestion des identifiants : Documentation des clés Alibaba Cloud

Ou suivez simplement ces instructions :

• Connectez-vous à la console RAM et connectez-vous avec votre compte Alibaba Cloud.

• Survolez l'image de profil dans le coin supérieur droit de la page qui s'affiche et cliquez sur Gestion des clés d'accès.

• Dans le message de note, lisez les conseils de sécurité et cliquez sur Utiliser la paire de clés d'accès actuelle.

• Sur la page Paire de clés d'accès, cliquez sur Créer une paire de clés d'accès.

• Dans le message Créer une paire de clés d'accès, affichez l' ID de clé d'accès et le Secret de clé d'accès.

  Vous pouvez cliquer sur Télécharger le fichier CSV pour télécharger la paire **AccessKey* ou cliquer sur Copier pour copier la paire AccessKey._

• Enfin, sélectionnez J'ai enregistré le Secret de clé d'accès.

Configuration GLPI

Allez dans Administration > Inventaire Cloud > +Ajouter

Entra

Créer des identifiants

Comment obtenir votre Tenant ID et Client ID

• Allez dans votre Tenant et enregistrez une nouvelle application

• Allez dans Aperçu pour obtenir le Tenant ID et le Client ID

• Allez dans Certificats et secrets

• Ajoutez un Nouveau secret client

• Définissez l'expiration

• Puis enregistrez

---

La valeur Secret sera affichée (4)

La valeur du secret client ne peut pas être consultée, sauf immédiatement après sa création. Assurez-vous de sauvegarder le secret lors de sa création avant de quitter la page.

• Allez dans Abonnement > Contrôle d'accès (IAM) > Ajouter une attribution de rôle

• Recherchez Microsoft.ClassicCompute

• Sélectionnez Lecteur

• Puis Suivant

• Sélectionnez cloudinventory (application) précédemment créée

• Puis cliquez sur Examiner + attribuer

Configuration de GLPI

Allez dans Administration > Inventaire Cloud > +Ajouter

Dans certains cas, des points de terminaison globaux sont disponibles.

Si vous avez plus d'une zone, ou si vous ne savez pas où se trouvent vos machines, les points de terminaison globaux sont disponibles :

• Tester tous les points de terminaison regroupe tous les points de terminaison

• Points de terminaison Europe uniquement regroupe les points de terminaison situés en Europe

• etc.

Cela signifie que la synchronisation prendra plus de temps.

Droits

Le plugin offre une gestion complète des droits.

Allez dans Administration > Profils > Inventaire Cloud

• Fournisseur

  • Lire

  • Mettre à jour

  • Supprimer

  • Purger

  • Lancer la découverte

• InstanceCloud

  • Mettre à jour

  • Synchroniser

  • Obtenir les données de l'API

  • Purger

• Tableau de bord

  • Voir le tableau de bord

Découverte

Maintenant que notre fournisseur a été créé dans GLPI, nous pouvons commencer à travailler sur l'inventaire cloud.

• Pour chaque fournisseur, vous pouvez déclencher manuellement la synchronisation ici :

• Vous pourrez visualiser la progression de la découverte.

• Ou simplement configurer les actions automatiques associées (vous pouvez filtrer par nom de fournisseur (par exemple, OVH)) (voir CronTask)

Instance Cloud

Chaque actif cloud trouvé est enregistré dans le plugin sous un objet CloudInstance.

• Vous pouvez trouver la liste des CloudInstance ici :

• Ou depuis le fournisseur (et l'onglet dédié)

L'action refresh vous permet d'exécuter manuellement la synchronisation pour une CloudInstance.

Le statut de la CronTask associée est affiché (voir CronTask). Un bouton permet de l'activer ou de la désactiver.

• Cliquez sur le lien CloudInstance pour obtenir plus d'informations :

Les Cloud Instances synchronisées sont automatiquement assignées à la même entité que le Fournisseur dont elles proviennent.

• Ordinateur GLPI

  • Ordinateur GLPI associé trouvé

  • Type de rapprochement pour cette CloudInstance (nom ou MAC)

Ordinateur GLPI inconnu

Plusieurs raisons peuvent expliquer cela :

• L'ordinateur n'existe pas encore dans GLPI (vous pouvez alors installer l'agent GLPI pour le faire apparaître, puis redémarrer la découverte des instances cloud pour établir le lien).

• Le rapprochement (en utilisant la MAC ou le nom de l'instance cloud) n'a pas pu trouver d'ordinateur.

• Vérifiez que l'adresse MAC ou le nom existe dans GLPI.

• Vous pouvez sélectionner manuellement l'ordinateur correspondant (N'oubliez pas de verrouiller l'ordinateur pour éviter que la prochaine découverte n'écrase votre sélection).

• Contactez-nous pour améliorer la méthode de rapprochement.

• Fournisseur

  • Nom du fournisseur (lien vers le formulaire du fournisseur GLPI)

  • Bouton pour synchroniser cette instance maintenant

• Instance Cloud

  • Nom de l'instance

  • Nom d'affichage de l'instance

  • ID de l'instance

  • ID du projet

  • Nom du projet

  • Modèle

  • État

  • Emplacement

  • Centre de données

• Sauvegardes

  • A une sauvegarde ?

  • État de la sauvegarde

  • Liste des sauvegardes

  • Planifiée

Une section finale, Données API, vous donne un accès direct aux informations de l'API pour l'Instance Cloud associée.

CronTask

Pour chaque fournisseur et chaque type d'instance, une tâche automatique dédiée permet une synchronisation régulière entre les données des API et les données de GLPI.

Recherche

Le plugin ajoute de nouveaux critères au moteur de recherche d'ordinateurs.

Depuis la liste des ordinateurs, il est possible de filtrer les résultats sur les données de la CloudInstance associée (si la CloudInstance y est liée).

Tableau de bord

Le plugin CloudInventory propose un tableau de bord pour afficher un résumé des CloudInstance.

Règles d'actifs

Le plugin ajoute de nouveaux critères aux Règles métier pour les actifs.

Chaque fois qu'un ordinateur est mis à jour (manuellement ou dynamiquement), s'il est lié à une CloudInstance, le moteur recevra les données suivantes (lorsqu'elles sont disponibles) :

• Inventaire Cloud - ID de l'instance

• Inventaire Cloud - Nom d'affichage de l'instance

• Inventaire Cloud - Nom de l'instance

• Inventaire Cloud - Nom du projet

• Inventaire Cloud - A une sauvegarde

• Inventaire Cloud - État

• Inventaire Cloud - Emplacement

• Inventaire Cloud - Centre de données

• Inventaire Cloud - Type d'instance

Journal

Si le mode débogage est activé pour un fournisseur dédié :

Un nouveau fichier journal sera automatiquement créé et contiendra diverses informations suite à l'exécution de la synchronisation.

Exemple : pour le fournisseur Ovh et la synchronisation VPS, un fichier nommé ovh-{{instance-type}}-{{provider_name}}-error.log sera créé dans le dossier glpi/files/_log/ et contiendra les erreurs rencontrées lors de son exécution.

---

FAQ

Si vous avez des questions concernant l'utilisation du plugin, n'hésitez pas à consulter notre FAQ

Aller à la FAQ