Vous êtes sur la page 1sur 309

HASP

Le Systme Professionnel
de Protection des Logiciels

Guide du Programmeur
Version 6.1
Septembre 1997

Aladdin France S.A.


55 avenue des Champs Pierreux
92012 Nanterre Cedex
Tl : +33 (0)1 41 37 70 30
Fax: +33 (0)1 41 37 70 39

Copyright (c) 1997 ALADDIN FRANCE S.A. - TOUS DROITS RSERVS


Ralisation : Octobre 1997 - DICTYMATEC S.C.

DROITS DE REPRODUCTION ET MARQUES DEPOSEES


Les droits de reproduction du systme HASP et de sa documentation sont rservs par
Aladdin Knowledge Systems Ltd. (C) depuis 1985 jusqu' ce jour.
Tous droits rservs.
HASP et MemoHASP sont des marques dposes de
Aladdin Knowledge Systems Ltd.
NetHASPTM, MacHASPTM, DataHASPTM, TimeHASPTM, SerialHASPTM
HASP36TM, MemoHASP36TM, NetHASP36TM,
TM
OpenHASP , HASPCardTM, et AladdinCARDTM sont des appellations commerciales de
Aladdin Knowledge Systems Ltd.
Tous les produits mentionns dans le prsent manuel sont des marques dposes de
leurs fabriquants respectifs.

LIMITATION DE GARANTIE, LIMITATION DE DOMMAGES ET DE


RESPONSABILITE
Aladdin Knowledge Systems Ltd. (Aladdin) garantit pendant une priode de douze (12)
mois compter de la date d'achat son logiciel et la cl HASP dans les conditions
stipules dans l'Accord et la Licence de Dveloppeur.
La seule obligation d'Aladdin en cas de rupture de garantie, et la limitation de
responsabilit pour dommages vis--vis de toute autre partie sont expliques dans
l'Accord et la Licence de Dveloppeur.
SAUF SPECIFICATIONS CI-DESSUS, IL N'EXISTE AUCUNE AUTRE GARANTIE,
EXPRESSE OU IMPLICITE, CONCERNANT LES PRODUITS D'ALADDIN, Y
COMPRIS, MAIS SANS S'Y LIMITER, LES GARANTIES IMPLICITES D'APTITUDE
LA COMMERCIALISATION ET D'APTITUDE UN USAGE PARTICULIER.

ALADDIN KNOWLEDGE SYSTEMS LTD.


ACCORD ET LICENCE DE DEVELOPPEUR
Tous les produits d'Aladdin Knowledge Systems Ltd. Ou de ses socits affilies
("Aladdin"), y compris les Logiciels d'valuation, quipements matriels, disquettes,
Cdrom, cls HASP et les Guides du Programmeur (ces lments tant collectivement
appels "le Produit") et toutes les commandes futures sont soumis aux termes ci-dessous.
Si vous n'acceptez pas ces termes, veuillez nous retourner le Logiciel d'valuation et le

Guide du Programmeur, en port pay, dans les sept jours suivant leur rception, et nous
vous rembourserons aprs dduction des frais de port et de prise en charge.

1. Licence. Aladdin, concepteur et fabricant du Produit, vous concde une licence


personnelle, incessible et non-exclusive, de sous-licence et de revente du Produit figurant
dans le prsent emballage, aux termes stipuls ci-aprs. Le Logiciel, ainsi que ses
rvisions futures, restera la proprit d'Aladdin, sous rserve des termes du prsent
Accord.
Sauf dispositions de la Section 2 ci-dessous, il vous est interdit de cder tout ou une partie
du Produit ou de la mettre la disposition de qui que ce soit, ou de modifier,
dsassembler, dcompiler, rtro-concevoir (reverse engineer), rviser ou amliorer le
Logiciel, la cl HASP ou toute autre partie du Produit, ni tenter de dcouvrir le code
source du Logiciel.
2. Modification du Logiciel ; Vente des cls HASP. Vous avez le droit de combiner
et lier le Logiciel vos programmes informatiques dans le seul but de protger ces
programmes informatiques, tels qu'ils sont dcrits dans le Guide du Programmeur. Vous
avez ensuite le droit de sous-licencier le Logiciel ainsi combin des distributeurs et
utilisateurs finaux de votre programme informatique, aux termes du prsent Accord. Vous
avez le droit d'effectuer une copie de sauvegarde du Logiciel.
Vous avez le droit de revendre des utilisateurs finaux, sous rserve des limitations
exprimes dans la Section 3 (c) ci-dessous, toutes les cls HASP qui vous sont vendues
par Aladdin.

3. Responsabilit Limite. Aladdin garantit pendant une priode de douze (12) mois
aprs la date de livraison (la "Priode de Garantie") les conditions suivantes :
(a) le Logiciel s'excute pour l'essentiel comme indiquer dans le Guide du Programmeur,
condition qu'il soit utilis sur l'ordinateur et avec le systme d'exploitation pour lesquels il
a t conu;
(b) le support sur lequel le Logiciel est distribu est pour l'essentiel exempt de dfaut
significatif de pices et main d'oeuvre;
(c) la cl HASP est pour l'essentiel exempte de dfaut significatif de pices et main
d'oeuvre.

4. Limitation des Recours. En cas de rupture de la prsente garantie, la seule


obligation d'Aladdin se limitera au remplacement et la rparation, au choix d'Aladdin,
de tout Produit ou composant du Produit, et ce gratuitement.

Les rclamations de garantie doivent tre effectues par crit pendant la Priode de
Garantie et dans les sept (7) jours suivant l'observation du dfaut, et tre accompagnes
par des preuves qu'Aladdin jugera satisfaisantes. Tous les Produits seront retourns au
distributeur HASP auquel ils ont t achets (s'ils n'ont pas t achets directement
Aladdin) et devront tre renvoys avec assurance, en port pay.
SAUF SPECIFICATIONS CI-DESSUS, IL N'EXISTE AUCUNE AUTRE GARANTIE,
EXPRESSE OU IMPLICITE, CONCERNANT LES PRODUITS D'ALADDIN, Y
COMPRIS, MAIS SANS S'Y LIMITER, LES GARANTIES IMPLICITES D'APTITUDE
LA COMMERCIALISATION ET D'APTITUDE UN USAGE PARTICULIER.

5. Limitation de la Responsabilit d'Aladdin. La responsabilit globale d'Aladdin


pour les dommages subis par vous ou toute autre partie pour quelque cause que ce soit, de
manire contractuelle ou dlictueuse, y compris les cas de ngligence, ne saurait excder
le prix que vous avez pay pour l'unit du Produit ayant provoqu les dommages qui
constituent, ou sont directement lis la cause de rclamation. Aladdin ne saurait en
aucun cas tre rput responsable de dommages provoqus par la non-excution de vos
obligations, ni d'une perte de donnes, profits, gains, ou tout autre dommage, incident ou
consquent, mme si Aladdin a t prvenu de la possibilit des dommages, ou pour toute
rclamation que vous pourriez baser sur toute rclamation d'une tierce partie.

6. Rsiliation. Le non-respect des termes du prsent Accord entrane la rsiliation de


votre Licence et du prsent Accord. Les Clauses 3, 4 et 5 resteront valides aprs
rsiliation du prsent Accord.

Sommaire
Guide HASP - Synopsis ___________________________________xiii
Chapitre 1 - Introduction __________________________________ 1-1
Le Systme HASP.............................................................................................................. 1-1
Avantages du Systme HASP ........................................................................................... 1-2
Les Points Forts de la Scurit HASP.............................................................................. 1-5
Avantages du Systme HASP pour vos Clients ............................................................... 1-6
La Gamme HASP............................................................................................................... 1-7
Conventions Typographiques.......................................................................................... 1-11
Protection de Logiciel Rfrence Rapide .................................................................... 1-12

Chapitre 2 - Concepts HASP de Base _______________________ 2-1


Termes HASP..................................................................................................................... 2-1
Mmoire HASP .................................................................................................................. 2-4
Mthodes de Protection HASP.......................................................................................... 2-5
Questions Frquemment Poses (FAQ) ........................................................................... 2-6

Chapitre 3 - Concepts NetHASP de Base_____________________ 3-1


Qu'est-ce qu'une cl NetHASP? ........................................................................................ 3-1
Termes NetHASP .............................................................................................................. 3-2
Le Systme NetHASP........................................................................................................ 3-4
Questions Frquemment Poses (FAQ) ........................................................................... 3-7

Chapitre 4 - Le Logiciel HASP _____________________________ 4-1


Les Utilitaires HASP......................................................................................................... 4-1
L'API HASP........................................................................................................................ 4-2
Les Gestionnaires de Priphriques HASP...................................................................... 4-2

vi

Sommaire

Installation du Logiciel HASP .......................................................................................... 4-3

Chapitre 5 - Protection par Enveloppe _______________________ 5-1


Protection dune Application Win32 ................................................................................. 5-3
Programme dEnveloppe Win32 ....................................................................................... 5-5
Protection dune Application DOS ou Win16 ................................................................. 5-21
Programme dEnveloppe DOS et Win16 ........................................................................ 5-22
Protection en Ligne de Commande ................................................................................. 5-36
FAS The Full Authorization System ........................................................................... 5-43
Protection de Logiciel sur des PC Isols ou en Rseau ................................................. 5-45
Considrations NetHASP................................................................................................ 5-46
Questions Frquemment Poses (FAQ) ......................................................................... 5-47

Chapitre 6 - Protection avec lAPI ___________________________ 6-1


Utilisation de l'API ............................................................................................................ 6-2
Services HASP de Base ..................................................................................................... 6-4
Services MemoHASP ......................................................................................................... 6-5
Services TimeHASP........................................................................................................... 6-6
Services NetHASP ............................................................................................................. 6-7
Protection de Logiciels pour Stations en Rseau ou Isols ............................................. 6-9
Questions Frquemment Poses (FAQ) ......................................................................... 6-10

Chapitre 7 - Services de Base de lAPI HASP _________________ 7-1


Service 1: IsHasp ............................................................................................................... 7-2
Service 2: HaspCode .......................................................................................................... 7-3
Service 5: HaspStatus........................................................................................................ 7-4

Chapitre 8 - Services API MemoHASP _______________________ 8-1


Service 3: ReadWord.......................................................................................................... 8-2
Service 4: WriteWord......................................................................................................... 8-3
Service 6: HaspID .............................................................................................................. 8-4
Service 50: ReadBlock ....................................................................................................... 8-5
Service 51: WriteBlock ...................................................................................................... 8-6

vii

Chapitre 9 - Services TimeHASP ___________________________ 9-1


Service 70: SetTime ........................................................................................................... 9-3
Service 71: GetTime........................................................................................................... 9-4
Service 72: SetDate............................................................................................................ 9-5
Service 73: GetDate ........................................................................................................... 9-6
Service 74: WriteByte ........................................................................................................ 9-7
Service 75: ReadByte ......................................................................................................... 9-8
Service 76: WriteBlock ...................................................................................................... 9-9
Service 77: ReadBlock ..................................................................................................... 9-11
Service 78: GetHaspID .................................................................................................... 9-13

Chapitre 10 - Services de lAPI NetHASP ____________________ 10-1


Service 40: LastStatus..................................................................................................... 10-4
Service 41: HaspCode ...................................................................................................... 10-5
Service 42: LOGIN........................................................................................................... 10-7
Service 43: LOGOUT ....................................................................................................... 10-9
Service 44: ReadWord.................................................................................................... 10-11
Service 45: WriteWord................................................................................................... 10-12
Service 46: HaspID ........................................................................................................ 10-13
Service 48: IdleTime ...................................................................................................... 10-14
Service 52: ReadBlock ................................................................................................... 10-16
Service 53: WriteBlock .................................................................................................. 10-17
Service 85: SetConfigFilename ..................................................................................... 10-19
Service 96: SetServerByName ...................................................................................... 10-20

Chapitre 11 - Codes dEtat de lAPI_________________________ 11-1


Codes LastStatus NetHASP............................................................................................ 11-4

Chapitre 12 - Scurit par Motifs Cods _____________________ 12-1


Protection Conventionnelle et PCS ................................................................................ 12-2
Structure dun Motif ........................................................................................................ 12-3
Mise en oeuvre du systme PCS ..................................................................................... 12-4
Questions Frquemment Poses (FAQ) ......................................................................... 12-6

viii

Sommaire

Chapitre 13 - Le Programme HaspEdit ______________________ 13-1


Lancement de HaspEdit .................................................................................................. 13-1
Saisie des Mots de Passe ................................................................................................. 13-3
Vrification des Codes de Retour .................................................................................... 13-3
Vrification du Numro d'Identification ........................................................................ 13-4
Modifier la Mmoire d'une Cl MemoHASP ou TimeHASP-4 ...................................... 13-5
Modifier la Mmoire TimeHASP .................................................................................... 13-7
Modifier la Mmoire NetHASP....................................................................................... 13-8
Rglage de l'Horloge TimeHASP .................................................................................... 13-9
Personnalisation de NetHASP...................................................................................... 13-10
Le Full Authorization System....................................................................................... 13-13

Chapitre 14 - Le Gestionnaire de Priphrique HASP __________ 14-1


Gestionnaire de Priphrique HASP pour Windows ..................................................... 14-3
Gestionnaire de Priphrique HASP pour Win32s ....................................................... 14-3
Gestionnaire de Priphrique HASP pour Windows 95 ................................................ 14-4
Gestionnaire de Priphrique HASP pour Windows NT .............................................. 14-4
Le Programme Setup....................................................................................................... 14-5
Le programme Hinstall ................................................................................................... 14-6
Installation Personnalise du Gestionnaire de Priphrique HASP............................ 14-7
Questions Frquemment Poses (FAQ) ......................................................................... 14-8

Chapitre 15 - Comment Assurer une Protection Maximale des Logiciels15-1


Utilisez des Appels Multiples.......................................................................................... 15-1
Utilisez Diffrents Codes Graine .................................................................................... 15-2
Utilisez des Expressions Mathmatiques ...................................................................... 15-2
Sommes de Contrle ........................................................................................................ 15-2
Cachez les Mots de Passe et les Codes de Retour .......................................................... 15-4
Utilisez les Rponses des Appels .................................................................................... 15-4
Sparez les Etapes de Vrification ................................................................................. 15-5
Utilisez des Donnes Dpendantes de HASP ................................................................ 15-5
Utilisez le systme PCS................................................................................................... 15-6

ix

Chapitre 16 - Installation de NetHASP sur un Rseau __________ 16-1


Rseaux et Protocoles Supports par NetHASP ............................................................ 16-1
Le Gestionnaire de Licence NetHASP............................................................................ 16-3
Recherche Automatique de NetHASP .......................................................................... 16-10
Recherche NetHASP Personnalise ............................................................................. 16-13
Installation NetHASP - Rfrence Rapide ................................................................... 16-22

Chapitre 17 - Outils NetHASP _____________________________ 17-1


Les Outils de Test NetHASP........................................................................................... 17-1
Moniteur NetHASP ......................................................................................................... 17-2

Annexe A - API et Langage Assembleur______________________ A-1


Annexe B - Le Gestionnaire Rsident HASP __________________ B-1
Annexe C - Fichier de Configuration NetHASP_________________ C-1
[NH_COMMON] ................................................................................................................C-4
[NH_IPX]............................................................................................................................C-5
[NH_NETBIOS] .................................................................................................................C-7
[NH_TCPIP] .......................................................................................................................C-8

Annexe D - Paramtres du Gestionnaire de Licence NetHASP ____ D-1


Annexe E - Adaptation de NetHASP _________________________ E-1
Dfinition des Stations Autorises sous IPX....................................................................E-1
Dfinition des Stations Autorises sous TCP/IP..............................................................E-2
Dfinition des Stations Autorises sous NetBIOS...........................................................E-4
Adaptation de la dure du Timeout ..................................................................................E-5
Dfinition du Nombre d'Applications Protges Gres .................................................E-6
Rseaux Locaux et Interconnects ...................................................................................E-7

Sommaire

Annexe F - HASP sous OS/2 ______________________________ F-1


Installation de HASP sous OS/2 ....................................................................................... F-1
Reconfiguration du Port Parallle pour Partager le Port ............................................... F-2

Annexe G - HASP36 et NetHASP36 _________________________G-1


La Gamme HASP36...........................................................................................................G-2
Installation de HASP36.....................................................................................................G-2
Protection par Enveloppe ..................................................................................................G-3
HaspEdit ............................................................................................................................G-4
Protection par API .............................................................................................................G-4
Gestionnaire de Priphrique HASP................................................................................G-6
Gestionnaires de Licence NetHASP .................................................................................G-7

Annexe H - Mots de Passe de Dmonstration _________________ H-1


Annexe I - Support Technique ______________________________I-1
Problmes et Solutions ....................................................................................................... I-3

Annexe J - Spcifications Techniques _______________________ J-1


Index ___________________________________________________ i

Liste des Tableaux


Tableau 1.1: Les solutions HASP...................................................................................... 1-3
Tableau 1.2: Conventions typographiques utilises dans ce manuel ........................... 1-11
Tableau 1.3: Etapes de protection d'un logiciel ............................................................. 1-12
Tableau 2.1: Mmoire HASP en lecture / criture ........................................................... 2-4
Tableau 5.1: Programmes de Protection par Enveloppe HASP ...................................... 5-2
Tableau 5.3: Nombre de licences NetHASP possibles .................................................. 5-12
Tableau 5.4: Valeurs possible pour le Numro de Programme..................................... 5-15
Tableau 5.5: Valeurs Possibles du Numro de Programme .......................................... 5-25
Tableau 5.6: Messages d'Erreur originaux..................................................................... 5-34
Tableau 6.1: Valeurs de LptNum et ports parallles recherchs ................................... 6-3
Tableau 6.2: Services HASP de base Description ......................................................... 6-4
Tableau 6.3: Services MemoHASP Description ............................................................ 6-5
Tableau 6.4: Services TimeHASP Description.............................................................. 6-6
Tableau 6.5: Services NetHASP Description ................................................................ 6-7
Tableau 7.1: Services HASP de base et les paramtres de la routine hasp( )............... 7-2
Tableau 8.1: Services MemoHASP et les paramtres de la routine hasp( ).................. 8-2
Tableau 9.1: Services TimeHASP et les paramtres de la routine hasp( ) .................... 9-2
Tableau 10.1: Services NetHASP et les paramtres de la routine hasp( ) ................... 10-2
Tableau 10.2: Dure du laps de temps par dfaut pour les Gestionnaire de Licence
NetHASP ........................................................................................................................ 10-15
Tableau 11.1: Codes d'Etat HASP-3, MemoHASP, TimeHASP-4 et NetHASP....... 11-1
Tableau 11.2: codes d'Etat TimeHASP et TimeHASP-4............................................. 11-1
Tableau 11.3: Codes d'Etat Applications utilisant le Gestionnaire de Priphrique
HASP ................................................................................................................................ 11-3
Tableau 11.4: codes d'Etat pour le service LastStatus NetHASP................................. 11-4
Tableau 12.1: Structure d'un motif PCS ........................................................................ 12-3
Tableau 13.1: Programme HaspEdit .............................................................................. 13-2
Tableau 16.1: Protocoles supports par les Gestionnaires de Licence NetHASP ........ 16-4
Tableau 16.2: Ordre de recherche du fichier nethasp.ini ............................................ 16-13
Tableau 16.3: Ordre de recherche du fichier newhaddr.dat ....................................... 16-18
Tableau 16.4: Paramtrage de NetHASP sous IPX ..................................................... 16-23
Tableau 16.5: Paramtrage de NetHASP sous TCP/IP ............................................... 16-24
Tableau 16.6: Paramtrage de NetHASP sous NetBIOS ............................................ 16-25
Tableau A.1: Appels la routine haspreg( ) avec les services HASP de base................A-1
Tableau A.2: Appels la routine haspreg() avec les services MemoHASP ....................A-2

xi

xii

Liste des Tableaux

Table A.3: Appels la routine haspreg() avec les services TimeHASP ..........................A-3
Tableau A.4: Appels la routine haspreg() avec les services NetHASP ........................A-5
Tableau C.1: Ordre de recherche du fichier nethasp.ini .................................................C-2
Tableau D.1: Gestionnaires de Licence NetHASP et leurs paramtres .........................D-1
Tableau D.2: Explication des paramtres du Gestionnaire de Licence NetHASP ........D-3
Tableau E.1: Ordre de recherche du fichier nhsrv.ini.....................................................E-3
Tableau G.1 Cls de la gamme HASP36 ..........................................................................G-2
Tableau G.3: Programmes HaspEdit pour HASP36........................................................G-4
Tableau G.4: Cls HASP36 et les services API correspondants .....................................G-4
Tableau G.5: Dfinition du LptNum avec HASP36 .........................................................G-5
Tableau G.7: Gestionnaires de Licence NetHASP pour NetHASP36.............................G-7
Tableau H.1: Mots de Passe des cls de dmonstration HASP mmoire ................... H-1
Tableau H.2: Mots de Passe des cls de dmonstration HASP-3................................... H-2

Guide HASP - Synopsis


Cl HASP

Information Gnrale

Protection de votre Application

HASP-3

Chapitre 2:
Chapitre 4:
Chapitre 14:

Concepts HASP de Base


Logiciel HASP
Le Gestionnaire de Priphrique
HASP

Chapitre 5:
Chapitre 6:
Chapitre 7:

Protection par Enveloppe


Protection par API
Services de l'API HASP

MemoHASP

Chapitre 2:
Chapitre 4:
Chapitre 14:

Concepts HASP de Base


Logiciel HASP
Le Gestionnaire de Priphrique
HASP

Chapitre 5:
Chapitre 6:
Chapitre 7:
Chapitre 8:

Protection par Enveloppe


Protection par API
Services de l'API HASP
Services de l'API MemoHASP

TimeHASP

Chapitre 2:
Chapitre 4:
Chapitre 14:

Concepts HASP de Base


Logiciel HASP
Le Gestionnaire de Priphrique
HASP

Chapitre 5:
Chapitre 6:
Chapitre 7:
Chapitre 9:

Protection par Enveloppe


Protection par API
Services de l'API HASP
Services de l'API TimeHASP

TimeHASP-4

Chapitre 2:
Chapitre 4:
Chapitre 14:

Concepts HASP de Base


Logiciel HASP
Le Gestionnaire de Priphrique
HASP

Chapitre 5:
Chapitre 6:
Chapitre 7:
Chapitre 8:
Chapitre 9:

Protection par Enveloppe


Protection par API
Services de l'API HASP
Services de l'API MemoHASP
Services de l'API TimeHASP

NetHASP

Chapitre 2:
Chapitre 3:
Chapitre 4:
Chapitre 14:

Concepts HASP de Base


Concepts NetHASP de Base
Logiciel HASP
Le Gestionnaire de Priphrique
HASP

Chapitre 5:
Chapitre 6:
Chapitre 10:

Protection par Enveloppe


Protection par API
Services de l'API NetHASP

HASP36

Chapitre 2:
Chapitre 4:
Chapitre 14:

Concepts HASP de Base


Logiciel HASP
Le Gestionnaire de Priphrique
HASP
HASP36 et NetHASP36

Chapitre 5:
Chapitre 6:
Chapitre 7:

Protection par Enveloppe


Protection par API
Services de l'API HASP

Concepts HASP de Base


Concepts NetHASP de Base
Logiciel HASP
Le Gestionnaire de Priphrique
HASP
HASP36 and NetHASP36

Chapitre 5:
Chapitre 6:
Chapitre 10:

Protection par Enveloppe


Protection par API
Services de l'API NetHASP

Annexe G:
NetHASP36

Chapitre 2:
Chapitre 3:
Chapitre 4:
Chapitre 14:
Annexe G:

Pour protger votre excutable immdiatement, reportez-vous au Chapitre 5


et utilisez l'Enveloppe HASP.
xiii

Chapitre 1 - Introduction
Le Systme HASP
HASP est un systme matriel la pointe du progrs qui protge les
logiciels contre le piratage en interdisant l'accs et l'excution non
autoriss du programme protg.
Chaque cl HASP est base sur un composant ASIC (Application
Specific Integrated Circuit - Circuit Intgr Spcifique) contenant un
algorithme lectronique interne unique. Durant son excution, le
programme protg envoie des requtes la cl HASP connecte
l'ordinateur. Si le rponse de la cl HASP est correcte, et si
l'algorithme HASP est identifi, l'application peut s'excuter. Dans le
cas contraire, vous pouvez choisir de ne pas lancer l'application, de
basculer en mode de dmonstration, ou encore de limiter certaines
fonctions.
L'utilisation de HASP est facile, bien que le niveau de scurit obtenu
soit trs lev.
Pour protger votre application , vous n'avez qu' :
Insrer des appels au systme HASP dans votre code source (en
utilisant l'API fournie), et compiler votre application.
Facultativement, utiliser l'Enveloppe HASP pour crypter votre
application et la protger par une enveloppe de protection. Cela
vite les accs non autoriss ou le piratage de votre application.
Le principal intrt de l'Enveloppe HASP est sa mise en place
extrmement rapide pour protger votre application.
Chaque mthode offre un trs haut niveau de protection. L'utilisation
conjointe des deux mthodes vous assure la plus haute protection
possible pour votre application.

1-1

1-2

Introduction

Une fois protge, seuls les utilisateurs lgitimes seront capables de


lancer votre application avec la cl HASP associe.

Figure 1.1: Mcanisme simplifi de la protection HASP

Avantages du Systme HASP


Souplesse d'Utilisation pour le Dveloppeur
La Plus Large Gamme de Solutions et de Fonctionnalits
Le systme HASP offre la plus large gamme de produits, solutions
et fonctionnalits du march de la protection de logiciels, avec des
cls avec ou sans mmoire, pour rseau, horloge, pour de
multiples plates-formes matrielles.

Avantages du Systme HASP

1-3

Facilit d'Utilisation Maximale


Un apprentissage facile et une interface de programmation (API)
commune pour tous les produits assurent une mise en place aise
et rapide du logiciel HASP dans votre application.
Support de Centaines de Compilateurs
Peu importe le compilateur ou le langage de programmation que
vous utilisez, le systme HASP contient srement l'interface
requise. De plus, le logiciel HASP et ses mises jour sont
disponibles gratuitement.
Le Gamme HASP supporte une Large Palette de Logiciels
et Matriels
La gamme HASP vous offre des solutions pour les ordinateurs
suivants :
Tableau 1.1: Les solutions HASP
Ordinateur

Produit HASP

IBM PC et compatibles

HASP

NEC Japonais et compatibles

HASP36

Apple Macintosh

MacHASP

UNIX et stations de travail Open System

OpenHASP

Le support des logiciels pour les ordinateurs IBM PC et


compatibles est fourni pour tous les principaux langages et
compilateurs du march, vous permettant ainsi de livrer votre
application protge par HASP sur toutes les principales platesformes : Windows 3.x, Windows 95, Windows NT, DOS, DOS
extenders, OS/2, UNIX, rseaux (LAN et WAN), AutoCAD, et bien
plus encore.

1-4

Introduction

Pas de Contrainte pour vos Clients


Faible Encombrement Seulement 39mm (1.5)
HASP est la plus petite cl du monde, vous assurant un maximum
de fonctionnalits avec un minimum de dsagrment une fois
connecte sur l'ordinateur de votre client.
Transparence pour lOrdinateur
Conue pour un maximum de compatibilit, les cls HASP sont
transparentes pour toutes les oprations entre l'ordinateur et les
priphriques connects. Toutes les cls HASP peuvent tre
enchanes d'autres cls HASP ou concurrentes.
Aucun Ralentissement des Applications
La communication entre l'application et la cl HASP est
transparente pour l'utilisateur, et n'affecte pas la vitesse de
fonctionnement de votre application.
Possibilit d'Effectuer des Copies de Sauvegarde
Vos clients peuvent crer des copies de sauvegarde de votre
application. Ils ne sont pas limits l'excution de votre
application sur un ordinateur donn.

Une Fiabilit Garantie


Une production Automatise SMT et Contrle Qualit
100%
Le processus de fabrication SMT (Surface Mount Technology Technologie de Montage en Surface) automatis d'Aladdin, avec un
contrle qualit 100% vous assure de recevoir le produit le plus
fiable possible (moins de 0.1% de retour).
Consommation Electrique Minimale
Conue pour une consommation minimale de courant et d'nergie,
les cls HASP fonctionnent mme dans les conditions les plus
adverses.

Les Points Forts de la Scurit HASP

1-5

Support et Service l'Echelle Mondiale


Plusieurs Sites de Productions
Des sites de production rpartis sur trois continents vous assurent
de manire ponctuelle des livraisons rapides, avec support
technique si ncessaire.
Service et Support Local dans plus de 50 Pays
Fort de ses six filiales et de son rseau de 50 distributeurs rpartis
dans le monde entier, les services commerciaux et techniques
locaux sont disponibles gratuitement sur demande tout moment.

Les Points Forts de la Scurit HASP


Le systme HASP offre l'tat de l'art en matire de scurit , dont :
Composant ASIC Totalement Personnalis
Toutes les cls HASP sont base sur un composant ASIC
(Application Specific Integrated Circuit - Circuit Intgr
Spcifique) propritaire totalement personnalis. Le composant
ASIC HASP compos de 2500 portes, 1.5 micron, conu par les
ingnieurs d'Aladdin empche tout "reverse engineering" et fait
que les cls HASP sont virtuellement impossible pirater.
Algorithmes Complexes de Protection et dAnti-Debogage
Le logiciel HASP utilise les plus puissants algorithmes de
protection propritaire, ainsi que la technologie la plus volue
d'anti-dbogage du march. Des fonctionnalits spciales antipiratage inclues dans le logiciel HASP crent des obstacles
quasiment infranchissables pour les pirates potentiels.
Communication Code
Le systme HASP comprend un codage de toutes les
communications entre l'application et la cl HASP, protgeant ce
lien vital entre l'application et sa cl HASP. Cela vite tout risque

1-6

Introduction

d'mulation de la cl, une des mthodes les plus utilises en


piratage.

Avantages du Systme HASP pour vos Clients


La protection HASP est un avantage aussi bien pour vous que pour
vos clients. Voici quelques raisons qui montrent pourquoi la protection
de logiciel est bonne pour vos clients:
Logiciel un Meilleur Prix
La protection HASP augmente vos ventes et revenus, gnrant
une hausse de votre budget d'investissement dans le
dveloppement et l'amlioration de votre logiciel, et augmente
votre comptitivit future. Cela signifie galement un logiciel
prix plus bas, plus volu, dvelopp plus rapidement et un
support technique de qualit pour les utilisateurs payants.
Protection des Termes de la Licence
La protection de logiciel vous permet de garantir le respect des
Termes de la Licence. Le systme HASP est le dispositif le moins
gnant, le moins contraignant pour assurer le respect de la
Licence. Il permet au client de ne pas avoir faire la police auprs
de ses employs ou de ne pas craindre une violation des Termes de
la Licence.
Protection de l'Investissement des Utilisateurs Lgitimes
Le systme HASP protge les utilisateurs lgitimes de la
comptitivit dloyale des utilisateurs malhonntes qui n'ont pas
pay leur logiciel et qui encombrent le service technique.
Protection Contre les Intrus
HASP assure l'intgrit de l'application en vitant qu'elle ne soit
modifie par des intrus.
Protection Supplmentaires

La Gamme HASP

1-7

Les utilisateurs bnficient d'avantages supplmentaires grce au


systme HASP, comme la protection de leurs donnes et la
dtection d'infections virales.

La Gamme HASP
Ce manuel dcrit les cls HASP pour les ordinateurs IBM PC et les
NEC japonais. Avec dix cls de protection dans la gamme HASP pour
PC , HASP fournit la plus large gamme de protection de logiciel du
march.
HASP-3
HASP-3 offre le meilleur rapport qualit/prix de la gamme HASP.
Utilisant le mme composant ASIC et les mmes fonctionnalits
que nos produits les plus volus, HASP-3 offre une solution de
protection faible cot, bien qu'extrmement sre et fiable.
MemoHASP
Les cls MemoHASP-1 et MemoHASP-4 associent l'tat de l'art en
de la protection, une mmoire interne accessible en lecture /
criture dont vous pouvez modifier le contenu durant l'excution
de l'application. La cl MemoHASP-1 possde 112 octets de
mmoire en lecture / criture, tandis que la cl MemoHASP-4 en
contient 496.
NetHASP
NetHASP est l'ultime solution de protection des logiciels pour PC
en environnement rseau. Une seule cl NetHASP connecte
n'importe quelle station de travail du rseau permet de protger
votre application et de limiter le nombre de stations utilisant
simultanment votre application. La cl NetHASP possde toutes
les fonctionnalits de protection d'une cl MemoHASP-4, ainsi que
496 octets de mmoire en lecture / criture.
TimeHASP

1-8

Introduction

Les cls TimeHASP et TimeHASP-4 sont des cls HASP contenant


une
horloge
temps-rel
interne.
La
TimeHASP
est
particulirement conue pour des versions limites dans le temps
de votre application, comme des versions de dmonstration ou des
versions de location.
La cl TimeHASP comprend une mmoire de 16 octets en lecture /
criture. La cl TimeHASP-4 contient 496 octets de mmoire en
lecture / criture, en plus des 16 octets de mmoire.
HASP36
La cl HASP36 possde toutes les fonctionnalits d'un cl HASP-3
avec un connecteur 36 broches (Centronics), conue pour protger
les applications tournant sur les PC japonais NEC.
MemoHASP36
Les cls MemoHASP36-1 et MemoHASP36-4 sont les versions avec
connecteurs 36 broches des cls MemoHASP-1 et MemoHASP-4.
NetHASP36
La cl NetHASP36 est la version connecteur 36 broches de la cl
NetHASP.
HASPCard
HASPCard est une cl HASP totalement intgre dans une carte
PC standard. HASPCard, disponible en versions HASP-3,
MemoHASP et NetHASP, vous permet de connecter la cl de
protection l'intrieur d'un PC.
PC-CardHASP
PC-CardHASP est une carte volue de protection qui se connecte
au port PC-Card (PCMCIA) de la plupart des PC portables.
Contenant 496 octets de mmoire interne en lecture / criture et le
composant ASIC HASP, la PC-CardHASP est totalement
compatible avec le reste de la gamme HASP.
D'autres cls sont disponibles pour les ordinateurs Apple Macintosh
et Power Macintosh, et les stations de travail en systme ouvert.

La Gamme HASP

1-9

1-10

Introduction

Conventions Typographiques

1-11

Conventions Typographiques
Tableau 1.2: Conventions typographiques utilises dans ce manuel
Convention

Signification

Gras

Noms d'options, de boutons, icnes, menus, options de


menu et champs. Indique galement l'application
excuter. Par exemple, Choisissez l'option Edit
Memory du menu Memory.

Italique

Des termes qui apparaissent pour la premire fois dans


le manuel. Indique galement un nom de fichier ou de
rpertoire. Par exemple, Vous pouvez trouver le fichier
hasput16.dll dans le rpertoire drivers des logiciels
HASP.

<Touche>

Touches utiliser sur le clavier. Par exemple, Appuyez


sur la touche <F3> pour protger votre application.

PETITES CAPITALES

Mots cls du fichier de configuration de la cl NetHASP.


Par exemple, Dans la section [NH_COMMON], dfinissez
NH_IPX=Enabled.

Note
NetHASP :

Information relative uniquement la cl NetHASP. Les


notes NetHASP n'apparaissent que des les chapitres et
sections ne traitant pas spcifiquement des cls
NetHASP. Si vous utilisez une protection base sur une
cl NetHASP, prenez note de cette information. Si vous
n'utilisez pas de cl NetHASP, vous pouvez passer cette
information

Information supplmentaire qui peut vous aider


raliser une tche plus efficacement.

1-12

Introduction

Protection de Logiciel Rfrence Rapide


Le tableau suivant explique les diffrentes tapes suivre pour
protger votre application avec une cl HASP. Pour chacune de ces
tapes, vous trouverez une rfrence une section du manuel
dcrivant l'tape en question.
Tableau 1.3: Etapes de protection dun logiciel
Etapes

Commentaires

Rfrence

1.

Installation du
Gestionnaire de
Priphrique HASP

Active l'accs au port parallle. A n'utiliser


qu'en environnement Windows 32 bits.

Chapitre
14:
Gestionnaire
Priphrique HASP

2.

Utilisation du programme
HaspEdit

Vous permet de personnaliser votre protection.

Chapitre 13: Le Programme HaspEdit,


Vrification des Codes de Retour

3.

Utilisation de l'API

Vous permet d'incorporer des appels la cl


HASP dans votre application.

Chapitre 6: Protection avec l'API

4.

Utilisation de l'Enveloppe
HASP

Vous permet de chiffrer votre fichier excutable


et d'augmenter le niveau de scurit.

Chapitre 5: Protection avec l'Enveloppe

5.

Utilisation du programme
HaspEdit

Vous permet d'diter la mmoire de chaque cl


HASP.

Chapitre 13: Le Programme HaspEdit

de

Chapitre 2 - Concepts HASP de Base


Pour utiliser efficacement la
protection HASP, nous vous
recommandons de vous familiariser avec les concepts et les termes
dcrits dans ce chapitre..
Note Si vous utilisez une protection base sur NetHASP, veuillez
NetHASP vous reporter galement au chapitre 3 pour vous familiariser

avec les termes et concepts spcifiques de NetHASP.

Termes HASP
Cls HASP Mmoire
Les cls HASP mmoire sont des cls HASP avec une mmoire
accessible en lecture / criture. Cela inclut toutes les cls HASP sauf
les HASP-3 et HASP36.

Cls HASP Monopostes


Les cls HASP monopostes sont les cls HASP conues pour des
ordinateurs isols. Cela inclut toutes les cls HASP sauf les NetHASP
et NetHASP36.

Code Dveloppeur
Le Code Dveloppeur est un code unique assign par Aladdin chaque
dveloppeur de logiciel. Le Code Dveloppeur est claqu dans le
composant ASIC de la cl HASP lors de sa fabrication empchant tout
reverse engineering, et assurant ainsi une protection totale.

2-1

2-2

Concepts HASP de Base

Utilisez ce Code Dveloppeur pour commander des cls HASP


supplmentaires. Le Code Dveloppeur est reprsent par une srie
de cinq sept lettres imprimes sur l'tiquette de chaque cl HASP.

Cl HASP de Dmonstration
Dans chaque Kit de Dveloppeur HASP, Aladdin fournit une cl HASP
de dmonstration. Chaque cl de dmonstration est cl HASP
complte, mais avec un Code Dveloppeur identique. Vous ne pouvez
pas utiliser la cl HASP de dmonstration pour protger votre logiciel,
car le Code Dveloppeur et les Mots de Passe associs la cl HASP
de dmonstration sont accessibles tous. Les cls HASP de
dmonstration ne doivent tre utilises que pour valuer le systme
de protection HASP.

Mots de Passe HASP


Les Mots de Passe HASP sont composs de deux entiers assigns
chaque dveloppeur de logiciel. Les mots de passe sont associs de
manire unique avec un Code Dveloppeur. Vous utilisez les Mots de
Passe HASP pour accder la cl HASP, protger vos applications et
utiliser les outils HASP.

Seed Code (Germe) et Code de Retour


Un Seed Code (ou Germe) est un entier que votre application envoie
la cl HASP. Un Code de Retour est un entier que la cl HASP renvoie
l'application protge. La cl HASP retourne quatre Codes de
Retour pour chaque Seed Code envoy par l'application protge. Les
Codes de Retour sont gnrs en fonction du Code Dveloppeur de la
cl HASP et du Seed Code.
En envoyant des Seed Codes et en vrifiant que les Codes de Retour
sont ceux attendus, vous pouvez vrifier que la cl HASP est prsente.

Termes HASP

2-3

Figure 2.1: Codes Graine et Codes de Retour

Numro d'Identification HASP (HASP ID Number)


Chaque cl HASP mmoire possde un Numro d'Identification
unique. Une application protge peut rechercher et vrifier ce
Numro d'Identification.
Les cls HASP possdant un Numro d'Identification vous permettent
de distinguer les utilisateurs dans votre application. En recherchant
le Numro d'Identification HASP dans votre application, vous pouvez
dterminer les actions mener en fonction de la cl prsente.

2-4

Concepts HASP de Base

Note:

Vous ne pouvez pas commander des cls HASP avec des


Numros d'Identification donns. Ils sont assigns de
manire pseudo-alatoire durant la fabrication des cls, vous
assurant ainsi de leur unicit.

Mmoire HASP
Le Tableau 2.1 montre la quantit de mmoire disponible pour les
diffrentes cls HASP.
Tableau 2.1: Mmoire HASP en lecture / criture
Type de cl HASP

Mmoire
en Lecture / Ecriture

HASP-3, HASP36

aucune

MemoHASP-1, MemoHASP36-1

112 octets

MemoHASP-4, MemoHASP36-4

496 octets

TimeHASP

16 octets

TimeHASP-4

512 octets

NetHASP, NetHASP36

496 octets

Vous pouvez utiliser la mmoire HASP, par exemple, pour :


Contrler l'accs diffrents modules d'un logiciel ou diffrentes
suites logicielles.
Assigner un code unique chaque utilisateur du logiciel.
Louer un logiciel ou distribuer des versions de dmonstration qui
ne pourront tre utilises qu'un certain nombre de fois.

Mthodes de Protection HASP

2-5

Sauver des mots de passe, une partie du code du programme, des


variables du programme, ou dautres informations sensibles.

Mthodes de Protection HASP


HASP offre deux diffrentes mthodes de protection.
L'Enveloppe HASP
L'Interface de Programmation d'Application HASP (API)

Enveloppe HASP
Le modle de protection de base est la protection par l'Enveloppe
HASP. Cette mthode ajoute un bouclier protecteur autour des
fichiers excutables. Une fois protge par l'Enveloppe, l'application
ne pourra plus fonctionner sans la cl HASP associe.
La protection par Enveloppe est rapide et facile mettre en place.
Dans le mme temps, cela fournit une protection de haut niveau en
rendant l'application virtuellement impossible dboguer ou
dsassembler.

Note:

La protection par Enveloppe ne requiert pas l'accs au code


source de l'application.

Interface de Programmation dApplication HASP (API)


Si vous possdez le code source de l'application protge, vous
pouvez lier l'API HASP - un fichier objet ou une DLL - votre
application. Comme l'API est la fois protge et encode, cette
mthode offre galement un haut niveau de scurit.
L'API vous permet d'insrer des appels la cl HASP tout au long de
votre application. Avec cette API, vous pouvez tester la prsence de la
cl HASP lorsque vous le dsirez, et prendre les mesures qui

2-6

Concepts HASP de Base

s'imposent si la bonne cl HASP n'est pas connecte. De plus, vous


pouvez accder aux donnes sensibles que vous avez pu stocker dans
la mmoire d'une cl HASP mmoire.

Quelle Mthode Utiliser ?


Vous pouvez utiliser l'une ou l'autre mthode, ou bien combiner les
deux.
Si vous n'utilisez que l'Enveloppe, vous n'avez pas besoin d'accder au
code source de l'application, et de ce fait, vous n'avez pas recompiler
l'application.
Si vous possdez le code source de l'application protger, vous
pouvez lier l'API HASP votre application, et tester la prsence de la
cl HASP lorsque vous le dsirez, et prendre les mesures qui
s'imposent si la bonne cl HASP n'est pas connecte.
Les deux mthodes Enveloppe et API sont des mthodes de protection
trs puissantes. L'utilisation d'une seule de ces deux mthodes vous
assure un haut niveau de scurit. Cependant, nous vous
recommandons de combiner, si possible, l'Enveloppe et l'API. Chaque
mthode possde des fonctionnalits uniques qui se compltent et
amliorent la protection de votre application.
Pour une protection optimale, utilisez lEnveloppe et lAPI :
Incorporez l'API HASP dans le code source de votre application,
compiler, lier les fichiers objets HASP ou les DLL votre application,
et enfin, utilisez la protection par Enveloppe HASP sur votre fichier
excutable.

Questions Frquemment Poses (FAQ)


Question:

Puis-je changer mes Mots de Passe HASP ?

Rponse:

Non. Afin de garantir un niveau de protection optimal et pour


viter tout reverse engineering de la cl, les Mots de Passe HASP
sont claqus de faon indlbile dans le composant ASIC de la cl

Questions Frquemment Poses (FAQ)

2-7

durant la phase de production. Personne ne peut ainsi accder la


cl HASP pour lire et modifier ces mots de passe.
Certain produits de protection de logiciel vous permettent de
dfinir vous-mme ces mots de passe. Cette fonctionnalit rduit
le niveau gnral de scurit du systme de protection, les mots de
passe pouvant tre lus et modifis par un pirate.
Question:

Puis-je donner chaque client une cl HASP avec un code


ou un mot de passe unique ?

Rponse:

Oui. Pour cela, nous vous recommandons d'utiliser des cls


MemoHASP qui contiennent un Numro d'Identification unique
pour chaque cl. De plus, vous pouvez programmer
individuellement la mmoire de la cl MemoHASP pour chacun de
vos clients.

Question:

Une cl HASP monoposte peut-elle tre utilise en


environnement rseau ?

Rponse:

Oui. Il existe deux possibilits d'utiliser le systme HASP en


rseau. La premire consiste connecter une cl HASP sur
chacune des stations du rseau devant excuter l'application
protge. La seconde - et la plus efficace - est de protger votre
application avec une cl NetHASP, un systme de protection
sophistiqu spcialement conu pour les environnements rseau.
Le systme NetHASP permet l'activation d'une application
protge sur plusieurs stations en n'utilisant qu'une seule cl
HASP. Pour plus d'informations sur le systme NetHASP,
reportez-vous au chapitre 3.

Question:

Peut-on connecter plusieurs cls HASP ensemble ?

Rponse:

Oui, plusieurs cls HASP peuvent tre chanes sans connectique


spciale.

2-8

Concepts HASP de Base

Question:

Et, quand est-il des cls fabriques par d'autres socits ?

Rponse:

Les cls HASP sont totalement transparentes. Vous pouvez les


enchaner avant ou aprs d'autres cls, condition bien sr que
ces dernires soient galement transparentes.

Question:

Est-il possible de protger des applications ou des fichiers


de donnes crits avec des outils de programmation tels
que Lotus et AutoLISP ?

Rponse:

Oui. Nous avons dvelopp un systme spcial, appel DataHASP,


pour protger les fichiers de donnes. Facile mettre en oeuvre,
DataHASP protge les fichiers en brouillant leur contenu et n'en
permettant l'accs qu'aux applications autorises. DataHASP
fonctionne sous DOS avec toutes les cls HASP.

Question:

Comment puis-je mettre jour le contenu de la mmoire


HASP aprs avoir livr une application protge mon
client ?

Rponse:

Le systme RUS (Remote Update System) permet de mettre jour


le contenu des mmoires HASP lorsque la cl est en possession de
votre client. Vous mettez jour la mmoire de la cl en envoyant
des mots de passe par tlphone, fax, e-mail, ou modem. Cela
permet l'activation de fonctionnalits supplmentaires ou l'accs
des modules supplmentaires.

Chapitre 3 - Concepts NetHASP de Base


Ce chapitre prsente les termes et concepts importants relatifs au
systme NetHASP. Avant de dbuter ce chapitre, lisez le chapitre 2
pour vous familiariser avec les termes et concepts gnraux HASP.

Qu'est-ce qu'une cl NetHASP?


Une cl NetHASP est une cl HASP conue pour l'utilisation en
rseau. Le systme NetHASP vous permet de licencier votre
application en environnement rseau, en contrlant le nombre
d'exemplaires d'une application s'excutant au mme moment. En ne
connectant qu'une seule cl NetHASP sur un ordinateur du rseau,
vous pouvez scuriser votre application et surveiller le nombre de
stations utilisant simultanment votre logiciel.

3-1

3-2

Concepts NetHASP de Base

Figure 3.1: Le systme NetHASP

Termes NetHASP
Gestionnaire de Licence NetHASP
Le Gestionnaire de Licence NetHASP est une application
communiquant avec l'application protge et la cl NetHASP. Il
fonctionne ainsi comme un lien entre les deux. Pour permettre au
systme NetHASP de grer le rseau, choisissez une station du
rseau, connectez-y une cl NetHASP, et chargez le Gestionnaire de
Licence NetHASP.
Les Gestionnaires de Licence NetHASP sont disponibles pour les
environnements suivants : serveurs Novell ddis, DOS, Windows,
Windows 95, Windows NT et OS/2.
Le Gestionnaire de Licence NetHASP est indpendant de la cl
NetHASP et de l'application protge. Quelque soit l'environnement
dans lequel fonctionne l'application protge (DOS, Windows, Win32,
et OS/2), vous pouvez utiliser n'importe lequel des Gestionnaires de
Licence NetHASP pour communiquer avec l'application et la cl
NetHASP.
Le Gestionnaire de Licence NetHASP peut communiquer avec un
maximum de 250 applications protges fonctionnant sur le rseau et
avec plusieurs cls NetHASP.

LOGIN et LOGOUT NetHASP


Lorsque vous excutez une application protge, elle effectue un
LOGIN NetHASP pour accder au Gestionnaire de Licence NetHASP
avec une demande d'excution. L'application protge informe le
Gestionnaire de Licence NetHASP qu'elle a termin son excution en
effectuant LOGOUT NetHASP.

Termes NetHASP

Note:

3-3

Ne confondez pas les LOGIN et LOGOUT NetHASP avec les


login et logout standards du rseau.

Table de Connexion NetHASP


Le Gestionnaire de Licence NetHASP tient jour une Table de
Connexion qui contient la liste de toutes les applications ayant
effectu un LOGIN NetHASP. La liste identifie chaque application
protge ainsi que la station sur laquelle elle fonctionne. Une
application et sa station restent dans la Table de Connexion jusqu'
envoi d'un LOGOUT NetHASP.
Le Gestionnaire de Licence NetHASP utilise cette Table de Connexion
pour compter le nombre de stations excutant une application
protge un moment donn. Le Gestionnaire de Licence NetHASP
s'assure que le nombre de stations n'excde pas le nombre maximum
de licences dfini par l'auteur du logiciel.

Note:

La Table de Connexion NetHASP est un mcanisme interne.


Elle n'est prsente que dans cette section pour vous aider
comprendre le fonctionnement du systme NetHASP.

Modles NetHASP
Il existe diffrents modles de cls NetHASP. Chaque cl peut
protger jusqu' 112 applications. Le numro associ une cl
NetHASP dtermine le nombre maximal de licences disponible pour
chaque application. Par exemple, une cl NetHASP-5 peut protger
jusqu' 112 applications, chacune d'entre elles pouvant disposer de
zro cinq licences. Les autres modles disponibles peuvent fournir
jusqu' 10, 20, 50 ou 100 licences. Avec la cl NetHASP-U votre
application peut bnficier d'un nombre illimit de licences.

3-4

Concepts NetHASP de Base

Le Systme NetHASP
Lorsqu'une application protge est excute sur le rseau, elle accde
au gestionnaire de Licence NetHASP et demande la permission de
s'excuter en effectuant LOGIN NetHASP. Le Gestionnaire de
Licence NetHASP vrifie alors que :
La bonne cl NetHASP est connecte.
L'application protge est autorise se lancer.
Le nombre de stations excutant actuellement l'application
protge n'excde pas le nombre maximal de licences.
Si l'un des tests ci-dessus n'est pas vrifi, le Gestionnaire de Licence
NetHASP retourne un code d'erreur.
Si tous les tests sont positifs, le Gestionnaire de Licence NetHASP
donne la permission l'application protge de s'excuter et met
jour la Table de Connexion NetHASP.
Le schma ci-dessous illustre le fonctionnement de la protection
NetHASP. Le rseau prsent est compos de quatre stations. Une cl
NetHASP est connecte sur l'une d'elles et le Gestionnaire de Licence
NetHASP est actif.
L'application protge n1 est autorise s'excuter sur cinq stations.
Les schmas illustrent les tapes pour l'excution de l'application
protge n1 sur la station 3.

Le Systme NetHASP

3-5

Avant un LOGIN NetHASP...

Les stations 1 et 2 excutent l'application protge n1, et sont listes dans la Table de Connexion
(Log Table). Sur les cinq stations autorises excuter l'application protge, deux sont dj dans
la Table de connexion.

Un LOGIN NetHASP est effectu...

3-6

Concepts NetHASP de Base

La station 3 charge l'application protge n1, cette dernire accde au Gestionnaire de Licence
NetHASP avec un LOGIN NetHASP. A ce moment, le Gestionnaire de Licence NetHASP vrifie si
la station 3 est autorise excuter cette application.

Aprs un LOGIN NetHASP...

Les tests effectus par le Gestionnaire de Licence NetHASP tant positifs, l'application protge
n1 est autorise s'excuter sur la station 3. La Table de Connexion est mise jour et comprend
maintenant la station 3.

Questions Frquemment Poses (FAQ)


Question:

Puis-je voir quelles stations ont accs la cl NetHASP ?

Rponse :

Oui. L'outil Monitor affiche toutes les stations excutant une


application ayant effectu un LOGIN NetHASP au Gestionnaire
de Licence NetHASP. Voir chapitre 17 pour plus de dtails.

Question:

Si je connecte deux cls NetHASP-5 du mme Code


Dveloppeur sur le mme ordinateur, aurais-je 10 licences?

Rponse :

Non. Lorsque deux cls NetHASP du mme Code Dveloppeur


sont chanes ou connectes sur deux ports parallles d'un mme
ordinateur, une seule cl NetHASP rpond. Pour avoir dix licences
avec deux cls NetHASP-5, vous devez les connecter sur deux
ordinateurs diffrents et excuter un Gestionnaire de Licence

Questions Frquemment Poses (FAQ)

3-7

NetHASP sur chacun d'eux. Vous pouvez aussi utiliser un cl


NetHASP-10.
Question:

Le Gestionnaire de Licence NetHASP peut-il librer


automatiquement les licences lorsque les stations
n'utilisent plus l'application protge ?

Rponse :

Oui. Si une station libre (une station qui n'a pas accd
l'application depuis un certain temps) est indique comme
utilisant un application protge, utilisez le service IdleTime pour
enlever cette station de la Table de Connexion et librer ainsi une
licence (voir chapitre 10). La Table de Connexion garde la trace
de toutes les stations ayant effectu un LOGIN NetHASP. Ce
service dfinit une priode durant laquelle une station doit
accder la cl NetHASP. Si la station n'accde pas la cl
NetHASP durant cette priode, elle est considre comme
potentiellement libre et supprime de la Table de Connexion en
cas de demande connexion d'une nouvelle station.

3-8

Concepts NetHASP de Base

Chapitre 4 - Le Logiciel HASP


Les utilitaires et API HASP compris dans le logiciel HASP,
permettent de grer toutes les cls HASP. Vous n'avez besoin que
d'une seule Enveloppe et/ou API pour protger votre logiciel avec
diffrents types de cls HASP.

Les Utilitaires HASP


Les utilitaires HASP comprennent les outils HASP d'Enveloppe, le
logiciel HaspEdit, les Gestionnaires de Licence NetHASP, le Moniteur
NetHASP, et les utilitaires de test NetHASP.
Chaque rpertoire utility comprend un fichier dcrivant le
fonctionnement de chaque utilitaire.
Les utilitaires HASP
fonctionnent sous DOS, Windows 16 bits, Windows 32 bits, et OS/2.

4-1

4-2

Le Logiciel HASP

LAPI HASP
LAPI HASP est disponible selon le systme d'exploitation. Il existe
une API spare pour DOS, Windows 16 bits, Windows 32 bits et
OS/2.
L'API est ensuite subdivise en fonction de l'environnement de
dveloppement, et le compilateur. Il existe un rpertoire pour chaque
compilateur comprenant :
Les fichiers Objet ou DLL que vous devez lier votre application.
Un exemple d'application montrant comment utiliser l'API avec
les diffrentes cls HASP.
Les interfaces HASP sont disponibles pour plusieurs centaines de
compilateurs. Chacune d'elles grant l'ensemble des cls HASP.
Si vous ne trouvez pas une interface pour votre compilateur :
Essayez une interface qui utilise le mme type de fichiers objet
que votre compilateur.
Si vous programmez sous Windows 16 bits, Windows 32 bits ou
OS/2, essayez les DLL que nous fournissons.
Utilisez l'Enveloppe pour protger votre fichier excutable.

Les Gestionnaires de Priphriques HASP


Le logiciel de Gestionnaire de Priphrique HASP comprend tous les
Gestionnaires de Priphriques HASP et les outils d'installation
associs.

Installation du Logiciel HASP

4-3

Installation du Logiciel HASP


Pour installer le logiciel HASP partir d'un Cdrom :
1. Insrez le Cdrom HASP dans votre lecteur de Cdrom. Dans
certains environnements comme Windows 95 ou Windows NT,
l'installation de HASP dmarre automatiquement lors de
l'insertion du Cdrom dans le lecteur.
2. Si l'installation ne dmarre pas automatiquement, lancer le
programme install.exe partir de Windows.
Suivez les instructions du programme d'installation pour installer les
utilitaires HASP, l'API HASP, le Gestionnaire de Priphrique HASP,
ainsi que d'autres logiciels HASP sur votre disque dur.

4-4

Le Logiciel HASP

Chapitre 5 - Protection par Enveloppe


LEnveloppe HASP ajoute un bouclier protecteur autour des fichiers
excutables DOS, Windows et Win32, et des DLLs Win32. La
protection par Enveloppe ne requiert pas l'accs au code source de
l'application.
Pour protger votre application en combinant l'Enveloppe et l'API
HASP, protgez d'abord votre application avec l'API. Pour en savoir
plus sur la protection avec API, reportez-vous au chapitre 6.

Figure 5.1: Protection par Enveloppe


Bien qu'extrmement facile et rapide mettre en place, la protection
par Enveloppe assure un haut niveau de scurit. Une fois
l'Enveloppe mise en place, il est pratiquement impossible de dboguer
ou dsassembler l'application protge.
L'Enveloppe HASP peut tre utilise avec n'importe quelle cl HASP.
Le programme de protection par Enveloppe utilis dpend du type
d'application protger (voir Tableau 5.1).

5-1

5-2

Protection par Enveloppe

Tableau 5.1: Programmes de Protection


par Enveloppe HASP
Type dApplication

Enveloppe

DOS

haspinst.exe

Windows

whinst.exe

Win32

w32hinst.exe

Il est important de retenir deux points


protection par Enveloppe :

avant de dbuter une

Crez une copie de sauvegarde du fichier non protg. Par dfaut,


le fichier original est dtruit durant la phase protection et
remplac par le programme protg.
Assurez-vous qu'il reste assez de place sur le disque dur avant de
dbuter la protection. L'application protge par Enveloppe sera
plus volumineuse que la version non protge. La diffrence de
taille dpend du type d'application que vous dsirez protger :

Protection dune Application Win32

5-3

Tableau 5.2: Taille Supplmentaire aprs Protection


Type dApplication

Supplment
de Taille

DOS

40 Ko

Windows

40 Ko

Win32

120Ko

Protection dune Application Win32


Pour protger une application avec l'Enveloppe Win32 :
1. Branchez la cl HASP avec laquelle vous dsirez protger votre
application.
2. Installez le Gestionnaire de Priphrique HASP (voir chapitre 14).
3. Lancez le programme d'Enveloppe, soit en choisissant le raccourci
Envelope for Win32 Applications dans le dossier Haspcd, soit
en excutant le programme w32hinst.exe. L'cran du programme
d'Enveloppe HASP apparat.

5-4

Protection par Enveloppe

4. Vous disposez maintenant de trois options :


Cliquez sur Start HASP Wizard. LAssistant HASP vous guidera
tout au long du processus de protection.
Cliquez sur New Envelope Configuration pour dbuter une
protection avec de nouveaux paramtres de protection.
Cliquez sur Open Envelope Configuration pour dbuter une
protection avec des paramtres pralablement sauvegards.
Ce chapitre dcrit le processus de protection lorsque vous
choisissez les options New ou Open Envelope Configuration.
5. Entrez le chemin d'accs et le nom de l'application protger dans
le champ Unprotected Filename de l'onglet principal.
6. Saisissez les mots de passe HASP associs la cl utilise dans les
champs correspondants.
7. Remplissez les champs selon les options que vous dsirez utiliser
(voir la section Programme d'Enveloppe Win32 pour plus de
dtails sur chaque champ).
8. Cliquez sur l'icne Protect ou choisissez l'option Protect
Application du menu Activity pour protger votre application.
Si vous dsirez utiliser les paramtres NetHASP ou FAS avec
l'Enveloppe, cliquez sur Yes pour sauvegarder les paramtres dans
la mmoire de la cl connecte.
9. Choisissez l'option Exit du menu File pour quitter le programme.
A partir de cet instant, l'application protge ne fonctionnera plus
sans la cl HASP qui lui est associe.

Vous pouvez appliquer l'enveloppe sur votre application


plusieurs fois avec la mme cl HASP. Chaque activation
augmentera le niveau de scurit de votre application;
cependant, il faudra un peu plus de temps pour que votre
application se charge.

Programme dEnveloppe Win32

5-5

Programme dEnveloppe Win32


Cette section dcrit toutes les options des menus, les icnes et le
champs de saisie du programme d'Enveloppe Win32. S'il existe une
valeur par dfaut pour un champ, elle est indique au dbut de
chaque description. Si une option n'est accessible qu'en ouvrant un
menu particulier, le menu en question est alors indiqu.

La Barre de Menu
New
Lieu: menu File

Dbute une nouvelle session de protection.

Open
Lieu: menu File

Ouvre un fichier contenant


pralablement sauvegards.

des

paramtres

de

protection

Save
Lieu: menu File

Sauvegarde les paramtres courants dans un fichier.

Save As
Lieu: menu File

Sauvegarde les paramtres courants dans un fichier diffrent.

5-6

Protection par Enveloppe

Exit
Lieu: menu File

Quitte le programme dEnveloppe Win32.

HASP Wizard
Lieu: menu Activity

Active l'Assistant HASP qui vous guide pas pas durant le processus
de protection.

Protect Application
Lieu: menu Activity

Aprs avoir saisi tous les paramtres de protection, utilisez cette


option Protect Application pour protger votre application.

Install PCS
Lieu: menu Activity

Utilise la Scurit par Motif Cod seule ou associe l'Enveloppe pour


ajouter une protection supplmentaire votre application. (Pour plus
de dtails sur la Scurit par Motif Cod, reportez-vous au chapitre
12.)

Program HASP
Lieu: menu Activity

Si vous utilisez une cl HASP mmoire, utilisez l'option Program


HASP pour sauvegarder les paramtres de protection dans la
mmoire de la cl. Les paramtres suivants peuvent tre sauvegards:
Avec MemoHASP : le numro du programme et le nombre de
lancements.

Programme dEnveloppe Win32

Avec TimeHASP :
d'expiration.

le

numro

du

programme

et

la

5-7

date

Avec NetHASP : le numro du programme, le nombre de licences


et le nombre de lancements.

Note:

Si la cl connecte l'ordinateur contient dj des


paramtres dfinis avec le programme HaspEdit, vous n'avez
pas besoin d'utiliser l'option Program HASP.

Help
Cliquez sur Help pour obtenir des informations complmentaires sur
le programme d'Enveloppe Win32.

La Barre dOutils
Afin d'acclrer le processus de protection, vous pouvez utiliser les
icnes de la barre d'outils. Elles apparaissent comme montr cidessous :

New
Dbute une nouvelle session de protection.

Open
Ouvre un fichier contenant
pralablement sauvegards.

des

paramtres

Save
Sauvegarde les paramtres courants dans un fichier.

de

protection

5-8

Protection par Enveloppe

Wizard
L'icne l'Assistant HASP vous guide pas pas durant le processus de
protection.

Protect
Aprs avoir saisi tous les paramtres de protection, l'icne Protect
Application protge votre application.

Help
Fournit des informations
d'Enveloppe Win32

complmentaires

sur

le

programme

Programme dEnveloppe Win32

5-9

Longlet Main
L'onglet Main contient les paramtres que vous devez spcifier pour
protger votre application. Si vous n'utilisez qu'une cl HASP
monoposte, remplissez tous les champs except NetHASP
Parameters. Si vous n'utilisez qu'une cl NetHASP, remplissez tous
les champs except HASP Passwords. Si vous utilisez simultanment
une cl HASP monoposte et une cl NetHASP, remplissez tous les
champs. L'cran se prsente sous la forme suivante :

Unprotected Filename (source)


Saisissez le chemin d'accs et le nom de l'application protger.
Cliquez sur Browse pour rechercher le fichier dans l'arborescence de
vos disques.

5-10

Protection par Enveloppe

Protected Filename (destination)


Valeur par dfaut: Le nom saisi dans le champ Unprotected Filename

Par dfaut, le programme d'Enveloppe HASP remplace le fichier


original par sa version protge. Pour viter d'craser votre fichier
original, vous pouvez spcifier un nom diffrent pour l'application
protge. Saisissez alors ce nom dans le champ Protected Filename.

HASP Passwords
Saisissez les Mots de Passe HASP de toutes les cls HASP
monopostes avec lesquelles vous dsirez protger l'application.
Gnralement, une seule cl HASP est utilise, mais il est possible
d'utiliser trois cls HASP monopostes diffrentes.

Executable Type
Valeur par dfaut: Win 32

Ce champ permet de prciser le type de fichier EXE/DLL protger.


Actuellement, l'Enveloppe Win32 ne supporte que les excutables
Win32 ou les DLLs.

Target Computer
Valeur par dfaut: IBM PC and Compatibles

Ce champ vous permet de prciser sur quel type d'ordinateur va


tourner l'application protge. La valeur par dfaut de ce champ est
IBM. Si l'ordinateur sur lequel va s'excuter le programme est un
NEC, modifiez la valeur du champ en consquence.

NetHASP Passwords
Lorsque vous protgez une application avec une cl NetHASP,
saisissez les Mots de Passe associs la cl NetHASP.

Programme dEnveloppe Win32

5-11

Program Number
Valeur par dfaut: 1

Chaque application protge par NetHASP reoit un numro


d'application de 1 112. Vous pouvez attribuer ce numro en utilisant
soit le programme HaspEdit, soit le programme d'Enveloppe.
Vous pouvez saisir le numro du programme de deux manires :
Entrez le numro de programme de l'application assign l'aide
du programme HaspEdit (et sauvegard dans la mmoire de la cl
HASP).
Dterminez maintenant un numro de programme pour votre
application en saisissant un nombre dans ce champ. Pour
sauvegarder le numro de programme dans la mmoire de la cl
HASP, cliquez sur Yes lorsqu'on vous le demandera (aprs la
protection).
Lorsque vous assignez un numro de programme l'aide de
l'Enveloppe, vous pouvez toujours utiliser le programme HaspEdit
pour modifier plus tard les paramtres de protection d'autres cls.
(Pour plus de dtails sur le Numro de Programme, reportez-vous au
chapitre 13)

Number of Licenses
Lorsque vous protgez une application avec NetHASP, vous devez
dterminer le nombre de licences assignes l'application. Ce nombre
de licences peut tre dfini l'aide du programme HaspEdit ou du
programme d'Enveloppe.
Si vous avez dj dfini le nombre de licences l'aide du programme
HaspEdit, vous pouvez laisser ce champ vide. Dans le cas contraire,
vous pouvez fixer le nombre maximum de licences autorises en
saisissant un nombre dans ce champ. Il est alors ncessaire de
sauvegarder les paramtres dans la mmoire de la cl HASP en
cliquant sur Yes lorsqu'on vous le demandera (aprs la protection).

5-12

Protection par Enveloppe

Lorsque vous assignez un nombre de licences l'aide de l'Enveloppe,


vous pouvez toujours utiliser le programme HaspEdit pour modifier
plus tard les paramtres de protection d'autres cls. (Pour plus de
dtails sur le Nombre de Licences, reportez-vous au chapitre 13)
Le tableau suivant montre le nombre de licences autorises pour
chaque modle de cl NetHASP.
Tableau 5.3: Nombre de licences
NetHASP possibles
Modle NetHASP

Nombre de Licences

NetHASP-5

05

NetHASP-10

0 10

NetHASP-20

0 20

NetHASP-50

0 50

NetHASP-100

0 100

NetHASP-U

Illimit

Number of Activations
Lorsque vous protgez une application avec NetHASP, vous devez
dterminer le nombre de lancements du programme. Ce nombre de
lancements peut tre dfini l'aide du programme HaspEdit ou du
programme d'Enveloppe.
Si vous avez dj dfini le nombre de lancements l'aide du
programme HaspEdit, vous pouvez laisser ce champ vide. Dans le cas
contraire, vous pouvez fixer le nombre maximum de lancements
autoriss en saisissant un nombre dans ce champ. Il est alors
ncessaire de sauvegarder les paramtres dans la mmoire de la cl
HASP en cliquant sur Yes lorsqu'on vous le demandera (aprs la
protection).

Programme dEnveloppe Win32

5-13

Lorsque vous assignez un nombre de lancements l'aide de


l'Enveloppe, vous pouvez toujours utiliser le programme HaspEdit
pour modifier plus tard les paramtres de protection d'autres cls.
(Pour plus de dtails sur le Nombre de Lancements, reportez-vous au
chapitre 13)

NetHASP Configuration File


Valeur par dfaut: nethasp.ini

Vous pouvez prciser le nom du fichier de configuration (un fichier


texte) pour le systme NetHASP. (Pour plus de dtails sur le fichier
de Configuration NetHASP, reportez-vous l'annexe C.)

Note:

Le programme d'Enveloppe n'utilise le fichier de


Configuration NetHASP que s'il existe. dans le cas contraire,
il utilise les valeurs par dfaut du systme NetHASP.

5-14

Protection par Enveloppe

Longlet Options
L'onglet Options contient des options de protection supplmentaires.
L'cran se prsente comme ci-dessous :

Full Authorization System (FAS)


Valeur par dfaut: Disabled

Vous ne pouvez utiliser le systme Full Authorization System (FAS)


qu'avec des cls MemoHASP, TimeHASP ou TimeHASP-4 (Pour plus
d'informations sur le FAS, reportez-vous la page 5-43).
Pour utiliser le FAS, cochez la case Use Full Authorization
System.

Programme dEnveloppe Win32

5-15

Application Program Number


Valeur par dfaut: 1

Si vous utilisez une cl monoposte pour protger plusieurs application


avec le FAS, entrez le numro unique que vous dsirez assigner
l'application.
Vous pouvez saisir le numro du programme de deux manires :
Entrez le numro de programme de l'application assign l'aide
du programme HaspEdit (et sauvegard dans la mmoire de la cl
HASP).
Dterminez maintenant d'un numro de programme pour votre
application en saisissant un nombre dans ce champ. Pour
sauvegarder le numro de programme dans la mmoire de la cl
HASP, cliquez sur Yes lorsqu'on vous le demandera (aprs la
protection).
Lorsque vous assignez un numro de programme l'aide de
l'Enveloppe, vous pouvez toujours utiliser le programme HaspEdit
pour modifier plus tard les paramtres de protection d'autres cls.
(Pour plus de dtails sur le Numro de Programme, reportez-vous au
chapitre 13.)
Tableau 5.4: Valeurs possible pour le Numro de Programme
Type de Cl

Valeurs Possibles

MemoHASP-1

1 16

MemoHASP-4

1 112

TimeHASP

18

TimeHASP-4

18

5-16

Protection par Enveloppe

Number of Application Activations


Si vous utilisez une cl monoposte pour protger plusieurs application
avec le FAS, entrez le nombre de lancements autoriss de
l'application. Vous pouvez dfinir ce nombre l'aide du programme
HaspEdit, ou du programme d'Enveloppe.
Si vous avez dj dfini le nombre de lancements l'aide du
programme HaspEdit, vous pouvez laisser ce champ vide. Dans le cas
contraire, vous pouvez fixer le nombre maximum de lancements
autoriss en saisissant un nombre dans ce champ. Il est alors
ncessaire de sauvegarder les paramtres dans la mmoire de la cl
HASP en cliquant sur Yes lorsqu'on vous le demandera (aprs la
protection).
Lorsque vous assignez le nombre de lancements l'aide de
l'Enveloppe, vous pouvez toujours utiliser le programme HaspEdit
pour modifier plus tard les paramtres de protection d'autres cls.
(Pour plus de dtails sur le Nombre de Lancements, reportez-vous au
chapitre 13.)

Application Expiry Date


Si vous utilisez une cl TimeHASP / TimeHASP-4 pour protger
plusieurs application avec le FAS, entrez la date d'expiration de
l'application. Vous pouvez dfinir cette date l'aide du programme
HaspEdit, ou du programme d'Enveloppe.
Si vous avez dj dfini une date d'expiration l'aide du programme
HaspEdit, vous pouvez laisser ce champ vide. Dans le cas contraire,
vous pouvez fixer la date d'expiration en saisissant une date dans ce
champ. Il est alors ncessaire de sauvegarder les paramtres dans la
mmoire de la cl HASP en cliquant sur Yes lorsqu'on vous le
demandera (aprs la protection).
Lorsque vous assignez une date d'expiration l'aide de l'Enveloppe,
vous pouvez toujours utiliser le programme HaspEdit pour modifier
plus tard les paramtres de protection d'autres cls. (Pour plus de
dtails sur la Date d'Expiration d'une application, reportez-vous au
chapitre 13.)

Programme dEnveloppe Win32

5-17

Background HASP Checks


Valeur par dfaut: Disabled

Par dfaut, le systme HASP recherche la prsence d'une cl HASP


une seule fois au dmarrage de l'application. Si vous dsirez rpter
cette recherche durant l'excution de l'application, ajoutez une
vrification de la cl HASP en tche de fond.
Pour activer cette fonctionnalit, cochez l'option Background HASP
Checks dans la zone Protection Methods.

Check HASP at Intervals


Lorsque vous utilisez l'option Background HASP Checks, vous devez
prciser un intervalle de temps entre deux recherches de la cl.
Entrez une valeur comprise entre 1 et 1000. Plus le nombre est petit,
plus il y aura de recherche de la cl.

Use HASP ID Number


Valeur par dfaut: Disabled

Utilisez ce champ si vous dsirez que l'application protge ne


fonctionne que si la cl HASP avec le Numro d'Identification indiqu
est connecte l'ordinateur. Cette option n'est disponible qu'avec des
cls HASP monopostes mmoire.
Il existe deux mthodes de saisie des Numros d'Identification : l'une
automatique, l'autre manuelle. La mthode de dtection automatique
permet au programme d'Enveloppe de lire le Numro d'Identification
de la cl HASP actuellement connecte sur port parallle. Sinon, vous
pouvez rcuprer le Numro d'Identification HASP de la cl l'aide
du programme HaspEdit et saisir ce numro manuellement. Le
Numro d'Identification est un entier 32 bits non sign qui doit tre
entr en notation hexadcimale.

5-18

Protection par Enveloppe

Note:

Lorsque vous protgez une application avec plusieurs cls


MemoHASP
ou
TimeHASP,
utilisez
le
Numro
d'Identification de la cl dont les Mots de Passe ont t saisis
en premier. Les Numro d'Identifications des autres cls ne
seront pas vrifis.

Encrypt Program File


Valeur par dfaut: Enabled

Cette option vous permet d'ajouter une protection supplmentaire en


codant le programme excutable.

Attention
Des applications modifiant leur propre code durant leur excution ne doivent pas
tre protges de cette manire.

Encryption Key (decimal)


Le processus de codage ncessite plusieurs cls de codage choisies
alatoirement par le programme d'Enveloppe HASP. Pour vous
assurer le maximum de scurit, vous pouvez dfinir l'une de ces cls
de codage en choisissant un nombre compris entre 0 et 65535.

Install HASP Envelope


Valeur par dfaut: Enabled

Dans la zone Protection Methods, vous indiquez la mthode de


protection que vous dsirez utiliser. Vous pouvez choisir l'Enveloppe,
la mthode de Scurit par Motif Cod, ou associer les deux.
Lorsque vous cliquez sur l'icne Protect ou lorsque vous choisissez
l'option Protect Application de menu Activity, vous mettez en place la
protection dfinie dans ce champ.

Programme dEnveloppe Win32

5-19

Cochez loption Install HASP Envelope pour une protection par


Enveloppe.

Install Pattern Code Security (PCS)


Valeur par dfaut: Disabled

Dans la zone Protection Methods, vous indiquez la mthode de


protection que vous dsirez utiliser. Vous pouvez choisir l'Enveloppe,
la mthode de Scurit par Motif Cod, ou associer les deux.
Lorsque vous cliquez sur l'icne Protect ou lorsque choisissez l'option
Protect Application du menu Activity, vous mettez en place la
protection dfinie dans ce champ. (Pour plus de dtails sur la Scurit
par Motif Cod, reportez-vous au chapitre 12.)
Cochez l'option Install Pattern Code Security (PCS) pour installer
le PCS et ainsi augmenter la protection de votre application.

5-20

Protection par Enveloppe

Longlet Error Messages


Cet onglet affiche la liste des messages derreur apparaissant quand
un problme survient durant l'excution de l'application protge. Par
exemple, si vous dsirez que les messages s'affichent dans une autre
langue, remplacez le texte des messages dans les champs.
L'cran a l'aspect suivant :

En plus des messages d'erreur, vous pouvez modifier les


codes de sortie. Si votre application utilise les mmes codes
de sortie que HASP, vous pouvez renumroter les codes
HASP.

Protection dune Application DOS ou Win16

5-21

Protection dune Application DOS ou Win16


Pour protger une application avec le programme d'Enveloppe
DOS ou Win16 :
1. Connectez l'ordinateur la cl HASP avec laquelle vous dsirez
protger l'application.
2. Installez le Gestionnaire de Priphrique HASP (voir chapitre 14).
3. Lancez le programme d'Enveloppe en excutant le programme
haspinst.exe pour protger des application s DOS, ou whinst.exe
pour des applications Win16. L'cran de copyright du programme
d'Enveloppe apparat. Appuyez sur une touche pour afficher l'cran
principal.
4. Entrez le chemin et le nom de l'application protger dans le
champ Program File to Protect.
5. Saisissez les Mots de Passe HASP dans les champs correspondants.
6. Remplissez les autres champs en fonction des options de protection
que vous dsirez utiliser (voir la section suivante pour une
description de chaque champ).
7. Appuyez sur la touche <F3> pour protger votre application. Un
message apparat vous indiquant que la protection s'est bien
droule.
8. Appuyez sur la touche <Escape> pour quitter le programme.
A partir de ce moment, l'application ne fonctionnera plus sans la cl
HAS P qui lui est associe.
Aprs la protection, vous pouvez rpter les oprations 4 7 autant de
fois que vous le dsirez pour la mme application ou d'autres
programmes.

5-22

Protection par Enveloppe

C
Note:

Vous pouvez appliquer lEnveloppe plusieurs fois sur votre


application avec la mme cl HASP. Chaque enveloppe
augmente le niveau de scurit de l'application, mais en
ralentit le temps de chargement.
Si vous protgez une application avec plusieurs enveloppes,
n'activez l'option Virus Detection que pour la dernire
enveloppe.

Programme dEnveloppe DOS et Win16


Cette section dcrit les diffrents champs du programme d'Enveloppe
DOS et Win16. Au dbut de chaque description, la valeur par dfaut
(si elle existe) est prcise. Sauf indication contraire, les champs
indiqus sont applicables pour les applications DOS et Win16.
Pour passer d'un champ l'autre, dans le programme
haspinst.exe :
Appuyez sur la touche Tab ou utilisez les flches de direction.

Touches de Fonction
<F1>
Appuyez sur <F1> pour obtenir de laide.

<F3>
Appuyez sur <F3> pour protger votre application aprs avoir saisi
tous les paramtres de protection.

Programme dEnveloppe DOS et Win16

5-23

<F4>
Appuyez sur <F4> pour utiliser la Scurit par Motif Cod (PCS). Le
PCS ajoute un niveau de protection supplmentaire votre
application. (Pour plus d'informations sur le PCS, reportez-vous au
chapitre 12.)

<F5>
Appuyez sur la touche <F5> pour sauvegarder les paramtres de
protection actuels dans un fichier.

<F6>
Appuyez sur la touche <F6> pour charger des paramtres de
protection pralablement sauvegards dans un fichier.

<Esc>
Appuyez sur la touche <Escape> pour quitter le programme.

5-24

Protection par Enveloppe

cran Principal
L'cran principal contient les paramtres que vous devez spcifier
pour protger votre application. L'cran principal a l'allure suivante :

Program File to Protect


Entrez le chemin et le nom du programme protger.
Appuyez sur la touche <F2> pour parcourir le disque.

Output Filename
Valeur par dfaut: Le nom saisi dans le champ Unprotected Filename

Par dfaut, le programme d'Enveloppe HASP remplace le fichier


original par sa version protge. Pour viter d'craser votre fichier

Programme dEnveloppe DOS et Win16

5-25

original, vous pouvez spcifier un nom diffrent pour l'application


protge. Saisissez alors ce nom dans le champ Output Filename.

NetHASP Password
Lorsque vous protgez une application avec une cl NetHASP,
saisissez les Mots de Passe associs la cl NetHASP.

Program Number (NetHASP/FAS)


Valeur par dfaut: 0

Si vous utilisez une cl NetHASP ou une cl monoposte mmoire


pour protger plusieurs applications avec le FAS, entrez le numro
unique que vous dsirez assigner cette application.
Ce Numro de Programme peut galement tre saisi partir du
programme HaspEdit. Si c'est le cas, entrez ce nombre dans le champ
Program Number (NetHASP/FAS). (Pour plus de dtails sur le
Numro de Programme, reportez-vous au chapitre 13. Pour le FAS,
reportez-vous la page 5-43.)
Tableau 5.5: Valeurs Possibles du Numro de Programme
Type de Cl

Valeurs Possibles

MemoHASP-1

1 16

MemoHASP-4

1 112

TimeHASP

18

TimeHASP-4

18

NetHASP

1 112

5-26

Protection par Enveloppe

HASP-3 Passwords
Saisissez les Mots de Passe de toutes les cls HASP-3 avec lesquelles
vous dsirez protger l'application. Gnralement, une seule cl HASP
est utilise, mais il est possible d'utiliser jusqu' trois cls HASP-3
diffrentes.

MemoHASP/TimeHASP Passwords
Saisissez
les
Mots
de
Passe
de
toutes
les
cls
MemoHASP/MemoHASP-4/TimeHASP/TimeHASP-4 avec lesquelles
vous dsirez protger l'application. Gnralement, une seule cl
MemoHASP/MemoHASP-4/TimeHASP/TimeHASP-4 est utilise, mais
il est possible d'utiliser jusqu' trois cls HASP diffrentes.

Protect with HASP ID Number


Utilisez ce champ si vous dsirez que l'application protge ne
fonctionne que si la cl HASP avec le Numro d'Identification indiqu
est connecte l'ordinateur. Cette option n'est disponible qu'avec des
cls HASP monopostes mmoire.
Il existe deux mthodes de saisie des Numros d'Identification : l'une
automatique, l'autre manuelle. La mthode de dtection automatique
permet au programme d'Enveloppe de lire le Numro d'Identification
de la cl HASP actuellement connecte sur port parallle. Sinon, vous
pouvez rcuprer le Numro d'Identification HASP de la cl l'aide
du programme HaspEdit et saisir ce numro manuellement. Le
Numro d'Identification est un entier 32 bits non sign qui doit tre
entr en notation hexadcimale.

Programme dEnveloppe DOS et Win16

Note:

5-27

Lorsque vous protgez une application avec plusieurs cls


MemoHASP
ou
TimeHASP,
utilisez
le
Numro
d'Identification de la cl dont les Mots de Passe ont t saisis
en premier. Les Numro d'Identifications des autres cls ne
seront pas vrifis.

Target Computer
Valeur par dfaut: IBM

Ce champ vous permet de prciser sur quel type d'ordinateur va


tourner l'application protge. La valeur par dfaut de ce champ est
IBM. Si l'ordinateur sur lequel va s'excuter le programme est un
NEC, modifiez la valeur du champ en consquence.

Full Authorization System


Valeur par dfaut: No

Vous ne pouvez utiliser le Full Authorization System (FAS) quavec


des cls MemoHASP, TimeHASP ou TimeHASP-4 (Pour plus
d'informations sur le FAS, reportez-vous la page 5-43).
Si vous utilisez le FAS, modifier la valeur du champ Yes.

cran Special Overlays Mode


Pour accder l'cran Special Overlays Mode du programme
d'Enveloppe DOS :
Cliquez sur le bouton Special Overlays Mode de l'cran
Principal.

5-28

Protection par Enveloppe

Special Overlays Mode


Applicable pour: Programme dEnveloppe DOS
Valeur par dfaut: No

Vous devez utiliser cette option si :


votre programme DOS contient des overlays et a t li avec un
linker d'overlay (Plink ou .RTLink, par exemple)
l'application fonctionne sous un DOS extender.
Pressez sur la touche <Espace> dans champ Special Overlays Mode,
pour faire dfiler les diffrentes valeurs.
Ce champ peut avoir l'une des valeurs ci-dessous :
NO
YES Default Method
YES Method1
Lorsque vous choisissez la valeur YES Default Method ou YES
Method1, le programme d'Enveloppe cre un fichier de chargement
(dans le rpertoire de l'application que vous protgez actuellement), et
code le fichier de l'application originale. Aprs la protection par
Enveloppe, le seul moyen de lancer l'application protge est
d'excuter le module de chargement. Ce module charge l'application
en mmoire, la dcode et l'excute.
Lorsque vous excutez le programme de chargement sans cl HASP
ou sans la cl requise pour l'Enveloppe, il n'active pas l'application
protge et affiche un message d'erreur.

Programme dEnveloppe DOS et Win16

5-29

Comme des DOS extender fonctionnent diffremment, il est


difficile de prvoir quelles valeurs utiliser dans le champ
Special Overlays Mode.
Vous trouvez ci-aprs quatre configurations des champs
Special Overlays Mode et Encrypt Protected File. La
description indique comment chaque mthode gre
l'application, les overlays ou le DOS extender. (Reportez-vous
la page 5-32 pour plus de dtails sur le champ Encrypt
Protected File.)
Special Overlays Mode = YES Default Method
Encrypt Protected File = YES
Code lapplication et le chargeur.
Special Overlays Mode = YES Default Method
Encrypt Protected File = NO
Code l'application, mais pas le chargeur. La scurit n'est
pas diminue tant donn que l'application elle-mme est
code.
Special Overlays Mode = YES Method1
Encrypt Protected File = YES
Code le chargeur mais pas lapplication.
Special Overlays Mode = YES Method1
Encrypt Protected File = NO
Ni le chargeur ni l'application ne sont cods.

Loader Filename
Applicable pour: Programme dEnveloppe DOS
Valeur par dfaut: haspexec.exe

Le champ Loader Filename vous permet de choisir le nom du


module de chargement de votre application.
Le chargeur recherche d'abord l'application protge dans le
rpertoire courant. S'il ne la trouve, il cherchera dans le rpertoire o

5-30

Protection par Enveloppe

se trouve lapplication (chemin complet) et finalement dans le chemin


spcifi par la commande path du DOS.

Note:

Le nom du chargeur doit tre de taille suprieur ou gale


celle de l'application qu'il charge.

Programme dEnveloppe DOS et Win16

5-31

cran Advanced Options


Pour accder l'cran Advanced Options des Programmes
d'Enveloppe DOS et Win16 :
Cliquez sur le bouton Advanced Options de l'cran Principal.
L'cran Advanced Options apparat alors :

HASP Protection Mode


Valeur par dfaut: Full

Il existe deux types de protection par Enveloppe: Full et Easy.


En protection Full, seule une cl HASP avec un Code Dveloppeur
spcifique peut ouvrir l'application. La protection Easy signifie que
n'importe quelle cl HASP, indpendamment de son Code
Dveloppeur peut ouvrir l'application.
La plupart des applications sont protges en mode de protection Full
. La protection Easy ne s'emploie que si vous dsirez autoriser
l'excution du programme avec plusieurs cls diffrentes. Avec la
protection Easy, vous pouvez utiliser la protection par API pour

5-32

Protection par Enveloppe

dterminer comment ragira votre programme selon le Code


Dveloppeur de la cl connecte.

Attention
N'utilisez pas la protection Easy sauf si vous dsirez que votre application se lance
avec n'importe quelle cl HASP, y compris une cl HASP de Dmo.

Encrypt Protected File


Valeur par dfaut: Yes

Cette option vous permet de protger votre application en codant le


fichier excutable.

Attention
Les applications modifiant leur propre fichier durant leur excution ne doivent pas
tre codes.

Encryption Key
Le processus de codage ncessite plusieurs cls de codage choisie
alatoirement par le programme d'Enveloppe HASP. Pour vous
assurer une protection maximale, vous pouvez dfinir vous-mme
l'une des cls de codage en choisissant une valeur entre 0 et 65535.

Programme dEnveloppe DOS et Win16

5-33

Automatic Virus Detection


Applicable pour: Programme dEnveloppe DOS
Valeur par dfaut: Yes

Cette option initialise la recherche automatique de virus et la


vrification de modification du fichier protg. Lorsque l'application
est excute, elle affiche un message d'alerte si elle est infecte.

Note:

Si vous protgez la mme application plus d'une fois avec le


programme d'Enveloppe, n'activez l'option de dtection de
virus que sur la dernire protection.

NetHASP Configuration File


Valeur par dfaut: nethasp.ini

Vous pouvez prciser le nom du fichier de configuration (un fichier


texte) du systme NetHASP. (Pour plus d'informations sur le Fichier
de Configuration NetHASP, reportez-vous l'annexe C.)

Note:

L'Enveloppe utilise le Fichier de Configuration NetHASP s'il


existe. Sinon, elle utilise les valeurs par dfaut du systme
NetHASP.

Random File Size


Applicable pour: Programme dEnveloppe DOS
Valeur par dfaut: Yes

A chaque protection d'un fichier excutable, le programme


d'Enveloppe en modifie alatoirement sa taille. Lorsque vous protgez
des applications DOS, vous pouvez dsactiver cette option de
modification alatoire de la taille du fichier. Si vous basculez le champ
Random File Size No, la taille du fichier protg sera invariable
d'une protection l'autre.

5-34

Protection par Enveloppe

cran Edit Error Messages


Pour accder l'cran Edit Error Messages des programmes
d'Enveloppe DOS et Win16 :
Cliquez sur le bouton Edit Error Messages de l'cran Principal.

Envelope Error Messages


Valeur par dfaut: (voir tableau 5.6)

Lorsque l'intgrit d'une application protge a t viole, l'Enveloppe


affiche un message d'erreur.
L'diteur de Messages d'Erreur HASP permet de remplacer les
messages d'erreur par dfaut. Par exemple, vous pouvez afficher les
messages dans une autre langue.

En plus des messages d'erreur, vous pouvez modifier les


codes de sortie HASP. Si votre application utilise les mmes
codes de sortie que HASP, vous pouvez renumroter les codes
HASP.

Pour personnaliser un message derreur :


Remplacez le message existant et appuyez sur la touche
<Entre>.
Tableau 5.6: Messages dErreur originaux
Messages dErreur
Originaux

Explication

Code de
Sortie

HASP key not found.

Il n'y a pas de cl HASP connecte

HASP Driver not installed.

Le Gestionnaire de Priphrique HASP n'est pas install


ou n'est pas compatible avec la version de l'Enveloppe
DOS.

No answer from the

Cl NetHASP uniquement. Le Gestionnaire de Licence

Programme dEnveloppe DOS et Win16

Messages dErreur
Originaux

Explication

Code de
Sortie

NetHASP License Manager.

NetHASP
ne
rpond
Il y a un problme de communication.

No authorization to run this


program.

Une cl HASP monoposte avec le FAS, ou une cl


NetHASP est utilise, mais l'application n'est pas dans la
liste des programmes autoriss.

Too many users are


currently using the program.

Cl NetHASP uniquement. Une application essaie de se


lancer alors que le nombre maximum de stations
autorises
est
dj
atteint.
Attendez qu'une station effectue un LOGOUT NetHASP
et ressayez.

The program is out of


runtimes.

Une cl HASP monoposte avec le FAS, ou une cl


NetHASP est utilise, mais le nombre de lancements
autoriss est dpass.

The program's runtime date


has expired.

Cl TimeHASP uniquement. La date limite d'utilisation de


l'application est dpasse.

The program is infected by a


virus.

L'application protge a dtect qu'elle est infecte par


un virus ou a t modifie par un virus.

pas.

5-35

5-36

Protection par Enveloppe

Protection en Ligne de Commande


Vous pouvez lancer les programmes dEnveloppe DOS et Win16
partir d'un fichier batch, sans utiliser l'interface Enveloppe, en
spcifiant les options de protection par des paramtres dans la ligne
de commande. Sauf spcification contraire, le programme d'Enveloppe
protge l'application avec les valeurs par dfaut de chaque option.
La liste suivante dcrit les diffrentes paramtres de la ligne de
commande. Il existe un paramtre pour chacune des fonctions dcrites
dans la section Champs du Programme d'Enveloppe.

-help
Affiche une liste de tous les paramtres, avec une courte description.

-?
Affiche une liste de tous les paramtres, avec une courte description.

-env
Protge avec l'Enveloppe.

-prg <filename>
Spcifie le fichier protger.

-out <filename>
Renomme le fichier protg.

-nhpass <password1> <password2>


Spcifie les mots de passe NetHASP.

Protection en Ligne de Commande

5-37

-prgnum <program number>


Spcifie le Numro de Programme FAS ou NetHASP.

-h3pass <password1> <password2>


Spcifie les mots de passe HASP-3.

-mhpass <password1> <password2>


Spcifie les mots de passe MemoHASP, TimeHASP ou TimeHASP-4.

-mhid <ID Number>


Spcifie le Numro d'Identification HASP de la cl MemoHASP,
TimeHASP ou TimeHASP-4 permettant l'ouverture de l'application.

-ibm
Valeur par dfaut. La plate-forme cible est un IBM PC ou compatible.

-nec
La plate-forme cible est un NEC.

-nofas
Valeur par dfaut. Ne pas utiliser le Full Authorization System (FAS).

-fas
Utilisation du Full Authorization System (FAS).

5-38

Protection par Enveloppe

-nospecial
Valeur par dfaut. A utiliser avec une application ne contenant pas
doverlays.
Identique Special Overlays Mode = NO.
Ce paramtre n'est valable que pour l'Enveloppe DOS.

-special
Gestion des overlays et des DOS extenders.
Identique Special Overlays Mode = YES Default Method.
Ce paramtre n'est valable que pour l'Enveloppe DOS.

-special1
Autre gestion des overlays.
Identique Special Overlays Mode = YES Method 1.
Ce paramtre n'est valable que pour l'Enveloppe DOS.

-loader <filename>
Spcifie le nom du chargeur lors de la protection d'une application
avec overlays.
Ce paramtre n'est valable que pour l'Enveloppe DOS.

-h3hard
Valeur par dfaut. Mode de protection Full.

-h3easy
Mode de protection Easy.

Protection en Ligne de Commande

5-39

-enc
Valeur par dfaut. Codage du fichier durant la protection.

-noenc
Pas de codage du fichier durant la protection.

-enckey <number>
Spcifie une cl de codage.

-vir
Valeur par dfaut. Protection automatique contre les virus.
Ce paramtre n'est valable que pour l'Enveloppe DOS.

-novir
Pas de protection automatique contre les virus.
Ce paramtre n'est valable que pour l'Enveloppe DOS.

-cfgfile <filename>
Charge un fichier de configuration et utilise les paramtres qu'il
contient.

-netcfg <filename>
Spcifie un Fichier de Configuration NetHASP.
d'informations, reportez-vous l'annexe C.)

-randomsize
Valeur par dfaut. Active l'option de taille alatoire du fichier.
Ce paramtre n'est valable que pour l'Enveloppe DOS.

(Pour

plus

5-40

Protection par Enveloppe

-norandomsize
Dsactive l'option de taille alatoire du fichier.
Ce paramtre n'est valable que pour l'Enveloppe DOS.

-ec1 <number>
Spcifie un code de sortie pour le message HASP key not found.

-ec2 <number>
Spcifie un code de sortie pour le message HASP Driver is not
installed.

-ec3 <number>
Spcifie un code de sortie pour le message No answer from the
NetHASP License Manager.

-ec4 <number>
Spcifie un code de sortie pour le message No authorization to run
this program.

-ec5 <number>
Spcifie un code de sortie pour le message Too many users are
currently using the program.

-ec6 <number>
Spcifie un code de sortie pour le message The program is out of
runtimes.

Protection en Ligne de Commande

5-41

-ec7 <number>
Spcifie un code de sortie pour le message The program's runtime
date has expired.

-ec8 <number>
Spcifie un code de sortie pour le message The program is infected by
a virus.
Ce paramtre n'est valable que pour l'Enveloppe DOS.

-pcs
Installe le PCS.
Ce paramtre n'est valable que pour l'Enveloppe DOS. (Pour plus
d'informations sur le PCS, reportez-vous au chapitre 12.)

-bw
Lance le Programme d'Enveloppe en mode Noir & Blanc. Utilisez
cette option avec des moniteurs sur lesquels le programme
d'Enveloppe n'est pas affich correctement.

-xcode
Ce paramtre vous permet de choisir une autre mthode gestion des
fichiers excutables si l'Enveloppe ne fonctionne pas.
Cette option n'est disponible qu'avec le programme d'Enveloppe
Windows. N'utilisez cette option que si votre application ne fonctionne
pas sans elle.

5-42

Protection par Enveloppe

Exemples dUtilisation en Ligne de Commande


Les exemples suivants illustrent l'utilisation des paramtres du
programme d'Enveloppe.

whinst -env -prg abc.exe -mhpass 15417 9632

Cet exemple montre comment protger une application Windows


nomme abc.exe avec une cl MemoHASP, TimeHASP ou
TimeHASP-4 avec le programme d'Enveloppe Windows. Seule la cl
HASP possdant les mots de passe 15417 et 9632 permettra
l'excution de l'application.

haspinst -env -cfgfile myconfig.cfg

Cet exemple montre comment protger une application DOS avec le


programme d'Enveloppe DOS. Dans ce cas, tous les paramtres sont
lus dans le fichier de configuration myconfig.cfg.

haspinst -cfgfile myconfig.cfg

Dans cet exemple, le paramtre -env n'est pas spcifi, de ce fait, la


protection par Enveloppe ne se fera pas en mode ligne de commande.
L'cran principal du programme d'Enveloppe apparatra avec les
champs contenant les valeurs lues dans le fichier de configuration
myconfig.cfg.
Note
NetHASP:

L'exemple suivant montre l'utilisation de paramtres pour


une protection avec une cl NetHASP.
haspinst -env -prg abc.exe -prgnum 1 -nhpass 15417 9632
Le programme abc.exe est protg avec une cl NetHASP et
le programme d'Enveloppe DOS. Dans cet exemple, abc.exe
est dfini comme le programme numro 1 dans la mmoire
NetHASP.

FAS The Full Authorization System

5-43

FAS The Full Authorization System


Quest-ce que le FAS?
FAS est un outil puissant vous permettant de protger plusieurs
applications avec une seule cl. Vous pouvez galement limiter
l'utilisation de votre application, en dfinissant le nombre de
lancements (MemoHASP) ou une date d'expiration du programme
(TimeHASP and TimeHASP-4). Une application, protge avec une
Enveloppe HASP intgrant FAS, effectue les vrifications suivantes
lors de son lancement :
L'application protge vrifie d'abord si la bonne cl HASP est
connect l'ordinateur. Sinon, l'application s'arrte avec un
message d'erreur.
Si la bonne cl HASP est prsente, le systme analyse la mmoire
de la cl HASP pour vrifier que l'application est autorise ce
lancer (voir chapitre 13).
Applications de dmo protges avec une MemoHASP : Si
vous avec limit le nombre d'excutions de l'application, le systme
vrifie que ce nombre n'est pas dpass.
A chaque lancement, le nombre de lancements autoriss est
dcrment d'une unit. Lorsque le nombre de lancements
autoriss atteint zro, l'application s'arrte avec un message
d'erreur.
Logiciel en location avec une cl TimeHASP ou
TimeHASP-4 : Si vous avez dfini une date d'expiration pour
votre application, elle vrifie la date dans l'horloge temps-rel de
la cl. Si l'application a atteint la date d'expiration, elle s'arrte
avec un message d'erreur.

5-44

Protection par Enveloppe

tapes de l'Implmentation du FAS


La mise place du FAS comprend deux tapes :
tape 1:

Protgez chaque application sparment avec le


programme d'Enveloppe. Dans le champ Program
Number , dfinissez un numro de programme unique
pour chaque application. Basculez le champ Full
Authorization System sur Yes.

tape 2:

Utilisez le programme HaspEdit pour dfinir la liste


d'autorisation (authorization list) du FAS (voir chapitre
13). La liste d'autorisation dfinit les applications
pouvant tre excutes avec la cl, et :
avec MemoHASP le nombre de lancements
autoriss pour chaque application.
avec
TimeHASP et TimeHASP-4 la date
d'expiration de chaque application.

Note:

Pour les applications Win32, l'tape 2 peut se faire via


le programme d'Enveloppe au lieu du programme
HaspEdit. Dans ce cas, entrez les paramtres dans les
champs appropris et choisissez l'option Program
HASP pour sauvegarder les paramtres de protection.

Protection de Logiciel sur des PC Isols ou en Rseau

5-45

Protection de Logiciel sur des PC Isols ou en Rseau


L'Enveloppe vous permet de protger votre application pour des
environnements rseau et PC isols.
Lorsque vous excutez une application protge pour rseau et PC,
votre application effectue les tests suivants :
Premirement, l'application vrifie qu'une cl HASP est connecte
sur l'ordinateur o est excute l'application.
Si l'application ne trouve pas de cl sur l'ordinateur, elle parcourra
le rseau la recherche d'une cl NetHASP.
Pour autoriser la protection par Enveloppe sur rseau et PC
isol :
Entrez les mots de passe de la cl NetHASP et de la cl HASP
monoposte dans les champs correspondants.

5-46

Protection par Enveloppe

Considrations NetHASP
LOGOUT NetHASP
Lorsque une application est lance, l'Enveloppe effectue
automatiquement un appel au Gestionnaire de Licence NetHASP avec
un LOGIN NetHASP, en demandant la permission de se lancer. Une
application protge par une Enveloppe DOS ou Windows, sans API
NetHASP, ne peut effectuer de LOGOUT NetHASP. Par contre, une
application protge par une Enveloppe Win32 effectue LOGOUT
NetHASP.

Temps de Disponibilit
Pour une application protge par Enveloppe, le temps partir
duquel une station est considre comme disponible, est le temps de
disponibilit par dfaut du Gestionnaire de Licence NetHASP (voir le
service 48 au chapitre 10).

Questions Frquemment Poses (FAQ)

5-47

Questions Frquemment Poses (FAQ)


Question:

Combien de temps faut-il pour charger en mmoire une


application protge par Enveloppe ?

Rponse:

Cela dpend de la taille de l'application et des performances de


l'ordinateur, mais le temps de chargement n'est augment que de
quelques secondes.

Question:

Le mcanisme d'anti-dbogage HASP interfre-t'il avec le


fonctionnement normal du PC ?

Rponse:

Non. Le mcanisme d'anti-dbogage HASP est compltement


transparent et n'a aucun effet sur l'excution de l'application.

Question:

L'Enveloppe HASP vrifie-t'elle la prsence de la cl


durant l'excution du programme ?

Rponse:

Oui. L'Enveloppe Win32 peut effectuer diffrentes vrifications de


la cl HASP en tche de fond durant l'excution de l'application.
Pour plus d'informations, reportez-vous l'option Background
HASP Checks dans la description des champs du programme
d'Enveloppe Win32.

5-48

Protection par Enveloppe

Chapitre 6 - Protection avec lAPI


LInterface de Programmation dapplication (API) HASP est compose
d'un fichier objet que vous pouvez lier votre application, ou d'une
DLL que vous appelez dans votre application. Comme l'API est la
fois protge et code, elle vous offre un trs au niveau de scurit.
L'API vous permet d'insrer des appels la cl HASP dans votre
application, en augmentant ainsi son niveau de scurit. A n'importe
quel endroit de votre application, vous pouvez vrifier la prsence de
la cl et dcider comment ragir en fonction du rsultat de la
recherche. Vous pouvez galement accder au contenu de la mmoire
de la cl HASP pour y lire ou stocker des donnes sensibles. Avec les
cls TimeHASP et TimeHASP-4, vous pouvez consulter l'horloge
temps-rel qu'elles contiennent.

Note:

Afin d'utiliser l'API HASP, vous devez installer le


Gestionnaire
de
Priphrique
HASP.
Pour
plus
d'informations sur le Gestionnaire de Priphrique HASP,
reportez-vous au chapitre 14.

Avant de protger votre application avec l'API HASP, nous vous


recommandons de vrifier les fichiers API correspondant votre
compilateur. Chaque interface HASP comprend un exemple
d'application montrant l'utilisation de l'API.
Si le compilateur que vous possdez est incompatible avec les
interfaces API HASP proposes, nous vous recommandons de :
Utiliser une interface utilisant le mme type fichiers d'objet que
votre compilateur.
Utilisez une DLL (pour les applications Windows, Win32 et OS/2).
Utiliser le Gestionnaire Rsident (pour les applications DOS
uniquement voir annexe B).
6-1

6-2

Protection avec lAPI

Utilisation de lAPI
Avant dutiliser lAPI, utilisez le programme HaspEdit (voir chapitre
13) pour vrifier les points suivants :
Dfinition des Codes de Retour attendus pour un Seed
Code donn : Avec l'API, vous pouvez vrifier la prsence de la
bonne cl HASP en vrifiant ces Codes de Retour.
Modifier la mmoire HASP : Si vous protgez votre application
avec une cl mmoire, et dcidez d'y stocker des donnes
sensibles, notez les donnes stockes chaque adresse mmoire.
Avec l'API, vous pouvez accder la mmoire en lecture et
criture une adresse prcise.
Dtermination du Numro d'Identification HASP : Si vous
protgez votre application avec une cl mmoire, dterminez le
Numro d'Identification HASP de chacune des cls utilises. Avec
l'API, vous pouvez vrifier la prsence d'une cl HASP prcise en
consultant son Numro d'Identification. Vous pouvez vrifier le
Numro d'Identification pour, par exemple, contrle l'accs
certains modules de votre application.

La Routine hasp( )
La routine hasp( ) vous permet d'incorporer la protection API votre
application. La routine hasp( ) vrifie la prsence d'une cl HASP,
renvoie des Codes de Retour pour un Seed Code (germe) donn et
permet d'accder la mmoire des cls HASP mmoire pour des
oprations de lecture et d'criture.
tous les appels l'API se font via la routine hasp( ) de la faon
suivante :
hasp (Service, SeedCode, LptNum, Password1, Password2, Par1, Par2, Par3, Par4)

La routine hasp( ) accepte neuf paramtres. Le premier, Service,


dtermine le type d'opration effectu par la routine. Les chapitres 7,
8, 9 et 10 dcrivent en dtail les diffrents services disponibles pour
les cl HASP.

Utilisation de lAPI

6-3

Il arrive quelques fois qu'un service ne puisse tre activ ou


ne fonctionne pas correctement. Dans ce cas, appelez la
routine hasp( ) avec un service plusieurs fois de suite avec de
conclure que la cl n'est HASP n'est pas connecte. Agissez en
consquence si la rponse est invariablement invalide.

Spcification du Port Parallle


Le paramtre LptNum permet de spcifier le port parallle sur lequel
rechercher la cl HASP.
Note
NetHASP:

Avec une cl NetHASP, la routine hasp( ) utilise le


paramtre ProgNum la place du paramtre LptNum.
Les application protges par NetHASP analysent tous
les ports parallles. De ce fait, si vous utilisez NetHASP,
vous pouvez passer cette section.

Si le paramtre LptNum est fix 0, l'application protge recherche


la cl HASP sur tous les ports parallles dans l'ordre suivant : 378h,
278h et 3BCh. Lorsque l'application trouve la cl HASP, la recherche
se termine automatiquement.
Vous pouvez rechercher la cl HASP sur un port parallle prcis ou
directement l'adresse matrielle (en outrepassant la zone de
donnes du BIOS). Le tableau suivant indique les diffrentes valeurs
possibles du paramtre LptNum.
Tableau 6.1: Valeurs de LptNum et ports parallles recherchs
LptNum

Port Recherch

Recherche automatique sur tous les ports

LPT1 uniquement

LPT2 uniquement

LPT3 uniquement

6-4

Protection avec lAPI

LptNum

Port Recherch

101*

03BCh uniquement

102*

0378h uniquement

103*

0278h uniquement

* Applicable uniquement pour les applications DOS et Windows 16-bit fonctionnant sous DOS extenders ou
Windows (16-bit).

Services HASP de Base


Trois services de base sont disponibles pour toutes les cls monopostes
(voir tableau 6.2). Pour une description dtaille de ces services,
reportez-vous au chapitre 7.
Tableau 6.2: Services HASP de base Description
Service

Nom

Fonction

IsHasp

Vrifie si une cl HASP est connecte l'ordinateur.

HaspCode

Renvoie les Codes de Retour pour un Seed Code donn.

HaspStatus

Vrifie le type de cl HASP connect l'ordinateur.

Vrifie sur quel port parallle est connect la cl.

Vrifie la taille de la mmoire des cls HASP mmoire.

Services MemoHASP

6-5

Services MemoHASP
En plus des services HASP de base, MemoHASP offre les services
indiqus dans le tableau 6.3. Pour une description dtaille de ces
services, reportez-vous au chapitre 8.
Tableau 6.3: Services MemoHASP Description
Service

Nom

Fonction

ReadWord

Lit un mot de donnes dans la mmoire HASP.

WriteWord

Ecrit un mot de donnes dans la mmoire HASP.

HaspID

Rcupre le Numro d'Identification HASP.

50

ReadBlock

Lit un bloc de donnes dans la mmoire HASP.

51

WriteBlock

Ecrit un bloc de donnes dans la mmoire HASP.

Vous pouvez utiliser les services 3, 4, 50 et 51 pour accder


aux 248-mots de la mmoire de la TimeHASP-4.

6-6

Protection avec lAPI

Services TimeHASP
Avec les cl TimeHASP, vous pouvez utiliser les services HASP de
base ainsi que les services indiqus dans le tableau 6.4. Pour plus
d'informations sur les services TimeHASP, reportez-vous au chapitre
9.
Tableau 6.4: Services TimeHASP Description
Service

Nom

Fonction

70

SetTime

Met l'horloge TimeHASP une heure donne.

71

GetTime

Lit l'heure de l'horloge TimeHASP.

72

SetDate

Met l'horloge TimeHASP une date donne.

73

GetDate

Lit la date de l'horloge TimeHASP.

74

WriteByte

Ecrit un octet de donnes dans la mmoire TimeHASP.

75

ReadByte

Lit un octet de donnes de la mmoire TimeHASP.

76

WriteBlock

Ecrit un bloc de donnes dans la mmoire TimeHASP.

77

ReadBlock

Lit un bloc de donnes de la mmoire TimeHASP.

78

GetHaspID

Rcupre le Numro d'Identification de la TimeHASP.

Si vous protgez votre application avec une TimeHASP-4, utilisez les


services 74 77 pour accder aux 16 octets de mmoire. Utilisez les
services MemoHASP 3, 4, 50 et 51 pour accder aux 248 mots de
mmoire.

Avec une cl TimeHASP ou TimeHASP-4, vous pouvez soit


utiliser le service 6 MemoHASP ou le service 78 TimeHASP
pour dterminer le Numro d'Identification de la cl.

Services NetHASP

6-7

Services NetHASP
Avec le cl NetHASP, vous pouvez utiliser les services du tableau 6.5.
Pour plus de dtails, reportez-vous au chapitre 10.
Tableau 6.5: Services NetHASP Description
Service

Nom

Fonction

40

LastStatus

Retourne l'tat du dernier appel. Utilisez ce service aprs


chaque appel la routine hasp( ).

41

HaspCode

Renvoie les Codes de Retour pour un Seed Code donn.

42

LOGIN

Demande une permission de lancement de l'application au


Gestionnaire de Licence NetHASP.
Sauf si vous utilisez les services 85 ou 96, le LOGIN doit tre le
premier appel la routine hasp().

43

LOGOUT

Demande une fin de session NetHASP au Gestionnaire de


Licence NetHASP. L'utilisation du LOGOUT n'est pas
obligatoire , mais recommand.

44

ReadWord

Lit un mot de donnes de la mmoire NetHASP.

45

WriteWord

Ecrit un mot de donnes dans la mmoire NetHASP.

46

HaspID

Rcupre le Numro d'Identification NetHASP.

48

IdleTime

Dfini la priode maximale avant la mise en disponibilit des


stations.

52

ReadBlock

Lit un mot de donnes de la mmoire NetHASP.

53

WriteBlock

Ecrit un bloc de donnes dans la mmoire NetHASP.

85

SetConfigFilename

Dfini le nom du Fichier de Configuration NetHASP.

96

SetServerByName

Dfini le nom du Gestionnaire de Licence NetHASP avec lequel


l'application protge doit effectuer son LOGIN NetHASP.

6-8

Protection avec lAPI

Note:

Pour accder une cl NetHASP connecte au port parallle


local, vous pouvez utiliser les services HASP de base ainsi
que les services MemoHASP.

Utilisation des Services NetHASP


Avec l'API NetHASP, certains services doivent tre appels avant ou
aprs les autres comme indiqu ci-dessous :
1. ventuellement, appelez la routine hasp( ) avec le service
SetConfigFilename suivi du service LastStatus.
2. ventuellement, appelez la routine hasp( ) avec le service
SetServerByName suivi du service LastStatus.
3. Appelez la routine hasp( ) avec le service LOGIN suivi du service
LastStatus.
4. Une fois le service LOGIN utilis, vous tes libre d'appeler
n'importe lequel des services NetHASP service. Aprs chaque
service, appelez la routine hasp( ) avec le service LastStatus.
5. Appelez la routine hasp( ) avec le service LOGOUT suivi du service
LastStatus.

Protection de Logiciels pour Stations en Rseau ou Isols

6-9

Attention
Avec le protocole TCP/IP, une application Windows 16-bit appelant la routine hasp( )
prend automatiquement le contrle tant que la routine est active. Le contrle est
obtenu via une boucle de message plutt que via l'instruction suivant l'appel la
routine hasp( ).
Tant que le contrle est tabli via l'instruction suivant l'appel la routine hasp( ),
assurez-vous de ne pas faire d'autre appel la routine hasp( ). Sinon, votre
application crashera. Pour viter cette situation, utilisez des drapeaux pour viter
que de nouveaux appels la routine hasp( ) tant que les appels prcdents sont en
cours.

Protection de Logiciels pour Stations


en Rseau ou Isols
L'API vous permet de protger des applications pour ordinateurs en
environnement rseau ou isols.
Pour autoriser la protection par API sur des PC en rseau ou
isols :
Utilisez les services HASP de base, MemoHASP et TimeHASP
pour vrifier la prsence de la cl monoposte sur le port parallle
local de l'ordinateur.
Si la bonne cl HASP monoposte n'est pas prsente, utilisez les
services NetHASP pour rechercher la cl NetHASP.

6-10

Protection avec lAPI

Questions Frquemment Poses (FAQ)


Question:

Qu'elle est la dure d'une vrification HASP ?

Rponse:

Avec des cls HASP monopostes, un appel la routine hasp( )


prend environ 20 millisecondes. Avec NetHASP, un LOGIN
NetHASP prend approximativement deux secondes, selon le trafic
sur le rseau. Les appels aux autres services NetHASP requirent
environ une demie seconde. Comme le montrent ces chiffres, vous
pouvez faire autant d'appels la routine hasp( ) que vous le
dsirez.

Question:

Le systme HASP vite-t'il le trace du code ?

Rponse:

Plus de 60% de nos routines sont spcialement conues pour viter


que les pirates ne puissent tracer le code des applications
protges. Naturellement, nous ne pouvons pas rvler notre
savoir faire dans ce domaine, mais voici quand mme quelques
exemples.
Dplacement des interruptions du debogueur, rendant difficile
le lancement du dbogueur lui-mme
Piges spciaux contre les dbogueurs matriels
Code autognr difficile pister
Piges temporiss
Un mcanisme de protection puissant (PCS) implment par le
dveloppeur
Mises jour frquentes des logiciels incorporant de nouvelles
fonctionnalits et une augmentation de la scurit

Questions Frquemment Poses (FAQ)

6-11

Question:

Le langage de programmation ou le compilateur que


l'utilise n'est pas compatibles avec les diffrents langages
et compilateurs supports par HASP. Comment puis-je
protger mon logiciel ?

Rponse:

Dans ce cas, nous vous suggrons de :

Utiliser une interface utilisant le mme type fichiers d'objet


que votre compilateur.

Utilisez une DLL (pour les applications Windows, Win32 et


OS/2).

Utiliser le Gestionnaire Rsident (pour les applications DOS


uniquement voir annexe B).
Consulter votre distributeur HASP. De nouvelles interfaces
sont constamment ajoutes dans la gamme HASP.
Utiliser la protection par Enveloppe.

6-12

Protection avec lAPI

Question:

Mon application protge par API renvoie des Codes de


Retour ngatifs . Pour le mme Seed Code, le programme
HaspEdit renvoie des valeurs positives. Pourquoi ?

Rponse:

Les Codes de Retour affichs dans le programme HaspEdit sont


des entiers non signs (compris entre 0 et 65535). Vous avez
probablement dfini, dans votre application, les Codes de Retour
comme des entiers signs (compris entre -32768 et +32767).
Il y a deux solutions pour rgler ce problme :
Soit, vous dfinissez les Codes de Retour de votre application
comme des entiers non signs.
Soit, vous utilisez la formule suivante pour transformer un
Code de Retour ngatif renvoy par la routine hasp( ) en Code
de Retour Positif :
Code de Retour Positif = 65536 + Code de Retour Ngatif
Les Codes de Retour positifs correspondront alors avec les Codes
de Retour affichs par le programme HaspEdit.

Question:

Comment puis-je protger une DLL avec HASP ?

Question:

J'utilise l'API pour vrifier le Numro d'Identification


HASP. Quelques fois, le Numro d'Identification retourn
est ngatif dans IDLow. Lorsque je calcule le Numro
d'Identification, j'obtiens une valeur diffrente de celle
obtenue par le programme HaspEdit.

Rponse:

Lorsque IDLow est ngatif, utilisez la formule suivante pour


calculer le Numro d'Identification :
Numro d'Identification = 65536 + IDLow + 65536 * IDHigh

Questions Frquemment Poses (FAQ)

6-13

Question:

J'utilise une cl NetHASP pour protger une seule


application. Les 24 premier mots de la mmoire NetHASP
ne sont pas suffisant. Que faire ?

Rponse:

Les 224 mots de la mmoire NetHASP sont rservs pour les


paramtres de protection des 112 applications que vous pouvez
protger avec une seule cl NetHASP. Comme vous ne protgez
qu'une seule application, vous pouvez utiliser cette partie de
mmoire rserve pour une autre usage. Contactez votre
distributeur HASP et demandez-lui Descriptif de la Mmoire
NetHASP. Utilisez ensuite lAPI NetHASP pour stocker des
donnes dans la partie non utilise de la mmoire.

6-14

Protection avec lAPI

Chapitre 7 - Services de Base de lAPI


HASP
Le tableau des services qui suit est compos de deux lignes :
La ligne d'Appel, A, affiche la liste des paramtres que l'on passe
la routine hasp( ).
La ligne de Retour, R, contient la liste des paramtres
routine hasp( ) renvoie.

Note:

que la

La signification des paramtres Par1, Par2, Par3 et Par4


change selon le service.
Tous les paramtres sont des entiers 16 bits pour les
applications 16-bit.
Tous les paramtres sont des entiers 32 bits pour les
applications 32-bit.

7-1

7-2

Services de Base de lAPI HASP

Tableau 7.1: Services HASP de base et les


paramtres de la routine hasp( )
Service
(Numro du Service)
A

Seed Code

IsHasp (1)

LptNum

Password1

Password2

Par3

Par4

Return
Code 1

Return
Code 2

Return
Code 3

Return
Code 4

Taille de la
Mmoire

Type de cl
HASP

LptNum
Actuel

Cl HASP
Trouve
HaspCode (2)

Seed Code

LptNum

Mot de passe 1

Mot de passe 2

Par2

LptNum

Par1

HaspStatus (5)

LptNum

Mot de passe 1

Mot de passe 2

Service 1: IsHasp
Description
Vrifie si une cl HASP est connecte l'ordinateur.

Cls Utilisables
HASP-3, MemoHASP-1, MemoHASP-4, TimeHASP, TimeHASP-4

Syntaxe
hasp (Service, SeedCode, LptNum, Password1, Password2, Par1, Par2, Par3, Par4)

Paramtres Utiliss
Service:

LptNum:

Valeur indiquant le port parallle sur lequel il faut chercher la cl


HASP.
Valeur recommande: 0 (voir le paragraphe Spcifier le Port au
chapitre 6 pour une liste des valeurs possibles).

Valeurs de Retour
Par1:

Cl HASP Trouve

Service 2: HaspCode

Par 3:

0 Aucune cl HASP connecte l'ordinateur

1 Une cl HASP de type quelconque a t trouve

7-3

Status - Un code indiquant le rsultat de l'opration (reportez-vous au


chapitre 11 pour connatre les valeurs possibles).

Service 2: HaspCode
Description
Dtermine les Codes de Retour (Return Codes) pour un Seed Code
(germe) donn.

Cls Utilisables
HASP-3, MemoHASP-1, MemoHASP-4, TimeHASP, TimeHASP-4

Syntaxe
hasp (Service, SeedCode, LptNum, Password1, Password2, Par1, Par2, Par3, Par4)

Paramtres Utiliss
Service:

SeedCode:

Un entier compris entre 0 et 65535.

LptNum:

Valeur indiquant le port parallle sur lequel il faut chercher la cl


HASP.
Valeur recommande: 0 (voir le paragraphe Spcifier le Port au
chapitre 6 pour une liste des valeurs possibles).

Password1:

Premier Mot de Passe HASP.

Password2:

Second Mot de Passe HASP.

Valeurs de Retour
Par1:

Return Code 1

Par2:

Return Code 2

7-4

Services de Base de lAPI HASP

Par3:

Return Code 3

Par4:

Return Code 4

Commentaires

Utilisez le service HaspCode pour vrifier qu'une cl HASP avec


les mots de passe spcifis est connecte l'ordinateur. Passez le
Seed Code voulu la routine hasp( ), et vrifiez que les Return
Codes sont ceux attendus.

Diffrents Seed Codes renvoient des Return Codes diffrents. Les


Return Codes sont dfinis par le Code Dveloppeur HASP et le
Seed Code.

Utilisez le programme HaspEdit pour vrifier les Return Codes


pour un Seed Code donn.

Service 5: HaspStatus
Description
Vrifie le type de cl HASP connect l'ordinateur. Vrifie galement
sur quel port parallle est connecte la cl.

Cls Utilisables
HASP-3, MemoHASP-1, MemoHASP-4, TimeHASP, TimeHASP-4

Syntaxe
hasp (Service, SeedCode, LptNum, Password1, Password2, Par1, Par2, Par3, Par4)

Paramtres Utiliss
Service:

LptNum:

Valeur indiquant le port parallle sur lequel il faut chercher la cl


HASP.

Service 5: HaspStatus

7-5

Valeur recommande: 0 (voir le paragraphe Spcifier le Port au


chapitre 6 pour une liste des valeurs possibles).
Password1:

Premier Mot de Passe HASP.

Password2:

Second Mot de Passe HASP.

Valeurs de Retour
Par1:

Par2:

Par3:

Taille de la Mmoire

1 MemoHASP-1

4 MemoHASP-4

0 autres cls

Type de cl HASP

0 HASP-3

1 MemoHASP-1 ou MemoHASP-4

3 TimeHASP

5 TimeHASP-4

LptNum Actuel Numro du port parallle sur lequel est connecte


la cl HASP.

Commentaires

Pour minimiser le temps de recherche, utilisez la valeur reue


dans le paramtre Par3 dans les appels suivants la routine
hasp( ).

Si une cl NetHASP est connecte sur le port parallle local, le


service HaspStatus l'identifie comme une cl MemoHASP-4.

7-6

Services de Base de lAPI HASP

Chapitre 8 - Services API MemoHASP


Il y a deux lignes pour chacun des services ci-dessous :
La ligne d'appel, A, indique les paramtres que vous devez passer
la routine hasp( ).
La ligne de retour, R, indique les paramtres que la routine hasp(
) renvoie.

Note:

La signification des paramtres Par1, Par2, Par3 et Par4


change selon le service.
Tous les paramtres sont en 16 bits dans des applications
16-bit.
Tous les paramtres sont en 32 bits dans des applications
32-bit.

8-1

8-2

Services API MemoHASP

Tableau 8.1: Services MemoHASP


et les paramtres de la routine hasp( )
Service
(Numro du Service)
A

Seed
Code

ReadWord (3)

LptNum

Password1

Password2

Par1

LptNum

Password1

Password2

Adresse

R
A

WriteWord (4)

LptNum

Password1

Password2

Adresse

Par2

Par3

Donnes

Etat

Donnes

R
A

Etat
HaspID (6)

LptNum

Password1

Password2

R
A

IDLow

IDHigh

Etat
*Segment du
Buffer

ReadBlock (50)

LptNum

Password1

Password2

Adresse
Dpart

Longueur du
bloc

WriteBlock (51)

LptNum

Password1

Password2

AdresseD
part

Longueur du
bloc

R
A

Par4

Offset du
Buffer

Etat

*Segment du
Buffer

Offset du
Buffer

Etat

* Vous navez pas besoin du Segment du Buffer pour des applications 32-bit.

Service 3: ReadWord
Description
Lit un mot de donnes dans la mmoire de la cl HASP.

Cls Utilisables
MemoHASP-1, MemoHASP-4, TimeHASP-4

Syntaxe
hasp (Service, SeedCode, LptNum, Password1, Password2, Par1, Par2, Par3, Par4)

Paramtres Utiliss
Service:

Service 4: WriteWord

LptNum:

8-3

Valeur indiquant le port parallle sur lequel il faut chercher la cl


HASP.
Valeur recommande: 0 (voir le paragraphe Spcifier le Port au
chapitre 6 pour une liste des valeurs possibles).

Password1:

Premier Mot de Passe HASP.

Password2:

Second Mot de Passe HASP.

Par1:

Adresse L'adresse de la mmoire Hasp laquelle vous dsirez lire


les donnes :

0 55 MemoHASP-1

0 247 MemoHASP-4

0 247 TimeHASP-4

Valeurs de Retour
Par2:

Donnes Un mot de donnes lues de la mmoire HASP.

Par3:

Etat Un code indiquant l'tat de l'opration (voir les valeurs


possibles au chapitre 11).

Service 4: WriteWord
Description
Ecrit un mot de donnes dans la mmoire de la cl HASP.

Cls Utilisables
MemoHASP-1, MemoHASP-4, TimeHASP-4

Syntaxe
hasp (Service, SeedCode, LptNum, Password1, Password2, Par1, Par2, Par3, Par4)

Paramtres Utiliss
Service:

LptNum:

Valeur indiquant le port parallle sur lequel il faut chercher la cl


HASP.
Valeur recommande: 0 (voir le paragraphe Spcifier le Port au
chapitre 6 pour une liste des valeurs possibles).

Password1:

Premier Mot de Passe HASP.

8-4

Services API MemoHASP

Password2:

Second Mot de Passe HASP.

Par1:

Adresse L'adresse de la mmoire laquelle vous dsirez crire :

Par2:

0 55 MemoHASP-1

0 247 MemoHASP-4

0 247 TimeHASP-4

Donnes Un mot de donnes.

Valeurs de Retour
Par3:

Etat Un code indiquant l'tat de l'opration (voir les valeurs


possibles au chapitre 11).

Service 6: HaspID
Description
Determine the HASP ID Number.

Cls Utilisables
MemoHASP-1, MemoHASP-4, TimeHASP-4

Syntaxe
hasp (Service, SeedCode, LptNum, Password1, Password2, Par1, Par2, Par3, Par4)

Paramtres Utiliss
Service:

LptNum:

Valeur indiquant le port parallle sur lequel il faut chercher la cl


HASP.
Valeur recommande: 0 (voir le paragraphe Spcifier le Port au
chapitre 6 pour une liste des valeurs possibles).

Password1:

Premier Mot de Passe HASP.

Password2:

Second Mot de Passe HASP.

Valeurs de Retour
Par1:

IDLow Mot faible (le moins significatif) du Numro d'Identification.

Par2:

IDHigh Mot fort (le plus significatif) du Numro d'Identification.

Par3:

Etat Un code indiquant l'tat de l'opration (voir les valeurs

Service 50: ReadBlock

8-5

possibles au chapitre 11).

Commentaires
Le Numro d'Identification est un entier long (32 bits). Vous pouvez le
calculer de la manire suivante :
Numro d'Identification = IDLow + 65536 * IDHigh,
o IDLow et IDHigh sont des entiers non signs.

Service 50: ReadBlock


Description
Lit un bloc de donnes de la mmoire de la cl HASP.

Cls Utilisables
MemoHASP-1, MemoHASP-4, TimeHASP-4

Syntaxe
hasp (Service, SeedCode, LptNum, Password1, Password2, Par1, Par2, Par3, Par4)

Parameters Used
Service:

50

LptNum:

Valeur indiquant le port parallle sur lequel il faut chercher la cl


HASP.
Valeur recommande: 0 (voir le paragraphe Spcifier le Port au
chapitre 6 pour une liste des valeurs possibles).

Password1:

Premier Mot de Passe HASP.

Password2:

Second Mot de Passe HASP.

Par1:

Adresse de Dpart Dfini l'adresse initiale de la mmoire HASP


pour la lecture du bloc de donnes :

0 55 MemoHASP-1

0 247 MemoHASP-4

0 247 TimeHASP-4

Par2:

Longueur du Bloc La taille du bloc en mots.

Par3:

Segment du Buffer Segment de l'adresse d'un buffer (variable).

8-6

Services API MemoHASP

Vous n'avez pas besoin de spcifier le Segment du Buffer dans une


application 32-bit.
Par4:

Offset du Buffer Offset de l'adresse d'un buffer (variable).


La taille du buffer doit tre au moins aussi grande que la taille du bloc.

Valeurs de Retour
Par3:

Etat Un code indiquant l'tat de l'opration (voir les valeurs


possibles au chapitre 11).

Rsultat
Le contenu de la mmoire HASP est plac dans le buffer.

Service 51: WriteBlock


Description
Ecrit un bloc de donnes dans la mmoire de la cl HASP.

Cls Utilisables
MemoHASP-1, MemoHASP-4, TimeHASP-4

Syntaxe
hasp (Service, SeedCode, LptNum, Password1, Password2, Par1, Par2, Par3, Par4)

Paramtres Utiliss
Service:

51

LptNum:

Valeur indiquant le port parallle sur lequel il faut chercher la cl


HASP.
Valeur recommande: 0 (voir le paragraphe Spcifier le Port au
chapitre 6 pour une liste des valeurs possibles).

Password1:

Premier Mot de Passe HASP.

Password2:

Second Mot de Passe HASP.

Par1:

Adresse de Dpart Dfini l'adresse initiale de la mmoire HASP


pour la lecture du bloc de donnes :

0 55 MemoHASP-1

0 247 MemoHASP-4

Service 51: WriteBlock

8-7

0 247 TimeHASP-4

Par2:

Longueur du Bloc La taille du bloc en mots.

Par3:

Segment du Buffer Segment de l'adresse d'un buffer (variable).


Vous n'avez pas besoin de spcifier le Segment du Buffer dans une
application 32-bit.

Par4:

Offset du Buffer Offset de l'adresse d'un buffer (variable).


La taille du buffer doit tre au moins aussi grande que la taille du bloc.

Valeurs de Retour
Par3:

Etat Un code indiquant l'tat de l'opration (voir les valeurs


possibles au chapitre 11).

Rsultat
Le contenu du buffer est crit dans la mmoire HASP.

8-8

Services API MemoHASP

Chapitre 9 - Services TimeHASP


APIIl y a deux lignes pour chacun des services ci-dessous :
La ligne d'appel, A, indique les paramtres que vous devez passer
la routine hasp( ).
La ligne de retour, R, indique les paramtres que la routine hasp(
) renvoie.

Note:

La signification des paramtres Par1, Par2, Par3 et Par4


change selon le service.
Tous les paramtres sont en 16 bits dans des applications
16-bit.
Tous les paramtres sont en 32 bits dans des applications
32-bit.

9-1

9-2

Services TimeHASP

Tableau 9.1: Services TimeHASP et les paramtres de la routine hasp( )


Service
(Service Number)
A

SetTime (70)

Seed
Code

LptNum

Password1

Password2

Par1

Par2

LptNum

Password1

Password2

Seconde

Minute

R
A

GetTime (71)

LptNum

Password1

SetDate (72)

LptNum

Password1

Password2

Seconde

Minute

Jour

Mois

GetDate (73)

LptNum

Password1

WriteByte (74)

LptNum

Password1

Password2

Jour

Mois

Adresse

Donne

ReadByte (75)

LptNum

Password1

Password2

WriteBlock (76)

LptNum

Password1

Password2

Adresse
Dpart

Donne

Etat

Long. du
bloc

*Segment
Buffer

Anne

Offset
Buffer

Etat
ReadBlock (77)

LptNum

Password1

Password2

Adresse
Dpart

Long. du
Bloc

R
A

Etat

Adresse

R
A

Anne

Etat

R
A

Heure

Password2

R
A

Etat

Etat

R
A

Heure

Password2

R
A

Par4

Etat

R
A

Par3

*Segment du
Buffer
Etat

GetHaspID (78)

LptNum

Password1

Password2

* Vous navez pas besoin du Segment du Buffer pour des applications 32-bit.

IDLow

IDHigh

Etat

Offset
Buffer

Service 70: SetTime

9-3

Service 70: SetTime


Description
Rgle l'heur ede l'horloge temps-rel de la TimeHASP.

Cls Utilisables
TimeHASP, TimeHASP-4

Syntaxe
hasp (Service, SeedCode, LptNum, Password1, Password2, Par1, Par2, Par3, Par4)

Paramtres Utiliss
Service:

70

LptNum:

Valeur indiquant le port parallle sur lequel il faut chercher la cl


HASP.
Valeur recommande: 0 (voir le paragraphe Spcifier le Port au
chapitre 6 pour une liste des valeurs possibles).

Password1:

Premier Mot de Passe TimeHASP.

Password2:

Second Mot de Passe TimeHASP.

Par1:

Seconde Secondes de l'heure que vous voulez dfinir (00 59).

Par2:

Minute Minutes de l'heure que vous voulez dfinir (00 59).

Par4:

Heure Heures de l'heure que vous voulez dfinir (00 23).

Valeurs de Retour
Par3:

Etat Un code indiquant l'tat de l'opration (voir les valeurs


possibles au chapitre 11).

9-4

Services TimeHASP

Service 71: GetTime


Description
Lit l'heure de l'horloge temps-rel TimeHASP.

Cls Utilisables
TimeHASP, TimeHASP-4

Syntaxe
hasp (Service, SeedCode, LptNum, Password1, Password2, Par1, Par2, Par3, Par4)

Paramtres Utiliss
Service:

71

LptNum:

Valeur indiquant le port parallle sur lequel il faut chercher la cl


HASP.
Valeur recommande: 0 (voir le paragraphe Spcifier le Port au
chapitre 6 pour une liste des valeurs possibles).

Password1:

Premier Mot de Passe TimeHASP.

Password2:

Second Mot de Passe TimeHASP.

Valeurs de Retour
Par1:

Seconde Secondes lues de l'horloge TimeHASP.

Par2:

Minute Minutes lues de l'horloge TimeHASP.

Par3:

Etat Un code indiquant l'tat de l'opration (voir les valeurs


possibles au chapitre 11).

Par4:

Heure Heures lues de l'horloge TimeHASP.

Service 72: SetDate

9-5

Service 72: SetDate


Description
Rgle la date de l'horloge temps-rel TimeHASP.

Cls Utilisables
TimeHASP, TimeHASP-4

Syntaxe
hasp (Service, SeedCode, LptNum, Password1, Password2, Par1, Par2, Par3, Par4)

Paramtres Utiliss
Service:

72

LptNum:

Valeur indiquant le port parallle sur lequel il faut chercher la cl


HASP.
Valeur recommande: 0 (voir le paragraphe Spcifier le Port au
chapitre 6 pour une liste des valeurs possibles).

Password1:

Premier Mot de Passe TimeHASP.

Password2:

Second Mot de Passe TimeHASP.

Par1:

Jour Jour de la date dfinir dans l'horloge TimeHASP (1 31).

Par2:

Mois Mois de la date dfinir dans l'horloge TimeHASP (1 12).

Par4:

Anne Anne de la date dfinir dans l'horloge TimeHASP (0 99).

Valeurs de Retour
Par3:

Etat Un code indiquant l'tat de l'opration (voir les valeurs


possibles au chapitre 11).

Commentaires
La valeur de l'anne est comprise entre 0 et 99, o 92 99 fait
rfrence 1992-1999 et 00 91 2000-2091.

9-6

Services TimeHASP

Service 73: GetDate


Description
Lit la date de l'horlge temps-rel TimeHASP.

Cls Utilisables
TimeHASP, TimeHASP-4

Syntaxe
hasp (Service, SeedCode, LptNum, Password1, Password2, Par1, Par2, Par3, Par4)

Paramtres Utiliss
Service:

73

LptNum:

Valeur indiquant le port parallle sur lequel il faut chercher la cl


HASP.
Valeur recommande: 0 (voir le paragraphe Spcifier le Port au
chapitre 6 pour une liste des valeurs possibles).

Password1:

Premier Mot de Passe TimeHASP.

Password2:

Second Mot de Passe TimeHASP.

Valeurs de Retour
Par1:

Jour Jour de la date lue dans l'horloge TimeHASP (1 31).

Par2:

Mois Mois de la date lue dans l'horloge TimeHASP (1 12).

Par3:

Etat Un code indiquant l'tat de l'opration (voir les valeurs


possibles au chapitre 11).

Par4:

Anne Anne de la date lue dans l'horloge TimeHASP (0 99).

Commentaires
La valeur de l'anne est comprise entre 0 et 99, o 92 99 fait
rfrence 1992-1999 et 00 91 2000-2091.

Service 74: WriteByte

9-7

Service 74: WriteByte


Description
Ecrit un octet de donnes dans la mmoire de la TimeHASP .

Cls Utilisables
TimeHASP, TimeHASP-4

Syntaxe
hasp (Service, SeedCode, LptNum, Password1, Password2, Par1, Par2, Par3, Par4)

Paramtres Utiliss
Service:

74

LptNum:

Valeur indiquant le port parallle sur lequel il faut chercher la cl


HASP.
Valeur recommande: 0 (voir le paragraphe Spcifier le Port au
chapitre 6 pour une liste des valeurs possibles).

Password1:

Premier Mot de Passe TimeHASP.

Password2:

Second Mot de Passe TimeHASP.

Par1:

Adresse L'adresse de la mmoire TimeHASP laquelle vous dsirez


crire (0 15).

Par2:

Donnes Un octet de donnes.

Valeurs de Retour
Par3:

Etat Un code indiquant l'tat de l'opration (voir les valeurs


possibles au chapitre 11).

Commentaires
Ce service crit dans les 16 octets de mmoire de la TimeHASP et
TimeHASP-4. Pour crire dans les 248 mots de mmoire d'une
TimeHASP-4, utilisez le service MemoHASP numro 4.

9-8

Services TimeHASP

Service 75: ReadByte


Description
Lit un octet de donnes de la mmoire TimeHASP.

Cls Utilisables
TimeHASP, TimeHASP-4

Syntaxe
hasp (Service, SeedCode, LptNum, Password1, Password2, Par1, Par2, Par3, Par4)

Paramtres Utiliss
Service:

75

LptNum:

Valeur indiquant le port parallle sur lequel il faut chercher la cl


HASP.
Valeur recommande: 0 (voir le paragraphe Spcifier le Port au
chapitre 6 pour une liste des valeurs possibles).

Password1:

Premier Mot de Passe TimeHASP.

Password2:

Second Mot de Passe TimeHASP.

Par1:

Adresse L'adresse de la mmoire TimeHASP laquelle vous dsirez


lire (0 15).

Valeurs de Retour
Par2:

Donnes Un octet de donnes lues de la mmoire TimeHASP.

Par3:

Etat Un code indiquant l'tat de l'opration (voir les valeurs


possibles au chapitre 11).

Commentaires
Ce service lit dans les 16 octets de mmoire de la TimeHASP et
TimeHASP-4. Pour lire dans les 248 mots de mmoire d'une
TimeHASP-4, utilisez le service MemoHASP numro 3.

Service 76: WriteBlock

9-9

Service 76: WriteBlock


Description
Ecrit un bloc de donnes dans la mmoire TimeHASP.

Cls Utilisables
TimeHASP, TimeHASP-4

Syntaxe
hasp (Service, SeedCode, LptNum, Password1, Password2, Par1, Par2, Par3, Par4)

Paramtres Utiliss
Service:

76

LptNum:

Valeur indiquant le port parallle sur lequel il faut chercher la cl


HASP.
Valeur recommande: 0 (voir le paragraphe Spcifier le Port au
chapitre 6 pour une liste des valeurs possibles).

Password1:

Premier Mot de Passe TimeHASP.

Password2:

Second Mot de Passe TimeHASP.

Par1:

Adresse de Dpart Dfini l'adresse initiale de la mmoire


TimeHASP d'criture du bloc (0 15).

Par2:

Longueur du Bloc Taille, en octets, du bloc de donnes (maximum


16).

Par3:

Segment du Buffer Segment de l'adresse d'un buffer (variable).


Vous n'avez pas dfinir le Segment du Buffer dans une application
32-bit.

Par4:

Offset du Buffer Offset de l'adresse d'un buffer (variable).


La taille du buffer doit tre au moins gale celle du bloc.

Valeurs de Retour
Par3:

Etat Un code indiquant l'tat de l'opration (voir les valeurs


possibles au chapitre 11).

Resultat
Le contenu du buffer est crit dans la mmoire HASP.

9-10

Services TimeHASP

Commentaires
Ce service crit un bloc dans les 16 octets de mmoire de la TimeHASP
et TimeHASP-4. Pour crire un bloc dans les 248 mots de mmoire
d'une TimeHASP-4, utilisez le service MemoHASP numro 51.

Service 77: ReadBlock

9-11

Service 77: ReadBlock


Description
Lit un bloc de donnes de la mmoire TimeHASP.

Cls Utilisables
TimeHASP, TimeHASP-4

Syntaxe
hasp (Service, SeedCode, LptNum, Password1, Password2, Par1, Par2, Par3, Par4)

Paramtres Utiliss
Service:

77

LptNum:

Valeur indiquant le port parallle sur lequel il faut chercher la cl


HASP.
Valeur recommande: 0 (voir le paragraphe Spcifier le Port au
chapitre 6 pour une liste des valeurs possibles).

Password1:

Premier Mot de Passe TimeHASP.

Password2:

Second Mot de Passe TimeHASP.

Par1:

Adresse de Dpart Dfini l'adresse initiale de la mmoire


TimeHASP de lecture du bloc (0 15).

Par2:

Longueur du Bloc Taille, en octets, du bloc de donnes (maximum


16).

Par3:

Segment du Buffer Segment de l'adresse d'un buffer (variable).


Vous n'avez pas dfinir le Segment du Buffer dans une application
32-bit.

Par4:

Offset du Buffer Offset de l'adresse d'un buffer (variable).


La taille du buffer doit tre au moins gale celle du bloc.

Valeurs de Retour
Par3:

Etat Un code indiquant l'tat de l'opration (voir les valeurs


possibles au chapitre 11).

Resultat
Le contenu de la mmoire HASP lue est plac dans le buffer.

9-12

Services TimeHASP

Commentaires
Ce service lit un bloc des 16 octets de mmoire de la TimeHASP et
TimeHASP-4. Pour lire un bloc des 248 mots de mmoire d'une
TimeHASP-4, utilisez le service MemoHASP numro 50.

Service 78: GetHaspID

9-13

Service 78: GetHaspID


Description
Dtermine le Numro d'Identification TimeHASP.

Cls Utilisables
TimeHASP, TimeHASP-4

Syntaxe
hasp (Service, SeedCode, LptNum, Password1, Password2, Par1, Par2, Par3, Par4)

Paramtres Utiliss
Service:

78

LptNum:

Valeur indiquant le port parallle sur lequel il faut chercher la cl


HASP.
Valeur recommande: 0 (voir le paragraphe Spcifier le Port au
chapitre 6 pour une liste des valeurs possibles).

Password1:

Premier Mot de Passe TimeHASP.

Password2:

Second Mot de Passe TimeHASP.

Valeurs de Retour
Par1:

IDLow Mot faible (le moins significatif) du Numro d'Identification.

Par2:

IDHigh Mot fort (le plus significatif) du Numro d'Identification.

Par3:

Etat Un code indiquant l'tat de l'opration (voir les valeurs possibles


au chapitre 11).

Commentaires
Le Numro d'Identification est un entier long (32 bits). Vous pouvez le
calculer de la manire suivante :
Numro d'Identification = IDLow + 65536 * IDHigh,
o IDLow et IDHigh sont des entiers non signs.

9-14

Services TimeHASP

Chapitre 10 - Services de lAPI NetHASP


Il y a deux lignes pour chacun des services ci-dessous :
La ligne d'appel, A, indique les paramtres que vous devez passer
la routine hasp( ).
La ligne de retour, R, indique les paramtres que la routine
hasp( ) renvoie.

Note:

La signification des paramtres Par1, Par2, Par3 et Par4


change selon le service.
Tous les paramtres sont en 16 bits dans des applications
16-bit.
Tous les paramtres sont en 32 bits dans des applications
32-bit.

10-1

10-2

Services de lAPI NetHASP

Tableau 10.1: Services NetHASP et les paramtres de la routine hasp( )


Service
(Numro Service)
C

Seed
Code

ProgNum

Password1

Password2

HaspCode (41)

Seed Code

ProgNum

Password1

LOGIN (42)

Seed Code

ProgNum

Password1

Par4

Net
Status

Erreur
Systme

Return
Code 1

Return
Code 2

Return
Code 3

Return
Code 4

Return
Code1

Return
Code2

Return
Code3

Return
Code4

Data

Status

Password2

Par3

Password2

Par2

LastStatus (40)

Par1

LOGOUT (43)

ProgNum

Password1

Password2

ReadWord (44)

ProgNum

Password1

Password2

R
C

Adresse

R
C

WriteWord (45)

ProgNum

Password1

Password2

Adresse

Data

R
C

Status
HaspID (46)

ProgNum

Password1

Password2

R
C

IdleTime (48)

Idle Time

ProgNum

Password1

Password2

ProgNum

Password1

Password2

IDLow

IDHigh

Status

Start
Address

Block
Length

*Buffer
Segment

R
C

ReadBlock (52)

R
C

Buffer
Offset

Status
WriteBlock (53)

ProgNum

Password1

Password2

Start
Address

Block
Length

*Buffer
Segment
Status

Buffer
Offset

Service 40: LastStatus

10-3

SetConfigFilename (85)

Buffer
Size

*Buffer
Segment

Buffer
Offset

SetServerByName (96)

Buffer
Size

*Buffer
Segment

Buffer
Offset

R
C

* Le paramtre Buffer Segment n'est pas ncessaire pour des applications 32-bit.

10-4

Services de lAPI NetHASP

Service 40: LastStatus


Description
Vrifie l'tat du prcdent appel la routine hasp( ). Appelez la routine
hasp( ) avec le service LastStatus aprs tout appel un service
NetHASP.

Cls Utilisables
NetHASP

Syntaxe
hasp (Service, SeedCode, ProgNum , Password1, Password2, Par1, Par2, Par3, Par4)

Paramtres Utiliss
Service:

40

Valeurs de Retour
Par1:

Par2:

Net Status Un code indiquant l'tat du prcdent appel la routine


hasp( ).

0 prcdent appel correctement effectu.

Sinon agir selon le code d'erreur indiqu (voir chapitre 11 pour les
diffrents codes d'erreur possibles).

System Error Un code d'erreur dpendant du contexte.


Par exemple :

Une erreur de communication NetBIOS renvoie un code d'erreur


NetBIOS prcis.

Une erreur de Fichier de Configuration NetHASP renvoie le


numro de la ligne laquelle l'erreur se trouve l'erreur.

Commentaires
Si une erreur survient, votre programme doit afficher les deux codes
d'erreur Net Status et System Error.

Service 41: HaspCode

10-5

Service 41: HaspCode


Description
Dtermine les Codes de Retour pour un Seed Code (germe) donn.

Cls Utilisables
NetHASP

Syntaxe
hasp (Service, SeedCode, ProgNum , Password1, Password2, Par1, Par2, Par3, Par4)

Paramtres Utiliss
Service:

41

SeedCode:

Un entier compris entre 0 et 65535.

ProgNum:

Le numro assign l'application dans la mmoire NetHASP via le


programme HaspEdit (voir chapitre 13).

Password1:

Premier Mot de Passe NetHASP.

Password2:

Second Mot de Passe NetHASP.

Valeurs de Retour
Par1:

Return Code 1

Par2:

Return Code 2

Par3:

Return Code 3

Par4:

Return Code 4

Commentaires

Utilisez le HaspCode pour vrifier si votre cl NetHASP est


connecte un Gestionnaire de Licence NetHASP. Passez les Seed
Code la routine hasp( ) et vrifiez que les Codes de Retour sont
ceux attendus.

Des Seed Codes diffrents renvoient des Codes de Retour


diffrents. Les Codes de Retour sont dtermins par le Code
Dveloppeur HASP et le Seed Code.

10-6

Services de lAPI NetHASP

Utilisez le programme HaspEdit pour vrifier les Codes de Retour


pour un Seed Code donn.

Service 42: LOGIN

10-7

Service 42: LOGIN


Description
Effectue un LOGIN NetHASP. L'application protge accde au
Gestionnaire de Licence NetHASP et requiert une licence.

Cls Utilisables
NetHASP

Syntaxe
hasp (Service, SeedCode, ProgNum , Password1, Password2, Par1, Par2, Par3, Par4)

Paramtres Utiliss
Service:

42

SeedCode:

Un entier compris entre 0 et 65535.

ProgNum:

Le numro assign l'application dans la mmoire NetHASP via le


programme HaspEdit (voir chapitre 13).

Password1:

Premier Mot de Passe NetHASP.

Password2:

Second Mot de Passe NetHASP.

Valeurs de Retour
Par1:

Return Code 1

Par2:

Return Code 2

Par3:

Return Code 3

Par4:

Return Code 4

Commentaires

Reportez-vous au chapitre 3 pour une description du processus de


LOGIN.

Excepts pour les services SetConfigFilename, SetServerByName


et LastStatus, vous devez effectuer un LOGIN avant l'utilisation
des autres services.

Le Seed Code pass la routine hasp( ) durant le service LOGIN


permet le renvoi de quatre Codes de Retour. Diffrents Seed Codes
renvoient des Codes de Retour diffrents. Dans votre application,

10-8

Services de lAPI NetHASP

vrifiez que les quatre Codes de Retour sont bien ceux attendus.

Si vous appelez la routine hasp( ) plus d'une fois avec le service


LOGIN sur la mme station, le Gestionnaire de Licence NetHASP
n'enregistrera pas plusieurs la station et l'application dans la Table
de Connexion. Cela signifie que le Gestionnaire de Licence
NetHASP ne fournira pas une licence supplmentaire cette
application.

Lorsque vous relancez une application avec un plantage machine,


l'application est dj dans la Table de Connexion et le Gestionnaire
de Licence NetHASP ne lui attribuera pas une autre licence.

Avec le protocole NetBIOS, toute processus Win32 sous Windows


NT ou Windows 95 effectue un LOGIN spar et reoit une licence
distincte.

Service 43: LOGOUT

10-9

Service 43: LOGOUT


Description
Effectue un LOGOUT NetHASP. Lorsque vous appelez la routine
hasp( ) avec le service LOGOUT, le Gestionnaire de Licence NetHASP
supprime la station et l'application de la Table de Connexion, librant
ainsi une licence.

Cls Utilisables
NetHASP

Syntaxe
hasp (Service, SeedCode, ProgNum , Password1, Password2, Par1, Par2, Par3, Par4)

Paramtres Utiliss
Service:

43

ProgNum:

Le numro assign l'application dans la mmoire NetHASP via le


programme HaspEdit (voir chapitre 13).

Password1:

Premier Mot de Passe NetHASP.

Password2:

Second Mot de Passe NetHASP.

Valeurs de Retour
Aucune

Commentaires

Voir le chapitre 3 pour la description du processus de LOGOUT.

Si vous n'effectuez pas de LOGOUT NetHASP, la station et


l'application resteront dans la Table de Connexion NetHASP. Cela
signifie que :
a. Le nombre de stations excutant l'application un moment
donn restera inchang et aucune licence ne sera libre. Si
vous avez dtermin que l'application ne pouvait fonctionner
que sur n stations, et que n stations ont effectu un LOGIN
NetHASP, aucune autre station ne pourra excuter
l'application jusqu' ce qu'une de ces n ait effectu un
LOGOUT NetHASP.

10-10

Services de lAPI NetHASP

b. Si une station lance lapplication une seconde fois, elle tournera


en utilisant la mme licence dj attribue.

Plusieurs instances d'une application Windows protge effectuent


des appels multiples au service LOGIN un LOGIN par instance.
La licence ne sera libre (la station et l'application seront
supprimes de la Table de Connexion) que si toutes les instances
effectuent un appel au service LOGOUT.

Service 44: ReadWord

10-11

Service 44: ReadWord


Description
Lit un mot de donnes de la mmoire NetHASP.

Cls Utilisables
NetHASP

Syntaxe
hasp (Service, SeedCode, ProgNum , Password1, Password2, Par1, Par2, Par3, Par4)

Paramtres Utiliss
Service:

44

ProgNum:

Le numro assign l'application dans la mmoire NetHASP via le


programme HaspEdit (voir chapitre 13).

Password1:

Premier Mot de Passe NetHASP.

Password2:

Second Mot de Passe NetHASP.

Par1:

Address L'adresse de la mmoire NetHASP qui sera lue (valeur de 0


247).

Valeurs de Retour
Par2:

Data Donnes lues de la mmoire NetHASP.

Par3:

Status Un code indiquant l'tat de l'opration sur la mmoire (voir le


chapitre 11 pour les valeurs possibles).

10-12

Services de lAPI NetHASP

Service 45: WriteWord


Description
Ecrit un mot de donnes dans la mmoire NetHASP .

Cls Utilisables
NetHASP

Syntaxe
hasp (Service, SeedCode, ProgNum , Password1, Password2, Par1, Par2, Par3, Par4)

Paramtres Utiliss
Service:

45

ProgNum:

Le numro assign l'application dans la mmoire NetHASP via le


programme HaspEdit (voir chapitre 13).

Password1:

Premier Mot de Passe NetHASP.

Password2:

Second Mot de Passe NetHASP.

Par1:

Address L'adresse de la mmoire NetHASP o vous dsirez crire


(valeur de 0 247).

Par2:

Data Un mot de donnes.

Valeurs de Retour
Par3:

Status Un code indiquant l'tat de l'opration sur la mmoire (voir le


chapitre 11 pour les valeurs possibles).

Commentaires
Les offsets 24 et plus de la mmoire NetHASP sont rservs pour la
Liste des Programmes NetHASP. Si vous crivez l'un de ces offsets,
vous risquez d'craser des paramtres de protection de l'application
que vous avez sauvegardez dans cette zone de la mmoire.

Service 46: HaspID

10-13

Service 46: HaspID


Description
Dtermine le Numro d'Identification NetHASP.

Cls Utilisables
NetHASP

Syntaxe
hasp (Service, SeedCode, ProgNum , Password1, Password2, Par1, Par2, Par3, Par4)

Paramtres Utiliss
Service:

48

ProgNum:

Le numro assign l'application dans la mmoire NetHASP via le


programme HaspEdit (voir chapitre 13).

Password1:

Premier Mot de Passe NetHASP.

Password2:

Second Mot de Passe NetHASP.

Valeurs de Retour
Par1:

IDLow Mot de poids faible (le moins significatif) du Numro


d'Identification.

Par2:

IDHigh Mot de poids fort (le plus significatif) du Numro


d'Identification.

Par3:

Status Un code indiquant l'tat de l'opration sur la mmoire (voir le


chapitre 11 pour les valeurs possibles).

Commentaires
Le Numro d'Identification est un entier long (32 bits). Vous pouvez le
calculer de la manire suivante :
ID Number = IDLow + 65536 * IDHigh,
o IDLow et IDHigh sont des entiers non signs

10-14

Services de lAPI NetHASP

Service 48: IdleTime


Description
Contrle que les stations n'utilisant plus une application protge.
Avec le service IdleTime, vous pouvez dfinir un laps de temps durant
lequel une station doit accder la cl NetHASP afin de ne pas tre
considre comme disponible. Si la station n'accde pas la cl
NetHASP durant ce laps de temps, le Gestionnaire de Licence
NetHASP considre cette station comme disponible.

Cls Utilisables
NetHASP

Syntaxe
hasp (Service, IdleTime, ProgNum , Password1, Password2, Par1, Par2, Par3, Par4)

Paramtres Utiliss
Service:

48

IdleTime:

Un laps de temps en minutes (0 65535).


Une station que n'accde pas la cl durant ce laps de temps est
considre comme disponible.

ProgNum:

Le numro assign l'application dans la mmoire NetHASP via le


programme HaspEdit (voir chapitre 13).

Password1:

Premier Mot de Passe NetHASP.

Password2:

Second Mot de Passe NetHASP.

Valeurs de Retour
Aucune

Commentaires

Lorsque le nombre de station excutant l'application protge a


atteint son maximum et qu'une autre station essaie de lancer
l'application, le Gestionnaire de Licence NetHASP recherche dans
la Table de Connexion une station disponible. Sil en trouve une, il
supprime cette station de la Table de Connexion pour librer une
licence.
Le Gestionnaire de Licence NetHASP peut ainsi attribuer cette

Service 48: IdleTime

10-15

licence la nouvelle station. L'application protge qui tournait


sur la station supprime de la Table de Connexion renverra un
code d'erreur (erreur 135 ou 139) la prochaine tentative d'accs
la cl NetHASP.

Lorsqu'une station accde la cl NetHASP durant le laps de


temps dfini, le compteur d'IdleTime est remis zro.

Pour mettre en place le service IdleTime, appelez la routine hasp( )


avec le service IdleTime juste aprs le service LOGIN. Si vous ne
dfinissez pas de laps de temps, le Gestionnaire de Licence
NetHASP utilisera les dures suivantes :

Tableau 10.2: Dure du laps de temps par dfaut pour les Gestionnaire de Licence
NetHASP
Gestionnaire de Licence NetHASP

Dure par dfaut

nhsrvwin.exe

36 heures

nhsrvwnt.exe

36 heures

haspserv.nlm

36 heures

nhsrvos2.exe

36 heures

haspserv.exe

24 heures

10-16

Services de lAPI NetHASP

Service 52: ReadBlock


Description
Lit un bloc de donnes de la mmoire NetHASP.

Cls Utilisables
NetHASP

Syntaxe
hasp (Service, SeedCode, ProgNum , Password1, Password2, Par1, Par2, Par3, Par4)

Paramtres Utiliss
Service:

52

ProgNum:

Le numro assign l'application dans la mmoire NetHASP via le


programme HaspEdit (voir chapitre 13).

Password1:

Premier Mot de Passe NetHASP.

Password2:

Second Mot de Passe NetHASP.

Par1:

Start Address Dfini l'adresse mmoire NetHASP de dpart de la


lecture du bloc (0 247).

Par2:

Block Size Taille du bloc de donnes en mots (maximum 24 mots).

Par3:

Buffer Segment Segment de l'adresse du buffer (variable).


Il n'est pas ncessaire de dfinir ce paramtre pour des applications
32 bit.

Par4:

Buffer Offset Offset de l'adresse du buffer (variable).


La taille du buffer doit tre au moins aussi grande que le bloc.

Valeurs de Retour
Par3:

Status Un code indiquant l'tat de l'opration sur la mmoire (voir le


chapitre 11 pour les valeurs possibles).

Rsultat
Le buffer contient les donnes contenues dans le bloc de mmoire lu.

Service 53: WriteBlock

10-17

Service 53: WriteBlock


Description
Ecrit un bloc de donnes dans la mmoire NetHASP.

Cls Utilisables
NetHASP

Syntaxe
hasp (Service, SeedCode, ProgNum , Password1, Password2, Par1, Par2, Par3, Par4)

Paramtres Utiliss
Service:

53

ProgNum:

Le numro assign l'application dans la mmoire NetHASP via le


programme HaspEdit (voir chapitre 13).

Password1:

Premier Mot de Passe NetHASP.

Password2:

Second Mot de Passe NetHASP.

Par1:

Start Address Dfini l'adresse mmoire NetHASP de dbut


d'criture du bloc (0 247).

Par2:

Block Size Taille du bloc (maximum 24 mots)

Par3:

Buffer Segment Segment de l'adresse du buffer (variable).


Il n'est pas ncessaire de dfinir ce paramtre pour des applications
32 bit.

Par4:

Buffer Offset Offset de l'adresse du buffer (variable).


La taille du buffer doit tre au moins aussi grande que le bloc.

Valeurs de Retour
Par3:

Status Un code indiquant l'tat de l'opration sur la mmoire (voir le


chapitre 11 pour les valeurs possibles).

Rsultat
Le contenu du buffer est crit dans la mmoire NetHASP.

Commentaires
Les offsets 24 et plus de la mmoire NetHASP sont rservs pour la
Liste des Programmes NetHASP. Si vous crivez l'un de ces offsets,

10-18

Services de lAPI NetHASP

vous risquez d'craser des paramtres de protection de l'application


que vous avez sauvegardez dans cette zone de la mmoire.

Service 85: SetConfigFilename

10-19

Service 85: SetConfigFilename


Description
Dfinit le nom du Fichier de Configuration NetHASP. Le Fichier de
Configuration NetHASP contient les paramtres et personnalisations
de l'application protge.

Cls Utilisables
NetHASP

Syntaxe
hasp (Service, SeedCode, ProgNum , Password1, Password2, Par1, Par2, Par3, Par4)

Paramtres Utiliss
Service:

85

Par2:

Buffer Size La taille en octets du buffer contenant le nom du Fichier


de Configuration NetHASP.

Par3:

Buffer Segment Le segment de l'adresse du buffer contenant le


nom du Fichier de Configuration NetHASP.
Il n'est pas ncessaire de dfinir ce paramtre pour des applications
32 bit.

Par4:

Buffer Offset L'offset de l'adresse du buffer contenant le nom du


Fichier de Configuration NetHASP.

Valeurs de Retour
Aucun

Commentaires
Si vous utilisez le service SetConfigFilename, appelez-le avant
d'effectuer un LOGIN NetHASP. Si vous n'utilisez pas le service
SetConfigFilename, l'application protge recherchera le fichier
nethasp.ini.
Pour plus de dtails sur le Fichier de Configuration NetHASP,
reportez-vous l'annexe .

10-20

Services de lAPI NetHASP

Service 96: SetServerByName


Description
Dfinit le nom d'un Gestionnaire de Licence NetHASP et indique
l'application protge de communiquer avec le Gestionnaire de Licence
NetHASP indiqu.

Cls Utilisables
NetHASP

Syntaxe
hasp (Service, SeedCode, ProgNum , Password1, Password2, Par1, Par2, Par3, Par4)

Paramtres Utiliss
Service:

96

Par2:

Buffer Size La taille en octets du buffer contenant le nom du


Gestionnaire de Licence NetHASP.

Par3:

Buffer Segment Le segment de l'adresse du buffer contenant le nom


du Gestionnaire de Licence NetHASP.
Il n'est pas ncessaire de dfinir ce paramtre pour des applications
32 bit.

Par4:

Buffer Offset L'offset de l'adresse du buffer contenant le nom du


Gestionnaire de Licence NetHASP.

Valeurs de Retour
Aucune

Commentaires

Appelez la routine hasp( ) avec le service SetServerByName avant


d'effectuer un LOGIN NetHASP.

Pour nommer un Gestionnaire de Licence NetHASP, chargez-le avec le


paramtre -srvname (voir annexe ). Lorsqu'une application appelle
la routine hasp( ) avec le service SetServerByName, la routine hasp( )
recherche un Gestionnaire de Licence NetHASP avec le nom indiqu.
Si elle en trouve un, elle stocke l'adresse du Gestionnaire de Licence
NetHASP. Lorsque l'application effectuera un LOGIN NetHASP, elle
accdera au Gestionnaire de Licence NetHASP l'adresse

Service 96: SetServerByName

10-21

pralablement sauvegarde.

Le nom du Gestionnaire de Licence NetHASP peut comporter


jusqu' sept caractres.

10-22

Services de lAPI NetHASP

Chapitre 11 - Codes dEtat de lAPI


Lorsque vous utilisez l'API pour accder la cl HASP, la routine
hasp( ) renvoie un code d'tat dans le paramtre Par3. Les tableaux
11.1, 11.2 et 11.3 contiennent l'ensemble des codes d'tat retourns.
Tableau 11.1: Codes dEtat HASP-3, MemoHASP,
TimeHASP-4 et NetHASP
Code

Description

Opration russie.

-1

Time-out: chec de l'opration d'criture.

-2

L'adresse est hors zone.

-3

Impossible de trouver une cl HASP avec les mots de passe spcifis.

-4

Une cl HASP a t trouve, mais ce n'est pas une MemoHASP.

-5

Echec de l'opration d'criture.

-999

Service invalide.

Tableau 11.2: codes dEtat TimeHASP et TimeHASP-4


Code

Description

Opration russie.

-20

Jour invalide.

-21

Mois invalide.

-22

Anne invalide.

-23

Secondes invalides.

-24

Minutes invalides.

11-1

11-2

Codes dEtat de lAPI

Code

Description

-25

Heures invalides.

-26

Adresse Invalide l'adresse n'est pas dans l'intervalle 0 15.

-27

Time-out: chec de l'opration d'criture.

-28

Cl HASP non trouve avec les mots de passe spcifis.

-29

Une cl HASP a t trouve, mais ce n'est pas une TimeHASP.

Les codes d'tat suivants sont rservs aux applications utilisant le


Gestionnaire de Priphrique HASP. Ces codes d'tat sont en plus des
codes lists dans les tableaux 11.1 et 11.2.

Codes LastStatus NetHASP

11-3

Tableau 11.3: Codes dEtat Applications utilisant


le Gestionnaire de Priphrique HASP
Code

Description

-100

Impossible d'ouvrir le Gestionnaire de Priphrique HASP (pour des applications Win32).


Installez le Gestionnaire de Priphrique HASP.

-101

Impossible de lire le Gestionnaire de Priphrique HASP (pour des applications Win32).

-102

Impossible de fermer le Gestionnaire de Priphrique HASP (pour des applications Win32)

-110

Impossible d'ouvrir le Gestionnaire de Priphrique HASP (pour des applications DOS, DOS
extender et Windows tentant d'accder au Gestionnaire de Priphrique HASP).
Installez le Gestionnaire de Priphrique HASP.

-111

Impossible de lire le Gestionnaire de Priphrique HASP (pour des applications DOS, DOS
extender et Windows tentant d'accder au Gestionnaire de Priphrique HASP).

-112

Impossible de fermer le Gestionnaire de Priphrique HASP (pour des applications DOS, DOS
extender et Windows tentant d'accder au Gestionnaire de Priphrique HASP).

-120

Impossible d'allouer de la mmoire DOS (pour des applications DOS extender et Windows
protges par des cls monopostes).
Essayez de librer de la mmoire DOS.

-121

Erreur en librant de la mmoire DOS (pour des applications DOS extender et Windows
protges par des cls monopostes).

Codes LastStatus NetHASP


Lorsque vous appelez la routine hasp( ) avec le service LastStatus, la
routine hasp( ) routine renvoie une code d'tat dans le paramtre Par1
(NetStatus), spcifiant l'tat du prcdent appel.
Si une erreur dpendant du contexte survient, vous la rcuprez dans
le paramtre Par2 (Erreur systme) en utilisant le service LastStatus.
Les codes LastStatus sont diviss en deux groupes :

11-4

Codes dEtat de lAPI

Les codes d'tat de 1 127 indiquent une erreur de


communication entre l'application et le Gestionnaire de Licence
NetHASP, ou une erreur dans les paramtres passs la routine
hasp( ). La routine hasp( ) reconnat ces erreurs mme sans
rponse du Gestionnaire de Licence NetHASP.
Les codes d'tat de 129 151 indiquent qu'une erreur est survenue
aprs que la communication client-serveur se soit tablie.
Le tableau 11.4 montre les valeurs possibles du paramtre Par1
(NetStatus).
Tableau 11.4: codes dEtat pour le service LastStatus NetHASP
Code

Description

Opration russie

Les protocoles IPX, NetBIOS ou TCP/IP n'ont pas t installs correctement agissez en
consquence.

Erreur de communication impossible d'obtenir un numro de socket (pour les protocoles IPX
et TCP/IP).
Vrifiez que ces protocoles sont installs correctement.

Erreur de communication.
NetBIOS impossible d'tablir une session.
IPX impossible d'obtenir une adresse immdiate du Gestionnaire de Licence NetHASP.
Vrifiez que le protocole est correctement install.
TCP/IP impossible de se connecter au serveur. Vrifiez que l'adresse du serveur est correcte.

Impossible de trouver un Gestionnaire de Licence NetHASP.


Vrifiez que votre application a accs au fichier d'adresse et avec droit en lecture.

Impossible de lire le fichier d'adresse du Gestionnaire de Licence NetHASP.

Impossible de fermer le fichier d'adresse du Gestionnaire de Licence NetHASP.

Erreur de communication Impossible d'envoyer un paquet (pour les protocoles IPX et


NetBIOS).
Vrifiez que les protocoles sont correctement installs.

Codes LastStatus NetHASP

Code

Description

Pas de rponse de la part du Gestionnaire de Licence NetHASP.

11-5

IPX - le rseau est occup ou des fichiers d'adresse incorrects ont t trouvs. Dans ce dernier
cas,
supprimez
tous
les
fichiers
haspaddr.dat
et
newhaddr.dat.
NetBIOS - le rseau est occup.
10

Vous avez appel la routine hasp( ) avec l'un des services sans avoir au pralable appel le
service LOGIN.

11

Erreur de communication erreur d'adaptateur (pour le protocole NetBIOS uniquement).


Vrifiez que le protocole est correctement install.

15

Pas de Gestionnaire de Licence NetHASP actif.

18

Impossible d'effectuer un LOGIN NetHASP cause d'un appel SetServerByName non russi.

19

Erreur de syntaxe dans le fichier de configuration. Le service LastStatus a retourn le numro


de la ligne en cause dans le paramtre Par2.
Si LastStatus a retourn 0 dans le paramtre Par2, il y a une variable d'environnement mal
initialise.

20

Erreur de gestion du Fichier de Configuration NetHASP. Le service LastStatus a retourn le


code d'erreur systme dans le paramtre Par2.

21

Le systme NetHASP n'a pas russi allouer de la mmoire. Cette erreur est spcifique des
interfaces NetHASP fonctionnant sous DOS extenders et Windows.
Essayez de librer de la mmoire DOS.

22

Le systme NetHASP n'a pas russi librer de la mmoire DOS. Cette erreur est spcifique
des interfaces NetHASP fonctionnant sous DOS extenders et Windows.

23

Adresse mmoire NetHASP invalide.

24

Service NetHASP invalide.

25

Echec de chargement de winsock.dll (sous protocole TCP/IP uniquement).

26

Echec de dchargement de winsock.dll (sous protocole TCP/IP uniquement).

28

Erreur de lancement de winsock.dll (sous protocole TCP/IP uniquement).

40

Services NetHASP non supports.

11-6

Codes dEtat de lAPI

Code

Description

129

La cl NetHASP n'est pas connecte au bon Gestionnaire de Licence NetHASP.

130

Le Numro de Programme spcifi n'est pas dans la Liste des Programmes de la mmoire
NetHASP.

131

Erreur de lecture de la mmoire NetHASP.

132

Erreur d'criture de la mmoire NetHASP.

133

Le LOGIN actuel entrane un dpassement du nombre autoris de stations pouvant excuter


simultanment l'application.

134

Le LOGIN actuel entrane un dpassement du nombre autoris d'activation de l'application.

135

Vous avez appel la routine hasp( ) avec le service LOGOUT sans avoir au pralable appel le
service LOGIN.

136

Le Gestionnaire de Licence NetHASP est occup cela peut survenir si le systme NetHASP
n'est pas bien adapt au rseau.

137

Il n'y a plus de place dans la Table de Connexion.

138

Erreur interne NetHASP le nombre de stations enregistres est suprieur au nombre maximal
de licences associ ce modle de cl NetHASP.

139

L'ordinateur avec la cl NetHASP a crash et a t redmarr, ou vous avez appel la routine


hasp( ) avec un service (except les services 40, 85, ou 96) sans avoir au pralable fait un
appel au service LOGIN.

140

Le Gestionnaire de Licence NetHASP ne gre pas le rseau de votre station.

141

Service invalide, ou une nouvelle version de l'API HASP communique avec une vieille version
de Gestionnaire de Licence NetHASP.

142

Impossible de trouver un Gestionnaire de Licence NetHASP avec le nom spcifi dans le


Fichier de Configuration NetHASP.

150

Aucun Gestionnaire de Licence NetHASP avec le nom assign n'a pas t trouv. Cette erreur
est retourne par le service SetServerByName.

151

Plus de deux Gestionnaires de Licence NetHASP ont t trouvs avec le mme nom. Cette
erreur est retourne par le service SetServerByName.

Codes LastStatus NetHASP

11-7

Cette liste est mise jour en permanence. Pour en connatre la


dernire version, reportez-vous au fichier d'aide du Gestionnaire de
Licence NetHASP.

11-8

Codes dEtat de lAPI

Chapitre 12 - Scurit par Motifs Cods


Le systme de Scurit par Motifs Cods (Pattern Code Security PCS) est une option puissante et volue qui peut tre utilise pour
protger votre logiciel en complment de l'Enveloppe HASP et de
l'API. L'intgration du systme PCS dans un programme augmente de
manire significative le niveau de protection du programme.
Le systme de Scurit par Motifs Cods n'est actuellement disponible
que pour les applications DOS et Windows 32 bits.
Le systme PCS ne peut tre mis en oeuvre que si vous disposez du
code source du programme, si le programme est capable d'effectuer
des initialisations de variables pendant leur dclaration.
L'implmentation de PCS se fait en utilisant l'API HASP. C'est
pourquoi nous vous recommandons d'abord de vous familiariser avec
les fonctionnalits de l'API (voir chapitre 6).

12-1

12-2

Scurit par Motifs Cods

Protection Conventionnelle et PCS


Le systme PCS contrecarre les tentatives des pirates dsirant
dtourner la protection incorpore dans votre application.
Toutes les procdures de protection, sauf les Enveloppes, revtent la
forme suivante :
1.

Appel de la procdure de protection.

2.

Vrification des rsultats retourns.

3.

Dcision de l'action prendre au cas o les rsultats attendus ne soient pas retourns (sortie,
message, boucle infinie, etc).

Cette forme est squentielle, de sorte qu'un pirate peut les pister
relativement facilement. Une fois piste, la procdure de protection
peut tre contourne en liminant ou en "recollant" les tapes de la
squence du programme protg.
Le "collage" ou la modification du systme de protection lui-mme
peut s'avrer quasiment impossible, tant donn que diverses
mesures ont t prises pour rendre cette opration aussi difficile que
possible. En revanche, l'limination de la squence d'appel peut tre
relativement facile.
Par exemple :
Appel de la routine de protection
HASP

Peut tre limin du programme.

Si Code de Retour = Code de Retour


attendu

Peut tre modifi en "diffrent de"

Alors sortie

Peut tre limin ou modifi en "ne rien


faire"

A l'inverse de la protection conventionnelle, le systme PCS excute


des processus multiples chaque appel de la routine de protection

Structure dun Motif

12-3

hasp( ). Diffrentes valeurs sont "magiquement" mises jour en


divers endroits du programme. Ultrieurement, ces valeurs peuvent
tre vrifies par d'autres procdures.
Si l'une des valeurs diffre des valeurs attendues n'importe quel
tape de l'excution du programme, des mesures appropries peuvent
tre prises par le protecteur.

Structure dun Motif


Un motif est une structure spciale, dfinie dans votre programme. Il
inclut une signature, un service HASP demand, et les paramtres
requis pour la routine hasp( ).
Un motif est cr en dfinissant une structure (en langage C) ou un
enregistrement (en langage Pascal), une chane (en Clipper) ou toute
autre "structure" qui dfinit une zone continue en mmoire. Le motif
doit contenir les champs suivants :
Tableau 12.1: Structure dun motif PCS
Champs

Type

Valeur

Signature

10 caractres

$HASP$PCS$

Non utilis

2 octets

(Rserv)

Service

entier*

Nombre de servies hasp( ) demands

Seed Code

entier*

Code Graine envoyer la routine ( )

Input 1

entier*

1er paramtre envoyer la routine hasp( )

Input 2

entier*

2e paramtre envoyer la routine hasp( )

Input 3

entier*

3e paramtre envoyer la routine hasp( )

Input 4

entier*

4e paramtre envoyer la routine hasp( )

Return 1

entier*

Paramtre de retour numro 1

12-4

Scurit par Motifs Cods

Champs

Type

Valeur

Return 2

entier*

Paramtre de retour numro 1

Return 3

entier*

Paramtre de retour numro 1

Return 4

entier*

Paramtre de retour numro 1

* sur 2 octets pour les applications DOS, 4 octets pour les applications Windows 32bits

Mise en oeuvre du systme PCS


Pour implmenter le systme PCS :
1. Incorporation de motifs dans votre programme. Vous pouvez
incorporer jusqu' 25 motifs diffrents dans une application.
2. Incorporation d'au moins un appel la routine hasp( ).
3. Insertion de vrifications dans votre code des valeurs de retour
attendues pour chaque motif.
4. Compilation de votre programme source et lien avec l'API HASP.
5. Installation du systme PCS : connectez une cl HASP votre
ordinateur, puis
En utilisant loutil dEnveloppe DOS :
a) Saisissez le nom de votre application dans le champ
Unprotected Filename.
b) Appuyez sur la touche <F4> pour lancer la protection.
En utilisant loutil dEnveloppe Windows 32 bits :
a) Saisissez le nom de votre application dans le champ
Program File to Protect.
b) Dans le zone Protection Methods, cochez l'option Install
PCS.

Mise en oeuvre du systme PCS

12-5

c) Dans la zone Protection Methods, dcochez l'option Install


HASP Envelope.
d) Cliquez sur l'icne Protect.

Note:

Durant l'installation du systme PCS, l'outil d'Enveloppe


supprime les signatures de tous les motifs PCS.
Aprs l'installation du systme PCS, vous pouvez utilisez
l'Enveloppe pour protger votre application. Pour cela,
suivez les instructions du chapitre 5.
Vous ne pouvez pas installer le systme PCS aprs avoir
install la protection par Enveloppe. Si vous avez dj
mis en place la protection par Enveloppe, crez un
nouveau fichier excutable avant d'installer le systme
PCS.

Le rpertoire pcs du Cdrom HASP contient des exemples


de mise place du systme PCS dans diffrents langages de
programmation.

La Routine hasp( ) et le Systme PCS


Durant l'excution de votre application protge, tout appel la
routine hasp( ) met jour automatiquement tous les motifs inclus
dans votre code.
Peu importe le service vous utilisez lorsque vous appelez la routine
hasp( ), les paramtres de retour de chaque motif recevront des
valeurs jour. Ces valeurs dpendent du service et des paramtres
dfinis dans chaque motif.

Incorporation et Vrification des Motifs


Il est vivement recommand de dclarer les motifs dans diffrents
endroits de votre programme. Les motifs ne sont pas obligatoirement
des variables globales, et peuvent tre dclars dans des fonctions.

12-6

Scurit par Motifs Cods

Comme tous les motifs incorpors dans votre code sont mis jour
aprs chaque appel la routine hasp( ), les vrifications des valeurs
de retour attendues doivent tre rparties dans diffrents sousprogrammes de votre application. De cette manire, le pistage de vos
vrifications devient extrmement difficile.

Note:

Ne dclarez pas de motifs dans les overlays DOS.

Questions Frquemment Poses (FAQ)


Question:

Je ne peux pas utiliser l'Enveloppe DOS pour protger mon


application car je veux activer un mode de dmonstration
si la cl n'est pas prsente.
Comment puis-je installer le systme PCS sans utiliser
l'Enveloppe ?

Rponse:

Loutil dEnveloppe DOS a deux fonctions :


Protger vos fichiers excutables
Installer le systme PCS
Ces deux fonctions sont totalement indpendantes, de ce fait, vous
pouvez installer le systme PCS sans mettre en place la protection
par Enveloppe.
Lancez le programme d'Enveloppe, saisissez le nom de votre
application dans le premier champ et pressez sur la touche <F4>.

Chapitre 13 - Le Programme HaspEdit


HaspEdit est un programme qui vous permet de :
Vrifier les Codes de Retour de votre cl HASP pour un Seed Code
donn.
Lire et Ecrire dans la mmoire HASP.
Dterminer le Numro d'Identification HASP.
Modifier la mmoire HASP pour protger plusieurs applications
avec une seule cl HASP.
Mettre l'heure l'horloge temps-rel de la cl TimeHASP.

Note:

Vous pouvez accder la cl HASP soit par l'API soit par le


programme HaspEdit. Ce chapitre dcrit le programme
HaspEdit.
Pour crire votre propre programme HaspEdit avec l'API,
reportez-vous au chapitre 6.

Lancement de HaspEdit
Pour excuter le programme HaspEdit :
1. Connectez votre cl HAS P au port parallle de l'ordinateur.
2. Lancez le programme HaspEdit selon votre systme d'exploitation :

13-1

13-2

Le Programme HaspEdit

Tableau 13.1: Programme HaspEdit


Systme d'Exploitation

Programme HaspEdit

DOS

haspedit.exe

Windows

whedit.exe

Win32

whedit32.exe

Ce chapitre dcrit le programme whedit.exe, le programme HaspEdit


pour Windows.

Attention
Ne connectez pas plusieurs cls HASP du mme code lorsque vous accdez la
mmoire HASP. Cela peut causer la destruction des donnes contenues dans la
mmoire de toutes les cls connectes.

Saisie des Mots de Passe

13-3

Saisie des Mots de Passe


Avant d'utiliser le programme HaspEdit pour vrifier ou modifier la
cl HASP, vous devez entrez les Mots de Passe associs la cl HASP
.
Pour saisir les Mots de Passe HASP :
1. Choisissez l'option Passwords du menu pour ouvrir la fentre
suivante.

2. Entrez les Mots de Passe HASP dans les champs.

Si vous tes en cours d'valuation sur systme HASP avec


une cl de dmonstration, cliquez sur le bouton DEMO relatif
la cl dont vous disposez. pour entrez automatiquement les
mots de passe.

Vrification des Codes de Retour


Pour protger votre application avec l'API HASP, vous devez
connatre les Codes de Retour attendus pour un Seed Code (Germe) et
une cl HASP donns. HaspEdit vous permet de dterminer les codes
de Retour que votre cl HASP renvoie pour un Seed Code donn. Si
vous ne dsirez pas protger votre application avec l'API HASP, vous
pouvez passer ce chapitre.

13-4

Le Programme HaspEdit

Pour vrifier les Codes de Retour :


1. Choisissez loption Return Codes dans la barre de menu. La
fentre HASP Return Codes s'affiche alors :

2. Dans le champ Seed Code, tapez un entier (de 0 65535) et


cliquez sur le bouton OK. HaspEdit affiche quatre Codes de Retour.
Les Codes de Retour sont des entiers 16-bit non signs.

Vrification du Numro d'Identification


Chaque cl HASP mmoire possde un Numro d'Identification
unique vous permettant de distinguer chaque client. Vous pouvez
incorporer une recherche d'un Numro d'Identification prcis avec
l'API. Dans cette optique, vous devez d'abord dterminer le Numro
d'Identification de la cl avec le programme HaspEdit.

Modifier la Mmoire d'une Cl MemoHASP ou TimeHASP-4

13-5

Pour vrifier le Numro d'Identification d'une cl HAS P


mmoire :
Choisissez loption ID Number du menu Memory. Une fentre
contenant le Numro d'Identification en format dcimal et
hexadcimal apparat. le Numro d'Identification est un entier
32-bit non sign.

Modifier la Mmoire d'une Cl MemoHASP ou


TimeHASP-4
Pour modifier les 248 mots de mmoire de la MemoHASP ou de
la TimeHASP-4 :
1. Choisissez loption Edit Memory du menu Memory pour ouvrir
l'Editeur de Mmoire. L'Editeur de Mmoire contient une grille
reprsentant la mmoire HASP. Avec l'Editeur de Mmoire, vous
pouvez modifier les 56 mots de mmoire de la MemoHASP-1, et les
248 mots de mmoire des cls MemoHASP-4 et TimeHASP-4.

13-6

Le Programme HaspEdit

La partie gauche de la grille reprsente le contenu de la mmoire en notation


hexadcimale; la partie droite en ASCII. Une grille similaire apparat lorsque vous modifier
la mmoire des cls MemoHASP-4 ou TimeHASP-4.

2. Modifiez la mmoire. La grille contient les sections hexadcimale et


ASCII, vous pouvez ainsi entrer les donnes sous la forme que vous
prfrez.
Utilisez les flches de direction ou la souris pour vous dplacer
travers la grille.
Appuyez sur la touche <Tab> pour passer de la section
hexadcimale la section ASCII.
Avec les cls MemoHASP-4 et TimeHASP-4, appuyez sur les
touches <PageUp> et <PageDown> pour changer de page
mmoire HASP.
3. Cliquez sur Write pour crire dans la mmoire.

Modifier la Mmoire TimeHASP

13-7

Modifier la Mmoire TimeHASP


Pour modifier les 16 octets de la mmoire TimeHASP :
1. Choisissez loption Edit Memory du menu Memory pour ouvrir la
fentre de l'Editeur de Mmoire. L'Editeur de Mmoire contient
une grille reprsentant les 16 octets de la mmoire TimeHASP.

2. Modifiez la mmoire. La grille contient les sections hexadcimale et


ASCII, vous pouvez ainsi entrer les donnes sous la forme que vous
prfrez.
Utilisez les flches de direction ou la souris pour vous dplacer
travers la grille.
Appuyez sur la touche <Tab> pour passer de la section
hexadcimale la section ASCII.
Avec la TimeHASP-4, appuyez sur les touches <PageUp> et
<PageDown> pour changer de page mmoire HASP.
3. Cliquez sur Write pour crire dans la mmoire.

13-8

Le Programme HaspEdit

Modifier la Mmoire NetHASP


Pour modifier la mmoire NetHASP :
1. Choisissez loption Edit Memory du menu Memory. La fentre
qui s'ouvre contient dans sa partie suprieure la Liste des
Programmes NetHASP, et l'Editeur de Mmoire dans sa partie
infrieure. L'Editeur de Mmoire contient une grille vous
reprsentant les 24 mots de mmoire NetHASP.

Utilisez l'Editeur de Mmoire pour modifier la mmoire NetHASP. Le NetHASP Program


List vous permet de personnaliser votre cl NetHASP (voir page Erreur! Signet non
dfini.).

2. Cliquez sur Edit Memory pour modifier la mmoire NetHASP en


lecture/criture.

Rglage de l'Horloge TimeHASP

13-9

3. Modifiez la mmoire. La grille contient les sections hexadcimale et


ASCII, vous pouvez ainsi entrer les donnes sous la forme que vous
prfrez.
Utilisez les flches de direction ou la souris pour vous dplacer
travers la grille.
Appuyez sur la touche <Tab> pour passer de la section
hexadcimale la section ASCII.
Cliquez sur Write pour crire dans la mmoire NetHASP.

Rglage de l'Horloge TimeHASP


Avec les cls TimeHASP ou TimeHASP-4, HaspEdit vous permet de
mettre l'heure l'horloge TimeHASP temps-rel. HaspEdit vous
permet de :
Voir l'heure et la date actuelle.
Modifier l'heure et la date de l'horloge TimeHASP.
Pour rgler l'horloge TimeHASP :
1. Choisissez loption Time and Date du menu. La fentre Set
TimeHASP Clock apparat, affichant l'heure et la date actuelle.

13-10

Le Programme HaspEdit

2. Entrez l'heure et la date dsire dans les champs correspondants.


L'horloge TimeHASP utilise le format horaire sur 24 heures
(00:00 23:59).
Entrez la date au format amricain : mm-jj-aa.
3. Cliquez sur Write pour sauvegarder l'heure et la date.

Personnalisation de NetHASP
Avant de fournir votre application, utilisez le programme HaspEdit
pour personnaliser votre cl NetHASP. Vous personnalisez une cl
NetHASP en dfinissant les paramtres de protection pour votre(vos)
application(s).

Paramtres de Protection NetHASP


Vous pouvez dfinir trois paramtres pour chacune des applications
protges par NetHASP : Numro de Programme, Nombre de Stations
Licencies et Nombre de Lancements Autoriss.

Numro de Programme
Assignez un nombre de 1 112 pour chaque application ou module
que vous dsirez protger. Notez bien le nombre assign chaque
application, vous en aurez besoin pour accder la cl NetHASP avec
l'API.
Avec le programme d'Enveloppe, vous utilisez le nombre pour
indiquer quelle application vous tes en train de protger.

Personnalisation de NetHASP

13-11

Nombre de Stations Licencies


Le nombre de stations licencies est le nombre de stations du rseau
pouvant excuter l'application au mme moment.
Dfinissez ce nombre pour chaque application. Sa valeur maximale
dpend du modle de cl NetHASP que vous utilisez.

Nombre de Lancements Autoriss


Le nombre de lancements autoriss est le nombre total de lancements
de l'application protge.
Le nombre de lancements est enregistr collectivement pour
l'ensemble des stations du rseau. Cette option est utile si vous louez
ou distribuez des versions de dmonstration de votre programme.

Dfinition des Paramtres de Protection NetHASP


Pour dfinir les paramtres de protection :
1. Choisissez loption Edit Memory du menu Memory. La fentre
qui s'ouvre contient dans sa partie suprieure la Liste des
Programmes NetHASP, et l'Editeur de Mmoire dans sa partie
infrieure. L'Editeur de Mmoire contient une grille vous
reprsentant les 24 mots de mmoire NetHASP. Utilisez la
NetHASP Program List pour dfinir les paramtres de protection.

13-12

Le Programme HaspEdit

Le NetHASP Program List vous permet de personnaliser votre cl NetHASP Utilisez


l'Editeur de Mmoire pour modifier la mmoire NetHASP(voir page 13-8).

2. Pour ajouter une nouvelle application dans la liste, cliquez sur le


bouton Add. Pour modifier les paramtres d'une application dj
existante, slectionnez l'application et cliquez sur le bouton Edit
List.
3. Entrez le Numro de Programme dans le champ Program
Number.
4. Entrez le Nombre de Stations Licencies dans le champ
Authorized Number of Stations.

Le Full Authorization System

Note:

13-13

Le nombre maximum de stations licencies apparat


dans la NetHASP Program List. HaspEdit n'acceptera
pas une valeur suprieure la valeur maximale
autorise par la cl.

5. Entrez le nombre de lancements autoriss dans le champ


Authorized Number of Activations (tapez <U> pour un nombre
de lancements illimits). Aprs avoir appuy sur la touche
<Entre>, les paramtres de protection apparaissent dans la
NetHASP Program List.
6. Cliquez sur Write pour sauvegarder ces informations dans la
mmoire NetHASP.

Le Full Authorization System


Le Full Authorization System (FAS) est un outil puissant pour les
dveloppeurs de logiciels qui dsirent protger plusieurs applications
avec une seule cls HASP monoposte mmoire. Pour plus
d'informations sur le fonctionnement du systme FAS, reportez-vous
au chapitre 5.
Avec FAS, vous pouvez protger jusqu' :
16 applications avec une MemoHASP-1
112 applications avec une MemoHASP-4
8 applications avec une TimeHASP ou une TimeHASP-4
Utilisez le programme HaspEdit pour dfinir la liste des applications
que vous dsirez protger avec la cl HASP.
Si vous utilisez le FAS avec la cl MemoHASP, vous pouvez limiter le
nombre de lancements de l'application. Avec une cl TimeHASP ou
TimeHASP-4, vous pouvez dfinir une date d'expiration pour chacune
des applications.

13-14

Le Programme HaspEdit

Note Cette section porte sur les cls MemoHASP, TimeHASP et


NetHASP: TimeHASP-4. Avec une cl NetHASP, le FAS n'est pas une

option, mais fait partie intgrante du systme NetHASP. En


personnalisant votre cl NetHASP, vous mettez en place le
FAS (voir page Erreur! Signet non dfini.).

Dfinition de la Liste d'Autorisation FAS pour une cl


MemoHASP
Pour dfinir la liste d'autorisation FAS pour une cl
MemoHASP:
1. Choisissez loption Full Authorization System
Memory. La fentre FAS Program List apparat.

du

menu

Le Full Authorization System

13-15

Utilisez la FAS Program List pour dfinir la liste d'autorisation FAS pour votre MemoHASP.
L'Editeur de Mmoire contient des zones de mmoire non rserv pour le FAS (les
premiers 24 mots). Utilisez l'Editeur de Mmoire pour modifier cette zone de la mmoire
MemoHASP.

2. Pour ajouter une nouvelle application dans la liste, cliquez sur le


bouton Add. Pour modifier les paramtres d'une application dj
existante, slectionnez-la et cliquez sur le bouton Edit List.
3. Entrez le Numro de Programme, utilis pour protger
l'application avec l'Enveloppe, dans le champ Program Number.
4. Entrez le nombre de lancements autoriss dans le champ
Authorized Number of Activations (tapez <U> pour un nombre
de lancements illimits). Aprs avoir appuy sur la touche
<Entre>, les paramtres de protection apparaissent dans la FAS
Program List.
5. Cliquez sur Write pour sauvegarder ces informations dans la
mmoire MemoHASP.

Si vous utilisez le FAS et que vous dsiriez sauvegarder des


informations dans la zone mmoire rserve pour le FAS (en
utilisant l'Editeur de Mmoire standard dcrit page 13-5),
contactez votre distributeur HASP et demandez-lui le
MemoHASP Memory Layout.

Dfinition de la Liste d'Autorisation FAS pour une cl


TimeHASP ou TimeHASP-4
Pour dfinir la liste d'autorisation FAS pour une cl
TimeHASP ou TimeHASP-4 :
1. Choisissez loption Full Authorization System du menu
Memory. La fentre TimeHASP FAS Program List apparat.

13-16

Le Programme HaspEdit

2. Pour ajouter une nouvelle application dans la liste, cliquez sur le


bouton Add. Pour modifier les paramtres d'une application dj
existante, slectionnez-la et cliquez sur le bouton Edit List.
3. Entrez le Numro de Programme, utilis pour protger
l'application avec l'Enveloppe, dans le champ Program Number.
4. Dans le champ Expiry Date, entrez la date du dernier lancement
de cette application.

Note:

Entrez la date au format amricain : mm-jj-aa.


entrez 0-0-0 pour une utilisation non limite dans le
temps.
Les annes autoriss vont de 0 99, o 92 99 fait
rfrence 1992-1999, et 00 91 2000-2091.
Les donnes sauvegardes dans la mmoire TimeHASP
avec l'Editeur de Mmoire peut apparatre comme des
dates invalides lorsque visualises dans la fentre FAS
Program List. si vous n'utilisez pas cette mmoire pour le
FAS, vous pouvez ignorer le message de dates invalides.

6. Cliquez sur Write pour sauvegarde les informations dans la


mmoire TimeHASP.

Le Full Authorization System

13-17

Si vous utilisez le FAS et que vous dsiriez sauvegarder des


informations dans la zone mmoire rserve pour le FAS (en
utilisant l'Editeur de Mmoire standard dcrit page 13-5),
contactez votre distributeur HASP et demandez-lui le
TimeHASP Memory Layout.

13-18

Le Programme HaspEdit

Chapitre 14 - Le Gestionnaire de
Priphrique HASP
Le Gestionnaire de Priphrique HASP est une interface entre les
applications protges par le systme HASP et les cls HASP. En
d'autres termes, les applications protges communiquent avec les
cls HASP via le Gestionnaire de Priphrique HASP.
Le tableau 14.1 montre les applications utilisant le Gestionnaire de
Priphrique HASP sous divers systmes d'exploitation.

14-1

14-2

Le Gestionnaire de Priphrique HASP

Tableau 14.1: Applications utilisant


le Gestionnaire de Priphrique HASP
Systme d'Exploitation
Type
d'Application

Windows
(16-bit)

Win32s

Windows 95

Windows NT

DOS

optionnel

optionnel

requis

requis

Windows
(16-bit)

optionnel

optionnel

requis

requis

Win32

requis

requis

requis

Lorsque la prsence d'un Gestionnaire de Priphrique HASP est


requis, mais non install, l'application protge ne pourra pas trouver
la cl HASP.
Lorsque le Gestionnaire de Priphrique HASP est optionnel, et qu'il
n'est pas install, l'application protge communique directement
avec la cl HASP. Pour augmenter les performances et viter des
conflits entre des priphriques utilisant le port parallle (comme des
imprimantes) et les accs la cl HASP, il est recommand d'install
le Gestionnaire de Priphrique HASP.
N'installez le Gestionnaire de Priphrique HASP que sur des
ordinateurs ayant une cl HASP connecte sur le port parallle local.
Note
NetHASP:

En environnement rseau, n'installez le Gestionnaire de


Priphrique HASP que sur la station laquelle est
connecte la cl HASP.

Le Gestionnaire de Priphrique HASP est compos de plusieurs


gestionnaires. Les sections suivantes dcrivent l'installation et
l'emplacement des gestionnaires installs sous les diffrents
environnements.

Gestionnaire de Priphrique HASP pour Windows

14-3

Gestionnaire de Priphrique HASP pour Windows


Le Gestionnaire de Priphrique HASP pour Windows est compos de
d'un seul fichier.
Fichier:
Localisation aprs installation:

hasp.386

(Gestionnaire de Priphrique Virtuel


Windows)
Rpertoire SYSTEM de Windows

Procdure d'Installation
Excutez le programme setup.exe (voir page 14-5).

Gestionnaire de Priphrique HASP pour Win32s


Le Gestionnaire de Priphrique HASP pour Win32s est compos de
deux fichiers.
Fichier:

hasp.386

Localisation aprs installation:

(Gestionnaire de Priphrique Virtuel


Windows)
Rpertoire SYSTEM de Windows

Fichier:
Localisation aprs installation:

hasput16.dll
(Universal Thunk DLL)
Rpertoire SYSTEM de Windows

Procdure d'Installation
Excutez le programme hinstall.exe (voir page 14-5).

Gestionnaire de Priphrique HASP pour Windows 95


Le Gestionnaire de Priphrique HASP pour Windows 95 est compos
d'un fichier.
Fichier:
Localisation aprs installation:

hasp95.vxd
(Gestyonnaire de Priphrique Virtuel)
Rpertoire SYSTEM de Windows 95

14-4

Le Gestionnaire de Priphrique HASP

Procdure d'Installation
Excutez le programme hinstall.exe (voir page 14-5).

Gestionnaire de Priphrique HASP pour Windows


NT
Le Gestionnaire de Priphrique HASP pour Windows NT est
compos de trois fichiers.
Fichier:
Localisation aprs installation:

(Noyau du Gestionnaire de
Priphrique)
Rpertoire SYSTEM32\DRIVERS de Windows NT

Fichier:
Localisation aprs installation:

haspvdd.dll
(Gestionnaire de Priphrique Virtuel)
Rpertoire SYSTEM32 de Windows NT

Fichier:
Localisation aprs installation:

haspdos.sys
(Gestionnaire de Priphrique DOS)
Rpertoire SYSTEM32 de Windows NT

Note:

haspnt.sys

Le Gestionnaire de Priphrique HASP supporte les


systmes Windows NT tournant sur des ordinateurs multiprocesseurs.

Procdure d'Installation
Excutez le programme hinstall.exe (voir page 14-5).

Note:

Les applications Windows 32-bit Natif accdent au


Noyau du Gestionnaire de Priphrique.
Les applications Windows 16 bit Natif utilisent le
Gestionnaire de Priphrique Virtuel qui lui-mme
utilise le Noyau du Gestionnaire de Priphrique.
Les applications DOS utilisent le Gestionnaire de
Priphrique DOS. Les Gestionnaire de Priphrique
DOS utilise le Noyau du Gestionnaire de Priphrique

Le Programme Setup

14-5

via le Gestionnaire de Priphrique Virtuel.

Le Programme Setup
Le programme Setup.exe est une application Win16 installant le
Gestionnaire de Priphrique pour Windows. Le lancement du
programme Setup active le Setup Wizard, qui vous guidera durant la
procdure d'installation.
Le programme Setup reconnat automatiquement le systme
d'exploitation utilis et installe les bons fichiers aux bons endroits.
Vous pouvez trouver le programme setup.exe sur le CD HASP sans le
rpertoire drivers\install\Win16. Avec le programme setup.exe, vous
devez fournir vos clients tous les fichiers contenus dans le rpertoire
drivers\install\Win16.
Pour installer, dsinstaller ou mettre jour le Gestionnaire de
Priphrique HASP :
1. Fermez toutes les applications Windows.
2. Excutez le programme setup.exe.

Le programme Hinstall
Le programme Hinstall.exe est une application Win32 permettant
l'installation du Gestionnaire de Priphrique HASP sous Win32s,
Windows 95 et Windows NT.
Vous pouvez trouver le programme hinstall.exe sur le CD HASP, dans
le rpertoire drivers\install\Win32. Vous devez fournir ce fichier
hinstall.exe vos clients.
Aprs le lancement du programme Hinstall, le Gestionnaire de
Priphrique HASP est charg dynamiquement sous Windows NT.

14-6

Le Gestionnaire de Priphrique HASP

Sous Windows 95 et Win32s, le Gestionnaire de Priphrique HASP


ne charge pas automatiquement, vous devez alors redmarrer
l'ordinateur.
Le programme Hinstall reconnat automatiquement le systme
d'exploitation et installe les bons fichiers aux bons endroits.
Le programme Hinstall reconnat galement le type d'ordinateur
IBM ou NEC. Cela permet une application protge de fonctionner
sur une plate-forme IBM ou NEC sans modification.

Note:

Pour utiliser le programme hinstall.exe sous Windows NT,


vous devez avoir les droits Administrateur.

Pour installer le Gestionnaire de Priphrique HASP :


1. Excutez le programme hinstall -i.
2. Sous Windows 95 et Win32s, redmarrez l'ordinateur.
Pour dsinstaller le Gestionnaire de Priphrique HASP :
1. Excutez le programme hinstall -r.
2. Sous Windows 95 et Win32s, redmarrez l'ordinateur.
Pour mettre jour le Gestionnaire de Priphrique HASP :
1. Installez le nouveau Gestionnaire de Priphrique HASP.
2. Sous Windows 95 et Win32s, redmarrez l'ordinateur.

Note:

Le programme hinstall possde de nombreuses options (voir


hinstall.hlp, ou excutez le programme hinstall -? pour plus
d'informations).

Installation Personnalise du Gestionnaire de Priphrique HASP

14-7

Installation Personnalise du Gestionnaire de


Priphrique HASP
Vous pouvez installer le Gestionnaire de Priphrique HASP pour
Win32 selon l'une des deux mthodes suivantes :
Excutez le programme hinstall. Vous pouvez crire un fichier de
commande (fichier batch) pour effectuer l'installation et diffuser ce
fichier avec votre application.
Installez le Gestionnaire de Priphrique HASP partir de votre
application en crant votre propre programme d'installation.
Vous pouvez effectuer l'installation via une DLL ou bibliothque.
L'installation personnalise vous permet d'installer ou dsinstaller le
Gestionnaire de Priphrique HASP partir de votre application
crite en Win32 Natif.
Dans le rpertoire drivers\Win32\install vous trouverez des
interfaces pour diffrents compilateurs. Le rpertoire de chaque
interface contient un exemple de programme d'installation nomm
hidemo.c. Pour plus d'informations, reportez-vous au fichier
hinstall.hlp.

Questions Frquemment Poses (FAQ)


Question:

Une nouvelle version du Gestionnaire de Priphrique


HASP peut-elle fonctionner avec des anciennes versions de
l'Enveloppe et de l'API ?

Rponse:

Oui, les nouvelles versions du Gestionnaire de Priphrique HASP


supportent les anciennes versions de l'API et de l'Enveloppe.
Inversement, les nouvelles versions de l'API et de l'Enveloppe
requirent les versions les plus rcentes du Gestionnaire de
Priphrique HASP.
Les API HASP antrieures Mai 1995 ne peuvent utiliser le

14-8

Le Gestionnaire de Priphrique HASP

Gestionnaire de Priphrique HASP Driver.


Question:

Comment savoir si un Gestionnaire de Priphrique HASP


est install sur l'ordinateur de mon client ?

Rponse:

Exzcutez le programme hinstall /info. Hinstall affiche des


informations sur l'installation comme la date et le numro de
version du Gestionnaire de Priphrique HASP.

Question:

Le Gestionnaire de Priphrique HASP se charge-t'il


dynamiquement ?

Rponse:

Oui, sous Windows NT le Gestionnaire de Priphrique HASP se


charge dynamiquement. Ce n'est pas le cas sous Windows 95 et
Win32s; de ce fait, vous devez redmarrer l'ordinateur aprs
l'installation.

Question:

Le Gestionnaire de Priphrique HASP supporte t'il les


communications bi-directionelles ?

Rponse

Oui. Le Gestionnaire de Priphrique HASP reconnat


automatiquement la configuration du port parallle et adapte
ainsi son fonctionnement. Au cas o le Gestionnaire de
Priphrique HASP ne reconnatrait pas le paramtrage du port
parallle, vous pouvez
personnaliser
l'installation
des
programmes Setup ou Hinstall en leur indiquant comment le
Gestionnaire de Priphrique HASP doit grer le port parallle.
Avec le programme Setup la personnalisation s'effectue en
cliquant sur le bouton Custom. Avec Hinstall, la personnalisation
est effectue l'aide du paramtre -portmode.
Pour plus de dtails sur le paramtre -portmode, veuillez vous
reporter au fichier hinstall.hlp.

Chapitre 15 - Comment Assurer une


Protection Maximale des Logiciels
La rgle d'or de la protection de logiciels avec HASP est que la
scurit offerte par le systme de protection ne peut tre meilleure
que celle des routines qui appellent la cl et dcident de permettre
l'excution du programme protg. En d'autres termes, comme
l'architecture matrielle des cls HASP est trop complexe pour tre
dcode ou duplique, les pirates vont, en gnral, tenter pister le
code de protection et d'liminer les routines de protection.
Nous vous fournissons les meilleurs outils de protection disponibles
tant matriels que logiciels. Cependant, le niveau de scurit de votre
application est fonction de la complexit et de la pertinence de
l'implantation de la protection.
Aucune technique isole ne peut arrter les pirates. Plus vous
utiliserez de piges et de garanties, plus votre logiciel sera difficile
pirater. Pour obtenir une protection maximale avec le systme HASP,
utilisez une combinaison des protections par Enveloppe et par API.
Pour augmenter la rsistance de votre application, si vous n'utilisez
que l'API, utilisez les techniques dcrites dans ce chapitre.

Utilisez des Appels Multiples


Utilisez de nombreux appels la cl avec autant de Seed Codes
diffrents . Plus il y a d'appels et de Codes de Retour tester , plus il
est difficile de les pister et de les retirer. Il est important de placer les
appels diffrents endroits du programme.

15-1

15-2

Comment Assurer une Protection Maximale des Logiciels

Utilisez Diffrents Codes Graine


Construisez, dans votre application, un tableau contenant les
diffrents Seed Codes et Codes de Retour.
Vrifiez la cl HASP de la faon suivante :
1. Choisissez un nombre alatoire, n.
2. Appelez la routine hasp( ) avec le nme Code Graine du tableau, et
tester si le Code de Retour obtenu correspond au nme Code de
Retour.
Avec cette technique, chaque fois que l'application est lance, vous
testez la cl HASP avec un Code Graine diffrent.

Utilisez des Expressions Mathmatiques


Vrifiez les Codes
mathmatiques.

de

Retour

en

utilisant

des

expressions

Par exemple :
Si vous attendez le Code de Retour 26387, incorporez une expression
mathmatique incluant cette valeur; comme :
Si (CodeRetour1-7)/4 = (CodeRetourAttendu1-6602)/3 Alors...

Sommes de Contrle
Effectuez une somme de contrle de l'application pour dtecter si elle
a t modifie. La mthode la plus simple consiste :
1. Calculer la somme de contrle.
2. La comparer avec la valeur correcte.

Sommes de Contrle

15-3

3. Si les deux valeurs ne correspondent pas, gnrer un message


d'erreur; sinon continuer.
Malheureusement, cette mthode est vulnrable diffrentes
attaques.
Le pirate peut modifier le code pour contourner le test.
Si le pirate identifie l'algorithme de somme de contrle, il peut
modifier le code du programme, et ajouter du code pour compenser
les octets modifis; cela renverra toujours la mme valeur de
somme de contrle.
Plusieurs amliorations sont possibles :
Evitez les simples additions ou les XOR. Utilisez un CRC (cyclic
redundancy check - test de redondance cyclique), ou un autre
algorithme sensible l'ordre des octets.
Ne comparez pas le rsultat avec une valeur prcalcule. Utilisez
plutt le rsultat dans une opration causant une erreur si la
bonne valeur n'est pas utilise. Par exemple, stockez le rsultat
dans une variable, et utilisez cette variable plus tard comme une
cl de dcryptage d'un certain code ou donnes. Cela a l'avantage
d'une action retarde et la somme de contrle attendue n'est pas
explicitement stocke dans l'application.

15-4

Comment Assurer une Protection Maximale des Logiciels

Cachez les Mots de Passe et les Codes de Retour


Cachez vos Mots de Passe
protge, pour cela :

et Codes de Retour

dans lapplication

Cryptez-les.
Sauvegardez-les dans diffrentes parties du code de votre
application.
Comparez les diffrentes variables dans lesquelles vous avez
sauvegard les mots de passe et les codes de retour pour viter
leurs modifications.
Appelez la routine hasp( ) avec des mots de passe volontairement
faux.

Utilisez les Rponses des Appels


Aprs avoir vrifi que la bonne cl HASP est connecte, utilisez les
diffrentes valeurs de retour pour effectuer diffrents tches dans
votre application.
Deux options efficaces sont :
Utiliser les valeurs retournes comme cls d'algorithmes de
codage.
Utiliser les valeurs retournes pour initialiser des variables.

Sparez les Etapes de Vrification

15-5

Sparez les Etapes de Vrification


Ne ragissez pas immdiatement aux appels de vrification. Par
exemple, ne testez pas une valeur donne pour mettre aussitt un
message d'erreur si le rsultat est incorrect. Dans ce cas, le pirate
comprendrait facilement le mcanisme que vous utilisez.
Il est prfrable de :
1. Stocker la valeur dans une variable, A.
2. Tester la valeur de A quelques lignes plus loin, et dfinir une
nouvelle variable, B, pour indiquer si vous acceptez la valeur de A.
3. Dans un autre module, tester la valeur de B.
4. Si ncessaire, afficher un message d'erreur.
Forcez les pirates travailler l'envers pour trouver comment B a
pris une valeur donne et pourquoi le programme a chou cause de
cela. La relation avec la valeur d'origine retourne ne doit plus tre
vidente.

Utilisez des Donnes Dpendantes de HASP


Lorsque vous utilisez des donnes stockes dans la mmoire d'une cl
HASP, vous vrifiez gnralement cette valeur avant de l'utiliser.
Mais cette procdure vous oblige garder la vraie valeur dans votre
application. La valeur est ainsi accessible aux pirates.
Pour viter que les pirates n'accdent ces donnes, nous vous
recommandons de la lire et de l'utiliser dans votre application sans
explicitement vrifier sa validit. Si la cl HASP est prsente, la
valeur sera valide; sinon, la valeur sera invalide provoquant une
erreur.

15-6

Comment Assurer une Protection Maximale des Logiciels

Utilisez le systme PCS


Utilisez le systme de Scurit par Motifs Cods pour augmenter la
scurit de votre application. Avec le systme PCS, lorsque la routine
de protection HASP est appele, de nombreux processus simultans
sont excuts diffrents endroits du programme. Reportez-vous au
chapitre 12 pour plus de dtails.

Chapitre 16 - Installation de NetHASP sur un


Rseau
Ce chapitre dcrit les tapes d'installation de NetHASP et de
configuration des stations du rseau au systme NetHASP.
Avec l'application protge, vous devez avoir :
Une cl NetHASP.
Tous les Gestionnaires de Licence NetHASP - des applications qui
facilitent la communication entre l'application protge et
NetHASP.
Le Gestionnaire de Priphrique HASP - une interface entre le
Gestionnaire de Licence NetHASP et la cl NetHASP.
Les outils de test NetHASP - des outils de diagnostic
systme NetHASP.

pour le

Le Moniteur NetHASP - un outil vous permettant de surveiller les


Gestionnaires de Licence NetHASP sur le rseau et les
applications utilisant des licences NetHASP.
Nethasp.ini - le Fichier de Configuration NetHASP, dans lequel
vous pouvez modifier les paramtres par dfaut de NetHASP.
Nethasp.txt - ce chapitre au format texte.

Rseaux et Protocoles Supports par


NetHASP
NetHASP supporte les rseaux suivants : 3Com, Banyan Vines, DLink, DEC Pathworks, Netware Lite, Novell 3.x, Novell 4.x, rseau
Windows NT, LANtastic, LanManager, OS/2 Lan Server, et tout autre
rseau utilisant les protocoles ci-dessous.

16-1

16-2

Installation de NetHASP sur un Rseau

NetHASP supporte les protocoles de communication rseau IPX,


TCP/IP, et NetBIOS.

Support IPX
NetHASP sous IPX supporte les mcanismes suivants :
Novell
SAP
(Bindery) - mcanisme
Novell
permettant
l'enregistrement d'applications ncessitant des annonces rseau
(@@network advertising).
Broadcast - le Gestionnaire de Licence NetHASP est constamment
l'coute des stations scrutant le rseau.
Fichier d'Adresse NetHASP - communication avec le Gestionnaire
de Licence NetHASP via un systme de fichier (fichier d'adresse).

Support TCP/IP
Sous les environnements supportant TCP/IP, NetHASP fonctionne
selon deux modes :
TCP, UDP - l'adresse du Gestionnaire de Licence Net HASP est
spcifi.
Broadcast UDP - le Gestionnaire de Licence NetHASP est
constamment l'coute des stations scrutant le rseau.

Support NetBIOS
NetHASP supporte diffrents types de NetBIOS dont Microsoft
NetBEUI.

Le Gestionnaire de Licence NetHASP

16-3

Le Gestionnaire de Licence NetHASP


Vous pouvez connecter la cl NetHASP sur n'importe quel ordinateur
du rseau. Cet ordinateur ne doit pas ncessairement tre un serveur
de fichier du rseau. Si le bon Gestionnaire de Licence NetHASP est
activ, les applications protges par NetHASP vont communiquer
avec la cl NetHASP.
Le Gestionnaire de Licence NetHASP est indpendant de la cl
NetHASP et de l'application protge, mais fonctionne comme un lien
entre les deux.
Quelque soit l'environnement sous lequel fonctionne l'application
protge - DOS, Windows, Windows 32 bits, ou OS/2 - vous pouvez
activer le Gestionnaire de Licence NetHASP de votre choix pour
communiquer avec l'application protge et la cl NetHASP. Un
Gestionnaire de Licence NetHASP peut grer jusqu' 250 clients
NetHASP.
Lorsque plusieurs applications sont protges avec diffrentes cls
NetHASP, nous vous recommandons de chaner toutes les cls sur un
seul ordinateur. Vous pouvez aussi connecter les cls sur autant
d'ordinateurs, mais vous devrez lancer un Gestionnaire de Licence
NetHASP sur chacun de ces ordinateurs.
Note:

Le Gestionnaire de Licence NetHASP doit rester actif aussi


longtemps
qu'une
application
protge
est
en
fonctionnement.

Le Gestionnaire de Licence NetHASP que vous utilisez doit tre


compatible avec le systme d'exploitation de l'ordinateur sur lequel il
est lanc. Le tableau ci-dessous montre les diffrents Gestionnaire de
Licence NetHASP, les systmes d'exploitation sous lesquels ils
fonctionnent et les protocoles supports.

16-4

Installation de NetHASP sur un Rseau

Tableau 16.1: Protocoles supports par


les Gestionnaires de Licence NetHASP
Gestionnaire de Licence NetHASP

IPX

TCP/IP

NetBIOS

DOS (haspserv.exe)

Windows et Win32s (nhsrvwin.exe)

Windows 95 et Windows NT (nhsrvw32.exe)

Serveurs de fichiers Netware 386 et 486 (haspserv.nlm)

OS/2 (nhsrvos2.exe)

Note:

Par dfaut, le Gestionnaire de Licence NetHASP pour


Win32s coute les trois protocoles simultanment.

Les sections suivantes dcrivent la procdure d'activation du


Gestionnaire de Licence NetHASP sur diffrentes stations et serveurs
de fichiers du rseau.

NetHASP sur une Station DOS


Le Gestionnaire
haspserv.exe.

de

Licence

NetHASP

pour

DOS

s'appelle

Pour charger le Gestionnaire de Licence NetHASP :


1. Connectez la cl NetHASP sur la station DOS.
2. Lancer le programme haspserv.exe. Un message apparat, vous
informant que le Gestionnaire de Licence Net HASP est charg. Le
message indique galement le type de protocole utilis.
Note:

Pour lancer le Gestionnaire de Licence NetHASP


automatiquement, ajoutez-le dans le fichier autoexec.bat.

Pour enlever le Gestionnaire de Licence NetHASP :

Le Gestionnaire de Licence NetHASP

16-5

Excutez haspserv.exe -r.


ou, supprimez la ligne d'appel dans le fichier autoexec.bat et
redmarrez la station.

NetHASP sur une Station Windows ou Win32s


Le Gestionnaire de Licence NetHASP pour Windows est nhsrvwin.exe.
Pour charger le Gestionnaire de Licence NetHASP :
1. Connectez la cl NetHASP la station Windows ou Win32s.
2. Lancez le programme nhsrvwin.exe. Une fentre apparat, vous
informant que le Gestionnaire de Licence NetHASP est charg. Le
message indique galement le protocole utilis.
Note:

Pour lancer automatiquement le Gestionnaire de Licence


NetHASP pour Windows, copiez son icne dans le groupe de
Dmarrage.

Pour enlever le Gestionnaire de Licence NetHASP :


Choisissez l'option Remove dans
Gestionnaire de Licence NetHASP.

la

barre

de

menu

du

NetHASP sur un Serveur de Fichiers sous Novell Netware 386/486


Le Gestionnaire de Licence NetHASP pour serveur de fichiers Novell
Netware s'appelle haspserv.nlm.
Pour charger le Gestionnaire de Licence NetHASP :
1. Connectez la cl NetHASP sur le serveur Novell.
2. Copiez le fichier haspserv.nlm dans le rpertoire SYSTEM du
serveur de fichiers.
3. Chargez le Gestionnaire de Licence NetHASP, en saisissant :

16-6

Installation de NetHASP sur un Rseau

load haspserv
L'cran du Gestionnaire de Licence NetHASP apparat indiquant le
protocole utilis.
Note:

Pour chargez automatiquement le Gestionnaire de Licence


NetHASP, ajoutez la ligne load haspserv dans le fichier
autoexec.ncf du rpertoire sys:system.

Pour enlever le Gestionnaire de Licence NetHASP :


Tapez unload haspserv.

NetHASP sur une Station Windows 95


Le Gestionnaire de Licence Net HASP pour Windows 95 s'appelle
nhsrvw32.exe.
Pour charger le Gestionnaire de Licence NetHASP :
1. Connectez la cl NetHASP la station Windows 95.
2. Installez le Gestionnaire de Priphrique HASP sur la station
Windows 95 en lanant :
hinstall -i.
3. Excutez le programme nhsrvw32.exe. Une fentre apparat vous
informant que le Gestionnaire de Licence NetHASP est charg. Le
message indique galement le protocole utilis.
Pour enlever le Gestionnaire de Licence NetHASP :
Choisissez l'option Exit dans le menu principal du Gestionnaire
de Licence NetHASP.

NetHASP sur une Station Windows NT


Le Gestionnaire de Licence NetHASP pour Windows NT s'appelle
nhsrvw32.exe.

Le Gestionnaire de Licence NetHASP

16-7

Pour charger le Gestionnaire de Licence NetHASP :


1. Connectez la cl NetHASP la station Windows NT.
2. Installez le Gestionnaire de Priphrique HASP sur la station
Windows NT en lanant :
hinstall -i.
3. Si vous utilisez Windows NT version 4.0, passez l'tape 4.
Avec des versions de Windows NT antrieures la 4.0, vous devez
optimiser la rponse du Gestionnaire de Licence NetHASP en
activant l'option @@multitche (tasking option) .
Cette procdure permet Windows NT d'attribuer les mmes
priorits aux processus en avant-plan et en tche de fond, et vous
assure que le Gestionnaire de Licence NetHASP fonctionnera
correctement mme en tche de fond.
a. Double-cliquez sur l'icne Systme du Panneau de Contrle.
b. Cliquez sur le bouton @@Tasking de la fentre Systme.
c. Dans le fentre @@Tasking Foreground/Background
Responsiveness frame, cochez:
Foreground and Background Applications Equally Responsive.
d. Cliquez sur OK pour sauver les modifications.
4. Excutez le programme nhsrvw32.exe. Une fentre apparat vous
informant que le Gestionnaire de Licence NetHASP est charg. Le
message indique galement le protocole utilis.
Pour enlever le Gestionnaire de Licence NetHASP :
Choisissez l'option Exit du menu principal du Gestionnaire de
Licence NetHASP.

Chargement Automatique du Gestionnaire de Licence NetHASP

16-8

Installation de NetHASP sur un Rseau

Sous Windows NT, vous pouvez charger automatiquement le


Gestionnaire de Licence NetHASP avant la connexion rseau, grce
au programme hinstall.exe.
Hinstall installe un module HASP de chargement NT qui fonctionne
comme un service Windows NT. Ce module de chargement assure
l'excution automatique du Gestionnaire de Licence NetHASP. Avec
ce module, vous n'avez pas besoin d'ouvrir une session pour activer le
Gestionnaire de Licence NetHASP.
Pour installer le module HASP de chargement NT :
1. Ouvrez une session sur la station avec les droits Administrateur.
2. Excutez hinstall -is.
3. Copiez le Gestionnaire de Licence NetHASP pour Windows 32bitsnhsrvw32.exe - dans le sous-rpertoire SYSTEM32 du rpertoire de
base de Windows NT.
4. Redmarrez la machine. Le module HASP de chargement NT
lancera automatiquement le Gestionnaire de Licence NetHASP.
Note:

Comme le Gestionnaire de Licence NetHASP se charge


automatiquement avant l'ouverture de session, les messages
du module HASP de chargement NT et du Gestionnaire de
Licence NetHASP n'apparatront pas l'cran avant
l'ouverture d'une session. Par exemple, si vous essayez de
charger le Gestionnaire de Licence NetHASP sans avoir au
pralable connect une cl NetHASP l'ordinateur, vous ne
verrez pas le message d'erreur "HASP not found" ("Cl HASP
non trouve") tant que vous n'aurez pas ouvert de session.

Pour enlever le module HASP de chargement NT :


1. Ouvrez une session avec les droits Administrateur.
2. Excutez hinstall -rs.
3. Redmarrez l'ordinateur.

Voir le Module HASP de Chargement NT dans le Gestionnaire de Service

Recherche Automatique de NetHASP

16-9

Si le Module HASP de chargement NT a t correctement install,


vous pouvez le voir dans le Gestionnaire de Services de Windows NT.
Pour accder au SCManager:
1. Dans le Panneau de Configuration, double-cliquez sur l'icne
Services. Le Module HASP de chargement NT apparat dans la
liste des Services.
2. Vrifiez que le
champ Statut est vide, et que le champ
Dmarrage contient la valeur Automatique.

NetHASP sur une Station OS/2


Le Gestionnaire
nhsrvos2.exe.

de

Licence

NetHASP

pour

OS/2

sappelle

Pour charger le Gestionnaire de Licence NetHASP :


1. Connectez une cl NetHASP la station OS/2.
2. Excutez le programme nhsrvos2.exe.
Pour charger automatiquement le Gestionnaire de Licence
NetHASP au dmarrage :
Ajoutez la ligne suivante dans le fichier startup.cmd :
start nhsrvos2
Pour enlever le Gestionnaire de Licence NetHASP :
Basculez vers le Gestionnaire de Licence NetHASP et pressez sur
<Q>.

Recherche Automatique de NetHASP


Le point le plus critique dans l'installation du systme NetHASP est
de s'assurer que le client NetHASP (la station excutant l'application

16-10

Installation de NetHASP sur un Rseau

protge) trouve le Gestionnaire de Licence NetHASP. Une session de


communication ne pourra dbuter qu'aprs la reconnaissance du
Gestionnaire de Licence NetHASP.
La Recherche Automatique de NetHASP vous permet de connecter la
cl NetHASP, charger le Gestionnaire de Licence NetHASP, et
d'excuter l'application protge, sans aucune modification du
systme NetHASP ou de l'environnement dans lequel il est install.
Cependant, le mcanisme de recherche permet un paramtrage plus
fin du systme NetHASP avec de simples ajustements client-serveur.
Cela est ralis par la Recherche Personnalise de NetHASP.
Les deux procds, automatique et personnalis, sont dcrits ci-aprs.
La Recherche Automatique de NetHASP s'active lorsque le client
NetHASP ne trouve pas de fichier de configuration NetHASP (le
fichier nethasp.ini par exemple). L'application protge avec le
systme NetHASP utilise alors l'algorithme suivant pour rechercher
le Gestionnaire de Licence NetHASP :

Dbut
Dtection des protocoles de communication actifs;
Boucler jusqu' trois fois sur la procdure suivante :
(1) effectuer un LOGIN NetHASP avec le protocole IPX, accorder n secondes pour russir;
Si LOGIN accept, continuer avec le protocole IPX;
sinon
(2) effectuer un LOGIN NetHASP avec le protocole TCP/IP, accorder n secondes pour russir;
Si LOGIN accept, continuer avec le protocole TCP/IP;
sinon
(3) effectuer un LOGIN NetHASP avec le protocole NetBIOS;
Si LOGIN accept, continuer avec le protocole NetBIOS;
sinon
(4) retourner au dbut de la boucle et doubler la valeur de n;
Si tout a chou aprs trois boucles, retourner une erreur NetHASP

Recherche Automatique de NetHASP

16-11

Dbut
Fin

Lors de la premire boucle de recherche de NetHASP, n gale 2


secondes.
Avant de lancer l'algorithme de recherche, le systme NetHASP
vrifi d'abord les protocoles installs, et n'effectue que les tapes
adquates. Par exemple, si le protocole TCP/IP a t dtect, seule
l'tape 2 de l'algorithme prcdant sera excute. Il sera cependant
excut jusqu' trois fois, en doublant la valeur de n chaque fois.

Recherche Automatique sous IPX


Sous IPX, le systme NetHASP utilise un mcanisme de broadcast
SAP pour automatiser la recherche du Gestionnaire de Licence
NetHASP. C'est dire que le client NetHASP broadcaste, pendant
que tous les Gestionnaires de Licence IPX NetHASP actifs sont
l'coute. Le premier rpondre au client - en acceptant le LOGIN
NetHASP - fournira les services NetHASP. Avec la recherche
automatique de NetHASP sous IPX, des clients et des Gestionnaires
de Licence NetHASP se trouvant sur des segments diffrents peuvent
communiquer ensemble.

Recherche Automatique sous TCP/IP


Sous TCP/IP, le systme NetHASP utilise un mcanisme de broadcast
UDP pour automatiser la recherche du Gestionnaire de Licence
NetHASP. C'est dire, le client NetHASP broadcaste, tandis que tous
les Gestionnaires de Licence TCP/IP NetHASP actifs sont l'coute.
Le premier rpondre au client en acceptant un LOGIN NetHASP
fournira les services NetHASP.

16-12

Installation de NetHASP sur un Rseau

Note:

Avec la recherche automatique sous TCP/IP, les clients


NetHASP ne peuvent accder des Gestionnaires de Licence
NetHASP se trouvant sur d'autres segments ou sur Internet.
Pour accder d'autres segments ou Internet, vous devez
personnaliser le mcanisme de recherche - voir la section
Recherche Personnalise de NetHASP.

Recherche Automatique sous NetBIOS


Sous NetBIOS, le systme NetHASP :
ne limite pas la recherche n secondes. Le temps de recherche
reste entre 4 et 6 secondes durant chaque passage dans la boucle.
dtermine quels lana numbers (canaux de communication) sont
oprationnels et les utilise pour la communication.
utilise
le
nom
("AladinHaspV012.0").

NetBIOS

NetHASP

par

dfaut

Sous NetBIOS, le mcanisme de recherche fonctionne selon le type


d'application tournant sur le client NetHASP.

Applications DOS et Win16


Les applications Win16 recherchent un Gestionnaire de Licence
NetHASP sur tous les lana numbers (canaux de communication). Cela
est effectu chaque itration ( section (3) dans la boucle de recherche
ci-dessus). Lorsqu'un Gestionnaire de Licence NetHASP est trouv,
quelque soit la cl NetHASP connecte, la recherche se termine.
Le Gestionnaire de Licence NetHASP sous Windows coute sur le
premier lana number qu'il dtecte.

Applications Win32
Les applications Win32 recherchent une cl NetHASP sur tous les
lana numbers dtects. Cela veut dire que la recherche ne s'arrtera
pas lorsqu'un Gestionnaire de Licence NetHASP rpondra, mais
seulement lorsque le Gestionnaire de Licence NetHASP associ la
bonne cl NetHASP rpondra.

Recherche NetHASP Personnalise

16-13

Le Gestionnaire de Licence NetHASP sous Win32 coute sur tous les


lana numbers qu'il dtecte.
Comme la communication sur tous les lana numbers dtects prend
tu temps, une tentative de communication sera effectue sur un seul
lana number par itration. Si la communication choue, l'itration
suivante utilisera le lananum suivant.
Note:

Si plus de trois lana numbers sont dtects, lorsque


l'algorithme termine ces trois itrations, la session (3) sera
excute une nouvelle fois en utilisant les lana numbers non
vrifis.

Recherche NetHASP Personnalise


Selon votre environnement, vous voudrez ou aurez besoin de
personnaliser le mcanisme de recherche de NetHASP. Cela se fait
par l'intermdiaire de mots cls dfinis dans le fichier de
configuration de NetHASP (i.e. le fichier nethasp.ini). Le fichier
nethasp.ini est lu par le client NetHASP (l'application protge) pour
personnaliser le mcanisme de recherche. Si le client NetHASP trouve
un fichier nethasp.ini, il utilisera les informations qu'il contient.
Sinon, le mcanisme standard de recherche automatique de NetHASP
sera utilis.
Le client NetHASP recherche le fichier nethasp.ini dans les
rpertoires suivants :
Tableau 16.2: Ordre de recherche du fichier nethasp.ini
Type dApplication

Ordre de Recherche

DOS

Rpertoire courant Map de recherche Netware

Windows

Rpertoire courant Rpertoire de Windows Rpertoire System de


Windows Rpertoire du fichier excutable Path Map de recherche
Netware

16-14

Installation de NetHASP sur un Rseau

Win32

Rpertoire du fichier excutable Rpertoire courant Rpertoire System


de Windows Rpertoire de Windows Path

Les sections suivantes dcrivent les mots cls utiliss dans le fichier
nethasp.ini pour une configuration de base du mcanisme de
recherche de NetHASP. Tous les mots cls du fichier nethasp.ini ne
sont pas dcrit dans ces sections. Un exemple de fichier nethasp.ini,
que vous pouvez utiliser pour paramtrer finement le systme
NetHASP, peut tre trouv l'annexe C, y compris une brve
description de tous ses mots cls.

Informations Gnrales sur la Recherche Personnalise


Vous pouvez modifier la valeur initiale de n, la premire priode de
recherche de l'algorithme NetHASP; la valeur par dfaut tant 2
secondes.
Pour modifier la valeur initiale de n :
Dans la section [NH_COMMON], dfinissez
NH_SESSION = <secondes>
o <secondes> est la valeur initiale dsire de la priode de
recherche.
Le fait de mettre le mot cl NH_SESSION dans la section
NH_COMMON permet de l'appliquer tous les protocoles. Pour
dfinir une valeur pour chacun des protocoles, dfinissez la valeur de
NH_SESSION dans la section de chaque protocole.

Recherche Personnalise sous IPX


La recherche personnalise sous IPX dpend de l'application. Les
sections suivantes dcrivent 4 options personnalises pour les
applications Win16, et 2 pour les applications Win32.

Broadcast (Applications DOS et Win16)

Recherche NetHASP Personnalise

16-15

1. Chargez le Gestionnaire de Licence NetHASP avec le paramtre


-ipx.
2. Modifiez le fichier nethasp.ini comme suit :

Dans la section [NH_COMMON], dfinissez NH_IPX =


Enabled

Dans la section [NH_IPX], dfinissez NH_USE_BROADCAST


= Enabled

Dans la section [NH_IPX], dfinissez NH_USE_BINDERY =


Disabled

3. Copiez le fichier nethasp.ini modifi dans un rpertoire accessible


par l'application.
Cette configuration est celle par dfaut. Elle est galement utilise
par la Recherche Automatique (itration (1) dans l'algorithme). Elle
indique au systme NetHASP d'utiliser le mcanisme de broadcast
SAP pour rechercher le Gestionnaire de Licence NetHASP.

Bindery / Broadcast (Applications DOS et Win16)


1. Chargez le Gestionnaire de Licence NetHASP avec le paramtre
-ipx.
2. Modifiez le fichier nethasp.ini comme suit :

Dans la section [NH_COMMON], dfinissez NH_IPX =


Enabled

Dans la section [NH_IPX], dfinissez NH_USE_BROADCAST


= Enabled

Dans la section [NH_IPX], dfinissez NH_USE_BINDERY =


Enabled

3. Copiez le fichier nethasp.ini modifi dans un rpertoire accessible


par l'application.
Cette configuration indique au systme NetHASP de rechercher le
Gestionnaire de Licence NetHASP dans la bindery Novell. Si la

16-16

Installation de NetHASP sur un Rseau

bindery n'est pas supporte, ou si le Gestionnaire de Licence


NetHASP ne peut tre trouv, le systme NetHASP utilisera le
mcanisme de broadcast pour mener terme la recherche.

Bindery / Fichier dAdresse (Applications DOS et Win16)


1. Chargez le Gestionnaire de Licence NetHASP avec le paramtre
-ipx.
2. Modifiez le fichier nethasp.ini comme suit :

Dans la section [NH_COMMON], dfinissez NH_IPX =


Enabled

Dans la section [NH_IPX], dfinissez NH_USE_BROADCAST


= Disabled

Dans la section [NH_IPX], dfinissez NH_USE_BINDERY =


Enabled

3. Copiez le fichier nethasp.ini modifi dans un rpertoire accessible


par l'application.
Cette configuration indique au systme NetHASP de rechercher le
Gestionnaire de Licence NetHASP dans la bindery Novell. Si la
bindery n'est pas supporte, ou si le Gestionnaire de Licence
NetHASP ne peut tre trouv, le systme NetHASP utilisera le
mcanisme de fichier d'adresse pour mener terme la recherche, i.e.
recherche l'adresse du Gestionnaire de Licence NetHASP dans le
fichier newhaddr.dat.

Fichier dAdresse (Applications DOS et Win16)


1. Chargez le Gestionnaire de Licence NetHASP avec le paramtre
-ipx.
2. Modifiez le fichier nethasp.ini comme suit :

Dans la section [NH_COMMON], dfinissez NH_IPX =


Enabled

Dans la section [NH_IPX], dfinissez NH_USE_BROADCAST


= Disabled

Recherche NetHASP Personnalise

16-17

Dans la section [NH_IPX], dfinissez NH_USE_BINDERY =


Disabled

3. Copiez le fichier nethasp.ini modifi dans un rpertoire accessible


par l'application.
Cette configuration indique au systme NetHASP de recherche le
Gestionnaire de Licence NetHASP en utilisant le mcanisme de
fichier d'adresse (recherche l'adresse du Gestionnaire de Licence
NetHASP looks for the NetHASP dans le fichier newhaddr.dat).

Broadcast (Applications Win32)


1. Chargez le Gestionnaire de Licence NetHASP avec le paramtre
-ipx.
2. Modifiez le fichier nethasp.ini comme suit :

Dans la section [NH_COMMON], dfinissez NH_IPX =


Enabled

Dans la section [NH_IPX], dfinissez NH_USE_BROADCAST


= Enabled

3. Copiez le fichier nethasp.ini modifi dans un rpertoire accessible


par l'application.
Il s'agit de la configuration par dfaut. . Elle est galement utilise
par la Recherche Automatique (itration (1) dans l'algorithme). Elle
indique au systme NetHASP d'utiliser le mcanisme de broadcast
SAP pour rechercher le Gestionnaire de Licence NetHASP.

Fichier dAdresse (Applications Win32)


1. Chargez le Gestionnaire de Licence NetHASP avec le paramtre
-ipx.
2. Modifiez le fichier nethasp.ini file comme suit :

Dans la section [NH_COMMON], dfinissez NH_IPX =


Enabled

16-18

Installation de NetHASP sur un Rseau

Dans la section [NH_IPX], dfinissez NH_USE_BROADCAST


= Disabled

3. Copiez le fichier nethasp.ini file modifi dans un rpertoire


accessible par l'application.
Cette configuration indique au systme NetHASP de recherche le
Gestionnaire de Licence NetHASP en utilisant le mcanisme de
fichier d'adresse (recherche l'adresse du Gestionnaire de Licence
NetHASP looks for the NetHASP dans le fichier newhaddr.dat).

Notes pour le protocole IPX


NH_USE_BINDERY est quivalent l'ancien
NH_USE_SAP. Vous pouvez utiliser l'un ou l'autre.

mot

cl

Les applications Win32 ne peut pas utiliser la bindery Novell. De


ce fait, le mot cl NH_USE_BINDERY est inutilis pour ces
applications.
Par dfaut, un fichier d'adresse NetHASP (newhaddr.dat) est cre
dans le rpertoire du Gestionnaire de Licence NetHASP. Lorsque
vous utilisez HASPSERV.NLM, le fichier d'adresse est cr dans
le rpertoire racine du serveur. Le client NetHASP recherche ce
fichier d'adresse dans les rpertoires suivants :
Tableau 16.3: Ordre de recherche du fichier newhaddr.dat
Application

Ordre de recherche

DOS

Rpertoire courant Map de recherche Netware

Windows

Rpertoire courant Rpertoire de Windows Rpertoire System


de Windows Rpertoire du fichier excutable Path Map de
recherche Netware

Win32

Rpertoire du fichier excutable Rpertoire courant Rpertoire


System de Windows Rpertoire de Windows Path

Recherche NetHASP Personnalise

16-19

En ajoutant les mots cl suivants dans fichier nethasp.ini dans les


options du Fichier d'Adresse Win16 et Win32, vous pouvez
prciser le rpertoire o se trouve le fichier d'adresse.
NH_DATFILE_PATH = <chemin>

Recherche Personnalise sous TCP/IP


Les sections suivantes dcrivent trois options personnalises sous
TCP/IP.

Broadcast UDP
1. Chargez le Gestionnaire de Licence NetHASP avec le paramtre
-tcpip.
2. Modifiez le fichier nethasp.ini comme suit :

Dans la section [NH_COMMON], dfinissez NH_TCPIP =


Enabled

Dans la section [NH_TCPIP], dfinissez NH_TCPIP_METHOD


= UDP

Dans la section [NH_TCPIP], dfinissez


NH_USE_BROADCAST = Enabled

3. Copiez le fichier nethasp.ini ainsi modifi dans un rpertoire


accessible l'application.
Il s'agit de la configuration par dfaut. Elle est galement utilise par
la Recherche Automatique (itration (2) dans l'algorithme). Elle
indique au systme NetHASP d'utiliser le mcanisme de broadcast
pour rechercher le Gestionnaire de Licence NetHASP.
Notez qu'avec cette configuration, les clients NetHASP ne peuvent
accder des Gestionnaires de Licence NetHASP se trouvant sur
d'autres segments ou sur Internet.

16-20

Installation de NetHASP sur un Rseau

UDP
1. Chargez le Gestionnaire de Licence NetHASP avec le paramtre
-tcpip.
2. Modifiez le fichier nethasp.ini comme suit :

Dans la section [NH_COMMON], dfinissez NH_TCPIP =


Enabled

Dans la section [NH_TCPIP], dfinissez NH_TCPIP_METHOD


= UDP

Dans la section [NH_TCPIP], dfinissez NH_SERVER_ADDR


= <adresse IP du Gestionnaire de Licence NetHASP, ou le nom
d'hte du Gestionnaire de Licence NetHASP>

Dans la section [NH_TCPIP], dfinissez


NH_USE_BROADCAST = Disabled

3. Copiez le fichier nethasp.ini ainsi modifi dans un rpertoire


accessible l'application.
Cette configuration indique au client NetHASP de rechercher un
Gestionnaire de Licence NetHASP avec l'adresse IP ou le nom
spcifie. Cette option permet au systme NetHASP de changer de
segment.

TCP
1. Chargez le Gestionnaire de Licence NetHASP avec le paramtre
-tcpip.
2. Modifiez le fichier nethasp.ini comme suit :

Dans la section [NH_COMMON], dfinissez NH_TCPIP =


Enabled

Dans la section [NH_TCPIP], dfinissez NH_TCPIP_METHOD


= TCP

Dans la section [NH_TCPIP], dfinissez NH_SERVER_ADDR


= <adresse IP du Gestionnaire de Licence NetHASP, ou le nom
d'hte du Gestionnaire de Licence NetHASP>

Recherche NetHASP Personnalise

16-21

3. Copiez le fichier nethasp.ini ainsi modifi dans un rpertoire


accessible l'application.
Cette configuration indique au client NetHASP de rechercher un
Gestionnaire de Licence NetHASP avec l'adresse IP ou le nom
spcifie. Cette option permet au systme NetHASP de changer de
segment.
Note:

Cette option active l'appel automatique sur les ordinateurs


configurs en connexion rseau en dial-up. Il s'agit d'un effet
secondaire connu de la prise de session TCP sur de tels
ordinateurs. Si vous n'utilisez le protocole TCP/IP que pour
des connexions en dial-up, vous devez utiliser l'une des deux
options prcdante, ou choisir un protocole diffrent.

Notes sur TCP/IP


NetHASP ne passe pas travers la plupart des firewalls ou
filtreurs de paquets. Pour supporter l'UDP, la plupart des
firewalls utilisent le filtrage de paquets, les connexions TCP
peuvent tre supportes avec soit des proxies soit un filtrage des
paquets. NetHASP utilise le port 475 pour TCP et UDP. Pour
configurer votre firewall afin qu'il permette NetHASP de
travailler, veuillez consulter votre administrateur rseau.
Le Gestionnaire de Licence NetHASP utilise par dfaut le port
numro 475. Si vous dsirez utiliser un autre port :
1. Chargez le Gestionnaire de Licence NetHASP avec les
paramtres -tcpip et -portnum=<nombre>.
2. Modifiez le fichier nethasp.ini :

Dans la section [NH_TCPIP], dfinissez


NH_PORT_NUMBER = <nombre>

Recherche Personnalise sous NetBIOS


Les applications Win16 recherchent un Gestionnaire de Licence
NetHASP sur tous les lana numbers (canaux de communication).
Lorsque un Gestionnaire de Licence NetHASP est trouv, la recherche

16-22

Installation de NetHASP sur un Rseau

prend fin. Si la bonne cl NetHASP n'est pas trouve, le Gestionnaire


de Licence NetHASP retournera un message d'erreur "HASP not
Found" ("Cl HASP non trouve").
Dans ce cas, vous pouvez personnaliser votre recherche en indiquant
au systme NetHASP de communiquer sur un autre lana number,
afin de trouver le Gestionnaire de Licence NetHASP avec la bonne cl.
Cela peut tre fait en modifiant le fichier nethasp.ini :
Pour communiquer sur un autre lana number :
Dans la section [NH_COMMON], dfinissez NH_NETBIOS =
Enabled
Dans la section [NH_NETBIOS], dfinissez NH_USE_LANANUM
= <lana number>
L'algorithme de recherche NetHASP excutera l'itration (3) dans la
boucle de recherche, en communiquant toujours sur le lana number
spcifi.

Note sur NetBIOS


Le protocole NetBEUI ne permet pas de changer de segment. Si vous
excutez une application protge en environnement NetBEUI, dans
lequel le Gestionnaire de Licence NetHASP et les clients NetHASP
sont sur des segments distincts, les clients NetHASP ne trouveront
pas le Gestionnaire de Licence NetHASP. Dans ce cas, vous devrez
charger le Transport compatible IPX/SPX avec NetBIOS et le
dfinir comme protocole par dfaut, afin de permettre la
communication entre segments.

Installation NetHASP - Rfrence Rapide


La mthode la plus rapide d'installer NetHASP sur votre systme est
de connecter la cl, de charger le Gestionnaire de Licence NetHASP,
et d'excuter l'application protge. Cependant, si vous dsirez
personnaliser le systme NetHASP, vous pouvez vous rfrer aux

Installation NetHASP - Rfrence Rapide

16-23

trois tableaux suivants qui vous guideront travers l'installation


personnalise de NetHASP.
Chacun de ces trois tableaux se rfre un protocole rseau prcis.
Pour chaque type d'application, les mots cls pertinents du fichier
nethasp.ini sont prciss. Les commentaires dcrivent la mthode de
recherche du Gestionnaire de Licence NetHASP par le client
NetHASP.

IPX
Tableau 16.4: Paramtrage de NetHASP sous IPX
Application

NH_USE_
BROADCAST

NH_USE_BINDERY

Commentaires

DOS
et
Win16

Enabled

Disabled

Le client NetHASP utilise un


Broadcast SAP (mthode par
dfaut).

DOS
et
Win16

Enabled

Enabled

Le client NetHASP utilise un


Novell Bindery. Si cela choue, il
utilise un Broadcast SAP.

DOS
et
Win16

Disabled

Enabled

Le client NetHASP utilise un


Novell Bindery. Si cela choue,
il utilise un fichier d'adresse.

DOS
et
Win16

Disabled

Disabled

Le client NetHASP utilise un


fichier d'adresse.

Win32

Enabled

N/A

Le client NetHASP utilise un


Broadcast SAP.

Win32

Disabled

N/A

Le client NetHASP utilise un


fichier d'adresse.

16-24

Installation de NetHASP sur un Rseau

TCP/IP
Tableau 16.5: Paramtrage de NetHASP sous TCP/IP
Application

NH_TCPIP_
METHOD

NH_SERVER
_ADDR

NH_USE
_BROADCAST

Commentaires

Win16
et
Win32

UDP

N/A

Enabled

Le client NetHASP utilise un


Broadcast UDP (mthode
par dfaut). Pas
changement de segment
possible.

Win16
et
Win32

UDP

Adresse ou Nom
d'Hte

Disabled

Le client NetHASP
recherche le Gestionnaire de
Licence NetHASP avec
l'adresse IP spcifie. Peut
changer de segment.

Win16
et
Win32

TCP

Adresse ou Nom
d'Hte

N/A

Le client NetHASP
recherche le Gestionnaire de
Licence avec l'adresse
spcifie. Peut changer de
segment et passer les
firewalls. Active le dial-up
Internet.

Installation NetHASP - Rfrence Rapide

16-25

NetBIOS
Tableau 16.6: Paramtrage de NetHASP sous NetBIOS
Application

NH_USELANANUM

Commentaires

Toute Application

Lananumber

Le client NetHASP recherche le Gestionnaire de


Licence NetHASP sur le lananumber spcifi.

16-26

Installation de NetHASP sur un Rseau

Chapitre 17 - Outils NetHASP


Ce chapitre dcrit les utilitaires NetHASP qui vous permettent de
vrifier le systme NetHASP chez vos clients. Nous vous
recommandons de les envoyer vos clients en mme temps que votre
application protge.

Les Outils de Test NetHASP


Les outils de test NetHASP appellent la routine hasp( ) en utilisant
tous les services de l'API NetHASP, et sont ainsi d'excellent outils de
diagnostic utiliser chez le client.
Les outils de test fournis avec NetHASP sont :
testnet.exe pour DOS
wtestnet.exe pour Windows
w32test.exe pour Win32
Par dfaut, les applications de test recherchent une cl NetHASP de
dmonstration. Pour votre convenance, nous fournissons le code
source de chaque application de test.

17-2

Outils NetHASP

Moniteur NetHASP
Le Moniteur NetHASP est un outil Windows permettant dafficher la
liste :
Des Gestionnaires de Licence NetHASP sur le rseau
Des utilisateurs utilisant une application protge ayant effectu
un LOGIN NetHASP sur le Gestionnaire de Licence NetHASP

Note:

Tous les Gestionnaires de Licence NetHASP (except le


Gestionnaire de Licence pour OS/2) grent le Moniteur
NetHASP.
Le Moniteur NetHASP agit comme n'importe quel client
NetHASP. Il affiche seulement les Gestionnaires de
Licence NetHASP accessibles depuis la station sur
laquelle il est lanc.

Moniteur NetHASP

17-3

Lancement du Moniteur NetHASP


Excutez le programme setup.exe se trouvant dans le rpertoire
Monitor; la fentre du moniteur NetHASP apparat.

Visualisation des Gestionnaires de Licence NetHASP par Protocole


La liste Protocols affiche les protocoles disponibles sur la station o
est excut le Moniteur NetHASP. A partir de cette liste des
protocoles, il est possible de voir l'ensemble des Gestionnaires de
Licence NetHASP du rseau utilisant le protocole slectionn.

Note:

Le Moniteur NetHASP supporte les protocoles NetBIOS,


IPX, et TCP/IP.

17-4

Outils NetHASP

Pour voir les Gestionnaires de Licence NetHASP utilisant un


protocole donn :
Double cliquez sur le protocole choisi dans la liste Protocols.
Ou, slectionnez un protocole et appuyez sur la touche <F5>.
Le nom du protocole apparat dans le champ Selected Protocol, et
les informations sur les Gestionnaires de Licence NetHASP utilisant
ce protocole apparaissent dans la liste NetHASP License Manager.

Note:

Les informations dans la liste NetHASP License Manager


peuvent apparatre sous forme condense. Pour voir les
informations dans leur intgralit, slectionnez un objet et
appuyez sur la touche <F7>.

Visualisation des Utilisateurs NetHASP


Pour afficher la liste des utilisateurs dun Gestionnaire de
Licence NetHASP donn :
Double cliquez sur le Gestionnaire de Licence NetHASP voulu
dans la zone NetHASP Servers ou appuyez sur la touche <F6>.
Les informations sur les utilisateurs de ce Gestionnaire de Licence
NetHASP apparaissent dans la liste NetHASP Users.

Note:

Les informations dans la liste NetHASP Users peuvent


apparatre sous forme condense. Pour voir les informations
dans leur intgralit, slectionnez un objet et appuyez sur la
touche <F7>.

Pour voir un rsum des informations affiches dans la liste


NetHASP Users :
Appuyez sur la touche <F8> pour ouvrir la fentre NetHASP
Statistics.

Moniteur NetHASP

17-5

Aide du Moniteur NetHASP


Pour plus dinformations sur les champs et fonctions du Moniteur
NetHASP, reportez-vous l'aide en ligne du Moniteur NetHASP.
Pour accder l'aide :
Choisissez loption Help du menu principal.

17-6

Outils NetHASP

Annexe A - API et Langage Assembleur


Si vous dsirez appeler les cls HASP directement partir du langage
Assembleur, utilisez les tableau suivants pour passer les paramtres
dans les registres.
Faites un appel la routine haspreg( ).

Note:

La routine haspreg( ) est dfinie comme far proc.

Les tableaux suivants illustrent les appels la routine haspreg( ) pour


les diffrentes cls HASP fonctionnant sur port parallle.
Tableau A.1: Appels la routine haspreg( ) avec les
services HASP de base
Service

Appel

IsHasp

BH
BL

AX
BH
BL
CX
DX

Seed

BH
BL
CX
DX

HaspCode

HaspStatus

Retour
AX:

LptNum

Code

2
LptNum
Password1

0 HASP non trouve


1 HASP trouve

AX: Return Code 1


BX: Return Code 2
CX: Return Code 3
DX: Return Code 4

Password2

LptNum
Password1

AX: Taille de la Mmoire


BX: Type de cl HASP
CX: LptNum Actuel

Password2

Tableau A.2: Appels la routine haspreg() avec les services MemoHASP


Service

Appel

ReadWord

BH

Retour
3

BX: Donnes

A-1

A-2

API et Langage Assembleur

Service

WriteWord

HaspID

Appel

Retour

BL
CX
DX
DI

LptNum

BH
BL
CX
DX
DI
SI

BH
BL
CX
DX

CX: Etat

Password1
Password2
Address

CX: Etat

LptNum
Password1
Password2
Address
Data

LptNum
Password1
Password2

AX: IDLow
BX: IDHigh
CX: Etat

A-3

Service

Appel

ReadBlock

BH
BL
CX
DX
DI
SI
ES
AX

50

BH
BL
CX
DX
DI
SI
ES
AX

51

WriteBlock

Retour
CX: Etat

LptNum
Password1
Password2
Start

Address
Length
Buffer Segment
Buffer Offset
Block

CX: Etat

LptNum
Password1
Password2
Start

Address
Length
Buffer Segment
Buffer Offset
Block

Table A.3: Appels la routine haspreg() avec les services TimeHASP


Service

Appel

SetTime

BH
BL
CX
DX
DI
SI
AX

70

BH
BL
CX
DX

71

GetTime

Retour
CX: Etat

LptNum
Password1
Password2
Seconde
Minute
Heure

LptNum
Password1
Password2

AX: Seconde
BX: Minute
CX: Etat
DX: Heure

A-4

API et Langage Assembleur

Service

Appel

SetDate

BH
BL
CX
DX
DI
SI
AX

72

BH
BL
CX
DX

73

Password2

AX: Jour
BX: Mois
CX: Etat
DX: Anne

BH
BL
CX
DX
DI
SI

74

CX: Etat

BH
BL
CX
DX
DI

75

BH
BL
CX
DX
DI
SI
ES
AX

76

GetDate

WriteByte

ReadByte

WriteBlock

Retour
CX: Etat

LptNum
Password1
Password2
Jour
Mois
Anne

LptNum
Password1

LptNum
Password1
Password2
Address
Data

LptNum

BX: Donnes
CX: Etat

Password1
Password2
Address

LptNum
Password1
Password2
Start

Address
Length
Buffer Segment
Buffer Offset
Block

CX: Etat

A-5

Service

Appel

ReadBlock

BH
BL
CX
DX
DI
SI
ES
AX

77

BH
BL
CX
DX

78

GetHaspID

Retour
CX: Etat

LptNum
Password1
Password2
Start

Address
Length
Buffer Segment
Buffer Offset
Block

LptNum
Password1

AX: IDLow
BX: IDHigh
CX: Etat

Password2

Tableau A.4: Appels la routine haspreg() avec les services NetHASP


Service

Appel

LastStatus

BH

40

HaspCode

AX
BH
BL
CX
DX

Seed

AX
BH
BL
CX
DX

Seed

LOGIN

Retour
AX: Net Status
BX: System Error
Code

41
ProgNum
Password1

AX: Return Code 1


BX: Return Code 2
CX: Return Code 3
DX: Return Code 4

Password2

Code

42
ProgNum
Password1
Password2

AX: Return Code 1


BX: Return Code 2
CX: Return Code 3
DX: Return Code 4

A-6

API et Langage Assembleur

Service

Appel

LOGOUT

BH
BL
CX
DX

43

BH
BL
CX
DX
DI

44

BH
BL
CX
DX
DI
SI

45

BH
BL
CX
DX

46

AX
BH
BL
CX
DX

Idle

BH
BL
CX
DX
DI
SI
ES
AX

52

ReadWord

WriteWord

HaspID

IdleTime

ReadBlock

Retour

ProgNum
Password1
Password2

ProgNum

BX: Donnes
CX: Etat

Password1
Password2
Address

CX: Etat

ProgNum
Password1
Password2
Address
Data

ProgNum
Password1

AX: IDLow
BX: IDHigh
CX: Etat

Password2

Time

48
ProgNum
Password1
Password2

ProgNum
Password1
Password2
Start

Address
Length
Buffer Segment
Buffer Offset
Block

CX: Etat

A-7

Service

Appel

WriteBlock

BH
BL
CX
DX
DI
SI
ES
AX

53

BH
SI
ES
AX

86

BH
SI
ES
AX

96

SetConfigFilename

SetServerByName

Retour

ProgNum
Password1
Password2
Start

Address
Length
Buffer Segment
Buffer Offset
Block

Buffer

Size
Segment
Buffer Offset
Buffer

Buffer

Size
Segment
Buffer Offset
Buffer

CX: Etat

A-8

API et Langage Assembleur

Annexe B - Le Gestionnaire Rsident HASP


Sil existe une interface HASP pour votre compilateur, vous pouvez
passer cette annexe.
Le Gestionnaire Rsident HASP est une application DOS rsident en
mmoire (TSR) que votre application protge vas appeler par le biais
d'interruptions. Le Gestionnaire Rsident HASP sert protger les
applications DOS qui ne peuvent tre protges l'API HASP standard.
Le Gestionnaire Rsident fournit les mme services HASP que l'API.
Vous pouvez insrer des appels dans votre application aussi souvent
que vous le dsirez, et dcider comment l'application doit ragir si la
cl n'est pas trouve.

Note:

Le passage de paramtres est effectu directement par les


registres du CPU.

Consultez le sous-rpertoire resident du rpertoire DOSAPI


pour y trouver des exemples d'applications dmontrant les
appels au Gestionnaire Rsident HASP.

Le Gestionnaire Rsident ncessite environ 28Ko de RAM. Vos clients


doivent charger ce Gestionnaire Rsident avant le lancement de
l'application protge, cela permet au Gestionnaire Rsident de rester
en mmoire.
Si votre application entre en conflit avec d'autres applications
utilisant des interruptions, vous pouvez changer l'interruption du
Gestionnaire Rsident.
L'interruption par dfaut est INT 63h, dfinie comme une
interruption utilisateur dans la documentation DOS. si vous devez
spcifier une autre interruption, choisissez un nombre qui n'interfre
pas avec le fonctionnement normal de l'ordinateur.

B-1

B-2

Le Gestionnaire Rsident HASP

Pour charger le Gestionnaire Rsident avec une interruption prcise,,


lancez-le de la manire suivante :
haspres [Numro d'Interruption]

o [Numro Interruption] est un nombre hexadcimal compris entre 0


et FF.
Rappelez-vous que votre client doit excuter le Gestionnaire Rsident
avant le lancement de l'application protge. Incluez un fichier batch
comme celui qui suit pour simplifier l'excution du programme par
votre client :
haspres [Numro d'Interruption]

Charge le Gestionnaire Rsident


HASP avec l'interruption par dfaut
(63h) ou avec celle de votre choix.

<Application>

Lance votre application

haspres [Numro d'Interruption] -r

Lorsque
votre
application
est
termine, retirez le Gestionnaire
Rsident HASP de la mmoire.

Annexe C - Fichier de Configuration


NetHASP
NetHASP permet lutilisation dun fichier de configuration contenant
les paramtres et autres configurations particulires de l'application
protge. Si l'application trouve un Fichier de Configuration
NetHASP, elle le lira et utilisera les informations qu'il contient. Dans
le cas contraire, elle utilisera les valeurs par dfaut.
Le Fichier de Configuration NetHASP s'appelle par dfaut
nethasp.ini. Une copie du fichier nethasp.ini est comprise avec les
outils HASP, ainsi qu'avec chaque API HASP.
L'application protge recherche le Fichier de Configuration
NetHASP lors du premier appel un service NetHASP, dans les
rpertoire suivants :

C-1

C-2

Fichier de Configuration NetHASP

Tableau C.1: Ordre de recherche du fichier nethasp.ini


Type dApplication

Ordre de Recherche

DOS

Rpertoire courant Map de recherche Netware

Windows

Rpertoire courant Rpertoire de Windows Rpertoire System de


Windows Rpertoire du fichier excutable Path Map de recherche
Netware

Win32

Rpertoire du fichier excutable Rpertoire courant Rpertoire System


de Windows Rpertoire de Windows Path

Le Fichier de Configuration est compos de quatre sections, chaque


section tant optionnelle :
[NH_COMMON]
[NH_IPX]
[NH_NETBIOS]
[NH_TCPIP]
La section [NH_COMMON] contient les paramtres globaux pour toutes
configurations des sections FILE. Si vous modfiez un mot cl dans une
autre section, il surchargera ce mot cl dans cette section uniquement.
Chaque section contient des mots cl Gnraux et Spcifiques une
Section. Vous pouvez utiliser les mots cls Gnraux dans toutes les
sections du fichier de configuration. Les mots cls Spcifiques une
Section ne sont disponibles que dans une section prcise.

C-3

Note:

Les noms ne sont pas sensibles la casse.


Les commentaires sont prcdez d'un point virgule (;).
Toutes les lignes du Fichier de Configuration NetHASP
fournit avec le logiciel HASP sont prcde d'un point
virgule. Pour activer une ligne, supprimez le point
virgule.
Les configurations de l'API et de l'Enveloppe sont
prioritaires par rapport aux paramtres du fichier de
configuration.

Vous trouverez ci-aprs une description dtaille de toutes les


sections du Fichier de Configuration NetHASP.

C-4

Fichier de Configuration NetHASP

[NH_COMMON]
Mots Cl Spcifiques la Section
Mot Cl:
Valeurs Possibles:
Description:

NH_IPX =
Enabled, Disabled
Utilise le protocole IPX.

Mot Cl:
Valeurs Possibles:
Description:

NH_NETBIOS =
Enabled, Disabled
Utilise le protocole NetBIOS.

Mot Cl:
Valeurs Possibles:
Description:

NH_TCPIP =
Enabled, Disabled
Utilise le protocole TCP/IP.

Mot Cl:
Valeurs Possibles:
Description:
Valeurs par Dfaut:

NH_MACHINE =
IBM, NEC
Dfinit le type d'ordinateur sur lequel l'application protge s'excutera.
IBM

Mots Cl Gnraux
Mot Cl:
Valeurs Possibles:
Description:
Valeurs par Dfaut:
Mot Cl:
Valeurs Possibles:
Description:
Valeurs par Dfaut:

NH_SESSION

<Number>
Dfinit la dure maximale durant laquelle l'application protge essaiera
de se connecter au Gestionnaire de Licence NetHASP.
2 secondes
NH_SEND_RCV =
<Nombre>
Dfinit la dure maximale pour que le Gestionnaire de Licence NetHASP
envoie et recoive un paquet.
1 seconde

C-5

[NH_IPX]
Mots Cl Spcifiques la Section
Mot Cl:
Valeurs Possibles:
Description:
Valeurs par Dfaut:

NH_USE_BINDERY =
Enabled, Disabled
Utilise IPX avec bindery. Ignor avec l'API Win32. Cette option remplace
l'ancienne option nomme NH_USE_SAP.
Disabled

Mot Cl:
Valeurs Possibles:
Description:
Valeurs par Dfaut:

NH_USE_BROADCAST =
Enabled, Disabled
Utilise le mcanisme de Broadcast IPX.
Enabled

Mot Cl:
Valeurs Possibles:
Description:

NH_BC_SOCKET _NUM =
<Nombre>
Dfinit le numro de socket pour le mcanisme de Broadcast. Ce nombre
doit tre au format hexadcimal.
7483H

Valeurs par Dfaut:


Mot Cl:
Valeurs Possibles:
Description:
Valeurs par Dfaut:

NH_USE_INT =

2F_NEW, 7A_OLD
2F_NEW signifie que le protocole IPX n'utilisera que l'interruption 2Fh.
7F_OLD signifie que le protocole IPX n'utilisera que l'interruption 7Ah.
2F_NEW

Mot Cl:
Valeurs Possibles:
Description:

NH_SERVER _NAME =
<Nom1>, <Nom2>,...
Communique avec le Serveur NetHASP dont le nom est indiqu.
Maximum : 6 noms comprenant jusqu' 7 caractres.

Mot Cl:
Valeurs Possibles:
Description:

NH_SEARCH _METHOD =
Localnet, Internet
Dtermine si l'application protge ne communique avec le Gestionnaire
de Licence NetHASP qu'en rseau local, ou avec n'importe quel
Gestionnaire de Licence NetHASP sur le rseau Internet.
Internet

Valeurs par Dfaut:

C-6

Fichier de Configuration NetHASP

Mot Cl:
Valeurs Possibles:
Description:

NH_DATFILE _PATH =
<Chemin>
Dfinit le lieu du fichier d'adresse du Gestionnaire de Licence NetHASP.

Mots Cl Gnraux
Mot Cl:
Valeurs Possibles:
Description:
Valeurs par Dfaut:
Mot Cl:
Valeurs Possibles:
Description:
Valeurs par Dfaut:

NH_SESSION =
<Nombre>
Dfinit la dure maximale durant laquelle l'application protge essaiera
de se connecter au Gestionnaire de Licence NetHASP.
2 secondes
NH_SEND_RCV =

<Nombre>
Dfinit la dure maximale pour que le Gestionnaire de Licence NetHASP
envoie et recoive un paquet.
1 seconde

C-7

[NH_NETBIOS]
Mots Cl Spcifiques la Section
Mot Cl:
Valeurs Possibles:
Description:

NH_NBNAME =
<Nom>
Attribue un nom au Gestionnaire de Licence NetHASP.
Maximum: 1 nom comportant jusqu' 8 caractres.

Mot Cl:
Valeurs Possibles:
Description:

NH_USELANANUM

<Nombre>
Attribue un lana number utiliser comme canal de communication.

Mots Cl Gnraux
Mot Cl:
Valeurs Possibles:
Description:
Valeurs par Dfaut:
Mot Cl:
Valeurs Possibles:
Description:
Valeurs par Dfaut:

NH_SESSION =
<Nombre>
Dfinit la dure maximale durant laquelle l'application protge essaiera
de se connecter au Gestionnaire de Licence NetHASP.
2 secondes
NH_SEND_RCV =
<Nombre>
Dfinit la dure maximale pour que le Gestionnaire de Licence NetHASP
envoie et recoive un paquet.
1 seconde

C-8

Fichier de Configuration NetHASP

[NH_TCPIP]
Note: NetHASP ne supporte pas le protocole TCP/IP sous DOS.

Mots Cl Spcifiques la Section


Mot Cl:
Valeurs Possibles:
Description:

NH_SERVER _ADDR =
<Adresse1>, <Adresse2>
Dfinit l'adresse IP de tous les Gestionnaires de Licence NetHASP que
vous dsirez chercher.
Des adresses illimites et des lignes multiples sont possibles.
Les formats d'adresse possibles peuvent tre par exemple :
Adresses IP : 192.114.176.65
Nom d'Hte Local : ftp.aladdin.co.il

Mot Cl:
Valeurs Possibles:
Description:

NH_SERVER _NAME

=
<Nom1>, <Nom2>,...
Communique avec le Serveur NetHASP dont le nom est indiqu.
Maximum : 6 noms comprenant jusqu' 7 caractres.

Mot Cl:
Valeurs Possibles:
Description:
Valeurs par Dfaut:

NH_PORT_NUMBER =
<Number>
Dfinit le numro du port TCP/IP (optionnel).
475

Mot Cl:
Valeurs Possibles:
Description:
Valeurs par Dfaut:

NH_TCPIP_METHOD =
TCP, UDP
Envoie un paquet TCP ou un paquet UDP.
UDP

Mot Cl:
Valeurs Possibles:
Description:
Valeurs par Dfaut:

NH_USE_BROADCAST

=
Enabled, Disabled
Utilise le mcanisme de Broascast UDP.
Enabled

C-9

Mots Cl Gnraux
Mot Cl:
Valeurs Possibles:
Description:
Valeurs par Dfaut:
Mot Cl:
Valeurs Possibles:
Description:
Valeurs par Dfaut:

NH_SESSION

<Nombre>
Dfinit la dure maximale durant laquelle l'application protge essaiera
de se connecter au Gestionnaire de Licence NetHASP.
2 secondes
NH_SEND_RCV =

<Nombre>
Dfinit la dure maximale pour que le Gestionnaire de Licence NetHASP
envoie et recoive un paquet.
1 seconde

C-10

Fichier de Configuration NetHASP

Annexe D - Paramtres du Gestionnaire de


Licence NetHASP
Le tableau D.1 contient tous les paramtres disponibles pour les
diffrents Gestionnaires de Licence NetHASP. Le tableau D.2
explique comment utiliser ces paramtres.
Tableau D.1: Gestionnaires de Licence NetHASP et leurs paramtres
Paramtres

haspserv .exe nhsrvwin .exe haspserv .nlm nhsrvw32 .exenhsrvos2.ex nhdosj.exe nhswinj.exe
e

-?

-addrappend

-addrpath

-help

-ibm

-ibm36

-ipx

-ipxnosap

-localnet

-maxlananum
-nbname

-nec

-net

u
u

-netbios

-nethaspnbname

D-1

D-2

Paramtres du Gestionnaire de Licence NetHASP

Paramtres

haspserv .exe nhsrvwin .exe haspserv .nlm nhsrvw32 .exenhsrvos2.ex nhdosj.exe nhswinj.exe
e

-openmin

-portnum
-r

u
u

-saptofile
-srvname

-tcp/ip
-uselananum

-userlist

u
u
u

D-3

Tableau D.2: Explication des paramtres du Gestionnaire de Licence NetHASP


Paramtres

Explication

-?

Affiche la liste des paramtres disponibles.

-addrappend

N'crit pas par dessus le fichier nethaddr.dat. Ajoute l'adresse du Gestionnaire de Licence
NetHASP la suite des adresses contenues dans le fichier d'adresses.

-addrpath=<chemin>

Spcifie le chemin de sauvegarde du fichier newhaddr.dat. Par dfaut, le Gestionnaire de


Licence NetHASP place le fichier newhaddr.dat dans le rpertoire d'o il est lanc.

-help

Affiche la liste des paramtres disponibles.

-ibm

Valeur par dfaut. Utilisez ce paramtre avec des PC IBM pour rechercher une cl NetHASP
standard.

-ibm36

Utilisez ce paramtre avec des PC IBM pour rechercher une cl NetHASP36 et ensuite une cl
NetHASP standard.

-ipx

Indique au systme NetHASP d'utiliser le protocole IPX avec SAP.

-ipxnosap

Indique au systme NetHASP d'utiliser uniquement le protocole IPX (sans SAP). Avec le
Gestionnaire de Licence pour Win32, vous pouvez toujours charger d'autres protocoles en
utilisant soit les paramtres -tcpip ou -netbios.
Lorsque vous utilisez ce paramtre, le Gestionnaire de Licence NetHASP cre un fichier nomm
newhaddr.dat. Ce fichier contient l'adresse du nud de la station excutant le Gestionnaire de
Licence NetHASP. Lorsque vous chargez le Gestionnaire de Licence NetHASP avec ce
paramtre, seules les applications protges ayant accs au fichier newhaddr.dat pourront
communiquer avec le Gestionnaire de Licence NetHASP.

-localnet

Utilisez ce paramtre si vous dsirez que le Gestionnaire de Licence NetHASP ne gre que les
stations se trouvant dans son rseau local.
Si des demandes proviennent de stations hors du rseau local, le Gestionnaire de Licence
NetHASP retournera l'erreur 140.

-nbname=<nom>

Assigne un nom NetBIOS au Gestionnaire de Licence NetHASP. Ce paramtre est identique au


paramtre -nethaspnbname.

-nec

Utilisez ce paramtre avec des ordinateurs NEC pour rechercher une cl NetHASP36.

-net

Ne diffuse l'adresse du Gestionnaire de Licence NetHASP qu' un numro de rseau local


donn.

D-4

Paramtres du Gestionnaire de Licence NetHASP

Paramtres

Explication

-netbios

Force le systme NetHASP n'couter que le protocole NetBIOS. Avec le Gestionnaire de


Licence NetHASP pour Win32, vous pouvez toujours charger d'autres protocoles l'aide des
paramtres -tcpip ou -ipxnosap.

-nethaspnbname=
<nom>

Assigne un nom NetBIOS au Gestionnaire de Licence NetHASP. Mme paramtre que


-nbname.

-openmin

Charge le Gestionnaire de Licence NetHASP en fentre minimise. Par dfaut, la fentre est
maximise.

-portnum=<nombre>

Si vous utilisez le protocole TCP/IP, vous pouvez utiliser ce paramtre pour indiquer au
Gestionnaire de Licence NetHASP d'couter le port indiqu. Le numro de port par dfaut est
475.

-r

Enlve le Gestionnaire de Licence NetHASP.

-saptofile

Lorsque vous utilisez ce paramtre, le Gestionnaire de Licence NetHASP cre un fichier


newhaddr.dat. Ce fichier contient l'adresse du nud de la station excutant le Gestionnaire de
Licence NetHASP.

-srvname=
<nom>[,nom]

Assigne un ou plusieurs noms au Gestionnaire de Licence NetHASP. Vous pouvez assigner


jusqu' six noms.

-tcpip

Force le systme NetHASP n'couter que le protocole TCP/IP. Avec le Gestionnaire de


Licence pour Win32, vous pouvez toujours charger d'autres protocoles avec les paramtres
-ipxnosap ou -netbios.

-uselananum=
<x>[,<x>]

Indique au Gestionnaire de Licence NetHASP d'couter sur les lana numbers indiqus.

-userlist

Limite le nombre maximum d'applications protges.

Annexe E - Adaptation de NetHASP


Dfinition des Stations Autorises sous IPX
au Rseau Cette section dcrit les paramtres supplmentaires du
Gestionnaire de Licence NetHASP et les mots cls du fichier
nethasp.ini que vous pouvez utiliser pour ajuster le systme NetHASP
votre environnement rseau.
Pour n'autoriser que certaines stations accder au systme
NetHASP sous protocole IPX :
1. Chargez le Gestionnaire de Licence NetHASP avec le paramtre ipxnosap.
Cela permet de diffuser l'adresse du Gestionnaire de Licence
NetHASP dans le fichier d'adresse NetHASP newhaddr.dat.
2. Modifier le fichier nethasp.ini comme suit :

Dans la section [NH_COMMON], dfinissez NH_IPX =


Enabled

Dans la section [NH_IPX], dfinissez NH_USE_BROADCAST


= Disabled

Dans la section [NH_IPX], dfinissez NH_USE_BINDERY =


Disabled

Ces paramtre indiquent l'application protge tournant sur les


stations autorises de chercher le fichier d'adresse et d'y lire l'adresse
du Gestionnaire de Licence NetHASP.
3. Copiez l'application protge et le fichier nethasp.ini dans le mme
rpertoire. Assurez-vous que seules les stations autorises, et
uniquement celles-ci, lancent l'application partir de ce rpertoire.

E-1

E-2

Adaptation de NetHASP

Dfinition des Stations Autorises sous TCP/IP


Il existe deux mthodes de dfinition des stations autorises sous
TCP/IP. Vous pouvez dfinir les stations autorises se connecter
un Gestionnaire de Licence NetHASP, ou bien indiquer le
Gestionnaire de Licence NetHASP que les stations autorises doivent
rechercher.

Spcification des Stations grce au Fichier nhsrv.ini


Les Gestionnaires de Licence NetHASP pour Windows et Win32
peuvent lire un fichier de configuration : nhsrv.ini. vous pouvez
modifier ce fichier pour indiquer les stations que le Gestionnaire de
Licence NetHASP grera sous TCP/IP.
Pour spcifier les stations autorises, modifiez le fichier
nhsrv.ini comme suit :
Dans le section [NH_SERVER], dfinissez NH_IP_LIMIT =
<ipaddr> [,<ipaddr....]
o <ipaddr> peut avoir des valeurs aux formats suivants :

10.1.2.3 - le Gestionnaire de Licence NetHASP ne grera que


les stations avec l'adresse ip indique

10.1.2.* - le Gestionnaire de Licence NetHASP ne grera que


les stations dont l'adresse ip correspond au masque indiqu,
i.e. 10.1.2.0 10.1.2.255

10.1.*.*- le Gestionnaire de Licence NetHASP ne grera que les


stations dont l'adresse ip correspond au masque indiqu, i.e.
10.1.0.0 10.1.255.255

10.1.2.3-5 - le Gestionnaire de Licence NetHASP ne grera que


les stations avec l'adresse ip 10.1.1.3, 10.1.1.4 et 10.1.1.5

Le Gestionnaire de Licence NetHASP recherche le fichier nhsrv.ini


dans les rpertoires suivants :

E-3

Tableau E.1: Ordre de recherche du fichier nhsrv.ini


Type dApplication

Ordre de Recherche

Windows

Rpertoire courant Rpertoire de Windows Rpertoire System de


Windows Rpertoire du fichier excutable Path Map de recherche
Netware

Win32

Rpertoire du fichier excutable Rpertoire courant Rpertoire System


de Windows Rpertoire de Windows Path

Pour n'autoriser que certaines stations accder NetHASP


sous protocole TCP/IP :
1. Modifiez le fichier nhsrv.ini et dfinissez les stations autorises.
2. Copiez le fichier nhsrv.ini dans un rpertoire accessible au
Gestionnaire de Licence NetHASP.

Spcification des Stations grce au Fichier nethasp.ini


Vous pouvez modifier le Ficher de Configuration NetHASP pour
indiquer au Gestionnaire de Licence NetHASP les stations
rechercher.
Pour spcifier les stations rechercher au Gestionnaire de
Licence NetHASP :
1. Modifiez le fichier nethasp.ini :

Dans
la
section
NH_SERVER_ADDRESS=
Licence NetHASP>

[NH_TCPIP],
dfinissez
<adresse du Gestionnaire de

2. Copiez le fichier nethasp.ini dans un rpertoire accessible qu'aux


stations autorises.

E-4

Adaptation de NetHASP

Dfinition des Stations Autorises sous NetBIOS


Pour n'autoriser que certaines stations accder la cl
NetHASP sous protocole NetBIOS :
1. chargez le Gestionnaire de Licence NetHASP avec le paramtre
-nbname pour dfinir un nom de votre choix (jusqu' 8 caractres).
Cela dfinit le nom NetBIOS du Gestionnaire de Licence NetHASP.
Par exemple, pour lancer haspserv.exe et dfinir le nom NetBIOS
de la station comme tant firstsrv, entrez :
haspserv -nbname = firstsrv
2. Modifiez le fichier nethasp.ini :

Dans le section [NH_COMMON], dfinissez NH_NETBIOS =


Enabled

Dans la section [NH_NETBIOS], dfinissez NH_NBNAME =


firstsrv

Cela lie la station au nom NetBIOS.


3. Copiez l'application protge et le fichier nethasp.ini dans un mme
rpertoire. Assurez-vous que seules les stations autorises, et
uniquement celles-ci, lancent l'application partir de ce rpertoire.

Note:

Vous ne pouvez pas dfinir deux stations avec le mme nom


NetBIOS. Si vous dsirez lancer le Gestionnaire de Licence
NetHASP sur plusieurs stations, vous devez dfinir un nom
NetBIOS diffrent pour chaque Gestionnaire de Licence
NetHASP.

Adaptation de la dure du Timeout


Le Gestionnaire de Licence NetHASP ne peur grer plus d'une
requte la fois. La dure du timeout dtermine le temps que met

E-5

une application protge pour essayer d'accder au Gestionnaire de


Licence NetHASP avant d'abandonner.
Sur la plupart des rseaux, la valeur par dfaut du timeout est
suffisante, vous ne devez modifier cette valeur que si la cl NetHASP
est connecte une station lente ou trs occupe.
Pour dfinir la dure du timeout :
Dans la section approprie du fichier nethasp.ini, dfinissez :
NH_SESSION = <m>
NH_SEND_RCV = <n>
o m et n sont exprims en secondes. Par dfaut, m vaut 2
secondes et n 1 seconde.

Dfinition du Nombre d'Applications Protges


Gres
Gestionnaire de Licence NetHASP pour DOS
Le Gestionnaire de Licence NetHASP alloue de la mmoire pour grer
250 applications protges (environ 4 Ko). Si ncessaire, vous pouvez
limiter la mmoire utilise en modifiant cette valeur par dfaut.
Pour modifier la quantit de mmoire alloue par dfaut :
Chargez le Gestionnaire de Licence NetHASP comme suit :
haspserv -userlist = n
o n est le nombre maximum d'applications protges.

E-6

Adaptation de NetHASP

Gestionnaire de Licence NetHASP pour Win32


Le Gestionnaire de Licence NetHASP pour Win32 peut grer plus de
250 applications protges.
Pour modifier la quantit de mmoire alloue par dfaut :
Chargez le Gestionnaire de Licence NetHASP comme suit :
nhsrvw32 -userlist = n
o n est le nombre d'applications protges grer.

E-7

Rseaux Locaux et Interconnects


Cette section dcrit des rseaux composs de plusieurs rseaux
interconnects utilisant le protocole IPX.
Avec le systme NetHASP, le terme de rseau local est trs vaste. Le
Gestionnaire de Licence NetHASP et le client NetHASP (l'application
protge) considrent le rseau local diffremment. Le Gestionnaire
de Licence NetHASP appelle rseau local tous les segments
directement connects au Gestionnaire de Licence NetHASP. Le client
NetHASP client appelle rseau local le segment actuel.
Un rseau interconnect est un groupe de deux ou plus rseaux locaux
connects entre eux.
L'exemple ci-dessous montre comment vous pouvez configurer le
client NetHASP et le Gestionnaire de Licence NetHASP pour
fonctionner en rseau local ou interconnect.

Adaptation du Gestionnaire de Licence NetHASP


Le rseau interconnect de notre exemple comprend deux serveurs de
fichiers : File Server 1 et File Server 2. Le serveur File Server 1
possde deux segments numrots 111 et 222. Le serveur File Server
2 possde galement deux segments numrots 333 et 444.

E-8

Adaptation de NetHASP

Figure E.1: Rseaux locaux et interconnects


Par dfaut, le Gestionnaire de Licence charg sur le File Server 1 ou
le File Server 2 gre l'ensemble du rseau interconnect. Cela signifie
que si vous lancez le Gestionnaire de Licence NetHASP sans
paramtre, il grera les segments 111, 222, 333 et 444 du rseau.
Si vous dsirez limit le Gestionnaire de Licence NetHASP aux
stations du rseau local gr par le serveur File Server 1 (stations
sur les segments 111 et 222) :
Sur le serveur File Server 1, chargez haspserv.nlm avec le
paramtre -localnet comme suit :
load haspserv -localnet
Dsormais, le Gestionnaire de Licence NetHASP ne grera plus les
stations des segments 333 et 444.
Si vous ne dsirez grer que les stations du segments 222 avec le
Gestionnaire de Licence NetHASP :
Sur le serveur File Server 1, chargez le Gestionnaire de Licence
NetHASP avec le paramtre supplmentaire -net, comme suit :
load haspserv -localnet -net 222

E-9

Dsormais, le Gestionnaire de Licence NetHASP ne grera que les


stations du segment 222, et non plus celles des segments 111, 333
et 444.

Adaptation du Client NetHASP


Par dfaut, une application protge recherche le Gestionnaire de
Licence NetHASP sur le rseau interconnect.
Si vous dsirez que votre application ne recherche le Gestionnaire de
Licence NetHASP que sur son rseau local :
Modifiez le fichier nethasp.ini comme suit :

Dans la section [NH_COMMON], dfinissez NH_IPX =


Enabled

Dans la section [NH_IPX], dfinissez NH_SEARCH_METHOD


= Localnet

Si l'application protge fonctionne sur une station du segment 222,


l'application ne trouvera le Gestionnaire de Licence NetHASP que sur
le segment 222. L'application ne recherchera pas un Gestionnaire de
Licence NetHASP qui est actif sur un autre rseau local.

E-10

Adaptation de NetHASP

Annexe F - HASP sous OS/2


Utilisez l'API HASP pour protger les applications en OS/2 natif.
L'API HASP pour OS/2 contient un rpertoire distinct pour chaque
compilateur support par HASP. Chaque rpertoire contient un sousrpertoire 16bit ou 32bit, ou bien les deux. Ces derniers contiennent
les fichiers objets HASP 16-bit et 32-bit. Le rpertoire 16bit inclut un
sous-rpertoire dll avec tous les fichiers ncessaire la gnration
d'une DLL HASP.
Note Actuellement, NetHASP ne supporte pas les fichiers objets
NetHASP: 32-bit. Pour protger votre application avec NetHASP,

utilisez les fichiers objets 16-bit ou la DLL.

Installation de HASP sous OS/2


Pour accder aux cls HASP, les applications protges lies des
fichiers objets 16-bit, doivent s'excuter dans des segments IOprivileged. Dans de tels cas, ajouter la ligne suivante dans le fichier
config.sys OS/2 :
IOPL = YES

Pour supporter les applications lies des fichiers objets HASP 32bit, vous devez installer le Gestionnaire de Priphrique HASP pour
OS/2 : haspos2.sys. Le Gestionnaire de Priphrique HASP permet
l'accs aux cls HASP sur des ordinateurs isols.
Pour installer le Gestionnaire de Priphrique HASP:
Ajoutez la ligne suivante dans le fichier config.sys OS/2:
DEVICE=<chemin>\HASPOS2.SYS

o <chemin> est le chemin d'accs complet au Gestionnaire de


Priphrique HASP.

F-1

F-2

HASP sous OS/2

Reconfiguration du Port Parallle pour


Partager le Port
Si l'imprimante et la cl HASP sont connectes sur le mme
port parallle, reconfigurez le port comme suit :
1. Dans le Gestionnaire de Programme OS/2, utilisez le bouton droit
de la souris sur l'icne Imprimante.
2. Choisissez l'option Rglage.
3. Choisissez longlet Sortie. Une page indiquant tous les ports LPT
et COM saffiche.
4. Double cliquez sur le port LPT sur lequel sont connects la cl
HASP et l'imprimante. La fentre de Paramtrage du Port
Parallle apparat.
5. Cochez l'option Partager l'accs dans le bas de la fentre.
6. Cliquez sur OK.

Annexe G - HASP36 et NetHASP36


HASP36 est se qui se fait de mieux en matire de systme de
protection matrielle pour les applications tournant sur des
ordinateurs PC NEC japonais.
La cl HASP36 se connecte sur le port parallle des ordinateurs NEC.
Si vous distribus des logiciels au Japon, HASP36 peut vous aider
augmenter vos revenus en empchant la diffusion de copies illgale de
votre application.
La gamme de cls HASP36 est entirement compatible avec les autres
produits HASP. Cela signifie que vous pouvez facilement adapter
votre application protge avec une cl HASP36 pour fonctionner sur
les PC occidentaux ou japonais.
La protection avec les cls HASP36 est similaire la protection avec
cls HASP. Les diffrences sont dtailles dans cette annexe.

G-1

G-2

HASP36 et NetHASP36

La Gamme HASP36
Tableau G.1 Cls de la gamme HASP36
Cls HASP

Mmoire Interne
en Lecture /.Ecriture

HASP36

aucune

MemoHASP36-1

56 mots (112 octets)

MemoHASP36-4

248 mots (496 octets)

NetHASP36

248 mots (496 octets)

Installation de HASP36
Les cls HASP36 se connectent sur le port parallle via le cble de
l'imprimante. Si le cble de l'imprimante n'est pas disponible, vous
pouvez utiliser un adaptateur. Vous pouvez connecter les cls
HASP36 sur les ports parallles Centronics 14, 20 et 36 broches des
ordinateurs NEC en utilisant diffrents types de cbles. Avec un
adaptateur, vous pouvez connecter les cls HASP36 un port
parallle 25 broches d'un ordinateur IBM PC.

G-3

Protection par Enveloppe


Le programme de protection par Enveloppe utilis dpend du type
d'application protger et de l'environnement de travail. Consultez le
tableau G.2 pour dterminer le programme d'Enveloppe que vous
devez utiliser.
Tableau G.2: Programmes dEnveloppe pour HASP36
Programme
dEnveloppe

Type d'Application Protger

Environnement de Travail

nhspinst.exe

DOS

DOS japonais sur NEC

vhspinst.exe

DOS

DOS/V sur IBM

haspinst.exe

DOS

DOS sur IBM

nwhinst.exe

Windows

DOS japonais sur NEC

vwhinst.exe

Windows

DOS/V sur IBM

whinst.exe

Windows

DOS sur IBM

W32hinst.exe

Win32

Systmes Win32 sur IBM et NEC

Identification de lOrdinateur
Les programmes d'Enveloppe possdent un champ Target Computer
permettant d'indiquer le type d'ordinateur sur lequel va s'excuter
l'application protge. Dans les programmes d'Enveloppe japonaise, la
valeur par dfaut est NEC. L'autre valeur possible est IBM. Pour
prciser le type d'ordinateur en mode batch, utilisez le paramtre
-ibm ou -nec.

G-4

HASP36 et NetHASP36

HaspEdit
Il existe diffrents programmes HaspEdit fonctionnant sur des
ordinateurs et environnements diffrents. Consultez le tableau G.3
pour dterminer le programme HaspEdit que vous devez utiliser.
Tableau G.3: Programmes HaspEdit pour HASP36
Programmes HaspEdit

Environnement de Travail

nhspedit.exe

DOS japonais sur NEC

vhspedit.exe

DOS/V sur IBM

haspedit.exe

DOS sur IBM

whedit.exe

Windows et Windows japonais sur IBM

nwhedit.exe

Windows japonais sur NEC

Protection par API


Utilisez la routine hasp( ) pour incorporer la protection par API dans
votre application. Le tableau G.4 indique les services disponibles pour
chacune des cls de la gamme HASP36.
Tableau G.4: Cls HASP36 et les services API correspondants
Cls HASP36

Services API Correspondants

HASP36

HASP de base

MemoHASP36-1

HASP de base et MemoHASP

MemoHASP36-4

HASP de base et MemoHASP

NetHASP36

NetHASP

G-5

Le Paramtre LptNum
Le paramtre LptNum est utilis lors des appels la routine hasp( )
avec les services HASP de base ou les services MemoHASP. Ce
paramtre indique la routine hasp( ) la famille de cl HASP
rechercher : HASP ou HASP36. Le paramtre LptNum indique
galement sur quel port parallle rechercher la cl.
Utilisez le tableau suivant pour dterminer la valeur assigner au
paramtre LptNum lors de la recherche d'une cl HASP36. Nous vous
recommandons d'effectuer une recherche automatique de la cl sur
tous les ports parallles de l'ordinateur. Ds que l'application trouve
une cl HASP, la recherche s'arrte.
Tableau G.5: Dfinition du LptNum avec HASP36
Ports Recherchs

LptNum sur NEC

LptNum sur IBM PC

Tous les Ports (Automatique)

60

50

Port Parallle NEC

61

LPT1 seulement

51

LPT2 seulement

52

LPT3 seulement

53

03BCH seulement

151

0378H seulement

152

0278H seulement

153

Note:

Actuellement, les ordinateurs NEC nont quun seul port


parallle. Une recherche automatique avec le LptNum 60
assure une compatibilit avec les futurs ports parallles.

Vous n'avez besoin que d'une seule cl HASP36 pour faire tourner vos
applications protges sur les NEC et les IBM PC. Assignez

G-6

HASP36 et NetHASP36

seulement au paramtre LptNum une valeur lui indiquant sur quel


port parallle et quel type de cl rechercher.

Gestionnaire de Priphrique HASP


Durant l'installation, le Gestionnaire de Priphrique HASP
reconnat automatiquement le type d'ordinateur (IBM ou NEC). Cela
permet une application protge de migrer d'une plate-forme IBM
vers une plate-forme NEC sans modification du programme. Le
Gestionnaire de Priphrique HASP convertit automatiquement le
paramtre LptNum de IBM NEC (voir tableau G.5).

Attention
Une application que vous protgez pour fonctionner sur IBM PC, ne peut tre lance
sur un ordinateur NEC que si vous utilisez le Gestionnaire de Priphrique HASP.
Le Gestionnaire de Priphrique HASP convertit automatiquement la valeur de
LptNum en fonction de la plate-forme. Si vous n'installez pas le Gestionnaire de
Priphrique HASP sur les ordinateurs NEC, assurez-vous d'appeler la routine
hasp( ) avec LptNum dfinit 60 ou 61. Toute autre valeur de LptNum provoquera
un plantage de l'ordinateur.

G-7

Gestionnaires de Licence NetHASP


Le tableau G.6 contient la liste des Gestionnaires de Licence
NetHASP que vous pouvez utiliser avec NetHASP36.
Tableau G.7: Gestionnaires de Licence NetHASP pour NetHASP36
Gestionnaires de Licence NetHASP

Environnement de Travail

nhsdosj.exe

DOS sur NEC

nhswinj.exe

Windows sur NEC

nhsrvwnt.exe

Windows 95 et Windows NT sur IBM ou NEC

haspserv.nlm

Serveurs de fichier Netware 386 et 486 sur IBM ou NEC

nhsrvos2.exe

OS/2 sur IBM ou NEC

G-8

HASP36 et NetHASP36

Annexe H - Mots de Passe de


Dmonstration
Lorsque vous commandez des cls HASP, on vous assigne un Code
Dveloppeur unique et des Mots de Passe HASP uniques.. Vous
recevez ces mots de passe avec votre premire srie de cls.
Les Tableaux H.1 et H.2 montrent les mots de passe que vous pouvez
utiliser avec les cls de dmonstration prsentent dans les Kit de
Dveloppement.
Tableau H.1: Mots de Passe des cls de dmonstration
HASP mmoire
Code Dveloppeur

Premier
Mot de Passe

Second
Mot de Passe

DEMOMA

15417

9632

DEMOMB

29875

28774

DEMOMC

29313

23912

H-1

H-2

Mots de Passe de Dmonstration

Tableau H.2: Mots de Passe des cls de dmonstration HASP-3


Code Dveloppeur

Premier
Mot de Passe

Second
Mot de Passe

DEMO3A

5932

25657

DEMO3B

20580

22012

DEMO3C

10038

15697

Annexe I - Support Technique


La premire partie de cette annexe prsente les problmes
frquemment rencontrs avec les cl HASP. Les parties suivantes
vous aideront rsoudre les diffrents problmes auxquels vous ou
vos clients pourriez tre confronts.
Malgr tous les efforts dploys pour assurer la meilleure qualit et
compatibilit, les cls HASP, comme tout priphrique PC, peuvent ne
pas fonctionner avec certaines configurations suite un quipement
dfectueux ou une mauvaise installation.
De plus, comme les cls HASP sont connectes sur l'ordinateur, elles
peuvent tre accuses de provoquer des dysfonctionnements dus en
fait d'autres composants d'une configuration particulire.
Si l'un de vos clients vous fait part d'un problme, vrifiez les points
de la liste ci-aprs. La plupart des problmes peuvent tre rgls
grce la liste suivante.
La carte parallle et la cl HASP sont-elles correctement
connectes au port parallle ?
Le PC est-il infect par un virus qui pourrait empcher
l'application de fonctionner correctement ?
Le problme se reproduit-il avec une autre cl HASP? Si non,
replacez la cl dfectueuse par une nouvelle.
Une imprimante est-elle connecte sur le mme port que le cl
HASP ? Si oui, fonctionne-t'elle correctement ? (Une impression
correcte ne signifie pas que le port fonctionne correctement
100%.)
Si la cl HASP est connecte sur le mme port d'une imprimante,
dconnectez l'imprimante et vrifier si la cl fonctionne
correctement. S'il y a des problmes d'impression, essayer
d'utiliser un autre cble de connexion et si possible une autre
imprimante.

I-1

I-2

Support Technique

Si possible, essayez dutiliser (ou dinstaller) un second port


parallle pour la cl HASP, pour viter tout problme caus par
l'imprimante. Si ce n'est pas possible, essayez de remplacer la
carte parallle d'origine.
Essayez d'utiliser l'application protge sur un autre PC de mme
modle.

I-3

Problmes et Solutions
Problme:

La cl HASP est connecte mais l'application protge


renvoie une erreur Cl HASP non trouve.

Solution:

Bien que de nombreux efforts dploys pour assurer le meilleur


niveau de communication, dans de rares occasions, un appel la
cl HASP peut ne pas tre transmis correctement. Nous vous
recommandons d'appeler la routine hasp( ) avec un service
plusieurs fois avant de conclure que la cl n'est pas prsente.
N'agissez en consquence que si toutes les rponses indiquent
l'absence de la cl.

Problme:

Le programme d'Enveloppe pour DOS ne peut tre utilis


pour protger les fichiers excutables pouvant tre lis
d'autres applications.

Solution:

Cela est particulirement vrai pour la commande chain des


anciens compilateurs BASIC, de mme que pour la commande
execute du Turbo Pascal V 3.0. Dans les autres cas, vous
pouvez protger le fichier principal (le fichier qui excute les
chanages) except s'il est lui-mme rappel.
N'oubliez pas que si vous ne pouvez pas utiliser le programme
d'Enveloppe, vous pouvez toujours utiliser l'API (voir chapitre 6).

Problme:

Vous obtenez des erreurs de l'imprimante lorsque vous


essayez d'imprimer partir d'une application protge.

Solution:

Cela est d un conflit entre l'imprimante et l'accs la cl


HASP.
Pour viter les conflits entre la cl HASP et d'autres
priphriques parallles (comme des imprimantes), installez le
Gestionnaire de Priphrique HASP. Voir chapitre 14 pour plus
d'informations.

I-4

Support Technique

Problme:

Une cl HASP est connecte l'impriamnte et Windows


indique que l'imprimante est inaccessible ou qu'il y a un
conflit de priphrique.

Solution:

1. Choisissez le Groupe Principal du Gestionnaire de


Programme.
2. Choisissez l'icne Panneau de Configuration.
3. Cliquez sur 386 Etendu.
4. Slectionnez LPT1 dans la zone Device Contention et cliquez
sur Never Warn.
5. Rptez l'opration 4 pour les ports LPT2 et LPT3.
6. Cliquez sur OK.

Problme:

Vous essayez d'utiliser le programme hinstall.exe pour


installer le Gestionnaire de Priphrique HASP sous
Windows NT mais vous obtenez l'erreur 9121.

Solution:

Vous obtenez lerreur 9121 sous Windows NT si vous essayez


dinstaller le programme hinstall sans les droits Administrateur.

Problme:

Vous essayez d'excuter une application protge par une


cl MemoHASP sous Windows NT ou Windows 95, mais
l'application ne peut trouver la cl.

Solution:

Vrifiez les points suivants :


Assurez-vous que le Gestionnaire de Priphrique HASP est
install.
Si le problme persiste avec le Gestionnaire de Priphrique
HASP charg, excutez :
hinstall -info

I-5

Hinstall affiche le numro de version, la date d'installation et le


type d'ordinateur. contactez votre reprsentant HASP et
fournissez-lui ces informations.

I-6

Support Technique

Problme:

Votre application protge avec une cl MemoHASP est


excute sous Windows NT. Vous avez indiqu votre
client d'installer le Gestionnaire de Priphrique HASP
en lanant : hinstall -is
Maintenant, chaque fois que le client redmarre rsont
ordinateur, il affiche le message: HASP Loader Service
unable to load the NetHASP License Manager.

Solution:

En excutant hinstall -is, vous avez install le Gestionnaire de


Priphrique HASP et galement le Gestionnaire de Licence
NetHASP pour Win32, nhsrvwnt.exe. Comme le programme
nhsrvwnt.exe n'a pas t copi dans le rpertoire SYSTEM32, le
module de chargement ne peut charger automatiquement le
Gestionnaire de Licence NetHASP et affiche ce message.
Il y a manires de rsoudre ce problme :
Copiez le programme nhsrvwnt.exe dans le rpertoire
SYSTEM32.
Dsactivez le Gestionnaire de Licence NetHASP. Vous n'avez
pas besoin du Gestionnaire de Licence NetHASP tant donn
que vous utilisez une cl MemoHASP et non une cl
NetHASP. Pour dsactiver le chargement automatique du
programme nhsrvwnt.exe excutez :
hinstall -rs

I-7

Problme:

Votre application est protge par une cl NetHASP et


l'Enveloppe. Bien que toutes les licences ne soient pas
utilises, des utilisateurs supplmentaires ne peuvent
lancer l'application. Ils obtiennent l'erreur too many
users ("trop d'utilisateurs") lorsqu'ils essaient.

Solution:

Une application protge uniquement par une cl NetHASP et


l'Enveloppe ne fait pas de LOGOUT NetHASP. Lorsqu'une
application se termine, elle reste liste dans la Table de
Connexion, ne librant ainsi pas sa licence.
Pour enlever l'application de la Table de Connexion, et ainsi
librer une licence, utilisez l'API pour effectuer un LOGOUT
NetHASP.

Problme:

Vous protgez une application utilisable soit sur PC isol


sous en environnement rseau avec une cl MemoHASP et
NetHASP. Maintenant, vous dcouvrez qu'une station de
plus que le nombre de licences accordes excutent
l'application.

Solution:

Ce arrive car l'application essaie d'abord de trouver une cl


MemoHASP sur le port local. si les Codes Dveloppeur des cls
MemoHASP et NetHASP sont les mmes, une application
excute sur la station possdant la cl NetHASP trouvera la cl
NetHASP locale. L'application traitera cette cl NetHASP locale
comme une cl monoposte et ne sera pas enregistre dans la
Table de Connexion NetHASP. De ce fait, l'application ne
consomme pas de licence.
Pour viter cette situation, assurez-vous que les cls
MemoHASP et NetHASP ont des Codes Dveloppeur diffrents.

I-8

Support Technique

Problme:

Votre application Win32 protge par une cl NetHASP


fonctionne correctement sur des stations sous Windows
for Workgroups, mais provoque des erreurs LastStatus
NetHASP 1 lorqu'elle foncitonne sous Win32s.

Solution:

Copiez le fichier hasput16.dll dans le rpertoire de l'application.


vous pouvez trouver le fichier hasput16.dll dans le rpertoire
drivers des logiciels HASP.

Problme:

Dans les trois situations suivantes, l'erreur 15 survient


lorsque vous excutez votre application Windows 16-bit :
Le Gestionnaire de Licence NetHASP nhsrvwnt.exe est
charg sur une station Windows NT.
L'application tourne sur une station Windows for
Workgroups.
Le protocole actif est NetBIOS.

Solution:

Cette erreur survient car les protocoles rseau du Gestionnaire


de Licence NetHASP et du client NetHASP ne sont pas
synchroniss.

I-9

Pour synchroniser les protocoles :


1. Assurez-vous que le transport IPX/SPX compatible NetBIOS
est le protocole par dfaut sur le Gestionnaire de Licence
NetHASP (voir Paramtrage du Protocole par Dfaut au
chapitre 16).
2. Assurez-vous que le transport IPX/SPX compatible NetBIOS
est galement le protocole par dfaut sur les stations
Windows for Workgroups (voir Paramtrage du Protocole par
Dfaut au chapitre 16).
3. Modifiez le Fichier de Configuration NetHASP comme suit :
Dans
la
section
NH_NETBIOS=Enabled

[NH_COMMON],

dfinissez

4. Copiez le Fichier de Configuration NetHASP dans le


rpertoire de l'application.
Problme:

Votre application Win32 protge par NetHASP,


fonctionnant sous Windows 95 avec le protocole IPX,
renvoie une erreur LastStatus NetHASP 4.

Solution:

Actuellement, de tels applications utilisent IPX sans SAP. Pour


accder au Gestionnaire de Licence NetHASP, l'application doit
accder au fichier newhaddr.dat pour obtenir l'adresse du
Gestionnaire de Licence NetHASP. Si l'application protge ne
peut accder ce fichier d'adresse, elle renvoie l'erreur
LastStatus 4.
Pour plus d'informations sur l'accs au fichier d'adresse,
reportez-vous au chapitre 16, Adapter NetHASP au protocole
IPX sans SAP.

I-10

Support Technique

Problme:

Votre application Windows protge


renvoie l'erreur LastStatus NetHASP 21.

par

NetHASP

Solution:

Les DOS extender et les applications Windows requirent


environ of 8 Ko de mmoire DOS. L'API NetHASP requiert 1 Ko
de mmoire DOS.
L'erreur LastStatus NetHASP 21 survient lorsque la quantit de
mmoire DOS est infrieure 1 Ko et, de ce fait insuffisante
pour le systme NetHASP. Dans ce cas, non seulement
NetHASP, mais d'autres applications Windows sont dsactives.
Pour rsoudre ce problme, dchargez quelques programmes
rsidents ou former des applications Windows. Utilisez la mme
solution pour toute application n'ayant pas assez de mmoire
pour s'excuter.

Problme:

L'accs au port parallle provoque un plantage de


l'ordinateur.

Solution:

A chaque port parallle des IBM PC est associ un des ports


suivants: 3BCh, 378h ou 278h.
Des cartes rseau utilisent gnralement les ports 10h ou 20h
aprs leur adresse de base.
Lorsque le port d'une carte rseau se superpose celui d'un port
parallle, l'accs ce port parallle peut provoquer un plantage
de l'ordinateur. Par exemple: une impression, l'accs une cl de
protection ou un priphrique connect sur le port parallle
peuvent provoquer un plantage de l'ordinateur.
Il est alors ncessaire de modifier l'adresse de base de la carte
rseau.
Il existe deux manires de changer l'adresse debase d'une
carte rseau :
Sur certaines cartes rseau il est possible de modifier
l'adresse de base par des jumpers. Reportez-vous la

I-11

documentation de votre carte rseau.


sur les nouvelles cartes, le changement d'adresse se fait
l'aide d'un logiciel de configuration livr avec la carte.
Problme:

Votre application fonctionne sur une station dont les


drivers rseau ne sont pas chargs. La station plante
aprs que l'application ait effectu un LOGIN NetHASP.

Solution:

Cela arrive lorsque le Fichier de Configuration NetHASP active


un protocole spcifique. Le systme NetHASP essaie d'utiliser ce
protocole sans vrifier s'il est rellement prsent. Si la station ne
possde pas les drivers du protocole, elle plante.
La solution consiste dtruire le Fichier de Configuration
NetHASP. Ou, si vous avez besoin du Fichier de Configuration
NetHASP, chargez les drivers rseau.

Problme:

Votre application protge par NetHASP fonctionne sur


une station sous Windows for Workgroups, sur un rseau
Novell, avec le protocole IPX, et retourne une erreur 3.

Solution:

Les type de trames du fichier net.cfg et de la configuration


rseau de Windows ne sont identiques. Vrifiez le type de trame
dans le fichier net.cfg et dfinissez un type de trame Windows
identique.
Pour dfinir le type de trame sous Windows :
1. Choisissez loption Configuration Rseau du Panneau de
Configuraiton.
2. Double cliquez sur Transport IPX/SPX Compatible
NetBIOS.
3. Slectionnrez Type de Trame.
4. Dans la liste, choisissez la trame dsire et cliquez sur
Dfinir.

I-12

Support Technique

5. Cliquez sur OK.


6. Redmarrez votre ordinateur.

Rsum
Assurez-vous d'utiliser la dernire version des logiciels HASP. Pour
obtenir les dernires versions, contactez votre reprsentant HASP.
Si le problme persiste, vrifiez si nos exemples et programmes de
test fonctionnent. Ensuite, contactez votre reprsentant HASP.

Annexe J - Spcifications Techniques


Gnral
Matriau du botier plastique .........................................................................................................ABS
Temprature de fonctionnement................................................................ 0 - 55 C (32 - 131 F)
Temprature de stockage ......................................................................-25 - 70 C (-13 - 158 F)
Taux d'humidit...................................................................................... 0 - 100 % sans condensation
Norme 1950 UL-6C61................................................................................................................ 94-V0
Plage de tensions de fonctionnement ASIC ......................................................................... 1,8 - 5,5V
Chanage ...................................................................................................................jusqu' 10 units
Nombre d'accs en criture de la mmoire HASP .................................................. au moins 100,000
Rtention des donnes dans la mmoire HASP........................................................ au moins 10 ans

J-1

J-2

Spcifications Techniques

HASP-3, MemoHASP, NetHASP


Dimensions ................................................................................................................ 39 x 53 x 17 mm
Poids............................................................................................................................................~33 g
Connecteurs ................................................................................................................................DB25
Lignes utilises ...........................................................................................D0-D7, INIT, ATFDXT, PE
Mmoire Lecture /. Ecriture
HASP-3 ........................................................................................................................ aucune
MemoHASP-1 ......................................................................................................... 112 octets
MemoHASP-4............................................................................. 496 octets
NetHASP ................................................................................................................. 496 octets
Piles / alimentation externe....................................................................................................... aucune

TimeHASP
Dimensions ................................................................................................................ 52 x 53 x 16 mm
Poids............................................................................................................................................~50 g
Connecteurs ................................................................................................................................DB25
Lignes utilises ...........................................................................................D0-D7, INIT, ATFDXT, PE
Mmoire Lecture / Ecriture
TimeHASP................................................................................................................. 16 octets
TimeHASP-4 ........................................................................................................... 512 octets
Compteurs horloge TimeHASP............................................heure, minute, second, anne, mois, jour
Prcision horloge TimeHASP ......................................................................................2 heures par an
Dure de vie de la pile ...............................................................................................................3+ ans

J-3

HASP36, MemoHASP36, NetHASP36


Dimensions .........................................................................................46 (62 avec attaches) x 68 x 20
Poids............................................................................................................................................~45 g
Connecteurs ................................................................................................................................DB36
Lignes utilises ...............................................................................................................D0-D7, BUSY
Mmoire Lecture / Ecriture
HASP36........................................................................................................................ aucune
MemoHASP36-1 ..................................................................................................... 112 octets
MemoHASP36-4.......................................................................... 496 octets
NetHASP36 ............................................................................................................. 496 octets
Piles / alimentation externe....................................................................................................... aucune

J-4

Spcifications Techniques

Index
A
Accs HASP 13-113-17
Adaptation
dure du timeout E-5
NetHASP E-1E-8; E-1E-9
Anti-debogage 5-47
API 2-5; 2-6; 4-2; 6-16-13
avec le langage Assembleur A-1A-6
codes d'tat 11-111-7
HASP36 G-4G-6
services de base 7-17-5
services MemoHASP 8-18-7
services NetHASP 10-110-20
TimeHASP services 9-19-13
Appel la routine hasp( ) 6-10
Apple Macintosh Voir Macintosh
Applications de dmo Voir Exemple
d'applications
Applications de dmo, cration 5-43
Applications Windows, instances multiples
10-10; 10-10
ASIC 1-5; 1-8; 2-1

C
Carte PC HASP Voir HASPCard
Cartes rseau I-10
Cascading See Daisy-chaining
Chaining See Daisy-chaining
Champ Application Expiry Date 5-16
Champ Application Program Number 5-15
Champ Automatic Virus Detection 5-33
Champ Background HASP Checks 5-17
Champ Check HASP Intervals 5-17
Champ Edit Error Messages 5-345-36
Champ Encrypt Program File 5-18
Champ Encrypt Protected File 5-32
Champ Encryption Key 5-18
Champ Encyrption Key 5-32

Champ Executable Type 5-10


Champ Full Authorization System 5-14
Champ Full Authorization System 5-27
Champ HASP Passwords 5-10
Champ HASP Protection Mode 5-31
Champ HASP-3 Passwords 5-26
Champ Install HASP Envelope 5-18
Champ Install Pattern Code Security 5-19
Champ Loader Filename 5-29
Champ NetHASP Configuration File 5-13; 533
Champ NetHASP Passwords 5-10; 5-25
Champ Number of Activations, NetHASP 512
Champ Number of Application Activations 516
Champ Number of Licenses, NetHASP 5-11
Champ Output Filename 5-24
Champ Program File to Protect 5-24
Champ Program Number 5-25; 5-44
Champ Program Number 5-11
Champ Protect with HASP ID Number 5-26
Champ Protected Filename 5-10
Champ Random File Size 5-33
Champ Special Overlays Mode 5-285-29
Champ Target Computer 5-10
Champ Unprotected Filename 5-9
Champ Use HASP ID Number 5-17
Chargeur NT 16-8
Checking
ID Number 8-4
Circuit Intgr Spcifique Voir ASIC
Cls 15-1
dmonstration 2-2; H-1H-2
mmoire 2-1
monoposte 2-1
Cls de dmonstration 2-2; H-1H-2
Codage 5-18
Code Batch Voir Code Dveloppeur
Code de Retour
calcul 6-12

ii
Code Dveloppeur 2-1; I-7
Code Dveloppeur H-1
Codes
Dveloppeur Voir Code Dveloppeur
Retour Voir Codes de Retour
Seed Voir Seed Codes
Codes de Reour
vrification 7-3
Codes de Retour 15-1; 15-2
dissimulation 15-4
negatif 6-12
vrification 10-5; 13-313-4
Codes de Sortie 5-20; 5-34
Codes d'erreur Voir Codes d'Etat
Codes d'tat
API 11-111-7
LastStatus NetHASP 11-411-7
Codes Graine 15-2
Compilateurs, support 4-2; 6-11
Configuration
type de trame I-11
Conflit de Priphrique 14-2; I-4
Conflits entre les priphriques parallles,
viter I-3
Connexion
HASP36 G-2
NetHASP 16-3
Contrle de l'accs NetHASP E-1E-5
Crash, relancement aprs 10-8

D
DataHASP 2-8
Date d'expiration, dfinition 13-13
Date d'expiration, paramtrage 5-43
Dates See Clock
invalides 13-16
Dates invalides 13-16
Dfinition
date d'expiration 13-13
Fichier de Configuration NetHASP 10-19
nom du Gestionnaire de Licence NetHASP
10-20
Dfinition des stations autorises E-1E-5
DLL

HASP 4-2
protection 6-12
DLLs
HASP 6-1
DOS, mmoire requise I-10

E
Ecriture dans la mmoire 8-3; 8-6; 9-7; 9-9;
10-12; 10-17
enregistrement 3-4; 3-7
Envelope
avec NetHASP I-7
protection rpte avec 5-22
Enveloppe 5-15-47
avec HASP36 G-3
espace disque supplmentaire requis 5-3
ligne de commande 5-365-42
messages d'erreur 5-20
messages d'erreur 5-345-36
pour DOS I-3
protection successives avec 5-4
temps de chargement 5-47
Erreurs
cl HASP non trouve I-3; I-4
erreur 1 I-8
erreur 15 I-8
erreur 21 I-10
erreur 3 I-11
erreur 4 I-9
erreur 9121 I-4
Espace Disque Requis 5-3
Etat, vrification du LastStatus NetHASP
10-4
Excutables, enchans I-3
Exemple d'applications
dmonstration de l'API 6-1
Gestionnaire Rsident HASP B-1
PCS 12-5
Expiration de Expiry date, paramtrage 5-16

F
FAS 5-425-44; 13-1313-17
liste d'autorisation 5-44; 13-14; 13-15

iii
Fichier de Configuration
Enveloppe 5-33
NetHASP 16-1C-9
Fichier de Configuration NetHASP 16-1C-9
dfinition du nom 10-19
Fonction de Scurit 6-10
Fonctionnalits de Scurit 1-5

G
Gamme HASP PC 1-71-9
Gesitonnaire de Priphrique HASP I-4
Gestionaire de Priphrique HASP 16-1
Gestionnaire de Licence Voir Gestionnaire de
Licence NetHASP
paramtres D-1D-4
Gestionnaire de Licence NetHASP 3-2; 10-20;
16-316-9
avec rseaux locaux et interconnects E-6
E-9
chargement automatique 16-8
problme de chargement I-6
Gestionnaire de priphrique Voir
Gestionnaire de Priphrique HASP
Gestionnaire de Priphrique HASP
dsinstallation 14-7
installation 14-6
installation personnalise 14-7
mise jour 14-7
pour Win32s 14-3
pour Windows 95 14-4
pour Windows NT 14-4
Gestionnaire de Priphrique HASP 14-1148; I-6
pour Windows 14-3
pour Windows NT I-4
programme d'installation 14-614-7
Gestionnaire Rsident 6-1B-2
Gestionnaire Rsident HASP 6-1B-2
GetDate 9-6
GetHaspID 9-13
GetTime 9-4

H
HASP 1-11-9
accs 13-113-17
cls mmoire 2-1
DLL 6-1
gamme 1-71-9
installation 4-3
interfaces 4-2; 6-1
logiciel 4-14-3
mises jour I-12
problmes I-1I-12
termes gnraux 2-12-4
HASP Passwords 2-6
HASP-3 1-7
HASP36 1-8; G-1G-7
gamme G-2
installation G-2
HASPCard 1-8
HaspCode 7-37-4; 10-510-6
HaspEdit 6-2; 13-113-17
lancement 13-1
pour HASP36 G-4
HaspID 8-48-5; 10-13
haspinst.exe 5-2; 5-3
HaspStatus 7-47-5
Heure Voir Horloge
Hinstall 14-614-7; 16-8; I-4
hinstall.exe 14-6
Horloge
rglage de la date 9-5
rglage de la date 13-913-10
rglage de l'heure 9-3; 13-913-10
vrification de la date 9-6; 13-9
vrification de l'heure 9-4; 13-9

I
IBM 5-10; 5-27; 14-6; G-3; G-6
ID Number
checking 8-4
Idle time 5-46
IdleTime 3-7; 10-1410-15
install.exe 4-3
Installation

iv
HASP 4-3
HASP sous OS/2 F-1F-2
HASP36 G-2
NetHASP 16-116-25
Instances multiples, d'applications Windows
10-10; 10-10
Interfaces 4-2; 6-1
Interruption, dfinition B-2
IPX protocol 16-23
IsHasp 7-2

K
Kit de Dveloppement HASP H-1

L
Lancement dapplication, limitation 5-43; 1313
Lancements dune application, limitation 512; 5-16
Langage Assembleur et API A-1A-6
Langages
support 4-2; 6-11
LastStatus 10-4
codes 11-411-7
erreur 1 I-8
erreur 21 I-10
erreur 4 I-9
Lecture de la mmoire 8-2; 8-5; 9-8; 9-11; 1016
Licence I-7
Limitation
applications gres E-6
lancement d'application 13-13
lancements d'application 5-43
lancements d'une application 5-12; 5-16
licences 5-11
Liste d'autorisation, FAS 5-44
Location de logiciel 5-43
Logiciel
HASP 4-14-3
HASP pour OS/2 F-1
HASP36 G-3; G-4
protection 1-12

Logiciels
mise jour I-12
LOGIN 3-3; 3-6; 10-710-8; I-11
LOGOUT 3-3; 5-46; 10-910-10; I-7
LptNum 6-3; G-6

M
Macintosh, support 1-9
Mcanisme de broadcast SAP 16-15; 16-17
Mcanisme de Broadcast UDP 16-2
MemoHASP 1-7
et FAS 13-1413-15
mmoire 13-15
modifier la mmoire 13-513-6
services 6-5; 8-18-7; A-2
MemoHASP/TimeHASP Passwords 5-26
MemoHASP36 1-8
MemoHASP36-1 1-8
MemoHASP36-4 1-8
Mmoire
cls 2-1
criture 8-3; 8-6; 10-12; 10-17
criture 9-7; 9-9
Editeur 13-8
lecture 8-2; 8-5; 9-8; 9-11
lecture 10-16
modification 13-513-6; 13-7; 13-813-9
NetHASP rserve 6-13; 10-12; 10-18
rserve MemoHASP 13-15
rserve TimeHASP 13-17
Memory 2-42-5
Messages d'erreur 5-20; 5-345-36
Messages, Cl HASP non trouve I-3; I-4
Mode Ligne de Commande 5-365-42
Mode TCP 16-2
Mode UDP 16-2
Modification, recherche 5-33
Modifier la mmoire
MemoHASP 13-513-6
NetHASP 13-813-9
TimeHASP 13-7
TimeHASP-4 13-513-6
Module HASP de chargement NT 16-8
Moniteur 17-2

v
Moniteur NetHASP 16-1; 17-217-5
aide 17-5
lancement 17-3
monitor.exe 17-3
Monoposte cls 2-1
Mot cl
Gnral C-2
Spcifique une Section C-2
Motifs, PCS 12-5
Mots cl gnraux C-2
Mots cl spcifiques une section C-2
Mots de Passe Voir Mots de Passe HASP
Mots de Passe de Dmonstration H-1H-2
Mots de Passe HASP 13-3; H-1
dissimulation 15-4
Mots de Passe HASP 2-2

N
NEC 5-10; 5-27; 14-6; G-1; G-3; G-6
NetHASP 1-7; 3-13-7
adaptation un rseau E-1E-8
codes LastStatus 11-411-7
connexion 16-3
Contrle d'accs E-1E-9
erreur 1 I-8
erreur 21 I-10
erreur 4 I-9
et l'Enveloppe I-7
Gestionnaire de Licence 16-1
installation 16-116-25
Liste des Programmes 10-12; 10-18
LOGIN 3-3; 3-6; 10-7; I-11
LOGOUT 3-3; 5-46; 10-9; I-7
mmoire 6-13
modles 3-4
modifier la mmoire 13-813-9
on OS/2 stations 16-9
outils de test 16-1
paramtres de protection 13-1013-11
personnalisation 13-1013-13
recherche automatique 16-1016-13
Serveur Voir Gestionnaire de Licence
NetHASP
services 6-76-9; 10-110-20; A-5A-6

sur Novell 16-516-6


sur port parallle local 7-5
sur station DOS 16-416-5
sur station Win32s 16-5
sur station Windows 16-5
sur une sation Windows 95 16-6
sur une Station Windows NT 16-716-8
Table de Connexion 3-3; 3-7; 10-8; 10-9;
10-15; 10-15
utilisateurs 17-4
NetHASP License Manager
viewing 17-3
nethasp.ini C-1; E-4
nethasp.txt 16-1
NetHASP36 1-8; G-1G-7
Netware, serveur de fichiers 16-516-6
Networks
using HASP-3 and MemoHASP on 2-7
NH_COMMON C-2; C-4
NH_IPX C-5C-6
NH_NETBIOS C-7
NH_TCPIP C-7C-9
nhsrv.ini E-2
Novell, serveur de fichiers 16-516-6
Numro de Programme 13-10
Numro d'Identification
calcul 6-12
et protection par API 6-2
protection par API et 6-6
protection par Enveloppe et 5-17; 5-26
vrification 9-13; 13-4

O
Ordinateurs japonais Voir
OS/2 F-1F-2
OS/2 stations 16-9
Outils de diagnostic 16-1
Outils de test 16-1
Overlays 5-28

P
Paramtrage
date d'expiration 5-43

vi
Paramtrage
nombre de lancements 5-12
nombre de licences 5-11
Paramtres
Enveloppe 5-365-42
Gestionnaire de Licence NetHASP D-1
hinstall 14-7
protection NetHASP 13-1013-11
routine hasp( ) 6-2; 7-1
Paramtres en Ligne de Commande Voir
Paramtres
Partage du port F-2
PC-CardHASP 1-8
PCMCIA 1-8
PCS
et hasp( ) 12-5
et l'Enveloppe 5-6; 12-5
et l'Enveloppe 5-19
Personnalisation
Installation du Gestionnaire de
Priphrique HASP 14-7
NetHASP 13-1013-13
Plantage
ordinateur I-10
Port parallle
reconfiguration F-2
Ports parallle I-10
vrification 7-4
Ports parallles 6-36-4
Power Macintosh Voir Macintosh
Problmes I-1I-12
Problmes d'impression I-2; I-3; I-4
Programme d'Enveloppe DOS
champ Full Authorization System 5-27
champ HASP-3 Passwords 5-26
champ NetHASP Passwords 5-25
champ Output Filename 5-24
champ Program Number 5-25
champ Protect with HASP ID Number 526
champ Special Overlays Mode 5-28
Programme d'Enveloppe DOS
champ Automatic Virus Detection 5-33
champ Encrypt Protected File 5-32
champ Encryption Key 5-32

champ HASP Protection Mode 5-31


champ Loader Filename 5-29
champ MemoHASP/TimeHASP Passwords
5-26
champ NetHASP Configuration File 5-33
champ Program File to Protect 5-24
champ Random File Size 5-33
champ Target Computer 5-27
cran Edit Error Messages 5-34
utilisation 5-22
Programme d'Enveloppe Win16
champ Full Authorization System 5-27
champ HASP Protection Mode 5-31
champ HASP-3 Passwords 5-26
champ MemoHASP/TimeHASP Passwords
5-26
champ NetHASP Configuration File 5-33
champ Output Filename 5-24
champ Program File to Protect 5-24
champ Program Number 5-25
champ Target Computer 5-27
cran Edit Error Messages 5-34
NetHASP Passwords 5-25
Protect with HASP ID Number 5-26
Programme d'Enveloppe Win16
champ Encrypt Protected File 5-32
champ Encryption key 5-32
utilisation 5-22
Programme d'Enveloppe Win32 5-45-20
champ Application Expiry Date, FAS 5-16
champ Application Program Number, FAS
5-15
champ Background HASP Checks 5-17
champ Check HASP at Intervals 5-17
champ Encrypt Program File 5-18
champ Encryption Key 5-18
champ Executable Type 5-10
champ Full Authorization System 5-14
champ HASP Passwords 5-10
champ Install HASP Envelope 5-18
champ Install PCS 5-19
champ NetHASP Configuration File,
NetHASP 5-13
champ NetHASP Passwords 5-10

vii
champ Number of Activations, NetHASP
5-12
champ Number of Application Activations,
FAS 5-16
Champ Number of License, NetHASP 5-11
Champ Program Number, NetHASP 5-11
champ Protected Filename 5-10
champ Target Computer 5-10
champ Unprotected Filename 5-9
champ Use HASP ID Number 5-17
onglet Error Messages 5-20
utilisation 5-55-8
Proteciton Easy 5-31
Protection 1-11-2
API 2-5; 2-6; 6-16-13
application Win32 5-3
Applications DOS et Win16 5-21
de plusieurs applications 13-13
de plusieurs applications 13-10
d'une DLL 6-12
Enveloppe 5-15-47
Enveloppe HASP36 G-3
Ligne de Commande 5-365-42
methods 2-52-6
paramtres, NetHASP 13-1013-11
pour PC en rseau et isols I-7
pour stations en rseau et isoles 6-9
rfrence rapide 1-12
sur rseau et postes isols 5-45
Protection Full 5-31
Protocole IPX
Bindery 16-15; 16-16
Broadcast 16-15; 16-17
Fichier d'adresse 16-16; 16-17
Fichier d'adresse 16-16
recherche personnalise 16-1416-19
Support NetHASP 16-2
Protocole NetBIOS 16-25
dfinition des stations autorises E-4
nom de station E-4
Support NetHASP 16-2
synchronisation, protocoles I-8
Protocole TCP/IP
Broadcast UDP 16-19
dfinition des stations autorises E-2

et hasp( ) 6-9
Support NetHASP 16-2
TCP 16-20
UDP 16-20
Protocoles
synchronisation I-8
Protocols
Support NetHASP 16-2

R
ReadBlock 8-58-6; 9-119-12; 10-16
ReadByte 9-8
ReadWord 8-28-3; 10-11
Recherche
de modification 5-33
de virus 5-33
Recherche automatique
algorithme 16-10
avec NetHASP 16-1016-13
sous IPX 16-11
sous NetBios 16-1216-13
sous TCP/IP 16-11
Recherche personnalise
avec NetHASP 16-1316-22
sous IPX 16-1416-19
sous NetBIOS 16-2116-22
sous TCP/IP 16-1916-21
Recherche Personnalise de NetHASP 161316-22
Recherche, ports parallle G-4G-6
Recherche, ports parallles 6-36-4
Reconfiguration, port parallle F-2
Rglage
date de l'horloge 9-5; 13-913-10
heure de l'horloge 9-3; 13-913-10
Relancement, aprs un crash 10-8
Remote Update System 2-8
Rseau
adaptation de NetHASP E-1E-8; E-1
installation de NetHASP 16-116-25
Rseaux
interconnects E-6E-9
locaux E-6E-9
NetHASP 3-13-7

viii
support 16-1
Rseaux interconnects E-6E-9
Rseaux locaux E-6E-9
Return Codes 2-22-3
Routime hasp( )
appels multiples 15-1
Routine hasp( ) 6-26-3; 7-1
et TCP/IP 6-9
temps requis pour un appel 6-10
Routine hasp( ) 8-1
Routine hasp( ) et PCS 12-5
Routine hasp( ) I-3
Routine haspreg( ) A-1
RUS 2-8

S
SCManager 16-9
Scrambling 5-32
Scurit, amlioration 12-112-6; 15-115-6
Seed Codes 2-22-3; 15-1
Service 1 7-2
Service 2 7-37-4
Service 3 8-28-3
Service 4 8-38-4
Service 40 10-4
Service 41 10-510-6
Service 42 10-710-8
Service 43 10-910-10
Service 44 10-11
Service 45 10-12
Service 46 10-13
Service 48 10-1410-15
Service 5 7-47-5
Service 50 8-58-6
Service 51 8-68-7
Service 52 10-16
Service 53 10-1710-18
Service 6 8-48-5
Service 70 9-3
Service 71 9-4
Service 72 9-5
Service 73 9-6
Service 74 9-7
Service 75 9-8

Service 76 9-99-10
Service 77 9-119-12
Service 78 9-13
Service 85 10-19
Service 96 10-20
Service Control Manager 16-9
Services
base 6-4; 7-17-5
de base A-1
MemoHASP 6-5; 8-18-7; A-2
NetHASP 6-76-9; 10-110-20; A-5A-6
TimeHASP 6-6; 9-19-13; A-2A-5
Services de base 6-4; 7-17-5; A-1
SetConfigFilename 10-19
SetDate 9-5
SetServerByName 10-20
SetTime 9-3
Setting
Tasking Option 16-7
Sommes de Contrle 15-215-3
Spcification du port G-4G-6
Spcification du Port Parallle 6-36-4
Spcifications J-1J-3
Spcifications techniques J-1J-3
Station Windows NT 16-716-8
Stations autorises, dfinition E-1
Stations de travail 1-9
Stations disponibles 10-14
Stations DOS 16-416-5
Stations libres 3-7
Stations Win32s 16-5
Stations Windows 16-5
Stations Windows 95 16-6
Support
protocoles 16-2
rseaux 16-1
Support Technique I-1I-12
Synchronisation
protocoles I-8

T
Table de connexion 3-3; 3-7; 10-8; 10-9; 1015; 10-15
Tasking Option 16-7

ix
TCP/IP protocol 16-24
Temps de chargement 5-47
testnet.exe 17-1
TimeHASP 1-8
et FAS 13-1513-17
mmoire 13-17
modifier la mmoire 13-7
rglage avec HaspEdit 13-913-10
services 6-6; 9-19-13; A-2A-5
TimeHASP-4 1-8; 6-5
et FAS 13-1513-17
modifier la mmoire 13-513-6
Traage du Code 6-10
Types de trame I-11

U
Utilitaires 4-1

V
Vrification
cl HASP spcifique 7-4
Codes de Retour 7-3; 10-5; 13-313-4
date de l'horloge 9-6; 13-9

tat du dernier appel 10-4


heure de l'horloge 9-4; 13-9
Numro d'Identification 9-13; 13-4
port parallle 7-4
prsence de la cl HASP 7-2
Type de cl HASP 7-4
Vrification de HASP en tche de fond 5-17;
5-47
Virus, recherche 5-33
Visualisation
Gestionnaires de Licence NetHASP 17-3
17-4
Utilisateurs NetHASP 17-4

W
w32hinst.exe 5-2; 5-3
w32test.exe 17-1
whinst.exe 5-2; 5-3
WriteBlock 8-68-7; 9-99-10; 10-1710-18
WriteByte 9-7
WriteWord 8-38-4; 10-12
wtestnet.exe 17-1