Protection de logiciels en JAVA

La Foltière - 37270 AZAY SUR CHER
Tél. [phone] - Fax [phone] - e-mail : [e-mail]
Guide d’intégration
Protection de logiciels
en JAVA avec
DinkeyPRO/FD
Contact Commercial :
Tél. : [phone]
Email : [e-mail]
Contact Technique :
Tél. : [phone]
Email : [e-mail]
Version 1.00 du 30/01/2014

 2
Guide d’intégration DinkeyPRO/FD JAVA
1. Introduction ................................................................................................................................................ 3
2. Exemple de test projet DPSample.java ..................................................................................................... 3
2.1. Ouverture du projet – Test simple de la protection avec une clé de DEMO .................................... 3
2.2. Protection des modules JAVA avec DinkeyADD ............................................................................. 4
2.3. Compilation et obfuscation de votre code JAVA .............................................................................. 8
3. Adaptation du code exemple à votre projet ............................................................................................... 8
4. Etape pour l’intégration de la protection à votre application JAVA ............................................................ 9
5. Note importante ......................................................................................................................................... 9

 3
Guide d’intégration DinkeyPRO/FD JAVA
1. Introduction
Afin de vous aider dans les premiers pas de la pose de protection sur vos logiciels JAVA, vous trouverez dans
ce guide de prise en main rapide l’essentiel des commandes et fonctionnalités pour la bonne utilisation des clés
DinkeyPRO/FD.
Méthode utilisée : API avec appel de au module DPJava à partir de votre code JAVA. Les modules peuvent
porter des noms différents en fonction des différentes plate-forme utilisées. Elles seront par contre toujours
référentes à DPJava dans votre code
Pour Windows les modules se nomment DPJava.dll (32-bit) et DPJava64.dll (64-bit).
Pour Linux les modules se nomment libDPJava.so (32-bit) et libDPJava64.so (64-bit).
Pour MAC les modules se nomment libDPJava.jnilib (32-bit) et libDPJava64.jnlib (64-bit).
Si vous désirez renommer ces modules (seulement la parties communes à tous ‘DPJava’), vous devrez alors
modifier ce nom dans le source DinkeyPro.java. Dans le cas contraire vous pourrez utiliser directement les
class DinkeyPRO
Ces fichiers sont les fichiers à protéger en utilisant l’outil DinkeyADD développeur fournis dans le SDK
DinkeyPRO, en utilisant la méthode API. Ces fichiers devront être placés dans un des dossiers spécifiés dans
les propriétés systèmes de java.library.path. Nous vous invitons à vous référer à la documentation Java de
System.loadLibrary() et System.getProperties() pour plus d'information.
DinkeyPro.class et un fichier class Java fournissant les méthodes API Java et les champs à utiliser dans votre
application. La class DinkeyPro représente une partie du package uk.microcosm.dinkeydongle. Reportez-vous
à la documentation de votre environnement de développement pour pus d'informations sur l'intégration de ce
package à votre projet. La suite de ce chapitre détaille l'interface entre la class DinkeyPro et votre application.
Des exemples sont également disponibles dans le dossier "Samples\Java" du dossier d'installation DinkeyPRO.
Pré-requis
La class DinkeyPro ne contient que des méthodes statiques et des champs, elle ne peut être instanciée.
2. Exemple de test projet DPSample.java
2.1. Ouverture du projet – Test simple de la protection avec une clé de DEMO
 Contenu de l’exemple :
 DPSample.java contient le source principale faisant les appels à la protection DinkeyPRO
 DinkeyPro.class class JAVA prêt à l’emploi contenant la définition de la structure DRIS, et de
fonctions utiles à DinkeyPRO
 DinkeyPro.java code source ayant servi à générer DinkeyPro.class (n’est pas à utiliser directement ;
sert à une meilleur compréhension de notre solution et éventuellement dans le cas ou vous
souhaiteriez renommer les libraires).
 Afin de rendre l’utilisation plus facile de la class DinkeyPro nous l’avons placée dans le package
uk.microcosm.dinkeydongle
 Le code DPSample.java contient l’implémentation de 11 fonctions différentes de test de protection. Ceci à
titre de démonstration. Vous pourrez ensuite décider de laquelle ou desquelles utiliser dans votre projet
définitif en fonction de votre besoin. Le but est de vous permettre de comprendre rapidement les étapes

 4
d’intégration et de vous aider dans la création de vos fonctions de test de protection en présentant un large
choix .
N’oubliez pas de consulter le guide utilisateur DinkeyPRO et particulièrement la rubrique ‘Améliorez votre
protection’
Vous pourrez également personnaliser vos messages d’erreur à votre guise.
Remarque : Avec cette solution vous ne protégez pas directement votre EXE. La sécurité de votre logiciel est
assurée via nos APIs. Ce sont donc ces dernières qu’il convient de protéger avec notre outil DinkeyADD.
Le fait de linker votre EXE à nos APIs garanti sa sécurité. Nous appelons cette méthode protection API.
2.2. Protection des modules JAVA avec DinkeyADD
Ouvrez l'utilitaire DinkeyAdd.
Dans l'onglet "Général" :
 Précisez le type de clé que vous utilisez. En cas de doute, exécutez DinkeyLook afin d'afficher un
diagnostique de la clé.
 Indiquez le Code Produit (pour les clés d'évaluation, celui-ci est "DEMO").

 5
Dans l'onglet "Profils Licences" :
 Créez le Profil Licence "DEMO".
Dans l'onglet "Programmes" :
 Cliquez sur le bouton "Ajouter à la liste".
 Dans le champ "Chemin source", pointez sur le ou les fichiers DPJava.dll (choisissez parmi tous les
modules JAVA disponible ceux qui correspondent à vos besoins en termes de système d’exploitation
d’installation) répétez cette étape pour chacun d’entre eux.
 Dans le champ "Chemin cible", indiquez l'emplacement vers lequel vous souhaitez qu'une copie
protégée de DPJava.dll soit placée.
 Choisissez le Profil Licence "DEMO" précédemment créé.
 Vérifiez que la méthode "API" est bien sélectionnée.
 Laissez les valeurs par défaut pour les champs suivants.
 Validez en cliquant sur le bouton OK.