wrapper.check_integrity.mode
Compatibilité :3.7.0
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community (non prise en charge)
Plateformes :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

Au démarrage, le Wrapper calcule et valide le hachage de wrapper.jar et de sa bibliothèque native associée afin de s'assurer qu'ils n'ont pas été modifiés, corrompus ou mis à niveau de manière incorrecte.

La propriété wrapper.check_integrity.mode contrôle la manière dont le Wrapper vérifie l'intégrité de ces bibliothèques.

Deux modes sont possibles :

  • DEFAULT :

    Dans ce mode, le Wrapper autorise le chargement des bibliothèques pendant la phase d'amorçage afin de collecter des métadonnées telles que les informations de version et d'édition. Leur intégrité est vérifiée avant le lancement de l'application Java et, si une non-concordance est détectée, le démarrage est interrompu et une erreur est consignée.

    Ce mode offre une protection d'intégrité solide pour l'application Java tout en préservant des informations de diagnostic utiles. En pratique, la plupart des échecs de vérification d'intégrité sont dus à des mises à niveau de bibliothèques incomplètes ou incorrectes plutôt qu'à une modification malveillante, et les métadonnées collectées dans ce mode aident à identifier rapidement ces problèmes.

  • STRICT :

    Dans ce mode, la vérification d'intégrité est effectuée avant le chargement des bibliothèques. Si la vérification échoue, les bibliothèques ne sont pas chargées du tout et le Wrapper s'arrête immédiatement.

    Ce mode offre un niveau de protection plus élevé en garantissant qu'aucune bibliothèque non vérifiée n'est jamais chargée dans le processus. Cependant, il ne distingue pas les causes possibles d'un échec de vérification, telles qu'une non-concordance de version ou d'édition, une modification de fichier ou d'autres incohérences.

    Dans les environnements où des permissions appropriées du système de fichiers empêchent la modification non autorisée des bibliothèques et de leurs répertoires, le mode strict n'est généralement pas nécessaire du point de vue de la sécurité.

La valeur par défaut est « DEFAULT ».

Exemple : 
wrapper.check_integrity.mode=STRICT

NOTE

Ces vérifications d'intégrité constituent une couche de défense supplémentaire contre les altérations et les erreurs de déploiement. Cependant, elles ne remplacent pas les permissions de fichiers appropriées au niveau du système d'exploitation. Le fichier wrapper.jar, la bibliothèque native et tous les JAR utilisés par l'application Java doivent être placés dans un emplacement sécurisé et protégés par des contrôles d'accès appropriés afin d'empêcher toute modification non autorisée.