Novell Confidential Manual (FRA) 6 October 2004
50
Référence : point d'insertion pour l'authentification du programme de lancement d'applicatifs Novell
Novell
®
Application Launcher
TM
comporte un point d'insertion pour l'authentification. Vous pouvez créer vos propres bibliothèques de liens dynamiques (DLL) nécessitant un point d'insertion pour l'authentification du programme de lancement d'applicatifs Novell. Pour implémenter un tel point d'insertion, vous devez bien connaître le programme de lancement d'applicatifs Novell
ZENworks
®
Desktop Management ainsi que les techniques de développement de DLL.
La DLL (généralement créée dans C) doit contenir la fonction
NWAPPAAuthenticateExtern .
Le fichier DLL vous permet d'ajouter une fonction à la bibliothèque zenlite.dll afin d'authentifier les lancements d'application sur la base d'un critère choisi. Les services de licence Novell,
ZENworks OnDemand Services
TM
et d'autres applications utilisent ce service pour inviter l'utilisateur à saisir des informations avant de lancer une application.
Par exemple, lorsqu'un utilisateur s'est authentifié auprès d'un réseau, il peut conserver une connexion permanente, sachant que le fichier DLL peut être configuré pour réauthentifier rapidement l'utilisateur (par empreinte ou biométrie) si celui-ci n'utilise pas le poste de travail pendant un certain laps de temps. Voici d'autres exemples d'utilisation du point d'insertion :
Licence : Vous pouvez fixer le nombre d'utilisateurs pour une application. Le point d'insertion pour l'authentification permet de suivre les utilisateurs de l'application grâce à une base de données ou un fichier texte. Le lancement de l'application peut être interdit si le nombre d'utilisateurs dépasse la limite prédéfinie.
Références spécialisées : Vous pouvez inviter certains utilisateurs qui accèdent à une application à donner leurs références (informations biométriques par exemple).
Groupement d'applications : Vous pouvez grouper des applications. Par exemple, celles qui nécessitent des données relatives aux achats ou à la facturation.
Reportez-vous aux sections suivantes pour obtenir des instructions sur le développement et l'implémentation :
« Création d'un point d'insertion pour l'authentification », page 555
« Enregistrement d'un point d'insertion pour l'authentification », page 556
« Fonction d'authentification (NWAPPAuthenticateExtern) », page 556
Création d'un point d'insertion pour l'authentification
Écrivez une DLL standard qui exporte une fonction appelée
NWAPPAAuthenticateExtern .
Vous prenez en charge l'implémentation. Si la fonction renvoie FAUX, l'application ne sera pas lancée (distribuée ou exécutée) et la fonction NWAPPAuthenticateExtern en affichera la raison.
Aucun paramètre de la DLL ne doit dépasser 512 octets (comme il est prévu dans
MAX_DN_OCTETS).
Référence : point d'insertion pour l'authentification du programme de lancement d'applicatifs Novell
555
Novell Confidential Manual (FRA) 6 October 2004
Pour obtenir un exemple de code et un fichier Microsoft Developer Studio Project compilable utilisables pour la création de la DLL, téléchargez nalauthhook.zip (http://www.novell.com/ documentation/french/zdpr/zdpradmn/data/nalauthhook.zip) .
Enregistrement d'un point d'insertion pour l'authentification
1
Créez une valeur de chaîne appelée DLL d'authentification dans la clé
HKCU\Software\NetWare\NAL\1.0 du registre de Windows.
2
Entrez le chemin complet de la DLL du point d'insertion pour l'authentification comme valeur de la DLL d'authentification créée à l'étape 1.
Si la bibliothèque DLL est introuvable, le message d'erreur suivant s'affiche :
Could not locate Third Party Authentication DLL\n%s
Si la DLL se trouve dans la bibliothèque mais que la fonction NWAPPAuthenticateExtern est introuvable (par exemple, si la fonction n'a pas été exportée), le message suivant s'affiche :
Could not locate Entry Point in Third Party Authentication DLL\n%s
Remarque :
%s se rapporte à une variable indiquée par l'utilisateur et affichée à l'écran.
Fonction d'authentification (NWAPPAuthenticateExtern)
La fonction NWAPPAuthenticateExtern offre un point d'insertion pour l'authentification dans la bibliothèque zenlite.dll.
Syntaxe
#include <afxwin.h>
bool __stdcall NWAPPAuthenticateExtern
{
char *szTreeName,
char *DSName,
char szWho
}
Paramètres
szTreeName
(IN) Indique le nom de l'arborescence dans laquelle se trouve la DLL sur le client.
DSName
(IN) Indique le nom de l'objet Application fourni à l'utilisateur. Par exemple, cette application peut demander le nom et/ou le mot de passe ou une autre méthode d'identification
(identification de l'empreinte digitale ou autre méthode biométrique).
szWho
(IN) Indique le nom complet de l'utilisateur.
556 Guide d’administration de ZENworks 6.5 Desktop Management
Novell Confidential Manual (FRA) 6 October 2004
Valeurs de retour
VRAI
FAUX
Remarques
Lance l'application.
Ne lance pas l'application.
L'implémentation de cette fonction est libre. Les valeurs entrées dans NWAPPAuthenticateExtern dépassant le nombre d'octets maximal (MAX_DN_OCTETS = 512) surchargent le tampon et renvoient un message de violation d'accès.
Important :
Assurez-vous d'exporter la fonction.
Référence : point d'insertion pour l'authentification du programme de lancement d'applicatifs Novell
557
Novell Confidential Manual (FRA) 6 October 2004
558 Guide d’administration de ZENworks 6.5 Desktop Management
