Module XOAPBaselineDSC C’est une composante essentielle du Configuration Management module. En utilisant XOAPBaselineModuleDSC dans les configurations, vous bénéficiez de fonctionnalités permettant d’installer des applications, de surveiller l’état de conformité de vos nœuds et bien plus encore.

Version actuelle

La version actuelle du module est 0.1.14

Mise à jour requise

Le module DSC Baseline mis à jour comprend des corrections mineures de bugs et des améliorations de compatibilité.

Cette version (0.1.15) est désormais requise pour tous les déploiements XOAP afin d’assurer un comportement de configuration de base cohérent.

Vous pouvez télécharger le fichier zip du module de base du lien suivant.

Comment procéder pour mettre à jour

Téléchargez le module de base de données et l'enregistrer dans votre Workspace XOAP.

Dans Modules Configuration Management, cliquez sur le bouton « Nouveau module ».
 

Téléchargez le module et cliquez sur « Confirmer ». Le module sera prêt à l’utiliser dans environ 10 à 15 minutes.

Recompilez maintenant votre configuration.

Accédez à Configuration Management, à la section « Configurations » et trouvez votre configuration.

Dans le menu Actions, cliquez sur « Récompiler ».

Pour le module Baseline de XOAP, sélectionnez la version 0.1.15 et cliquez sur « Enregistrer ».

La dernière étape consiste à modifier votre groupe de configuration. Changez la version à la nouvelle et cliquez sur « Enregistrer ».

Votre configuration sera prête dans 10 à 15 minutes.

Remarque importante :
Il n'est pas nécessaire d'effectuer de modifications manuelles sur vos nœuds. Les mises à jour seront appliquées automatiquement.

The post About XOAP Baseline Module appeared first on XOAP.

Cela constitue une introduction à Configuration Management, en présentant son objectif, ses avantages et ses caractéristiques importantes.

Configuration Management (Configuration Management) est une version étendue de la configuration des états souhaités de Microsoft PowerShell (DSC), une partie essentielle de la configuration, de la gestion et de l'entretien des nœuds Windows et Linux. Elle permet de spécifier la configuration d'un nœud à l'aide d'un modèle déclaratif de manière simple et standardisée, facile à maintenir et à comprendre.

Avec Configuration Management, l’infrastructure est définie comme un code garantissant une configuration, une versionnage et une testabilité cohérentes. Configuration Management Les serveurs et les clients gérés par Configuration Management sont continuellement évalués en fonction de leur état souhaité. De plus, ils s’assurent que les configurations ne changent pas et que celles-ci sont automatiquement corrigées et appliquées partout où elles sont assignées.

Cela importe peu si vous utilisez DSC sur des serveurs ou sur vos postes de travail.

Regardez notre Vidéo YouTube Pour une visite guidée visuelle

Caractéristiques principales

• Créer et assurer Configurations standardisées et les assigner à des groupes ou à des hôtes individuels
• L’état souhaité est évalué et corrigé en continu selon les besoins – afin de permettre une Configuration cohérente
• Personnalisable code pour la flexibilité – créez vos propres configurations ou modules et les appliquez là où c’est nécessaire
• Migration et gestion sans douleur en intégrant la solution dans un petit nombre d’hôtes côte à côte et en évoluant à votre propre rythme
• Répliquez le code et assignez-le à plusieurs infrastructures pour concevoir un système de sécurité efficace. Une infrastructure répétable et immuable. Vous pouvez assigner le même ensemble de configurations à vos nœuds sur site ou à ceux qui fonctionnent dans des clouds publics.
• Implémenter Testage du code Des outils pour tester automatiquement les résultats de vos configurations
• Remplacer la configuration et la provisionnement manuels de l’infrastructure en utilisant la configuration d’état souhaitée ; il est conçu pour être lisible par l’homme et facile à comprendre, à écrire et à modifier.
• Activer Adoption de la cloud computing en exploitant l’infrastructure en mode « on-demand » du cloud, associée à un système de gestion de configuration robuste et facile à utiliser. L’infrastructure s’adapte automatiquement à votre progression en intégrant de nouveaux hôtes à la solution
• Support sur site – Peu importe si vous avez votre propre centre de données ou si vous exécutez vos workloads entièrement dans le cloud. Nous supportons de nombreux environnements accessibles par réseau.

Cas d'utilisation

• Gestion complète de la configuration des services d’infrastructure Microsoft Windows
• Gestion simple et efficace de la configuration des clients et des postes de travail Windows
• Remplacer les politiques de groupe et configurer les machines virtuelles sans connexion Active Directory (par exemple, les machines virtuelles dans la DMZ)
• Installer et configurer les fonctionnalités de Windows
• Utilisez notre interface utilisateur intuitive pour fournir PowerShell DSC à votre équipe informatique
• Exécutez les installations de paquets lors des opérations de gestion de configuration (avec Application Management basé sur PowerShell App Deployment Toolkit)

Principales avantages

• Simplifiez les tâches liées à l’infrastructure en configurant automatiquement un ou plusieurs nœuds
• Configurer tous les nœuds d’une même rôle de manière identique
• Eviter le décalage des configurations au fil du temps
• Automatiser le déploiement sur demande ou “ en masse ”, de manière entièrement automatisée et indépendante de l’emplacement d’un nœud

The post About Configuration Management appeared first on XOAP.

Configuration Management

PowerShell

Tous les nœuds qui seront utilisés pour rédiger ou recevoir des configurations sont en cours d'exécution. Version WMF 5.1 ou ultérieure. Les nœuds d’écriture, utilisés pour écrire les configurations localement, doivent disposer d’une connexion Internet pour télécharger les nouvelles ressources liées au DSC.

Gestion à distance

Le trafic WS-Management (WS-MAN) est autorisé sur le réseau. Il sera activé par défaut sur les nœuds qui disposent d'un Version PowerShell 5 Il a été installé, mais vous devez vous assurer qu’il ne soit pas bloqué par des pare-feu ou d’autres éléments du réseau. Lisez la suite pour plus d’informations.

Communication avec notre système de gestion

Pour communiquer avec notre serveur backend, les ports suivants doivent être ouverts : https://api.xoap.io sur le port 443.

Configuration de proxy pour les nœuds

Pour forcer les nœuds PowerShell DSC à utiliser un serveur proxy pour communiquer avec le backend hébergé dans le cloud, certaines modifications doivent être apportées à la configuration du nœud avant de le mettre en service. Le DSC ne communique pas dans un contexte utilisateur et utilise donc le contexte SYSTEM.

Pour que le DSC se connecte correctement et enregistre le noeud, ajustez les lignes suivantes dans le fichier machine.config de votre machine. .Dossier d'installation .NET.

Vous devriez trouver le fichier dans ces emplacements :

32 bits
**%windir%\Microsoft.NET\Framework\[version]\config\machine.config**
64 bits
**%windir%\Microsoft.NET\Framework64\[version]\config\machine.config**
[version] doit être égale à v1.0.3705, v1.1.4322, v2.0.50727 ou v4.0.30319. Les versions v3.0 et v3.5 contiennent uniquement des ensembles supplémentaires à v2.0.50727, donc il ne devrait pas y avoir de config\machine.config. Les versions v4.5.x et v4.6.x sont stockées dans v4.0.30319.
Ajoutez ensuite les lignes suivantes :

Firewalls

Le déchiffrement SSL peut vous mettre en difficulté lorsque des clients situés dans votre réseau d'entreprise tentent de communiquer avec le serveur cloud.

DEP

Nous avons observé que certains scanners antivirus avec DEP activé empêchaient les utilisateurs d’accéder avec succès au serveur cloud.

TLS

Activer TLS 1.2 autant que possible. Le fait de ne pas le faire empêchera le Gestion des Configurations de fonctionner correctement.

Configurer via PowerShell :

Set-ItemProperty -Path 'HKLM:\SOFTWARE\Microsoft\.NetFramework\v4.0.30319' -Name 'SchUseStrongCrypto' -Value '1' -Type DWordSet-ItemProperty -Path 'HKLM:\SOFTWARE\Wow6432Node\Microsoft\.NetFramework\v4.0.30319' -Name 'SchUseStrongCrypto' -Value '1' -Type DWordSet-ItemProperty -Path 'HKLM:\SOFTWARE\Microsoft\.NetFramework\v2.0.50727' -Name 'SchUseStrongCrypto' -Value '1' -Type DWord[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::Tls12

The post Prerequisites appeared first on XOAP.

Guide rapide

Les noeuds sont des dispositifs qui sont enregistrés dans votre espace de travail XOAP lorsque une configuration leur est attribuée. Une fois enregistrés, ils sont visibles dans XOAP et peuvent être gérés et surveillés via les configurations de configuration de l’état souhaité.

Ajouter un noeud

1. Pour ajouter (enregistrer) un noeud à votre espace de travail, utilisez l'option Groupe de configuration commande/script de registre.
2. Aller à Configuration Management → Groupes de configuration.
3. Sélectionnez un groupe de configuration (par exemple, XOAP non attribué) et ouvrez Menu d’action (⋮).
4. Sélectionner Commandes de copie d'enregistrement Pour copier le commandement dans votre presse-papiers.
5. Sur l'appareil cible, ouvrez PowerShell en tant qu’administrateur et collez le commandement.
6. Exécutez le commandement pour enregistrer le dispositif. Le nœud sera ajouté à votre espace de travail XOAP dans le groupe correspondant.

Mettre à jour un nœud

1. Cliquez sur Menu d’action (⋮) à côté du noeud.
2. Sélectionner Régions pour consulter l’inventaire complet du système.
3. Sur la page Détails, vous pouvez mettre à jour Tags et examen Matériel informatique, Logiciel, et Conformité informations.

Supprimer un noeud

1. Cliquez sur Menu d’action (⋮) et sélectionnez Supprimer.
2. Confirmez la suppression en cliquant Supprimer.

Informations supplémentaires utiles

Dispositifs Windows et Linux :

Les nœuds peuvent être Windows des appareils. Linux Les appareils sont gérés via le Connecteur XOAP et sont listés sous la rubrique Inventaire module. Les appareils Windows peuvent également avoir le Connecteur XOAP installé et apparaît sous Inventaire le module, tout en étant encore géré via Configuration Management en parallèle.

Groupe de configuration :

Les nœuds ne peuvent être assignés qu'à un seul groupe de configuration, et les modifications peuvent être effectuées dans l'espace « Groupe de configuration ».

Support PowerShell :

L’enregistrement et la gestion des nœuds sont actuellement limités à PowerShell 5.1 uniquement. PowerShell Core n’est pas pris en charge.

Documentation technique

Les noeuds sont des dispositifs qui sont enregistrés dans votre espace de travail XOAP lorsque une configuration est appliquée à ces derniers. Une fois enregistrés, ils sont visibles dans XOAP et peuvent être gérés et surveillés centralement grâce à leurs configurations assignées, notamment l’inventaire et l’état de conformité, les résultats des exécutions de configuration ainsi que l’état opérationnel de chaque appareil. Cela permet une application cohérente des normes de configuration dans l’ensemble de l’environnement et offre une visibilité claire sur l’état actuel de chaque appareil ainsi que sur les modifications de configuration.

L'état des noeuds dans XOAP indique l'état de configuration actuel d'un appareil en fonction des résultats de l'évaluation et de l'exécution de la configuration la plus récente. Les statuts suivants sont utilisés :

• Conforme : Le nœud correspond à la configuration assignée. Tous les paramètres requis sont appliqués et l’évaluation finale s’est terminée avec succès, sans détection de déviations.
• Non conforme : Le nœud ne correspond pas à la configuration assignée. Une ou plusieurs des paramètres requis manquent, sont incorrects ou n'ont pas été appliqués lors de la dernière exécution.
• Course : Une configuration est actuellement en cours sur le nœud. XOAP applique activement cette configuration ou l’évalue et le résultat final de la conformité n’est pas encore disponible.

Vous pouvez consulter l’historique de conformité de deux façons :

• Cliquez sur État de conformité icône.
• Ouvrir le Menu d’action (⋮) et sélectionnez Historique de conformité.

Les deux méthodes ouvrent la même vue déroulante présentant les informations relatives à la conformité pour la dernière période. 14 jours. En cliquant à nouveau sur l’entrée de statut, vous pouvez consulter les détails d’une application de configuration spécifique en cours d’exécution. Des journaux détaillés sont disponibles pour les ressources qui ne sont pas dans l’état souhaité.

Pour afficher les détails du nœud complet, cliquez sur Nom du nœud ou ouvrez Menu d’action (⋮) et sélectionnez Régions.

Le Régions view offre un aperçu détaillé de l’état actuel du nœud dans plusieurs catégories :

• Matériel : BIOS, Processeurs, Dispositifs et Volumes.
• Réseautage : Tous les détails de l'interface et les configurations réseau.
• Système d'exploitation : Listes en temps réel des services, des tâches planifiées et des utilisateurs locaux.
• Maintenance et politique : Installation des mises à jour et de l’état de DSC (Configuration d’état souhaitée).

The post Nodes appeared first on XOAP.

Guide rapide

A Groupe de configuration est un conteneur logique dans XOAP qui attribue une configuration spécifique a Politique et éventuellement un Rôle de l'application à un ensemble de nœuds.

Créer un nouveau groupe de configuration

1. Dans le coin supérieur droit, cliquez sur + Créer un groupe.
2. Tapez le code ci-dessous Nom du groupe et sélectionnez/ajoutez Tags.
3. Dans le menu déroulant en haut, sélectionnez celui que vous souhaitez. Rôle de l'application.
4. Mettre les nœuds dans Nouveaux nœuds disponibles à Nouveaux noeuds sélectionnés les assigner à ce groupe.
5. Sélectionner la configuration et la version de la configuration
6. Sélectionnez « Politique »
7. Cliquez sur Créer finir.

Modifier un groupe de configuration

1. Cliquez sur Menu d'action (⋮) et sélectionnez Editer.
2. Mettez à jour le nom, la politique, le rôle d’application, les tags ou modifiez les configurations assignées.
3. Cliquez sur Économiser appliquer les changements.

Supprimer un groupe de configuration

1. Cliquez sur Menu d'action (⋮) et sélectionnez Supprimer.
2. Confirmez la suppression en cliquant Supprimer.

Informations supplémentaires utiles

Groupes de configuration et nœuds :

Dans les groupes de configuration, vous pouvez ajouter uniquement des nœuds (Nouveaux Nouveaux Disponibles) qui ne sont pas déjà assignés à un autre groupe de configuration. Les nœuds peuvent être supprimés dans les détails du groupe de configuration.

Pour enregistrer un nouveau nœud (un nœud qui n’est pas encore disponible dans votre espace de travail XOAP), exécutez le script d’enregistrement ou la commande d’enregistrement dans PowerShell sur le nœud. Un groupe de configuration ne peut avoir qu’une seule configuration et une seule application de rôle assignée.

Documentation technique

A Groupe de configuration est un conteneur logique dans XOAP qui assigne une valeur spécifique Configuration—et éventuellement un Rôle de l'application et Politique—à un ensemble de nœuds. Les nœuds enregistrés au sein du groupe héritent de ces assignations, et la vue du groupe fournit un aperçu du nombre de nœuds présents. conforme, non conforme, ou En cours d'exécution la configuration.

Pour enregistrer des nœuds dans votre espace de travail, exécutez la commande script de registration (ou commande d'enregistrement) sur le noeud cible en utilisant Windows PowerShell 5.1 en tant que Administrateur.

Vous pouvez trouver le script/commande d’enregistrement dans le menu Actions (⋮) :

1. Cliquez sur Menu d’action (⋮) et sélectionnez Téléchargez le script de registration ou Commandes de copie d'enregistrement.
2. Sur le système cible (nœud), ouvrir Windows PowerShell 5.1 en tant que Administrateur, et soit :
   • Exécutez le script téléchargé, ou
   • Insérez le code d’enregistrement et exécutez-le.
3. La configuration spécifiée sera appliquée au nœud. Si un Rôle de l'application Si cette définition est définie, les applications attribuées seront également installées.
4. Le nœud apparaîtra dans Nœuds table sous Configuration Management.

Les deux méthodes appliquent la même configuration et donnent le même résultat.

Inscription massive (déploiement sur plusieurs nœuds)

Pour enregistrer plusieurs nœuds à la fois, répartissez les commande/script de registre en utilisant votre logiciel de déploiement ou vos outils de gestion de politiques existants. L’enregistrement doit se faire dans un contexte privilégié (Administrateur/SYSTEM).

Option 1 : Politique de groupe (GPO) – Tâche planifiée ou script de démarrage

Utilisez une GPO de domaine pour exécuter la procédure de registration sur les machines cibles :

• Task planifiée (recommandée) : Créez une tâche planifiée dans le GPO qui se lance lors du démarrage comme Système et exécute le commandement/script de registration.
• Script de démarrage : Attribuer un script de démarrage qui se lance lors du démarrage (scope ordinateur).
  Cette approche est simple, fonctionne bien pour de grandes flottes et garantit que le système d’exploitation fonctionne avec les privilèges requis.

Option 2 : Microsoft SCCM / MECM

Démarrer l'installation en tant que package/application SCCM :

• Exécutez le commandement/script de registration comme Système local.
• Targeter une collection de dispositifs (par exemple, une première phase pilote puis une diffusion plus large).
  Cela permet la génération de rapports, une logique de redémarrage et un déploiement contrôlé.

Option 3 : Microsoft Intune (Remédiation proactive ou déploiement de scripts)

Pour les appareils sous Entra ID ou gérés par Intune :

• Démarrer le script de configuration comme script d'appareil, ou utiliser Réparations préventives Pour l'exécuter une seule fois et vérifier que le nœud est enregistré.
• Assurez-vous que le script s’exécute dans contexte système pour les autorisations requises.

Option 4 : Exécution à distance (PowerShell Remoting)

Si PowerShell Remoting est disponible :

• Utilisez Invoke-Command pour exécuter le commandement de registration sur une liste de machines cibles sous un compte doté des droits d'administrateur locaux.
  Cela est utile pour l'intégration rapide de petites séries ou de groupes ad hoc.

Conseils pratiques pour une déploiement à grande échelle

• Utilisez un groupe pilote Premièrement, valider la connectivité, les autorisations et le comportement attendu.
• Veillez à ce que l’environnement permette l’envoi de données HTTPS (443) vers l’endpoint de l’API XOAP.
• Évitez de ré-exécuter des opérations sur des nœuds déjà enregistrés en utilisant les cibles/exclusions appropriées dans votre outil de déploiement (par exemple, les collections SCCM ou les gPOs).

Préalables pour enregistrer un nœud

• Dispositif Windows
• Exécuter en tant qu'administrateur
• 64-bits Windows PowerShell (pas PowerShell ISE)
• Windows PowerShell 5.1 avec DSC (PSDesiredStateConfiguration) disponible
• WinRM / PowerShell Remoting Il peut être activé et redémarré
• Envoi HTTPS (443) accès (ou un proxy fonctionnel pour l'accès au système) à : https://api.xoap.io

The post Groups appeared first on XOAP.

Guide rapide

A Module Il s’agit d’un ensemble de ressources DSC qui fournit les éléments nécessaires à la création et à la compilation des Configurations XOAP. Les modules définissent les ressources disponibles dans l’Assistant configuration et les paramètres qui peuvent être appliqués aux nœuds gérés.

Téléchargez un nouveau module

1. Aller à Configuration Management → Modules.
2. Cliquez sur Charger les modules.
3. Téléchargez le package de module (formats pris en charge : .zip ou .nupkg).
4. Activer Permettre l'écriture si le fichier existe déjà si vous souhaitez remplacer un module/une version existante.
5. Cliquez sur Suivant, révisez les détails si nécessaire, et complétez le téléchargement.

Modifier un module

1. Cliquez sur Menu d’action (⋮) au côté d'un module et sélectionnez Régions.
2. Revoir les informations du module telles que Nom, version, description, et Notes de sortie, et gérer Étiquettes si nécessaire.
3. Utilisation Télécharger Dans la vue de détails, pour télécharger la version du module sélectionné.

Supprimer un module

1. Cliquez sur Menu d’action (⋮) au côté d'un module et sélectionnez Supprimer.
2. Confirmer la suppression.

Informations supplémentaires utiles

Formats de package de modules supportés

Les modules peuvent être téléchargés comme .zip ou .nupkg paquets.

Chargement de modules pour des ressources manquantes

Si une ressource requise n’est pas disponible dans l’Assistant configuration, téléchargez le module correspondant dans Configuration Management → Modules.

Versions des modules

De multiples versions du même module peuvent exister dans XOAP, permettant de compiler des configurations en fonction des versions spécifiques du module.

Dependencies des modules

Si un module présente des prérequis (des dépendances) envers d'autres modules, tous les modules requis doivent être téléchargés afin que les ressources soient disponibles et utilisables.

Temps de compilation du module

Lorsque vous téléchargez un module, laissez 10 à 15 minutes s’écouler pour que celui-ci soit compilé en arrière-plan avant qu’il puisse être utilisé dans l’Assistant configuration.

Documentation technique

A Module C'est un package versionné de ressources DSC qui fournit les éléments constitutifs de Configurations XOAP. Les modules déterminent les ressources qui apparaissent dans Assistant de configuration, Les paramètres qui peuvent être configurés ainsi que les paramètres qui peuvent être appliqués aux nœuds gérés.

Techniquement, un module est un module standard de PowerShell qui contient un ou plusieurs Ressources du DSC. Chaque ressource représente une “ unité d’exécution ” (par exemple, un registre, un service, un fichier ou une fonctionnalité) et expose des paramètres qui décrivent l’état souhaité. XOAP lit les métadonnées du module pour identifier :

• Quels ressources sont inclus dans le module ?
• Quels paramètres sont requis vs. facultatifs
• Types de paramètres, valeurs autorisées et valeurs par défaut (si elles sont définies)

Version des modules et compatibilité

Les modules sont versionnés et la version du module sélectionné a un impact direct sur :

• Quels ressources sont disponibles
• Quels paramètres existent-ils (de nouvelles versions peuvent ajouter, renommer ou supprimer des paramètres)
• Comportement des ressources (correction de bugs et modifications de la logique d’application)

En raison de cela, la compilation de la configuration est liée à la version du module utilisée lors de la compilation. Si vous téléchargez une version de module plus récente, vous devrez généralement récompiler Des configurations sont mises en place pour garantir que la sortie générée soit conforme aux définitions des ressources mises à jour.

Les dépendances (prérequis)

Certains modules dépendent d'autres modules (par exemple, des bibliothèques auxiliaires ou des ressources DSC partagées). Si une dépendance requise est manquante :

• XOAP risque de ne pas être en mesure de compiler la configuration correctement, et/ou
• Les ressources concernées peuvent ne pas être disponibles ou utilisables dans le guide d’utilisation.

La meilleure pratique consiste à télécharger la chaîne complète des dépendances (tous les modules préalables) avant de créer ou de recompiler les configurations.

Qu’exige XOAP d’un module

Pour que un module soit utilisable dans XOAP Configuration Management, il doit être empaqueté dans un format supporté et contenir des ressources DSC valides. En pratique, cela signifie :

• Le module peut être importé via PowerShell/DSC Tooling
• Les ressources peuvent être découvertes (le schéma de ressources et les métadonnées sont présents)
• Tous les dépendances nécessaires sont disponibles
• La version du module est compatible avec les nœuds cibles (Windows PowerShell 5.1 / DSC 1.1)

Considérations opérationnelles

• Changements majeurs : Les nouvelles versions de modules peuvent introduire des changements majeurs (par exemple, des renommées de paramètres). Traitez les mises à jour de modules comme les mises à jour logicielles — vérifiez la validité dans une configuration pilote d’abord.
• Reproducibilité : Confirmer les configurations des pin connectés à une version connue du module pour obtenir des résultats prévisibles, et ne passer à une version plus récente que lorsque cette dernière est validée.
• Troubleshooting : Si une ressource n’est pas visible dans le guide d’installation ou si la compilation échoue, les causes les plus fréquentes sont l’absence de dépendances, une structure de module incompatible ou des exigences de ressource non supportées.

En pratique, XOAP consomme les modules dans les formats de paquets standard de PowerShell (le plus couramment .nupkg). Lorsque un module est téléchargé vers Configuration Management → Modules, Les ressources de l’application deviennent disponibles pour la sélection dans l’Assistant configuration (module/version → ressources → paramètres).

Téléchargez un module

Vous pouvez télécharger des modules pour une révision hors ligne ou pour réutiliser le même package dans un autre environnement :

• En Configuration Management → Modules, ouvrez le module Menu d’action (⋮) et sélectionnez Télécharger, ou
• Ouvrir Régions et l'utiliser Télécharger dans la vue des détails du module.

Comment trouver les modules communautaires

La plupart des modules DSC communautaires sont publiés via le Galerie PowerShell. Un workflow courant est le suivant :

1. Trouvez le module dans la galerie PowerShell.
2. Téléchargez le fichier brut .nupkg fichier (Téléchargement manuel).
3. Téléchargez .nupkg dans XOAP → → Configuration Management Modules.

Préalables du module (dépendances)

Si un module possède des prérequis (des dépendances) envers d'autres modules, Tous les modules requis doivent être téléchargés.. Autrement, certains ressources peuvent ne pas être disponibles ou utilisables lors de la création ou de la compilation de la configuration.

Créer un module personnalisé

XOAP supporte les modules personnalisés de la même manière que les modules communautaires : en téléchargeant le package résultant dans Configuration Management → Modules.

The post Modules appeared first on XOAP.

Guide rapide

A Politique détermine la manière dont les configurations sont appliquées et maintenues sur les nœuds. Il contrôle le comportement opérationnel du DSC, notamment le mode de configuration, la cadence d’exécution (fréquences), la gestion du redémarrage et les paramètres de proxy optionnels.

Créer une nouvelle politique

1. Aller à Configuration Management → Politiques.
2. Cliquez sur + Nouvelle politique.
3. Tapez un Nom.
4. Configurer les paramètres de politique requis :
   • Action après le redémarrage
   • Mode de configuration
   • Mode de configuration Fréquence (min)
   • Fréquence de la mise à jour (min)
   • Durée de conservation du statut (d)
5. (Facultatif) Configurer URL proxy, Nom d'utilisateur du proxy, et Mot de passe du proxy, et/ou ajouter Tags.
6. Cliquez sur Confirmer créer la politique.

Modifier une politique

1. Dans le cadre de la Politiques table, cliquez sur Menu d’action (⋮) à côté de la politique.
2. Sélectionner Editer.
3. Mettez à jour les champs requis selon les besoins.
4. Cliquez sur Confirmer Pour enregistrer les modifications.

Supprimer une politique

1. Dans le cadre de la Politiques table, cliquez sur Menu d’action (⋮) à côté de la politique.
2. Sélectionner Supprimer.
3. Confirmer la suppression.

Informations supplémentaires utiles

Changements de politique générale :

Les modifications apportées à une politique XOAP pas méditer automatiquement les paramètres de la politique sur les nœuds.

Paramètres du proxy :

Paramètres du proxy : Configurez les champs du proxy uniquement si les nœuds nécessitent un proxy pour accéder à XOAP ; sinon, laissez-les vides.

Documentation technique

A Politique Détermine la manière dont DSC est exécuté et maintenu sur un nœud. Il contrôle le comportement d’exécution de la configuration du nœud (mode de configuration), la fréquence avec laquelle le nœud évalue et applique la configuration (Frecuence de mode de configuration), la fréquence avec laquelle il renouvelle son contexte de configuration (Frecuence de renouvellement), et ce qui doit se produire après un redémarrage. Les politiques peuvent également stocker les paramètres de proxy pour garantir que les nœuds puissent accéder aux services XOAP dans des environnements réseau restreints.

Domaines d'action politique

Nom

Un nom unique et lisible par l’homme pour la politique (par exemple, Ordinateurs de bureau XOAP (pas de redémarrage)). Utilisez une convention de nommage qui reflète le volume de travail cible et les attentes en matière de redémarrage.

Sélectionnez l’action « Après redémarrage »

Détermine ce que le nœud doit faire avec le traitement de la configuration après un redémarrage. Dans la plupart des environnements, cette valeur est définie sur ContinueConfiguration, ce qui signifie que l'exécution de la configuration se poursuit et que le nœud reprend l'application/évaluation de la configuration assignée après le redémarrage.

Permettre l'écriture de modules

Contrôle si le contenu du module utilisé pour l'exécution de la configuration peut être remplacé lors de l'introduction d'une nouvelle version de module. Cette option n'est généralement utilisée que lorsque l'on souhaite intentionnellement que les nœuds acceptent les versions modifiées du module sans intervention manuelle.

Mode de configuration

Définie le comportement du DSC sur le nœud :

• ApplyOnlyApplique la configuration une seule fois ; elle ne surveille pas continuellement l’évolution de la valeur.
• ApplyAndMonitorApplique la configuration et rapporte les dérives, mais ne remédie pas automatiquement.
• ApplyAndAutoCorrectApplique la configuration et tente automatiquement de remédier aux dérives afin de remettre le nœud dans l’état souhaité.

Dans XOAP, ApplyAndAutoCorrect Il est généralement utilisé pour les bases de sécurité et la mise en œuvre de mesures de sécurité, tandis que ApplyOnly Il convient mieux aux scénarios de provisionnement ponctuel.

Mode de configuration Fréquence (min)

Contrôle la fréquence avec laquelle le nœud effectue un contrôle de cohérence en fonction de la sélection. Mode de configuration (surtout pertinent pour ApplyAndMonitor et ApplyAndAutoCorrect). C’est la principale “ cadence d’exécution ” qui détermine la rapidité avec laquelle XOAP/DSC détecte les dérives et les corrige automatiquement (lorsque cette option est activée).

Conseils clés

• Des valeurs plus faibles = une détection plus rapide des déplacements et une intervention plus rapide, mais une charge plus importante pour l’appareil cible.
• Des valeurs plus élevées = moins de vérifications fréquentes, moins de charge, détection de dérive plus lente.

Utilisation recommandée

• Tablettes : 30–60 minutes (typiquement)
• Serveurs : 60 minutes (typiquement), sauf si une application stricte est requise

Fréquence de la mise à jour (min)

Contrôle la fréquence avec laquelle le nœud renouvelle son contexte de configuration et vérifie la présence de contenu de configuration mis à jour. Cela influence la rapidité avec laquelle les modifications dans XOAP (nouvelle version de la configuration, ressources mises à jour, etc.) sont détectées par le nœud.

Conseils clés

• Des valeurs plus faibles = les nœuds réagissent plus rapidement aux changements, mais avec un taux de sondage plus élevé.
• Des valeurs plus élevées = une prise en charge plus lente des changements, une réduction des coûts liés à la collecte des données.

Utilisation recommandée

• Tablettes : 180 minutes (typique)
• Serveurs : 360 minutes (typique), sauf si vous avez besoin d’une propagation plus rapide

Durée de conservation du statut (d)

Détermine la durée pendant laquelle XOAP conserve l’historique des exécutions et des statuts des nœuds pour les rapports et les problèmes de dépannage (par exemple, l’historique de conformité). Des valeurs plus élevées conservent plus d’historique, mais peuvent augmenter la taille de l’espace de stockage et le temps de conservation.

URL du proxy / Nom d’utilisateur du proxy / Mot de passe du proxy

Configurations de proxy facultatives utilisées lorsque les nœuds doivent accéder aux endpoints XOAP via un proxy.

• URL proxy: L’endpoint proxy (par exemple, http://proxy.company.local:8080)
• Nom d'utilisateur du proxy / Mot de passe du proxyLes informations de connexion si le proxy nécessite une authentification
  Utilisation Choisissez « Existant » réutiliser les valeurs stockées dans Paramètres de manière constante.

Redémarrer le nœud

Contrôle si le redémarrage d'un nœud est autorisé ou déclenché dans le cadre de l'exécution de la configuration (le cas échéant). Activez cette option uniquement si les redémarrages sont acceptables pour les systèmes cibles et que vos politiques opérationnelles le permettent.

Tags

Les métadonnées facultatives utilisées pour le filtrage et l’organisation (par exemple, Serveur, Bureau, RebootAllowed, PoC).

Mode de configuration : fréquence vs. fréquence de rafraîchissement (comment ils fonctionnent ensemble)

Ces deux valeurs ont des objectifs différents et ne devraient pas être considérées comme des doubles.

• Mode de configuration de la fréquence = la fréquence à laquelle le nœud évalue/applique l’état souhaité (cadence de détection et de correction des drifts).
• Fréquence de la mise à jour = à quelle fréquence le nœud vérifie la présence de contenu de configuration mis à jour (la vitesse à laquelle les modifications de configuration se propagent).

Exemple pratique

• Si vous définissez Mode de configuration : Fréquence = 15 min et Fréquence de rafraîchissement = 360 min, Avec cette configuration, le nœud appliquera la configuration actuelle toutes les 15 minutes, mais il peut prendre jusqu'à ~6 heures pour commencer à utiliser une version de configuration nouvellement mise à jour (jusqu'à ce qu'elle soit mise à jour).

Valeurs minimales et limites pratiques

XOAP applique des valeurs minimales (en fonction de la configuration et des politiques en vigueur). Les limites actuelles sont les suivantes :

• Mode de configuration Fréquence : minimum 15 minutes
• Fréquence de la mise à jour : minimum 30 minutes

En tant que pratique de sécurité recommandée :

• Évitez les valeurs très faibles à moins que vous n’ayez une véritable nécessité et que vous ayez testé l’impact sur les points d’extrémité. (Valeurs) Les valeurs inférieures au minimum ne sont pas prises en charge et sera rejeté.)
• Gardez Fréquence de la mise à jour  plus élevé que Mode de configuration de la fréquence  pour réduire les rafraîchissements et les sondages inutiles.
• Une approche commune est Mode de configuration : Fréquence = 15 min et Fréquence de rafraîchissement = 60–360 min, Cela dépend de la rapidité avec laquelle vous avez besoin que les nœuds prennent en charge les modifications.

The post Policies appeared first on XOAP.

Securing configurations

All uploaded configurations are automatically signed with our code signing certificate. So you do not have to take care of securing your configurations.

During client registration, an additional certificate is installed on the client to identify requests from trusted nodes.

Securing the Pull Server

Our DSC implementation does not run on a web server. We are running containers behind an API gateway with user authentication.

Configure for Strong Cryptography

How to configure .NET Framework to support strong cryptography. Set the SchUseStrongCrypto registry setting to DWORD:00000001. This value disables the RC4 stream cipher and requires a restart. For more information about this setting, see Microsoft Security Advisory 296038.

Make sure to set the following registry keys on any computer that communicates across the network with a TLS 1.2-enabled system. For example, configuration manager clients, remote site system roles not installed on the site server, and the site server itself.

For 32-bit applications that are running on 32-bit OSs and for 64-bit applications that are running on 64-bit OSs, update the following sub-key values:

Registre

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\v2.0.50727]
      "SystemDefaultTlsVersions" = dword:00000001
      "SchUseStrongCrypto" = dword:00000001

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\v4.0.30319]
      "SystemDefaultTlsVersions" = dword:00000001
      "SchUseStrongCrypto" = dword:00000001

For 32-bit applications that are running on 64-bit OSs, update the following subkey:

[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\.NETFramework\v2.0.50727]
      "SystemDefaultTlsVersions" = dword:00000001
      "SchUseStrongCrypto" = dword:00000001

[HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\.NETFramework\v4.0.30319]
      "SystemDefaultTlsVersions" = dword:00000001
      "SchUseStrongCrypto" = dword:00000001

The SchUseStrongCrypto setting allows .NET to use TLS 1.1 and TLS 1.2. The SystemDefaultTlsVersions setting allows .NET to use the OS configuration. For more information, see TLS best practices with .NET Framework.

Configuration de proxy pour les nœuds

In order for PowerShell DSC nodes to be forced to use a proxy server to communicate with the cloud-hosted backend, some adjustments to the node configuration must be done before registering the node.

DSC does not communicate in a user context and therefore uses the SYSTEM context.

For DSC to connect successfully and register the node, adjust the following lines inside the machine.config in your .NET installation directory. You should find the file in these locations:

32-bit

**%windir%\Microsoft.NET\Framework\[version]\config\machine.config** copie

64-bits

**%windir%\Microsoft.NET\Framework64\[version]\config\machine.config** copie

[version] should be equal to v1.0.3705, v1.1.4322, v2.0.50727 or v4.0.30319. v3.0 and v3.5 just contain additional assemblies to v2.0.50727 so there should be no config\machine.config. v4.5.x and v4.6.x are stored inside v4.0.30319.

Then add the following lines: <defaultProxy> <proxy autoDetect="false" bypassonlocal="false" proxyaddress="http://127.0.0.1:8888" /> </defaultProxy> </system.net> copie

PowerShell DSC configuration encryption

PowerShell DSC configurations that are uploaded while adding the configuration are going to be encrypted by using a certificate that is provided by XOAP.

This happens in two cases:

• Adding a configuration by manually uploading configuration files (as ps1) with the upload wizard
• Adding a configuration by using the DSC Configuration Wizard

After the file is encrypted, it is converted to base64 string and pushed to a dedicated backend storage location.

If you are uploading a compiled mof file, it will not be encrypted.

The post Security appeared first on XOAP.

Pour écrire des configurations PowerShell DSC, vous avez besoin d’outils pour vous aider à commencer.

WMF 5.1

Si ce dernier n’est pas déjà installé, vous devriez le mettre en place. Windows Management Framework 5.1.

Si vous utilisez Windows 10 ou Windows Server 2016 ou une version ultérieure, il devrait déjà être installé.

PowerShell Get

Exécutez les commandes suivantes en tant qu’administrateur sur votre machine Windows :

Installer le module PowerShellGet -Name -Force

En savoir plus sur PowerShell Get.

Éditeurs de code

Vous aurez besoin d’un éditeur de code source approprié ; nous vous recommandons donc l’un des logiciels suivants.

Visual Studio Code

Visual Studio Code est notre éditeur de code préféré pour tous les sujets liés à PowerShell. Il peut être téléchargé ici. Vous pouvez l’installer pour un utilisateur ou en tant qu’installateur système. Choisissez l’installateur qui répond à vos besoins.

IntelliJ IDEA

Si vous n’êtes pas un fan de Visual Studio Code, vous pouvez utiliser IntelliJ IDEA en tant qu’alternative. Il peut être téléchargé. ici.

PowerShell ISE

PowerShell ISE est un autre éditeur de code que vous pouvez utiliser pour modifier vos configurations DSC, mais nous Je recommande vivement l'un des deux ci-dessus..

Ressources supplémentaires pour le DSC

Des ressources supplémentaires de DSC peuvent être téléchargées à partir de Galerie PowerShell. Les modules que vous devez télécharger dépendent de la configuration que vous souhaitez créer. Parcourez la Galerie PowerShell pour trouver les ressources dont vous avez besoin.

Si les ressources ne sont pas encore disponibles, n'hésitez pas à en créer vos propres ressources.

Ils sont installés via PowerShell :

Installer le module -Name xWindowsUpdate

Conventions de nomenclature

Suivez les instructions ci-dessous pour garantir un traitement correct :

• Les noms standard ne peuvent contenir que des lettres (a-z, A-Z), des nombres (0-9) et un underscore (_)
• Le nom ne peut pas être nul (0), vide ( ) ou composé de points (-), et doit commencer par une lettre (a-z, A-Z).

Exemples de noms valables

“XOAP_Any_Apps_And_Monitoring”

“xoap_any_apps_and_monitoring_0_1_9”

“XOAP_Hp_Dl380_Baseline_Configuration”

“xoap_hp_dl380_baseline_configuration”

Exemple de nommage invalide

“XOAP-W10-20H2-Citrix-Optimizer”

“01 XOAP W10 20H2 Citrix Optimizer”

Commandes et actions

Des cmdlets DSC (Configuration d’état souhaitée) pour une utilisation quotidienne

Commandes Debugging (DSC)

The post Best practices appeared first on XOAP.

The post Use case: B3S/BSI Technical control mapping appeared first on XOAP.