wrapper.ntservice.account

Compatibilité :3.0.0
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community
Plateformes :WindowsMac OSX (Non pris en charge)Linux (Non pris en charge)Alpine Linux (Non pris en charge)FreeBSD (Non pris en charge)Solaris (Non pris en charge)IBM z/Linux (Non pris en charge)

AVERTISSEMENT

NE MODIFIEZ PAS la valeur de cette propriété tant qu'une application utilisant le fichier de configuration est installée en tant que service Windows. Veuillez désinstaller le service existant AVANT de modifier cette propriété. Le service avec la nouvelle valeur pourra ensuite être réinstallé en toute sécurité.

Cette propriété n'est effective que sur les plates-formes Windows. Elle vous permet de spécifier le compte à utiliser lors de l'exécution en tant que service Windows. Le compte de service fournit essentiellement un contexte de sécurité pour votre service.

NOTE

Les modifications de cette propriété ne prendront effet qu'après la réinstallation du service Windows.


Comptes :

Les services Windows peuvent être configurés pour s'exécuter avec différents types de comptes :


NOTE

L'utilisation de la plupart de ces comptes nécessitera de définir des autorisations appropriées sur les fichiers auxquels le Wrapper ou l'application Java doivent accéder. Il est préférable de définir les autorisations de fichiers uniquement pour les comptes de service qui nécessitent un accès, et de limiter le type d'accès (par exemple lecture, écriture, exécution, etc.) au strict minimum. Le réglage fin des autorisations de fichiers demande un certain effort, mais constitue souvent une étape nécessaire si vous souhaitez exécuter votre application de manière sécurisée.

Sous Windows, la plupart des fichiers auront des autorisations complètes pour le compte « SYSTEM ». Cela signifie que tout service s'exécutant avec LocalSystem fonctionnera sans qu'il soit nécessaire de modifier les autorisations de fichiers. C'est pourquoi LocalSystem, en tant que compte par défaut pour les services Windows, facilite la configuration et l'exécution de vos services. Mais vous devez garder à l'esprit que, avec LocalSystem, votre processus Java s'exécutera alors avec les privilèges les plus élevés sous Windows. Bien que de nombreux services sous Windows soient considérés comme de confiance et s'exécutent avec LocalSystem, c'est à vous de décider si votre application doit ou non disposer de tels privilèges.


Mot de passe :

La plupart des comptes utilisateur ou des comptes utilisateur de domaine nécessiteront qu'un mot de passe soit défini. Consultez la propriété wrapper.ntservice.password pour les différentes options de spécification d'un mot de passe.


Erreur lors de l'installation du service :

Lors de la tentative d'installation du service, vous rencontrerez le message suivant si le nom du compte est invalide, n'existe pas, ou si le mot de passe du compte est incorrect. Une erreur courante consiste à définir le nom du compte sur leif plutôt que .\leif.

CreateService failed - The account name is invalid or does not exist,
or the password is invalid for the account name specified. (0x421)

De plus, seuls les comptes pour lesquels le droit « Ouvrir une session en tant que service » est défini peuvent être utilisés pour exécuter un service. Si ce droit n'est pas défini, le message d'erreur suivant s'affichera lorsque vous tenterez d'installer le service :

 Authentication attempt failed - Logon failure: the user has not been granted the requested logon type at this computer. (0x569)

NOTE

Depuis la version 3.5.8, le Wrapper ajoutera automatiquement l'autorisation « Ouvrir une session en tant que service » lors de l'installation du service.

À partir de la version 3.5.44, il est possible de contrôler si l'autorisation doit être ajoutée ou non en utilisant la propriété wrapper.ntservice.account.logon_as_service.


Définition du droit d'accès sur le système :

Pour définir le droit « Ouvrir une session en tant que service », allez dans le dossier « Outils d'administration » de votre panneau de configuration. Ouvrez l'applet « Stratégie de sécurité locale ». Développez « Stratégie locale » puis cliquez sur « Attribution des droits utilisateur ». Sur le côté droit, vous trouverez une stratégie « Ouvrir une session en tant que service ». Cliquez avec le bouton droit ou double-cliquez pour accéder à sa boîte de dialogue de propriétés, puis ajoutez l'utilisateur que vous souhaitez autoriser à exécuter le service.

Notez que l'applet « Stratégie de sécurité locale » ne semble pas être disponible sur les éditions Familiale de Windows.


Services interactifs :

La propriété wrapper.ntservice.interactive sera ignorée (résolue à FALSE) si le service est configuré pour s'exécuter avec un compte spécifique.

Référence : Compte