Installer un MID Server sur Windows

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 21 minutes de lecture
  • Installez les MID Servers avec le package d’installation Windows guidée de MID Server. Le package inclut un programme d’installation qui configure automatiquement OpenJDK pour qu’il s’exécute dans l’environnement. Le MID Server peut utiliser un environnement JRE existant plutôt que l’OpenJDK fourni. Désinstallez le MID Server pour le redéployer.

    Configurer l’indicateur pour la phase d’installationAssurez-vous que le MID Server peut se connecter à des éléments à l'intérieur et à l'extérieur de votre réseauTélécharger et installer le MID Server sur un hôte Linux ou WindowsConfigurer votre MID ServerConfigurer la sécurité du MID ServerAssurez-vous que le MID Server peut se connecter à des éléments à l'intérieur et à l'extérieur de votre réseauTélécharger et installer le MID Server sur un hôte Linux ou WindowsConfigurer votre MID ServerConfigurer la sécurité du MID Server
    • Vérifiez que l’ordinateur hôte satisfait à la commande .Configuration requise pour le MID Server
    • Le MID Server nécessite la version 3.0 minimale de PowerShell et prend en charge les versions jusqu’à PowerShell 5.1.
    • Assurez-vous que le service de recherche d’expérience d’application Microsoft est activé sur l’hôte du Serveur MID. Si ce service est désactivé, la mise à niveau automatique du MID Server peut échouer et entraîner sa panne. Pour plus d’informations sur la gestion des problèmes avec le service Application Experience, consultez KB0597552.
    Java 11.0.17 est fourni avec le package d’installation Serveur MID et est installé sur l’hôte pour tous les nouveaux Serveurs MIDfichiers . Le programme d’installation configure automatiquement Java 11.0.17 pour qu’il s’exécute dans votre environnement. Aucune configuration supplémentaire n’est requise. Cette version prend en charge à la fois 64 bits Windows Serveurs MID et 64 bits Linux Serveurs MID. Le nécessite Serveur MID au minimum la version 11.0.8 de JRE et la version 11.0.17 recommandée. Si vous utilisez une version antérieure à 11.0.8, vous pouvez rencontrer des problèmes liés au chiffrement.
    Remarque :
    ServiceNow ne prend plus en charge les nouvelles installations de MID Server 32 bits ni les mises à niveau vers la version Rome. Les nouvelles installations de MID Server sont bloquées via les programmes d’installation RPM et MSI sur les systèmes d’exploitation suivants :
    • CentOS 7
    • Serveur Windows 2008
    • Serveur Windows 2008 R2
    • Windows 8
    • Windows 10
    Les MID Servers peuvent être installés manuellement sur n’importe quel système d’exploitation à l’aide du fichier ZIP, mais Windows 10 n’est pas pris en charge. La mise à niveau automatique des MID Servers non pris en charge vers la version Rome crée un enregistrement de problème dans Problèmes de MID Server (ecc_agent_issue). Pour plus d’informations, consultez Changements de plate-forme pris en charge pour MID Server [KB0863694].

    Les tests ont montré que le Serveur MID fonctionnement fonctionne comme prévu avec Oracle Java 11 version 11.0.5. Si vous devez mettre à niveau le JRE vers une version différente, contactez le représentant de compte approprié pour obtenir de l’aide.

    Les MID Servers mis à niveau peuvent utiliser différentes versions de Java en fonction de la version de leur système d’exploitation.
    • Les MID Servers mis à niveau à partir de versions antérieures utilisent OpenJDK fourni avec le programme d’installation du MID Server. Cette version d’OpenJDK a été testée et certifiée pour une utilisation avec ces MID Servers.
    • Serveurs MID mis à niveau sur d’autres versions du système d’exploitation met également à niveau automatiquement le JRE vers la version fournie avec le package d’installation.

    Installer un MID Server sur Windows avec l’installation guidée

    Installez les MID Servers avec le package d’installation Windows guidée de MID Server. Le package inclut un programme d’installation qui configure automatiquement OpenJDK pour qu’il s’exécute dans l’environnement.

    Avant de commencer

    Rôle requis : admin ou mid_server

    Pourquoi et quand exécuter cette tâche

    Le programme d’installation natif guidé de Windows par MID Server configure le MID Server avec les paramètres fournis. Le programme d’installation crée le service de MID Server et l’affecte à l’utilisateur fourni. Le programme d’installation définit les autorisations des fichiers sur le dossier d’installation du MID Server. Le programme d’installation permet de configurer les paramètres du proxy. En option, le programme d’installation peut démarrer automatiquement le MID Server.

    Procédure

    1. Sur l’instance, téléchargez le fichier de .msi d’installation du MID Server depuis Serveur MID > Télécharger.
    2. Connectez-vous à l’ordinateur hôte Windows sur lequel vous souhaitez installer le MID Server.
    3. Placez l'.msi du programme d’installation sur l’hôte du MID Server souhaité.
    4. Ouvrez le programme d’installation avec des privilèges de niveau administrateur.
    5. Utilisez le programme d’installation pour entrer les informations suivantes.

      Exemple d’installation d’un MID Server.

      Champ Description
      Type d'authentification
      Élémentaire
      Authentification basée sur le nom d’utilisateur et le mot de passe.
      Mutuelle
      Authentification basée sur certificat client. Consultez Magasin de clés unifié du MID Server pour plus d’informations sur l’authentification réciproque.
      Remarque :
      La sélection de l’authentification réciproque désactive les champs nom d’utilisateur et mot de passe du MID Server. Les champs désactivés ne sont pas écrits pour config.xml.
      URL de l'instance ServiceNow Saisissez l’URL complète de votre instance, par exemple :

      https://mycompanyinstace.service-now.com

      Nom d’utilisateur de ServiceNow MID Server Entrez le nom de l’utilisateur de MID Server que vous avez déjà créé. L’utilisateur du MID Server doit avoir le rôle mid_server.
      Mot de passe de ServiceNow MID Server Saisissez le mot de passe de l’utilisateur dans le nom d’utilisateur de ServiceNow MID Server.
      Révocation du certificat

      Cette case est cochée par défaut pour activer les politiques de révocation de certificat afin d’améliorer la sécurité. Pour en savoir plus sur la révocation des certificats, reportez-vous à Politiques de vérification des certificats de Serveur MID.

      Lors du test d’une connexion avec la révocation de certificat activée, le programme d’installation vérifie si le port OCSP 80 est ouvert et si la page Entrust est accessible.

      Si le test de connexion échoue en raison de la vérification de la révocation du certificat, l’erreur doit être corrigée et testée à nouveau ou la vérification de la révocation du certificat doit être désactivée. La vérification de la révocation du certificat n’est pas requise pour une installation réussie.

      Utiliser un proxy Cochez cette case si votre MID Server communique via un proxy pour se connecter à l’instance.
      Remarque :
      Votre serveur proxy doit utiliser l’authentification de base pour que le MID Server se connecte à l’instance.

      Le MID Server peut contourner les serveurs proxy dont l’adresse DNS/IP est répertoriée dans le paramètre de configuration mid.cloud.discovery.proxy.exclusion.list. Pour plus d’informations, reportez-vous à la section Propriété du MID Server .

      Hôte proxy Entrez le nom d’hôte ou l’adresse IP du serveur proxy. N’incluez pas le protocole dans le nom d’hôte. Par exemple, entrez proxyserver.domain.com, pas https://proxyserver.domain.com.
      Port proxy Entrez le port par lequel le serveur proxy communique. Si vous laissez ce champ vide, il devrait utiliser le numéro de port par défaut du serveur proxy.
      Nom d’utilisateur de proxy Entrez le nom d’utilisateur qui a les droits d’administrateur sur le serveur proxy.
      Mot de passe proxy Entrez le mot de passe correspondant au nom d’utilisateur.
    6. Cliquez sur Tester votre connexion pour valider les informations d’identification et d’instance.
      Si vous rencontrez des erreurs, vérifiez les informations que vous saisissez.
    7. Cliquez sur Suivant.
    8. Configurez le nom et les paramètres du compte de services (voir table Serveur MID ).

      Paramètres MID.

      Champ Description
      Nom de Serveur MID Entrez un nom de MID Server.
      Avertissement :
      Les noms de MID Server ne peuvent pas commencer par mid.server.
      Nom du compte de service

      Nom d’utilisateur du compte de service qui sera utilisé pour exécuter le service de Serveur MID. Pour plus d’informations sur la création de comptes de service, consultez Créer un compte de service Windows avec « Se connecter en tant que service » [KB0867669].

      Le champ Nom du compte de service est un menu déroulant modifiable. Sélectionnez une valeur dans la liste déroulante ou saisissez une nouvelle valeur dans le champ de texte. Seuls les comptes avec log on as service politique sont affichés dans la liste déroulante. Les comptes de services gérés par un groupe (gMSA) qui héritent de la log on as service politique de leurs groupes ne sont pas affichés dans la liste déroulante. Toutefois, vous pouvez installer le service MID Server à l’aide de ces comptes en saisissant manuellement le nom du compte de service dans la liste déroulante modifiable. Le nom peut suivre trois formats.

      1. Si le compte de service est local à l’ordinateur, vous pouvez donner uniquement le nom.

        Exemple : My_Local_Service_Account

      2. Si le compte de service est local à l’ordinateur, vous pouvez fournir « . » comme nom de domaine pour le compte.

        Exemple : .\My_Local_Service_Account

      3. N’importe quel compte peut suivre le format {domain}\{username}.

        Exemple : MON-ORDINATEUR-DOMAINE\My_Domain_Service_Account

      Ajoutez un nouveau compte de service local en sélectionnant le bouton + . Ce bouton ouvre la fenêtre Configurer un nouvel utilisateur local , qui comporte trois champs.
      • Nom du compte de service : Saisissez le nom du nouveau compte de services.
      • Mot de passe du compte de service : Saisissez le mot de passe du nouveau compte de service.
      • Entrez à nouveau le mot de passe : Confirmez le mot de passe du nouveau compte de service.

      Lorsqu’un utilisateur du compte de service géré de groupe (gMSA) est sélectionné, le champ de mot de passe est supprimé, car les mots de passe des utilisateurs gMSA sont gérés par Active Directory.

      Remarque :

      Les informations d’identification du compte de service fournies doivent répondre aux exigences suivantes en plus d’être un compte valide.

      • L’utilisateur ne peut pas être un compte de niveau système local ou administrateur (administrateur local, administrateur de domaine, entre autres).
      • Le compte de service fourni a le log on as service droit, qui est requis pour qu’un compte soit utilisé comme compte pour log on user un service.
      Mot de passe du compte de service Mot de passe du compte de service qui sera utilisé pour exécuter le service de Serveur MID.
      Définir le nom de service manuellement

      Cochez cette case si vous souhaitez définir manuellement le nom de service et le nom d’affichage de votre MID Server.

      Remarque : votre serveur proxy doit utiliser l’authentification de base pour que le MID Server se connecte à l’instance.

      Nom de la couche de service MID Modifiez ce champ si nécessaire. Il est renseigné automatiquement en préfixant snc_mid_ au nom du MID Server. Dans la plupart des cas, vous n’avez pas besoin de modifier cela.
      Nom d’affichage de la couche du MID Server Modifiez ce champ si nécessaire. Elle est renseignée automatiquement en préfixant la Server_ MID ServiceNow au nom du MID Server. Dans la plupart des cas, vous n’avez pas besoin de modifier cela.
    9. Cliquez sur Suivant et sélectionnez un dossier de destination pour l’installation.

      Les utilisateurs peuvent entrer manuellement un chemin de fichier existant et valide, ou utiliser le bouton « Modifier » pour ouvrir une page de navigation où ils peuvent choisir l’emplacement d’installation.

    10. Cliquez sur Suivant pour afficher le résumé.
      Démarrage du MID Server.

      Sélectionnez Démarrer le MID Server après l’installation si vous souhaitez démarrer le MID Server immédiatement après l’installation. Si vous souhaitez apporter des modifications de configuration supplémentaires, avant de démarrer le MID Server, décochez cette case. Si l’authentification réciproque a été sélectionnée, les champs nom d’utilisateur et mot de passe du MID Server sont supprimés.

      Remarque :
      Si le MID Server ne parvient pas à démarrer, cela peut être dû à un nom en double ou à plusieurs services qui pointent vers le même chemin d’accès exécutable. Cela peut se produire lorsque vous avez des MID Servers qui n’ont pas été installés via le programme d’installation. Consultez Le serveur MID ne parvient pas à démarrer pour en savoir plus.
    11. Cliquez sur la page Liste des Mid Servers.
      Le programme d’installation ouvre la liste des MID Servers à partir de votre instance.
    12. Sélectionnez le nom du MID Server dans la liste.
      Remarque :
      L’établissement d’une connexion avec votre instance par le MID Server peut prendre quelques secondes.
      Le système affiche l'enregistrement du MID Server.
    13. À partir de Liens connexes, cliquez sur Valider.
      La valeur Validé du MID Server passe à Oui.

    Que faire ensuite

    Pour mettre à niveau MID Server, consultez la section Mises à niveau de MID Server pour connaître les procédures et les exigences.

    Désinstaller un MID Server Windows avec le programme d’installation guidé

    Le programme d’installation natif guidé de Windows de MID Server prend également en charge la désinstallation guidée de MID Server.

    Avant de commencer

    Rôle requis : admin

    Il existe trois façons de désinstaller un MID Server après son installation avec le programme d’installation natif guidé de Windows.

    Procédure

    1. Sur l’hôte du MID Server, accédez au Panneau > Programmes > Programmes et fonctionnalités > Désinstaller un programme.
      1. Désinstallez le programme portant le nom du MID Server.
    2. Facultatif : Vous pouvez également accéder à Paramètres > Applications
      1. Désinstallez le programme portant le nom du MID Server.
    3. Facultatif : Le MID Server peut également être désinstallé à l’aide du script de désinstallation silencieuse.
      Cette propriété est utile pour désinstaller plusieurs MID Servers. Pour plus d'informations, voir Installation et désinstallation silencieuses de Windows MID Server

    Configurer les informations d’identification du service Windows MID Server

    Les informations d’identification du service Serveur MID sont requises pour gérer le service Serveur MID sur l’ordinateur hôte, y compris sa capacité à se mettre à niveau automatiquement.

    Avant de commencer

    Rôle requis : admin

    Pourquoi et quand exécuter cette tâche

    Si vous avez installé le MID Server à l’aide du programme d’installation natif, vous n’avez pas besoin d’effectuer cette procédure. Toutefois, pour modifier l’utilisateur du service après l’installation pour quelque raison que ce soit, utilisez cette procédure.

    Les informations d’identification du service Windows contrôlent le niveau de privilège sur l’appareil. L’utilisateur ne doit pas être un compte de niveau système local ou administrateur (administrateur local, administrateur de domaine, entre autres). Le compte de service fourni doit avoir le droit de connexion en tant que service , ce qui est une condition pour qu’un compte soit utilisé en tant qu’utilisateur de connexion pour un service.

    Remarque :

    Les informations d’identification du service Windows ne sont pas les mêmes que les informations d’identification de l’utilisateur du MID Server, qui permettent la communication entre le MID Server et l’instance. Vous devez configurer ces deux informations d’identification séparément. Consultez Créer l’utilisateur du MID Server et lui accorder le rôle les instructions relatives aux informations d’identification de l’utilisateur de Serveur MID.

    Procédure

    1. Ouvrez la console Services Windows.
    2. Double-cliquez sur le ServiceNow service <Nom du MID Server> pour chaque MID Server.
    3. Sélectionnez l’onglet Connexion .
    4. Choisissez un utilisateur non administrateur et fournissez le mot de passe de cet utilisateur.
    5. Dans l’onglet Général , définissez le type de démarrage.
      Ce champ est défini sur Automatique par défaut.
    6. Cliquez sur OK.
    7. Redémarrez le ServiceNow service <Nom du MID Server> et assurez-vous que ServiceNowle champ \<Nom du MID Server>\agent\logs\agent0.log ne comporte pas de messages d’erreur.
      Si le MID Server ne démarre pas, consultez l’article de la base de ServiceNow connaissances Consultez le journal de l’agent pour rechercher des erreurs dans le MID Server (article KB0535148).
    8. Dans l’instance à laquelle ce MID Server est connecté, accédez à Serveur MID > Serveurs.

      S’il Détection est installé, accédez également à Détection > Serveurs MID. Tous les MID Servers connectés à cette instance sont répertoriés.

    9. Assurez-vous que l’état du MID Server que vous venez d’installer est défini sur Actif.

    Installation et désinstallation silencieuses de Windows MID Server

    L’installation silencieuse du MID Server utilise des paramètres prédéfinis et ne nécessite aucune intervention de l’utilisateur une fois lancée. Vous pouvez utiliser l’installation silencieuse sur plusieurs machines à la fois pour configurer rapidement un réseau et vous assurer que tous les MID Servers disposent des mêmes paramètres d’installation.

    Installation silencieuse du MID Server

    Remarque :
    Toutes les commandes d’installation/désinstallation silencieuses doivent être exécutées avec des privilèges de niveau administrateur.
    Pour installer silencieusement le MID Server sur un système Windows, téléchargez le script joint à l’article de la base de connaissances Installation et désinstallation silencieuses du MID Server Windows. Placez le fichier sur l’ordinateur hôte du MID Server cible et exécutez la commande suivante à partir de l’invite de commandes. Vous pouvez également exécuter le script directement à partir de PowerShell.
    powershell -command « .\SilentInstall.ps1 -<parameter_name1> '<valeur du paramètre1>' -<parameter_name2> '<valeur du paramètre2>' etc... »
    Le script vérifie les paramètres obligatoires suivants :
    • MSI_FILE_NAME: le nom du fichier MSI utilisé pour l’installation.
    • INSTALL_LOCATION : emplacement d’installation du MID Server.
    • INSTANCE_URL: l’instance ServiceNow cible à laquelle le MID Server se connectera.
    • MID_USERNAME: le nom du compte d’instance.
    • MID_PASSWORD: le mot de passe du compte d’instance.
    • MID_NAME: nom du MID Server.
    • SERVICE_ACCOUNT_NAME: le nom du compte de services.
    • SERVICE_ACCOUNT_PASSWORD: le mot de passe du compte de service.
    Les paramètres suivants sont facultatifs :
    • LOG_NAME: active la journalisation et place les journaux dans le fichier nommé par ce paramètre.
    • START_MID: définit le MID Server pour qu’il démarre automatiquement une fois l’installation terminée.
    • USE_PROXY: permet l’utilisation d’un proxy. Si vous choisissez cette commande, les paramètres suivants deviennent obligatoires.
      • PROXY_HOST: le nom de l’hôte proxy.
      • PROXY_PORT: le numéro de port du proxy.
      • PROXY_USERNAME: le nom d’utilisateur du proxy. S’il n’y a pas de nom d’utilisateur, saisissez « ».
      • PROXY_PASSWORD: le mot de passe du proxy. S’il n’y a pas de mot de passe, saisissez ''.
    • MANUAL_SERVICE_NAME: nom du service. Si vous choisissez cette commande, les paramètres suivants deviennent obligatoires :
      • SERVICE_NAME: nom du service.
      • SERVICE_DISPLAY_NAME: le nom d’affichage du service.
    • MUTUAL_AUTH: active l’authentification réciproque. Si ce commutateur est activé et MID_PASSWORD n’est MID_USERNAME pas requis. Consultez Magasin de clés unifié du MID Server pour plus d'informations.
    Remarque :
    Les paramètres START_MID, USE_PROXY, MUTUAL_AUTH, et MANUAL_SERVICE_NAME sont des commutateurs. Ils utilisent le format -<switch_param_name> et ne sont pas suivis d’une valeur.

    Une fois le script exécuté, vérifiez que les fichiers, le service et l’entrée dans Programmes et fonctionnalités du MID Server sont installés. Si vous avez activé la journalisation, vérifiez les informations de journal dans le fichier spécifié par le LOG_NAME paramètre.

    Exemple de commande d’installation silencieuse du MID Server :

    powershell -command « .\SilentInstall.ps1 -MSI_FILE_NAME 'MID-Installer.msi' -INSTALL_LOCATION 'C :\Users\Administrator' -INSTANCE_URL 'https://my-instance-name.service-now.com' -MID_USERNAME 'mid_server' -MID_PASSWORD 'mid_password' -MID_NAME 'Silent_Install_MID' -SERVICE_ACCOUNT_NAME 'DOMAIN\My_Service_Account' -SERVICE_ACCOUNT_PASSWORD 'Service_Account_Password' -LOG_NAME 'Silent_Install_Log.txt' »

    Exemple de commande utilisant le START_MID commutateur :

    powershell -command « .\SilentInstall.ps1 -MSI_FILE_NAME 'MID-Installer-Wix.msi' -INSTALL_LOCATION 'C :\Users\Administrator' -INSTANCE_URL 'https://my-instance-name.service-now.com' -MID_USERNAME 'DOMAIN\My_Service_Account' -MID_PASSWORD 'mid_password' -MID_NAME 'Silent_Install_MID' -SERVICE_ACCOUNT_NAME 'DOMAIN\My_Service_Account' -SERVICE_ACCOUNT_PASSWORD 'Service_Account_Password' -LOG_NAME 'Silent_Install_Log.txt' -START_MID »

    Désinstallation silencieuse du MID Server

    Pour désinstaller silencieusement le MID Server sur un système Windows, téléchargez le script joint à l’article de la base de connaissances Installation et désinstallation silencieuses du MID Server Windows. Exécutez ensuite le script à l’aide de l’invite de commande. Il peut également être exécuté directement à partir de PowerShell.
    powershell -command « .\SilentUninstall.ps1 -MID_NAME '<valeur pour MID_NAME>' -LOG_NAME '<valeur pour LOG_NAME>' »

    Le script demande le paramètre MID_NAMEobligatoire, qui est le nom du MID Server que vous souhaitez désinstaller.

    Le paramètre LOG_NAME facultatif permet d’enregistrer la désinstallation et de placer les journaux dans le fichier nommé par ce paramètre.

    Après l’exécution du script, vérifiez que les fichiers, le service et l’entrée Programmes et fonctionnalités du MID Server sont désinstallés. Si vous avez activé la journalisation, vérifiez les informations de journal dans le fichier spécifié par le LOG_NAME paramètre.

    Exemple de commande de désinstallation silencieuse du MID Server :

    powershell -command « .\SilentUninstall.ps1 -MID_NAME 'silent_install_cmd' -LOG_NAME
          'uninstall.txt' »

    Installer manuellement un MID Server sur Windows

    Installez les MID Servers avec le package d’installation du fichier ZIP et vérifiez qu’il est actif.

    Avant de commencer

    Rôle requis : admin ou mid_server

    Pourquoi et quand exécuter cette tâche

    Cliquez sur ce lien pour visionner la vidéo

    Procédure

    1. Connectez-vous à l’ordinateur hôte Windows sur lequel vous souhaitez installer le MID Server.
    2. Créez un dossier pour le MID Server au niveau supérieur du lecteur, par exemple ServiceNow\MID Server1.
    3. Téléchargez le fichier d’archive MID dans le nouveau dossier.
    4. Cliquez avec le bouton droit de la souris sur l’archive et sélectionnez Extraire tout.
    5. Accédez au dossier service-now\<nom du serveur MID>\agent qui a été créé lors de l’extraction du fichier.
    6. Pour configurer manuellement le MID Server, modifiez le fichier config.xml à l’aide d’un éditeur de texte tel que WordPad :
      1. Recherchez l’élément d’élément <parameter name="url" value="https://YOUR_INSTANCE.service-now.com" /> et remplacez la valeur par l’URL de votre instance.
      2. Entrez les informations d’identification de l’utilisateur MID dans les paramètres mid.instance.username et mid.instance.password .
        Par défaut, le MID Server utilise une authentification de base pour les messages SOAP. La valeur du mot de passe est également une authentification chiffrée.
      3. Facultatif : Recherchez l’élément <parameter name="name" value="YOUR_MIDSERVER_NAME_GOES_HERE" /> et modifiez la valeur du nom du MID Server.
      4. Facultatif : Entrez les informations de connexion pour le serveur proxy.
        Supprimez les balises de commentaire appropriées des informations de configuration du proxy.
        Par exemple, vous pouvez configurer les paramètres suivants :
        • mid.proxy.use_proxy
        • mid.proxy.host
        • mid.proxy.port
        • mid.proxy.username
        • mid.proxy.password
    7. Exécutez start.bat pour démarrer le MID Server.
    8. Sur l’instance, dans les liens connexes, sélectionnez Valider.
      La valeur Validé du MID Server passe à Oui.

    Exécuter un MID Server Windows en tant que non-administrateur après une installation manuelle

    Vous pouvez configurer les MID Servers pour qu’ils s’exécutent à l’aide de comptes non administratifs. L’utilisation de comptes non-administrateurs associée à l’application des autorisations de fichiers peut améliorer la sécurité en limitant l’accès aux fichiers du MID Server.

    Avant de commencer

    Rôle requis : admin
    Remarque :
    Dans une version ultérieure, les comptes non-administrateurs seront obligatoires pour le MID Server et la prise en charge de l’utilisation d’un compte administratif sera déconseillée.
    Cette procédure s’applique uniquement aux utilisateurs qui installent le MID Server à l’aide du fichier ZIP. Le programme d’installation du MID Server de Windows nécessite déjà que le MID Server s’exécute en tant qu’utilisateur non administrateur. Dans le cadre du processus d’installation du programme d’installation de MID Server, les listes de contrôle d’accès pour le dossier MID Server sont limitées aux utilisateurs et groupes suivants.
    • Système
    • Administrateur
    • Compte de service configuré

    Lors de l’installation à l’aide du fichier ZIP, installez le MID Server sur un ordinateur Windows à l’aide d’un compte administrateur. Créez un compte d’utilisateur Windows sans privilèges d’administrateur.

    L’exécution d’un MID Server avec un compte non administrateur a des limites et modifie le comportement d’autres applications. Les comportements suivants peuvent être modifiés :

    • Le compte MID Server a besoin des informations d’identification appropriées pour exécuter un calendrier Discovery. Si les informations d’identification sont insuffisantes, le MID Server revient aux privilèges du compte d’utilisateur. Un compte d’utilisateur non-administrateur peut ne pas disposer des privilèges nécessaires pour accéder à la cible de détection.
    • Le mappage amélioré des dépendances d’applications (ADME) et la détection basée sur les fichiers (FBD) peuvent ne pas fonctionner par défaut. Pour corriger ce problème, les utilisateurs non administrateurs doivent être autorisés à lire/écrire dans le dossier Partage administrateur.
    • Les comptes non-administrateurs ne peuvent pas lancer de services de mise à niveau dans des versions antérieures à la version Orlando.

    Procédure

    1. Exécutez le service MID Server en tant que LocalSystem ou en tant qu’utilisateur disposant de droits d’administrateur.
    2. Créez un fichier intitulé GrantStartStopPerm.ps1 avec le code suivant.
      Function GrantStartStopPerm
      {
          Param( [string]$username, [string]$servicename )
          $user = New-Object System.Security.Principal.NTAccount($username) 
          $sid = $user.Translate([System.Security.Principal.SecurityIdentifier]).Value 
          Write-Output "Sid : $sid"
      
          $sd = sc.exe sdshow $servicename
          Write-Output "SD value   : $sd"
                         
          if( !($sd -like "*$sid*") ){
              $permsToAdd = [string]::Format(")(A;;RPWPCR;;;{0})S:(", $sid);
              if($sd -match [regex]::Escape(")S:(")){
                  $sd = $sd -replace [regex]::Escape(")S:("),"$permsToAdd"
                  $result = sc.exe sdset $servicename $sd
                  Write-Output "SD changed : $sd";
                  Write-Output "Result : $result";
              }
          }else{
              Write-Output "Sid is already part of SD"
          }
      }
    3. Démarrez la console PowerShell en tant qu’administrateur.
    4. Chargez le fichier à l’aide de la fonction dot-source à partir du fichier GrantStartStopPerm.ps1 .
      Par exemple : C :\Users\mid_account\Desktop> . .\GrantStartStopPerm.ps1
    5. Exécutez la fonction source PowerShell avec un compte non-administrateur et le nom du service comme entrée.
      Par exemple :
      GrantStartStopPerm mid_account snc_mid_test
      Output line expection in success :
      Result : [SC] SetServiceObjectSecurity SUCCESS
    6. Ajoutez le nom du compte non-administrateur au paramètre mid.windows_host.file_permissions.allow_list du MID Server dans le fichier config.xml de l’hôte du MID Server.
      Cette étape ajoute le compte non-administrateur à la liste d’autorisation. Voir Paramètres du MID Server pour plus d’informations et d’instructions pour mid.windows_host.file_permissions.allow_list ajouter un paramètre au fichier config.xml .
    7. Redémarrez le MID Server.
      Les nouvelles règles d’application des autorisations de fichiers entrent en vigueur au démarrage du MID Server.
    8. Basculez le MID Server vers le compte de service non administrateur.
    9. Redémarrez le MID Server.

    Que faire ensuite

    Pour plus d’informations sur la gestion de la liste d’autorisation et l’application des autorisations de fichiers, reportez-vous à la section Application de l’autorisation de fichier pour les MID Servers Windows.

    Désinstaller un MID Server Windows après une installation manuelle

    Le MID Server s’exécute en tant que service autonome. Vous pouvez supprimer un service de MID Server autonome pour prendre en charge des tâches telles que le redéploiement du MID Server sur un autre ordinateur hôte ou la modification du nom unique d’un MID Server lors du déploiement de plusieurs MID Servers.

    Avant de commencer

    Rôle requis : admin

    Cette procédure s’applique uniquement aux utilisateurs qui installent le MID Server à l’aide du fichier ZIP.

    Procédure

    1. Arrêtez le service MID Server en cours d’exécution en utilisant l’une des procédures suivantes :
      • Ligne de commande Windows : à partir du répertoire d’accueil (agent) du MID Server, exécutez stop.bat.
      • Console des services Windows : dans la console des services Windows, cliquez avec le bouton droit sur le nom du MID ServerServiceNow, puis sélectionnez Arrêter.
    2. À partir d’une invite de commandes, accédez au répertoire \agent\bin dans le répertoire d’installation du MID Server et double-cliquez sur le fichier UninstallMID-NT.bat .

    Que faire ensuite

    Validez le MID Server pour le préparer à l’utilisation.

    Configurer un MID Server sur Windows pour utiliser un environnement JRE existant

    Vous pouvez choisir d’utiliser un environnement JRE existant pour votre MID Server plutôt que l’OpenJDK fourni avec le programme d’installation du MID Server.

    Avant de commencer

    Assurez-vous que votre version JRE est prise en charge. Voir Configuration requise pour le MID Server pour plus de détails.

    Rôle requis : admin

    Pourquoi et quand exécuter cette tâche

    En choisissant d’utiliser votre propre environnement JRE, vous êtes responsable de sa mise à niveau si nécessaire. Pour une procédure détaillée et des mises en garde concernant la modification de l’ERE, voir KB0778272.

    Procédure

    1. Accédez à ce fichier dans le répertoire d’installation du MID Server :
      agent/conf/wrapper-override.conf
    2. Pour spécifier l’exécutable Java existant que vous souhaitez utiliser, ajoutez cette ligne au fichier :
      wrapper.java.command={your_java_executable}

      Pour plus d’informations, consultez la documentation sur les propriétés de la couche de service Java.

    3. Enregistrez le fichier.