Tous les autres noms de produits ou appellations sont des marques déposées ou des noms commerciaux appartenant à leurs propriétaires respectifs.

Transcription

1 4D SSL Par Vincent LALUQUE, Service qualité & Contrôle Note technique 4D FR Version 0 Date 1 Mars 2001 Résumé La base exemple fournie avec cette note technique illustre la manière de gérer un serveur WEB en connexion sécurisé avec le protocole SSL. Le code gérant la mise en place de ce protocole est minimaliste, et donc, immédiatement intégrable dans vos projets. 4D Notes techniques Copyright D SA - Tous droits réservés Tous les efforts ont été faits pour que le contenu de cette note technique présente le maximum de fiabilité possible. Néanmoins, les différents éléments composant cette note technique, et le cas échéant, le code, sont fournis sans garantie d'aucune sorte. L'auteur et 4D S.A. déclinent donc toute responsabilité quant à l'utilisation qui pourrait être faite de ces éléments, tant à l'égard de leurs utilisateurs que des tiers. Les informations contenues dans ce document peuvent faire l'objet de modifications sans préavis et ne sauraient en aucune manière engager 4D SA. La fourniture du logiciel décrit dans ce document est régie par un octroi de licence dont les termes sont précisés par ailleurs dans la licence électronique figurant sur le support dulogiciel et de la Documentation afférente. Le logiciel et sa documentation ne peuvent être utilisés, copiés oureproduits sur quelque support que ce soit et de quelque manière que ce soit, que conformément aux termes de cette licence. Aucune partie de ce document ne peut être reproduite ourecopiée de quelque manière que ce soit, électronique ou mécanique, y compris par photocopie, enregistrement, archivage ou tout autre procédé de stockage, de traitement et de récupération d'informations, pour d'autres buts que l'usage personnel de l'acheteur, et ce exclusivement aux conditions contractuelles, sans la permission explicite de 4D SA. 4D, 4D Calc, 4D Draw, 4D Write, 4D Insider, 4ème Dimension, 4D Server, 4D Compiler ainsi que les logos 4e Dimension, sont des marques enregistrées de 4D SA. Windows,Windows NT,Win 32s et Microsoft sont des marques enregistrées de Microsoft Corporation. Apple, Macintosh, Power Macintosh, LaserWriter, ImageWriter, QuickTime sont des marques enregistrées ou des noms commerciaux de Apple Computer,Inc. Mac2Win Software Copyright est un produit de Altura Software,Inc. 4D Write contient des éléments de "MacLink Plus file translation", un produit de DataViz, Inc,55 Corporate drive,trumbull,ct,usa. XTND Copyright D SA. Tous droits réservés. XTND Technology Copyright Claris Corporation.. Tous droits réservés ACROBAT Copyright , Secret Commercial Adobe Systems Inc.Tous droits réservés. ACROBAT est une marque enregistrée d'adobe Systems Inc. Tous les autres noms de produits ou appellations sont des marques déposées ou des noms commerciaux appartenant à leurs propriétaires respectifs. 1 / 16

2 Introduction Comment mettreen place un serveur WEB 4D sécurisé grâce au protocole SSL (Secure Socket Layer) et aux commandes 4D? Cette note technique a pour but de vous exposer les différentes étapes nécessaires à la mise en place d'un serveur WEB 4D sécurisé. Généralités Pré-requis : La DLL "4DSLI" doit être présente dans votre dossier "4D Extensions", sinon un message d'erreur -1 ("Le Blob ne peut pas être créé") apparaîtra chaque fois que vous voudrez vous servir des commandes d'encryption de 4D. La DLL qui vous est fournie par défaut sur le CD-ROM de 4ème Dimension est limitée à une encryption 40- bits. Elle vous permet d'utiliser uniquement des clés de longueurs 512 bits. Pour utiliser des clés de longueur 1024 bits, vous devrez utiliser la DLL 128-bits. Pour des raisons de législation, cette clé n'est disponible que par téléchargement et sur des sites dont le pays d'accueil autorise l'exportation 128-bits.(la liste de ces sites n'est pas encore disponible à ce jour.) Le protocole TCP est directement lié au protocole SSL. Vous ne pourrez pas mettre en place le serveur WEB sécurisé sans ce protocole. La version minimale à utiliser est la version 6.7 de ce composant réseau. Votre base devra également comprendre une version du plug-in "Internet Commands" pour faire marcher les fonctionnalités WEB de la base exemple. Paramétrage du serveur WEB dans les propriétés de la base : Il est très important de fixer un dossier WEB par défaut dans les propriétés de la base, dans le champ "dossier racine HTML" (Onglet WebServer I). La version 6.7 de 4D affecte par défaut une valeur à ce champ. Il s'agit du dossier "dossier WEB" ("WebFolder" en version US). Si ce champ n'est pas renseigné, le serveur WEB 4D ne se voit imposer aucune limitation quant à l'emplacement des fichiers qu'il est autorisé à servir, et la totalité des fichiers présents sur votre disque dur est accessible sur simple requête par un quelconque navigateur, y compris le fichier contenant votre clé privée! Il est donc indispensable de fixer un dossier par défaut pour le serveur WEB dans les propriétés de la base (entrer un véritable nom de dossier et non pas seulement le dossier racine "/" qui pourrait également donner accès à la clé privée). La boîte à cocher "Autoriser le serveur WEB à fonctionner en SSL" doit être cochée. Note : 2 / 16

3 Problèmes pouvant être rencontrés sur les versions de 4D antérieures ààà la : Les fonctionsde cryptagede 4D 6.7 ne fonctionnent pas si le chemin d'accès au fichier 4DSLI.DLL contient un caractère non-standard ( ). Certains opérateurs de certification ne reconnaissent pas les demandes de certificats émises par la commande GENERATE CERTIFICATE REQUEST à cause d'un champ parasite "0.0" généré par 4D. Utilisation de la base exemple "4D_SSL" pour mettre en place un serveur WEB 4D sécurisé. 1. Génération d'un couple de clés : clé privée, clé publique La base "4D_SSL" démarre en mode menus créés. Sélectionner la ligne de menu "Génération des clés" dans le menu "Paires de clés" Le formulaire de mise en place d'une configuration sécurisée contient deux onglets. 3 / 16

4 Voici le contenu du premier onglet "Paires de clés" : - Une zone de défilement affichant la liste des paires de clés stockées dans la base. (Ces paires de clés sont également accessibles en modification en sélectionnant la ligne de menu "Liste des paires de clés" dans le menu "Paires de clés"). - Deux zones de texte affichant les clés associées à la paire de clés sélectionnée dans la zone de défilement. En rouge est affichée la clé privée. En vert est affichée la clé publique. Le format de ces clés est le format PEM (Privacy Enhanced Mail). - Un bouton "Générer une nouvelle paire de clés" associé à un Pop-Up permettant de générer une nouvelle paire de clés dont la clé publique est soit de longueur 512 soit de longueur 1024 (le choix de la longueur se fait dans le Pop-Up). Il est important de noter que vous aurez besoin de la DLL 128-bits pour exploiter une clé publique de longueur 1024 dans une configuration Serveur WEB sécurisée. Voici le contenu de la méthode associée à ce bouton : C_BLOB($Private_Key;$Public_Key) GENERER CLES CRYPTAGE($Private_Key;$Public_Key;vL_Length) vt_privatekey:=blob vers texte($private_key;texte sans longueur ) vt_publickey:=blob vers texte($public_key;texte sans longueur ) - Un bouton "Enregistrer dans la base", vous permet d'enregistrer dans la base le couple de clés que vous venez de générer. Le nom de la paire de clé que vous voulez enregistrer vous est demandée : Une fois enregistré, le nom de la paire de clés apparaît dans la zone de défilement et vous pouvez passer à la deuxième étape de la mise en place d'une configuration sécurisée. 2. Génération d'une demande de certificat 4 / 16

5 Le deuxième onglet " Certificats " contient les éléments suivants : Les champs standard associés à une demande de certificat pour un serveur WEB. La liste de ces champs est accessible en modification en sélectionnant la ligne de menu "champs du certificat" dans le menu "Outils". 5 / 16

6 Ces champs sont standards et ne sont pas spécifiques au serveur WEB 4D. Ils caractérisent les informations qui seront associées à votre clé publique. Il vous faut envoyer ces informations ainsi que la clé publique à un organisme certificateur qui vous enverra en échange un certificat. La façon dont cette demande sera envoyée se fera sous la forme d'une demande de certificat. Le bouton "Générer une demande de certificat associée à une paire de clés" effectue cette opération. Vous pouvez voir la demande de certificat s'afficher dans la zone de texte située sous les champs du certificat. 6 / 16

7 Voici la méthode objet associée au bouton : Au cas ou : (Evenement formulaire= Sur clic souris ) C_BLOB($vB_PrivateKey) Si (Taille tableau(scroll_keys_ids)#0) Si (Scroll_Keys_IDs#0) CHERCHER([Keypair];[Keypair]KeyPair_ID=Scroll_Keys_IDs{Scroll_Keys_IDs}) Si (Enregistrements trouves([keypair])=1) $vb_privatekey:=[keypair]key_private Fin de si LIBERER ENREGISTREMENT([Keypair]) TABLEAU ALPHA(80;$ArS80_Names;Taille tableau(arl_codes)) Boucle ($k;1;taille tableau(arl_codes)) $p:=pointeur vers("vt_"+chaine($k)) $ArS80_Names{$k}:=$p-> Fin de boucle 7 / 16

8 C_BLOB($vB_Cert_Req) GENERER DEMANDE CERTIFICAT($vB_PrivateKey;$vB_Cert_Req;ArL_codes;$ArS80_Names) vt_cert_req:=blob vers texte($vb_cert_req;texte sans longueur ) C_BLOB($vB_Req) Si (Longueur(vT_Cert_Req)>0) TEXTE VERS BLOB(vT_Cert_Req;$vB_Req;Texte sans longueur ) BLOB VERS DOCUMENT("Cert_REQ";$vB_Req) Fin de si Sinon BEEP M_Avertissement ("Sélectionnez une paire de clés à laquelle associer la demande de certificat") Fin de si Sinon BEEP Fin de si Fin de cas La troisième étape va être l'utilisation de la demande de certificat pour obtenir un certificat. 3. Obtention d'un certificat auprès d'un organisme certificateur L'obtention d'un certificat auprès d'un organisme certificateur est une prestation payante. Pour illustrer cette note technique, nous allons donc utiliser des organismes certificateurs permettant la délivrance de certificats de tests gratuits. Ces certificats sont bien sûr limités dans le temps. Ces certificats permettent l'établissement d'une connexion sécurisée entre le Serveur WEB intégré de 4ème Dimension et un navigateur, mais ils ne sont pas reconnus comme valides par le navigateur et ils provoqueront l'affichage d'un (ou de plusieurs) message (s) d'alerte au niveau du navigateur. Le contenu de ces messages d'alerte sera le plus souvent un message disant que l'autorité de certification n'est pas reconnue par le navigateur. La liste des organismes certificateurs de test est disponible en accédant à la ligne de menu "Liste des organismes certificateurs" et contient une liste d'url donnant accès à la délivrance de ces certificats de tests. 8 / 16

9 Nous choisirons ici l'organisme certificateur "Thawte". Il convient de suivre les étapes suivantes : a) Cliquer sur le bouton "Obtenir un certificat de test". En cliquant sur ce bouton, vous copiez par défaut la demande de certificat dans le presse-papier. L'URL associée à l'organisme certificateur s'ouvre dans le navigateur par défaut de votre machine grâce à la commande "OUVRIR URL WEB". 9 / 16

10 b) Coller la demande de certificat dans la zone prévue par Thawte pour recueillir la demande de certificat et soumettez cette demande en cliquant sur le bouton de validation. c) Thawte vous renvoie directement le certificat dans une page HTML. Copier le certificat et coller le dans le dialogue de saisie qui est apparue dans 4D. Valider ce dialogue. 10 / 16

11 Vous avez maintenant, tous les éléments permettant de mettre en place une configuration sécurisée, enregistrés dans la base 4D,. 4. La génération des fichiers "key.pem" et "cert.pem" Le fichier "key.pem" contient la clé privée. Le fichier "cert.pem" contient le certificat qui vous a été retourné par l'organisme certificateur. Pour générer ces deux fichiers, il vous faut tout d'abord cliquer sur la ligne de menu "Liste des paires de clés" dans le menu "Paires de clés". Ouvrir en saisie la fiche associée à la paire de clés qui vous a servi à générer le certificat. 11 / 16

12 Cliquer sur l'onglet "Certificat" 12 / 16

13 Double-cliquer sur le certificat qui vient d'être généré. 13 / 16

14 Cette sous-fiche affiche : - Le certificat - La clé privée - Les informations utilisées par l'organisme certificateur pour générer le certificat - Cliquer sur le bouton "Générer les fichiers cert.pem et key.pem" dont le script contient les lignes de code suivantes : Si (Is_On_Windows ) C_BLOB($vB_Key) TEXTE VERS BLOB(vT_Private_Key;$vB_Key;Texte sans longueur ) BLOB VERS DOCUMENT("Key.pem";$vB_Key) C_BLOB($vB_CERT) TEXTE VERS BLOB(vT_Cert;$vB_CERT;Texte sans longueur ) 14 / 16

15 BLOB VERS DOCUMENT("Cert.pem";$vB_CERT) Sinon C_BLOB($vB_Key) TEXTE VERS BLOB(vT_Private_Key;$vB_Key;Texte sans longueur ) BLOB VERS DOCUMENT("Key.pem";$vB_Key) CHANGER TYPE DOCUMENT("Key.pem";"TEXT") C_BLOB($vB_CERT) TEXTE VERS BLOB(vT_Cert;$vB_CERT;Texte sans longueur ) BLOB VERS DOCUMENT("Cert.pem";$vB_CERT) CHANGER TYPE DOCUMENT("Cert.pem";"TEXT") Fin de si Une fois cette opération effectuée, quitter la base 4D puis la réouvrir pour prendre en compte la génération de ces deux nouveaux fichiers. 5. Mise en place et utilisation du serveur WEB 4D sécurisé à travers un exemple simple A partir d'un navigateur WEB quelconque, connectez-vous à la base exemple "4D_SSL". La page d'accueil du site WEB associée à la base 4D vous prévient que vous êtes connecté à un Serveur WEB 4D et vous présente un lien sécurisé : Cliquez sur ce lien pour faire basculer la connexion du mode normal (http) au mode sécurisé (https). Votre navigateur vous affiche alors un message d'alerte "il y a un problème avec le certificat du site sur lequel vous voulez vous connecter" (ce qui est normal puisque le certificat du site est un certificat de test), vous demandant si vous voulez ou non établir une connexion sécurisée avec ce site. Valider le (ou les) message(s) d'alerte pour établir une connexion sécurisée. Le plus souvent, un petit verrou apparaît dans le bas de la fenêtre du navigateur pour vous prévenir que la connexion est sécurisée. Vous pouvez également demander à lire les informations sur la page WEB courante pour voir si celle-ci est cryptée ou non. Note : vous trouverez les DLL 128 bits sur le CD 1er trimestre 2001, dans : Produits : Gamme 4D : 4D Extension. Annexe 15 / 16

16 Méthode projet M_Avertissement : C_TEXTE($1) Si ($1#"") vt_warning:=$1 $Win:=Creer fenetre formulaire([table 1];"Warning";Dialogue modal déplaçable ;65536 ; Centrée verticalement ) DIALOGUE([Table 1];"Warning") FERMER FENETRE Fin de si Méthode projet Is_On_Windows : C_BOOLEEN($0) C_ENTIER($PlateForme;$Machine) C_ENTIER LONG($System) PROPRIETES PLATE FORME($PlateForm;$System;$Machine) $0:=($PlateForm=Windows ) 16 / 16