Guide rapide

XOAP Connexions Gérez les identifiants et les points d'accès dont XOAP a besoin pour s'intégrer à des systèmes externes (par exemple, des fournisseurs de services cloud et des plateformes de virtualisation sur site). Ces connexions sont ensuite référencées par d'autres fonctionnalités de XOAP.

Créer une nouvelle connexion

1. Aller à Connexions et cliquez sur + Nouvelle connexion.
2. En Sélectionnez le type de connexion, Choisissez : Fournisseur de cloud, Sur site, ou API key.
3. Remplissez les champs requis pour le type sélectionné (voir les exemples ci-dessous).
4. (Facultatif) Ajouter Description et Tags.
5. Cliquez sur Testez la connexion (lorsque disponible) pour valider les informations d’identification et la connectivité.
6. Cliquez sur Confirmer (ou Enregistrer) pour créer la connexion.

Modifier une connexion

1. Dans la table « Connexions », cliquez sur Menu d’action (⋮) pour la connexion.
2. Sélectionner Editer.
3. Mettez à jour les champs selon les besoins.
4. Cliquez sur Testez la connexion (recommandé) et Enregistrer/Confirmer.

Supprimer une connexion

1. Dans la table « Connexions », cliquez sur Menu d’action (⋮) pour la connexion.
2. Sélectionner Supprimer.
3. Confirmer la suppression.

Informations supplémentaires utiles

Utilisez des identifiants ayant un niveau d'accès le plus bas

Créez des identités/credentials séparées par connexion et accordez uniquement les autorisations requises pour la fonctionnalité XOAP que vous utilisez (par exemple, Image Management uniquement pour le contrôle des inventaires).

Cycle de vie des certificats

Rotativez régulièrement les secrets (surtout ceux des applications en nuage) et mettez à jour la connexion XOAP pour l’adapter. Préférez des approches non expirables ou gérées, lorsque votre environnement le permet.

Les tags aident à une grande échelle

Attribuez des tags en fonction de leur objectif (par exemple ImageManagement, Inventory, Prod, PoC) afin de les rendre plus faciles à trouver et à gérer.

Testez les connexions dès le début

Si Testez la connexion Il faut valider l'accessibilité du réseau (proxy/pare-feu/DNS), les autorisations d'identité et le contexte du tenant/abonnement avant de procéder à des dépannages concernant les fonctionnalités XOAP dépendantes de la connexion.

Documentation technique

Connexions définir la manière dont XOAP s’authentifie auprès de plateformes et d’API externes. Elles sont utilisées par les fonctionnalités de XOAP nécessitant un accès à votre infrastructure (dans le cloud ou sur site) ou par le connecteur XOAP lors de l’inscription.

Dans XOAP, vous pouvez créer trois catégories de connexion :

• Fournisseurs de services cloud (Azure, AWS, Google Cloud)
• Sur site (vSphere, Nutanix) (Preview)
• API Keys (Preview)

Champ d’application de l’assignation : Une connexion peut être attribuée seulement à Images / Image Management et Actions scénarisées (il n'est pas utilisé ailleurs).

Permissions : Les autorisations minimales requises par fournisseur sont documentées dans Prérequis XOAP.

Types de connexion et champs

1) Connexions avec les fournisseurs de services cloud

Azure : Identité gérée

Données que vous fournissez :

• Nom de la connexion – Nom amical utilisé dans XOAP pour désigner cette connexion.
• Connecteur – Dispositif équipé d'un connecteur XOAP (Plus d'informations dans la section « Inventaire »)
• ID de l'abonnement – L’identifiant de la souscription Azure où XOAP gérera/lirera les ressources.
• Description (facultatif) – Note à caractère libre concernant l’objectif du document/le propriétaire de la connexion.
• Étiquettes (facultatif) – Des étiquettes pour vous aider à trouver, filtrer et gérer les connexions (max 5 par objet).

Test de connexion : Disponible (vérifie les informations d’identification et les autorisations auprès d’Azure).

Notes :

• Utilisez un appareil de gestion de l’identité dédié avec des autorisations de niveau le plus bas et les fonctionnalités du connecteur XOAP installées.
• Rotativez régulièrement vos secrets ; considérez-les comme des informations privées.

Azure – Registre d’applications

Données que vous fournissez :

• Nom de la connexion – Nom amical utilisé dans XOAP pour désigner cette connexion.
• Connecteur – Dispositif équipé d’un connecteur XOAP (Plus d’informations dans la section « Inventaire »). Non obligatoire.
• Numéro d'identification du locataire – L’identifiant de répertoire Entra ID (tenant) où l’application existe.
• Description (facultatif) – Note à caractère libre concernant l’objectif du document/le propriétaire de la connexion.
• Étiquettes (facultatif) – Des étiquettes pour vous aider à trouver, filtrer et gérer les connexions (max 5 par objet).

Test de connexion : Disponible (vérifie les informations d’identification et les autorisations auprès d’Azure).

Notes :

• Utilisez l'option d'enregistrement d'application lorsque vous souhaitez exécuter des actions scriptées à partir de Platform Management, mais que vous n'avez pas de abonnement Azure.
• Support de la fonction RestAPI de MS Graph.

AWS – Clé d'accès

Données que vous fournissez :

• Nom de la connexion – Nom amical utilisé dans XOAP pour désigner cette connexion.
• ID d’un compte AWS – L’identifiant de compte AWS de 12 chiffres qui appartient aux ressources cibles.
• Identifiant de l’accès – La partie identifiant publique d’une clé d’accès IAM.
• Clé de l'accès secrète – La partie privée de la clé d’accès IAM (traitée comme un mot de passe).
• Description (facultatif) – Note à caractère libre concernant l’objectif du document/le propriétaire de la connexion.
• Étiquettes (facultatif) – Des étiquettes pour vous aider à trouver, filtrer et gérer les connexions (max 5 par objet).

Test de connexion : Disponible (vérifie les informations d’identification et les autorisations auprès d’AWS).

Remarque : Utilisez un utilisateur/un rôle IAM dédié et une politique de privilèges minimaux conformément aux exigences de l’XOAP.

AWS – Assumer un rôle

Données que vous fournissez :

• Nom de la connexion – Nom amical utilisé dans XOAP pour désigner cette connexion.
• Rôle ARN – Le nom complet de la ressource Amazon (Amazon Resource Name) de la role IAM XOAP sera utilisé pour les autorisations.
• Description (facultatif) – Note à caractère libre concernant l’objectif du document/le propriétaire de la connexion.
• Étiquettes (facultatif) – Des étiquettes pour vous aider à trouver, filtrer et gérer les connexions (max 5 par objet).

Test de connexion : Disponibles. (vérifie les identités et les autorisations contre AWS).

AWS – Assumer un rôle (cross-account)

Données que vous fournissez :

• Nom de la connexion – Nom amical utilisé dans XOAP pour désigner cette connexion.
• Rôle ARN – L’ARN de la fonction IAM dans le compte cible que XOAP assumera.
• Identité externe – Une chaîne “ secrète ” partagée requise par la politique de confiance des rôles pour empêcher l’accès par des sous-responsables confus.
• Description (facultatif) – Note à caractère libre concernant l’objectif du document/le propriétaire de la connexion.
• Étiquettes (facultatif) – Des étiquettes pour vous aider à trouver, filtrer et gérer les connexions (max 5 par objet).

Test de connexion : Disponible (vérifie les informations d’identification et les autorisations auprès d’AWS).

Remarque : Les configurations entre comptes nécessitent généralement une politique de confiance de rôle + un schéma d’identification externe. La page des conditions préalables d’XOAP liste les autorisations minimales et les conseils à suivre.

Google Cloud

Données que vous fournissez :

• Nom de la connexion – Nom amical utilisé dans XOAP pour désigner cette connexion.
• ID du projet – L’identifiant du Google Cloud projet où XOAP gérera/lira les ressources.
• Fichier (clé de compte de service JSON) – Le fichier JSON de clés téléchargé sert à authentifier un compte de service.
• Description (facultatif) – Note à caractère libre concernant l’objectif du document/le propriétaire de la connexion.
• Étiquettes (facultatif) – Des étiquettes pour vous aider à trouver, filtrer et gérer les connexions (max 5 par objet).

Test de connexion : Disponible. (vérifie les informations d’identification/les autorisations contre Google Cloud).

Remarque : La clé JSON téléchargée doit appartenir à un compte de service avec des rôles de privilèges minimaux requis pour votre cas d'utilisation (Images vs Actions scriptées).

2) Connexions sur site (pré-version)

vSphere

Données que vous fournissez :

• Nom de la connexion – Nom amical utilisé dans XOAP pour désigner cette connexion.
• vCenter Server – Le nom d’hôte vCenter ou l’adresse IP XOAP à laquelle il sera connecté.
• Nom d'utilisateur – L’utilisateur vCenter (ou l’identité SSO) utilisé pour l’authentification.
• Mot de passe – Le mot de passe de l’utilisateur vCenter spécifié.
• Centre de données – Le vSphere Centre de données Un objet d’inventaire qui contient les clusters/hôpitaux/datastores que vous souhaitez cibler.
• Cluster – Le cluster vSphere situé dans le datacenter sélectionné, qui regroupe les hôtes et fournit la gestion des ressources partagées (DRS/HA si activé).
• Hôte – Un hôte ESXi spécifique à cibler (utilisé souvent lors du choix d’un hôte précis plutôt que de programmer via le cluster ou les règles).
• Pool de ressources – La ressource du cluster/hôte qui définit les quotas de CPU/RAM/limites/réservations pour les VMs déployées.
• Datastore – L’emplacement de stockage où les fichiers VM (VMDKs/config) seront placés.
• Fichier – Le dossier vCenter VM sert à organiser l’affichage de l’objet VM dans l’inventaire.
• Insecure (toggle) – Permet la connexion sans validation stricte du TLS (utiliser uniquement lorsque cela est requis dans les scénarios de laboratoire ou de POC).
• Description (facultatif) – Note à caractère libre concernant l’objectif du document/le propriétaire de la connexion.
• Étiquettes (facultatif) – Des étiquettes pour vous aider à trouver, filtrer et gérer les connexions (max 5 par objet).

Test de connexion : Actuellement indisponible Pour les installations sur site.

Comportement important :

• Les champs sensibles au cas : Les noms des objets d’inventaire vCenter (Datacenter/Cluster/Host/Pool de ressources/Datastore/Folder) sont sensible au casier. Entrez-les exactement comme définis dans vCenter.

Nutanix

Données que vous fournissez :

• Nom de la connexion – Nom amical utilisé dans XOAP pour désigner cette connexion.
• Nom d’utilisateur Nutanix – Le compte XOAP utilisé pour authentifier auprès de Nutanix (typiquement Prism).
• Nutanix Password – Le mot de passe de votre compte Nutanix.
• Endpoint – L’extrémité de connexion de Prism (nom d’hôte/adresse IP + port si applicable) vers laquelle XOAP se connecte.
• Nom du cluster – L’identifiant/nom du cluster Nutanix dans Prism où les opérations seront exécutées.
• Insecure (toggle) – Permet la connexion sans validation stricte du TLS (utiliser uniquement lorsque cela est requis dans les scénarios de laboratoire ou de POC).
• Description (facultatif) – Note à caractère libre concernant l’objectif du document/le propriétaire de la connexion.
• Étiquettes (facultatif) – Des étiquettes pour vous aider à trouver, filtrer et gérer les connexions (max 5 par objet).

Test de connexion : Actuellement indisponible Pour les installations sur site.

3) Connexions API key (pré-version)

Utilisé pour authentifier l' Installation / enregistrement du connecteur XOAP flux (sélection d’une clé API lors de la génération des commandes d’installation).

Données que vous fournissez :

• Nom de la connexion
• Type de token API (actuellement, les permissions de “ Admin ” et de “ XOAP Connector ” sont identiques — ignorez la différence pour l’instant)
• Optionnel : Description, Tags

Notes de sécurité

• Traiter les clés API comme des secrets : restreindre l’accès, les renouveler si nécessaire et éviter de les insérer dans une documentation en texte brut.
• Si une clé API est modifiée, les points d’accès qui en dépendent (par exemple, les processus d’inscription des connecteurs) doivent être mis à jour en conséquence.

Notes opérationnelles et bonnes pratiques

• Priorité minimale : Commencez par les autorisations minimales documentées dans les prérequis de XOAP, puis étendez les autorisations uniquement si une fonctionnalité spécifique nécessite davantage.
• Séparés par objet : Utilisez différentes connexions pour Image Management vs Actions scénarisées si vous souhaitez une séparation stricte des privilèges.
• Convention de désignation : Incluez le nom avec le fournisseur, la raison d’être et l’environnement (par exemple, azure-im-prod, aws-sa-dev, vsphere-im-lab).
• Étiqueté : Ajoutez des tags pour indiquer la propriété, l’environnement, le client/projet et le but (par exemple, prod, lab, im, sa).
• Rotation et cycle de vie : Planifiez un processus de rotation (surtout pour les clés Azure Client Secret, les clés AWS Access Keys, les clés JSON de Google et les clés API).
• Conscience de l’assignation : Avant de supprimer une connexion, vérifiez qu’elle n’est pas attribuée à aucun autre appareil. Images ou Actions scénarisées.

The post Connections appeared first on XOAP.

Guide rapide

Les paramètres XOAP fournissent une manière centralisée de stocker des valeurs réutilisables (par exemple, des noms d’utilisateur, des mots de passe, des identifiants, des listes et des mapes), afin qu’ils puissent être référencés dans toutes les fonctionnalités de XOAP. Les paramètres sont principalement utilisés via Choisissez « Existant » des champs dans toute l’interface utilisateur — lorsque vous cliquez Choisissez « Existant », XOAP affiche des paramètres qui correspondent à ceux de Type requis de ce domaine.

Créer un nouveau paramètre

1. Aller à Paramètres et cliquez sur + Nouvelle option.
2. En Sélectionnez le type, Choisissez le type de paramètre : Texte, Mot de passe, Qualifications, Numéro, Bool, Liste, ou Carte.
3. Tapez un Nom et le Valeur Pour le type sélectionné.
4. (Facultatif) Ajoutez un Description et Tags.
5. Cliquez sur Confirmer (ou Économiser) pour créer le paramètre.

Modifier un paramètre

1. Dans le cadre de la Paramètres table, cliquez sur Menu d’action (⋮) pour le paramètre.
2. Sélectionner Régions (ou ouvrez le paramètre).
3. Mettez à jour la valeur et/ou les métadonnées (Description, Tags) si nécessaire.
4. Cliquez sur Économiser appliquer les changements.

Supprimer un paramètre

1. Dans le cadre de la Paramètres table, cliquez sur Menu d’action (⋮) pour le paramètre.
2. Sélectionner Supprimer.
3. Confirmer la suppression.

Informations supplémentaires utiles

Comment fonctionne “ Choisir un fichier existant ”

Lorsque le champ prend en charge Choisissez « Existant », XOAP filtre la liste pour ne montrer que les paramètres de du même type car ce champ (par exemple, les champs de mot de passe ne sont affichés que) Mot de passe paramètres).

Utilisez les paramètres pour standardiser les environnements

Mémorisez les valeurs communes une fois (identifiants de locataires, identifiants d’abonnement, points d’extrémité, noms d’utilisateur par défaut, etc.) et réutilisez-les dans toutes vos connexions, vos scripts et autres fonctionnalités.

Traitement des secrets

Utilisation Mot de passe ou Qualifications utiliser des types pour les données sensibles au lieu de Text, et limiter l’accès via RBAC si nécessaire.

Les conventions de nommencement aident

Utilisez des préfixes clairs pour regrouper les paramètres (par exemple AZ_, AWS_, VMW_, IM_, SA_, PROD_, POC_) afin qu’ils soient faciles à trouver dans Choisissez « Existant » dialogues.

Références

Les références ne sont pas automatiquement mises à jour partout : modifier un paramètre n’actualise pas automatiquement la valeur effective dans tous les endroits où il avait été utilisé auparavant. Si une fonctionnalité enregistre une vue d’ensemble de la valeur, vous devrez peut-être sauvegarder/appliquer à nouveau la configuration (ou exécuter à nouveau l’action correspondante) pour récupérer le paramètre mis à jour.

Documentation technique

Paramètres Il s’agit de valeurs gérées centralement pouvant être réutilisées dans toute l’architecture XOAP. Elles visent à éviter la codification rigide des données sensibles (mot de passe, identifiants), des identifiants fréquemment réutilisés (identifiants d’abonnement, identifiants de locataire) et des paramètres spécifiques à l’environnement (pathos, flags, listes, mappings).

Les paramètres sont principalement consommés via Choisissez « Existant » les champs de l'interface utilisateur. Lorsque vous cliquez sur Choisissez « Existant » à côté d'un champ, XOAP filtre et affiche uniquement les paramètres correspondant à celui-ci. Type requis de ce domaine.

Où les paramètres sont utilisés

Les paramètres peuvent être référencés à partir de plusieurs fonctionnalités de XOAP, généralement là où vous les voyez :

• Un champ avec Choisissez « Existant »
• Un champ qui prend en charge les valeurs sensibles (mot de passe, secret)
• Un champ qui est réutilisé dans plusieurs configurations (identifiants, noms, listes)

Exemples d'utilisation typiques :

• Connexions: stockage de secrets/credentials (secrets dans le cloud, mot de passe vCenter, mot de passe Nutanix, etc.)
• Actions programmées / Automatisme: stockage des tokens API, des noms d’utilisateur/des mots de passe, des variables d’environnement
• Image Management: stockage des identifiants du cloud, des noms de ressources ou des identifiants utilisés par les développeurs

Types de paramètres

XOAP prend en charge plusieurs types de paramètres. Chaque type détermine la validation, le masquage et les situations dans lesquelles il peut être utilisé.

1) Texte

• Valeur de chaîne générique.
• Utilisez-le pour les identifiants, les noms, les adresses IP, les URL et les valeurs non sensibles.
• Exemples : tenant-id, subscription-id, resource-group, endpoint-url.

2) Mot de passe

• Valeur de chaîne secrète (masquée dans l’interface utilisateur).
• Utilisez-le pour tout secret unique sensible (mot de passe, secrets d’application, jetons).
• Exemples : vcenter-password, aws-secret-access-key, client-secret.

3) Les pouvoirs

• Objet structuré pour l’authentification.
• Contient généralement l’utilisateur et le mot de passe (ou des champs équivalents).
• Le meilleur pour les endroits où l’on utilise un nom d’utilisateur et un mot de passe ensemble.
• Format de valeur d'exemple (conceptuel) : { “username”: “xoap-admin”, “password”: “****” }.

4) Nombre

• Valeur numérique.
• Utilisez-le pour les calculs de nombres, les seuils, les tailles, les délais d'expiration, etc.
• Exemples : vm-count = 3, timeout-seconds = 600.

5) Bool

• Valeurs « vrai/faux ».
• Utilisez-le pour les fonctions de basculement et les drapeaux.
• Exemples : enable-tpm = true, dry-run = false.

6) Liste

• Liste/tableau de valeurs.
• Utilisez-le pour les collections telles que les noms d'hôtes, les noms de VM, les sous-réseaux, etc.
• Exemple [“XOAPDEMO0001″,”XOAPDEMO0002”]:.

7) Carte

• Structure clé/valeur (semblant à un dictionnaire).
• Utilisez-le pour les configurations et les mappages structurés.
• Exemple : (le [{“name”:”key1″,”value”:”value1″},{“name”:”key2″,”value”:”value2″}] format peut varier selon l'interface utilisateur).

Dans le cadre de la Détails des paramètres Dans la page XOAP, il est indiqué où se trouve actuellement le paramètre (Affecté à).

Cela permet d’identifier :

• Quels actions/ Platform Management objets scriptés dépendent de cela
• Que se verra-t-il affecté si vous changez les identifiants ou les informations de connexion ?

Utilisez cette vue avant :

• Rôles circulaires des secrets
• Renommer ou supprimer des paramètres
• Modification des valeurs spécifiques à l’environnement

Meilleures pratiques de sécurité et opérationnelles

• Mémoriser les secrets d’accès sous forme de mot de passe/d’informations d’identification, pas Text.
• Roter les informations d'identification Effectuez régulièrement des mises à jour et conservez une procédure opérationnelle concise pour “ mise à jour + redémarrage / réapplication ”.
• Utilisation Étiquettes Grouper les paramètres selon :
  • environnement (prod, poc, lab)
  • objectif (gestion des images, inventaire, actions scriptées)
  • client/projet
• Prefer principe de la moindre privilègeNe réutilisez pas la même clé secrète partout si les scopes diffèrent.
• Pour les types de « Credentials », « List » et « Map », maintenez la structure cohérente et documentée afin que les équipes sachent à quoi s'attendre.

The post Parameters appeared first on XOAP.

Guide rapide

XOAP Ressources C'est un référentiel de fichiers centralisé utilisé dans toute l'organisation XOAP. Vous pouvez y télécharger toute forme de fichier (scripts, fichiers de configuration, modèles, archives, binaries, etc.). Les ressources sont généralement référencées par d'autres fonctionnalités de XOAP (par exemple, la sélection des scripts dans “ Exécuter le script ”).

Créer une nouvelle ressource

1. Aller à Ressources et cliquez sur + Nouvelle ressource.
2. Téléchargez vos fichiers en utilisant Cliquez pour télécharger ou glisser et déposer.
3. (Facultatif) Dans le Détails des ressources étape, ajout :
   • Description
   • Tags
   • (Facultatif) Version du message
4. Cliquez sur Suivant/Confirmer terminer et créer la ressource.

Modifier une ressource

1. Dans le cadre de la Ressources table, cliquez sur Menu d’action (⋮) pour la ressource.
2. Sélectionner Régions.
3. Si la ressource est un type modifiable (PowerShell, Script Shell, JSON, YAML, Fichier texte), mettre à jour le contenu et/ou les métadonnées selon les besoins.
4. Sauvez les modifications (une nouvelle version peut être créée en fonction du flux de travail de mise à jour).

Supprimer une ressource

1. Dans le cadre de la Ressources table, cliquez sur Menu d’action (⋮) pour la ressource.
2. Sélectionner Supprimer.
3. Confirmer la suppression.

Informations supplémentaires utiles

Téléchargez tout

XOAP Resources permet le téléchargement toute forme de fichier (sans limitation aux scripts).

Formats modifiables

Vous pouvez modifier et maintenir ces types de ressources directement : PowerShell, Scripts Shell, JSON, YAML, Fichiers texte.

Utilisez des tags pour organiser vos données

Classifiez les ressources par objectif ou environnement (par exemple ImageManagement, ScriptedAction, PoC, Prod) afin de rendre la bibliothèque accessible et gérable.

Les ressources sont réutilisées dans l’ensemble de XOAP

De nombreux flux de travail d’interface utilisateur qui nécessitent un fichier ou un script (par exemple les flux d’exécution de scripts) référencent le contenu stocké dans Ressources.

Documentation technique

XOAP Ressources C’est un référentiel central pour les fichiers utilisés sur toute la plateforme. Vous pouvez y télécharger toute forme de fichier (scripts, configs, templates, binaries, archives, etc.). Les ressources sont versionnées et peuvent être référencées par d'autres fonctionnalités de XOAP (généralement les Actions scriptées et Image Management).

Catégories de ressources et filtrage

La page « Ressources » propose des filtres/des onglets pour les catégories de fichiers les plus courantes, telles que :

• Tous les ressources
• PowerShell
• Scripts Shell
• JSON
• YAML
• ZIP
• Fichiers texte
• Journal d'activité

Ces fonctionnalités sont principalement destinées à faciliter l'organisation et la découverte des données ; l'outil XOAP permet toutefois encore de télécharger des données de tout format.

Propriétés de la ressource de base

Chaque ressource possède généralement les éléments suivants :

• Nom de la ressource
• Type de ressources (Classification des MIME/types)
• Description
• Tags
• Version et Version du message
• Informations relatives à l'audit (Créé par / Mis à jour par + les timestamps)

Comportement d'upload et de remplacement

Lors de l’ajout de ressources :

• Vous pouvez télécharger des fichiers via le glisser-déposer ou le menu de sélection.
• Permettre l'écriture si le fichier existe déjà contrôle si un téléchargement peut remplacer une ressource existante avec la même identité/nom (selon votre comportement et vos contraintes XOAP). Si vous supprimez une ressource déjà existante, une nouvelle version est créée avec la ressource téléchargée.

Liste des actions liées aux ressources

Dans la liste des ressources (menu d’actions ⋮), vous pouvez généralement :

• Voir les détails
• Télécharger
• Supprimer

Page des détails des ressources

La page « Détails de la ressource » constitue la surface de contrôle principale d’une ressource.

Panneau de la dernière version

Également disponibles dans les versions suivantes :

• Numéro de la dernière version
• Version du message
• Création / mise à jour des métadonnées

Modifier le contenu de la ressource

• Modifier le contenu de la ressource ouvre un éditeur pour les types de ressources textuelles supportés (par exemple: PowerShell, Shell, JSON, YAML, Texte).
• Cela permet une édition en place sans avoir à télécharger à nouveau le fichier.

Enregistrer / Confirmer et versionner

Lorsque vous enregistrez des modifications dans le contenu de la ressource, XOAP vous demande de créer un Nouvelle version de la ressource:

• Vous pouvez définir Nouvelle version (y compris Version personnalisée segments).
• Vous pouvez fournir un Version du message définir le changement.
• Confirmant publie la version mise à jour comme la version la plus récente.

La versionnage est crucial car d'autres composants de XOAP peuvent dépendre d'une version de ressources spécifique pour assurer la reproductibilité.

Voir toutes les versions et les comparer

Dans les détails de la ressource, Voir tout ouvre Historique des versions où vous pouvez :

• Voir toutes les versions historiques
• Revoir les messages, les dates et les auteurs de la version révisée
• Comparez les versions (affichage des différences) pour comprendre exactement ce qui a changé entre les versions.

Télécharger la ressource

• Télécharger la ressource retrouve le fichier de ressources actuellement sélectionné ou le dernier.

Tags

• Les tags permettent la classification, le filtrage et la gouvernance (par exemple, vSphere, Image.XO, Prod, PoC).

Affecté à

Le Affecté à La section liste les endroits où la ressource est actuellement référencée (généralement sous la rubrique Platform Management« Actions scriptées » par exemple). Cela aide à analyser les impacts avant les modifications :

• “ Qui utilise cette ressource ? ”
• “ Quelle version est actuellement référencée ? ”

Notes pratiques et bonnes pratiques

• Utilisation messages de version de manière cohérente (ce qui a changé + pourquoi).
• Je préfère l'édition via Modifier le contenu de la ressource pour de petits changements contrôlés dans les fichiers de scripts/config ; privilégiez le redémarrage pour de grands changements structurels ou des artefacts binarés.
• Traiter les ressources partagées comme des “ interfaces ” : un changement de comportement peut avoir des répercussions sur les versions suivantes — utilisez le système de versionnement pour faciliter les ravalements.
• Utilisez des tags pour séparer les environnements et les objectifs (par exemple, Prod, Test, CustomerX, AVD, Build, Deploy).

The post Resources appeared first on XOAP.

Guide rapide

XOAP Horaires vous permettre de courir Définitions d'images et Actions scénarisées automatiquement selon un cycle horaire défini (minutes, heures, jours, semaines ou mois). Chaque calendrier peut être assigné à une ou plusieurs images et/ou actions scriptées, et XOAP affiche Nouvelle course prévue dans la liste des calendriers.

Créez un nouveau planning

1. Aller à Horaires et cliquez sur + Nouvelle grille de temps.
2. En Détails du programme, entrez :
   • Nom (obligatoire)
   • Description (facultatif)
   • Tags (facultatif)
3. Sélectionnez le mode de répétition à l’aide des tabulations :
   • Minutes, Horaire, Daily, Semestriel, ou Mensuel
   • Configurer les options de temporisation affichées pour la rubrique sélectionnée (par exemple “ Chaque X minute(s) ”, “ Chaque X heure(s) à minute Y ”, etc.).
4. Cliquez sur Suivant ouvrir Affecter un horaire.
5. Attribuer le calendrier aux cibles :
   • Utiliser le Images onglet pour sélectionner une ou plusieurs images
   • Utiliser le Actions scénarisées tab pour sélectionner une ou plusieurs actions scriptées
6. Cliquez sur Finition créer le calendrier.

Modifier un horaire

1. Dans le cadre de la Horaires table, cliquez sur Menu d’action (⋮) pour le calendrier.
2. Sélectionner Régions.
3. Mise à jour Nom, Description, Tags, et/ou le schéma de récurrence (minutier/heureux/diurnel/semestriel/mensuel).
4. Revoir ou ajuster l’affectation Images / Actions scénarisées (si applicable dans votre flux de travail).
5. Cliquez sur Économiser.

Supprimer un horaire

1. Dans le cadre de la Horaires table, cliquez sur Menu d’action (⋮) pour le calendrier.
2. Sélectionner Supprimer.
3. Confirmer la suppression.

Informations supplémentaires utiles

Quels objectifs peut cibler un calendrier

Un horaire peut être assigné à Images et/ou Actions scénarisées (vous pouvez utiliser un horaire pour les deux).

Visibilité des courses à venir

La liste des horaires montre Nouvelle course prévue afin que vous puissiez vérifier rapidement le temps.

Étiquettes pour la gouvernance

Utilisez des tags tels que Prod, PoC, AWS, Hardening et WeeklyAudit pour filtrer et gérer les calendriers à grande échelle.

Troubleshooting

Si les exécutions prévues ne se déroulent pas comme prévu, validez le schéma de calendrier, les assignations (images/actions scriptées) et vérifiez les informations correspondantes. Journal d'activité pour l’exécution des preuves.

Documentation technique

Horaires Dans XOAP, définissez des temps d'exécution récurrents pour Images et Actions scénarisées. Un calendrier est un objet réutilisable qui combine :

• Les métadonnées (nom, description, tags, informations d'audit)
• Mouvement cyclique (minutes/heure/jour/semaine/mois)
• Travaux (des images et/ou des actions scénarisées sont liées au calendrier)

Les horaires permettent de normaliser l’automatisation et de rendre les opérations répétées prévisibles et vérifiables.

Lorsque les horaires sont utilisés

Les horaires peuvent être attribués à :

• Images (Image Management)
• Actions scénarisées

Un seul calendrier peut être attribué à plusieurs cibles, et à toutes les deux catégories en même temps.

Vue de l'affichage des horaires

Le Horaires La liste présente de manière générale les métadonnées horaires les plus importantes.

Colons (typiques)

• Nom – Nom de l’agenda
• Description – Description courte optionnelle
• Nouvelle course prévue – Timestamp de la prochaine exécution calculé en fonction du modèle de répétition sélectionné
• Tags – Étiquettes facultatives pour le filtrage et la gouvernance

Barres d'outils et commandes de liste

• Recherche – Filtre les horaires par nom/description (et les marque généralement en fonction de la mise en œuvre de l’interface utilisateur)
• Sélectionneur de colonnes – Choisissez les colonnes visibles
• Les cases de sélection de rangées – Sélectionner les éléments (si des actions en masse existent dans votre environnement)
• Pagination – Naviguez dans les pages de résultats

Actions de ligne (menu Action ⋮)

• Régions – Ouvrir les détails du calendrier
• Supprimer – Supprime le calendrier (après confirmation)

Page des détails du programme

Le Détails du programme view est l’endroit privilégié pour inspecter et gérer un calendrier. Il comprend :

1) Section des métadonnées

• Nom (obligatoire)Identifiant unique et convivial pour le planning.
• Description (facultatif)Documentation à caractère libre concernant l’intention ou le but.
• Étiquettes (facultatif)Utilisé pour le filtrage, la gouvernance et le regroupement (par exemple, aws, prod, weekly-audit).

2) Informations d’audit (lecture uniquement)

• Créé par / Mis à jour par – Identité de l’utilisateur qui a créé/modifié le planning
• Heure et date de création / Heure et date de mise à jour – Étalons chronologiques pour le suivi du cycle de vie

3) Configuration du schéma de récurrence

Les calendriers prennent en charge les modes de répétition suivants :

• Minutes
• Horaire
• Daily
• Semestriel
• Mensuel

Chaque fois que vous activez une configuration de récurrence, seule une seule afficheur apparaît. L’interface utilisateur affiche les commandes pertinentes pour la rubrique sélectionnée. Le moteur de planification utilise ces paramètres pour calculer Nouvelle course prévue montré dans la vue de liste.

Note : L’interface utilisateur exprime généralement ces règles de manière “ humaine comme le Cron ” (par exemple “ Tous les X minutes ”, “ Toutes les heures à minuit Y ”). Les champs disponibles exacts dépendent du mode sélectionné.

4) Section des assignations (objectifs)

Les horaires peuvent être assignés à deux types cibles via des onglets :

• Images onglet
  Montre la liste des définitions d'image actuellement assignées au calendrier.
• Actions scénarisées onglet
  Montre la liste des Actions Scriptées actuellement assignées au calendrier.

Ces onglets permettent de mieux comprendre Qu’est-ce qui sera déclenché avec ce calendrier.

Le tableau comprend généralement des colonnes telles que :

• Nom
• État (Dernière course) (si applicable)
• Évolution (la dernière version) (si applicable)
• OS / Rôle / Créateur (pour les images, selon votre espace de travail)

Cette section est principalement destinée aux gestion de l’association et visibilité (ce qui est inclus dans le calendrier).

Créer un flux de tâches (wizard)

Lors de la création d'un planning, XOAP utilise un processus en deux étapes :

Étape 1 – Détails du calendrier

• Fournir Nom, optionnellement Description et Tags
• Choisissez et configurez le mode de répétition (minutes/heure/jour/semaine/mois)
• A Résumé Le bar affiche généralement le nom sélectionné ainsi que les informations relatives à la fréquence de publication

Étape 2 – Assigner un horaire

• Sélectionnez les objets cibles dans la section suivante :
  • Images
  • Actions scénarisées
• Le Résumé Le bar affiche généralement le nombre d’objectifs sélectionnés par type.
• Terminez avec Finition

Ce programme d’aide assure que la définition des horaires et les affectations sont enregistrées ensemble.

Actions et comportement

Économiser

• Commite les modifications de configuration de l’horaire (méta-données + répétition)
• Le Nouvelle course prévue Il est recalculé en fonction des nouvelles configurations.

Supprimer

• Supprime la définition de calendrier dans XOAP
• Toute automatisation basée sur ce calendrier s'arrête (car l'objet de calendrier n'existe plus).

Régions

• Ouvre la vue de configuration et d’attribution du calendrier pour inspection et modification

Notes opérationnelles et bonnes pratiques

• Ajoutez des tags qui aident Gouvernance et filtrage futurs (par exemple, prod, poc, aws, audit, hebdomadaire).
• Prefer Des noms qui expriment une intention et une cadence (par exemple, Weekly-CIS-Hardening, Daily-AVD-Image-Refresh).
• Un programme sans devoirs Il existera, mais ne déclenchera rien de vraiment utile. Confirme toujours les images/actions scriptées assignées.
• Des horaires très fréquents (minutiers/heureux) peuvent entraîner des coûts considérables. charge informatique et opérationnelle Selon ce que font vos images/actions scriptées.
• Pour les cibles indiquées dans les tableaux d’affectation, les indicateurs “ Dernière utilisation ” sont les suivants : Le moyen le plus rapide de repérer les problèmes; Pour une enquête plus approfondie, il convient d’utiliser les vues d’activité/logues appropriées dans XOAP.

Limites et portée

• Les horaires s'appliquent uniquement Image Définitions et Actions scénarisées.
• L'interface utilisateur propose Nouvelle course prévue Comme indicateur principal que la définition de la récurrence est valide et active.

The post Schedules appeared first on XOAP.

Guide rapide

Les tags XOAP vous permettent de catégoriser et d’étiqueter les objets sur toute la plateforme (par exemple, Applications, Groupes, Rôles, Paramètres, Ressources et Connexions). Les tags facilitent la recherche, le filtrage et la gestion des objets à grande échelle.

Créer un nouveau tag

1. Aller à Tags et cliquez sur + Nouvelle étiquette.
2. Tapez un Nom de tag (jusqu'à 40 caractères).
3. Sélectionnez un Couleur de l'étiquette.
4. (Facultatif) Ajoutez un Description (jusqu'à 160 caractères).
5. Cliquez sur Confirmer créer le tag.

Modifier un tag

1. Dans le cadre de la Tags table, cliquez sur Menu d’action (⋮) pour le tag.
2. Sélectionner Régions.
3. Mise à jour Nom de tag, Couleur de l'étiquette, et/ou Description.
4. Cliquez sur Économiser.

Supprimer un tag

1. Dans le cadre de la Tags table, cliquez sur Menu d’action (⋮) pour le tag.
2. Sélectionner Supprimer.
3. Confirmer la suppression.

Informations supplémentaires utiles

Limite d'affectation

Vous pouvez assigner jusqu'à 5 tags vers un seul objet.

Maintenez une nomenclature cohérente

Utilisez des noms simples et réutilisables (par exemple Prod, PoC, AWS, Azure, ImageManagement).

Utilisez les tags pour la gouvernance

Les tags sont les plus utiles lorsqu’ils sont standardisés au sein des équipes (environnement, propriétaire, objectif, client, etc.).

Documentation technique

Objectif et comportement

Les tags sont des étiquettes réutilisables qui peuvent être attribuées à de nombreux objets XOAP. Ils supportent les fonctionnalités suivantes :

• Filtrage et recherche dans les vues de liste.
• Cohérence et gouvernance par l’étiquetage standard.
• Organisation croisée des caractéristiques (le même tag peut être réutilisé dans plusieurs modules/objets).

Contrainte importante : un seul objet peut avoir maximum 5 tags assigné.

Vue de la liste des tags

La liste des tags fournit un aperçu de tous les tags et de leurs métadonnées de base.

Colons courants

• NomIdentifiant du tag (jusqu'à 40 caractères).
• Description: Texte facultatif (jusqu'à 160 caractères).
• AperçuReprésentation visuelle du tag (label + couleur sélectionnée).

Contrôles et actions

• RechercheLes filtres filtrent les tags par leur nom (et correspondent généralement à la description si elle est disponible).
• Sélectionneur de colonnesChoisissez les colonnes qui doivent être affichées dans la table.
• Menu d’action (⋮) par tag :
  • Régions: Ouvrir la page de détails des tags pour leur modifier et leur rendre visible.
  • SupprimerSupprime le tag du système (le tag ne sera plus disponible pour l’attribution).

Créer un tag

Lors de la création d’une balise, les champs suivants sont disponibles :

• Nom de tag (obligatoire)La longueur maximale est 40 caractères
• Couleur de l'étiquette (obligatoire)Choisissez une couleur parmi les couleurs disponibles dans la palette.
• Description (facultatif)Longueur maximale : 160 caractères

Page des détails du tag

La page des détails des tags est le lieu central pour gérer les métadonnées des tags et pour voir où ils sont utilisés.

Des champs modifiables

• Nom de tag
• Couleur de l'étiquette
• Description du tag

Metadonnées de l’audit (lecture uniquement)

• Créé par / Mis à jour par
• Heure et date de création / Heure et date de mise à jour

Affichage assigné (suivi de l'utilisation)

Le Affecté à La section indique quels objets utilisent actuellement le tag, classés par module (par exemple : Application Management, Configuration Management, Image Management, Platform Management, Paramètres, Ressources, Connexions).

Qu'il vous soit possible de faire ici

• Évaluer l’utilisationConsultez les objets qui sont tagués (nom + type d’objet/description).
• Recherche dans les tâchesTrouvez rapidement où un tag est appliqué.
• Se déconnecter d'un objetUtilisez le contrôle « Supprimer/Décliner » (icône poubelle/poubelle) à côté d’une entrée pour déconnecter le tag de cet objet.

Considérations relatives à la suppression

Lorsqu'un tag est supprimé :

• Il est supprimé du catalogue des tags et ne peut plus être sélectionné pour de nouvelles assignations.
• L’utilisation existante ne sera plus disponible sous forme d’association de tag (c’est-à-dire que le tag ne figurera plus sur les objets).

Conventions et bonnes pratiques recommandées

• Utilisez un petit ensemble de tags mondiales (par exemple, Prod, Test, PoC) plus Tags de domaine (AWS, Azure, vSphere, Sécurité, AVD).
• Je préfère des noms courts qui sont stable au fil du temps (éviter d'inclure des dates sauf si c'est nécessaire).
• Définissez un standard interne afin que les différentes équipes n’aient pas besoin de créer des copies quasi identiques (par exemple, AWS vs Amazon).

The post Tags appeared first on XOAP.