Protéger les applications JavaSE
Vidéos de démarrage
Téléchargement
Visitez https://protector4j.com/download pour télécharger la dernière version
Installation
Windows et Linux
Il n'y a pas d'étapes d'installation particulières, il suffit de télécharger l'archive et de l'extraire.
macOS
Téléchargez le fichier dmg et faites glisser Protector4J dans Applications. Le contenu réel de cet outil se trouve dans /Applications/Protector4J.app/Contents/protector4j-mac
Chiffrer les applications JavaSE avec l'outil GUI
Accédez au dossier Protector4J, exécutez p4j-ui[.exe], vous verrez l'interface utilisateur suivante.
Pour les utilisateurs macOS, double-cliquez simplement sur Protector4J.app comme une application Mac classique.
Connexion
Si vous avez déjà acheté la licence, veuillez cliquer sur le bouton de connexion dans le coin supérieur droit et saisir vos informations utilisateur. Si vous n'avez pas de licence, vous pouvez quand même essayer cet outil.
Sélectionner le type d'application
Cliquez sur le bouton « JavaSE Application » sur la page de type d'application.
Sélectionner le fichier jar/war à chiffrer
Sélectionnez les fichiers jar/war que vous souhaitez chiffrer, vous pouvez sélectionner un ou plusieurs fichiers
Options
Chiffrer uniquement les fichiers jar
Chiffre uniquement les fichiers jar, sans déployer l'ensemble du JRE. Cette option est généralement utilisée en combinaison avec la fonctionnalité KeySeed pour mettre à jour des programmes existants.
Créer un fichier exécutable
Créez un fichier exécutable pour lancer l'application, veuillez ne pas ajouter l'extension .exe.
Console masquée
Cette option n'est effective que pour les programmes GUI sous Windows et sert à masquer la fenêtre de ligne de commande pendant l'exécution du programme.
Options JVM
Définissez les options JVM, telles que -Xmx et -Xms, séparées par des espaces ou des retours à la ligne.
Sortie
Sélection de la version Java
Choisissez la version Java, avec support de Java 8, Java 11, Java 17 et Java 21
Créer un nouveau dossier
Sélectionné par défaut, la tâche de chiffrement créera un fichier nommé p4j-[task-id] dans le dossier de sortie. Le résultat est stocké dans ce dossier.
Inclure JavaFX
S'il s'agit d'une application JavaFX, veuillez sélectionner cette option
Application SWT
S'il s'agit d'une application SWT, veuillez sélectionner cette option.
KeySeed
La tâche de chiffrement demande par défaut une clé aléatoire au serveur pour le chiffrement. Les fichiers générés par différentes tâches de chiffrement ne peuvent pas être utilisés ensemble. Si un KeySeed est spécifié, le même KeySeed générera la même clé de chiffrement. Cette option peut être utilisée avec l'option précédente « Chiffrer uniquement les fichiers jar » pour mettre à jour les applications existantes. Cette option n'est valide que pour les utilisateurs licenciés.
Exécuter la tâche de chiffrement
Veuillez patienter un moment. Une fois la tâche de chiffrement terminée, vous pouvez voir le résultat de l'application chiffrée dans le dossier de sortie.
Exécuter les applications chiffrées
Il existe trois façons d'exécuter l'application chiffrée
- Exécuter avec le fichier exe
Si la plateforme cible est Windows, vous pouvez exécuter l'application chiffrée avec le fichier exécutable généré lors de la tâche de chiffrement.
- Exécuter avec un script
Si la plateforme cible est Linux ou macOS, vous trouverez un fichier script avec le nom exe-name.sh, vous pouvez exécuter l'application avec ce script.
- Exécuter le programme avec la commande Java traditionnelle
Vous pouvez également exécuter manuellement le programme avec vlxjre/bin/java, le format de cette commande est le même que celui de la commande java normale.
On peut voir un dossier nommé vlxjre dans le répertoire de sortie, qui est notre JRE personnalisé, et les fichiers jar chiffrés sont stockés dans le dossier vlxlib.
vlxjre/bin/java -jar vlxlib/xxx.jar
vlxjre/bin/java -cp vlxlib/xxx.jar MainClass
vlxjre/bin/java -cp "vlxlib/*" MainClass
vlxjre/bin/java -Xms512M -Xmx1024m -cp "vlxlib/*" MainClass
Java 8 ne supporte actuellement pas l'exécution via vlxjre/bin/java -jar. Veuillez utiliser vlxjre/bin/java -cp xx MainClass
Remarques
Si la plateforme cible de ce programme est macOS ou Linux, mais qu'il est compilé sous Windows, veuillez exécuter add-executable-permission.sh sur la plateforme cible pour accorder les permissions d'exécution au programme avant le premier démarrage.
Modifier les paramètres JVM du fichier exe
Windows
Si vous devez modifier les paramètres JVM du fichier exe, éditez exe-name.json et modifiez les valeurs dans le tableau JArgs.
"JArgs": [
"-DParam1=value1",
"-DParam2=value2"
]
Linux et macOS
Ouvrez simplement le fichier script et ajoutez ou modifiez les paramètres JVM.
Chiffrer les applications JavaSE avec l'outil CLI
Fichier de configuration
L'outil CLI nécessite de spécifier un fichier de tâche en paramètre.
Accédez au dossier protector4j/task-templates, trouvez java-task.yml, copiez-le et modifiez-le.
# Available values: 8,11,17,21
javaVersion: 17
# The jar files that need to be encrypted
jarFiles: []
# Only encrypt the jar files, do not deploy the runtime
# This option is used while upgrading an existing application
onlyEncryptJarFiles: false
## [ Executable file information ]
# The executable file name
exeFileName: ''
# Hide command line window, only valid for Windows
hideConsole: false
# The main class of this Java Application
mainClass: ''
# The splash image
splash: ''
# JVM Options
jvmOptions: []
## [ Output Options ]
# The output folder
outputFolder: ''
# Create a new and unique folder for the application, the folder name is like p4j-<taskId>
createNewFolder: true
# Whether this is a JavaFX application
includeJavaFX: false
# Whether this a swt gui application
swtApplication: false
# Fixed key seed, only avaiable for licensed user
# Jars encrypted in different tasks can be used together with same key seed
keySeed: ''
# The target platforms
# available values: [win, linux, mac] or empty for current platform
platforms: []
Exécuter la tâche de chiffrement
Accédez au dossier Protector4J et exécutez la commande suivante.
Linux ou macOS
Pour les utilisateurs macOS, vous pouvez trouver l'outil CLI dans /Applictions/Protector4J.app/Contents/protector4j-mac.
./p4j -t java -f path-of-task-file
Windows
p4j -t java -f path-of-task-file
Vous pouvez exécuter p4j --help pour afficher les paramètres détaillés.
Exécuter avec les informations de compte
./p4j -t java -f path-of-task-file -u email -p password
Voir les résultats
Une fois la tâche de chiffrement terminée, veuillez accéder au dossier de sortie pour vérifier les résultats.
Exécuter les applications chiffrées
Il existe trois façons d'exécuter l'application chiffrée
- Exécuter avec le fichier exe
Si la plateforme cible est Windows, vous pouvez exécuter l'application chiffrée avec le fichier exécutable généré par la tâche de chiffrement.
- Exécuter avec un script
Si la plateforme cible est Linux ou macOS, vous trouverez un fichier script avec le nom exe-name.sh, vous pouvez exécuter l'application avec ce script.
- Exécuter le programme avec la commande Java traditionnelle
Vous pouvez également exécuter manuellement le programme avec vlxjre/bin/java, le format de cette commande est le même que celui de la commande java normale.
On peut voir un dossier nommé vlxjre dans le répertoire de sortie, qui est notre JRE personnalisé, et les fichiers jar chiffrés sont stockés dans le dossier vlxlib.
vlxjre/bin/java -jar vlxlib/xxx.jar
vlxjre/bin/java -cp vlxlib/xxx.jar MainClass
vlxjre/bin/java -cp "vlxlib/*" MainClass
vlxjre/bin/java -Xms512M -Xmx1024m -cp "vlxlib/*" MainClass
Java 8 ne supporte actuellement pas l'exécution via vlxjre/bin/java -jar. Veuillez utiliser vlxjre/bin/java -cp xx MainClass
Remarques
Si la plateforme cible de ce programme est macOS ou Linux, mais qu'il est compilé sous Windows, veuillez exécuter add-executable-permission.sh sur la plateforme cible pour accorder les permissions d'exécution au programme avant le premier démarrage.