|
|
|
|
|
|
|
|
|
|
- Re-création de socket
- Réutilisation d'une adresse déjà utilisée
SocketCréeSSL (Fonction) En anglais : SocketCreateSSL Créé un socket sécurisé selon le protocole SSL.
sSocketSSL est une chaîne = "sSocketSSL"
SI PAS SocketCréeSSL(sSocketSSL, 5043, "9d a4 84 fc f6 62 92 90 9a 62 d4 " + ...
"ca 65 fb 08 7e 06 45 de 24", HashCertificat) ALORS
Erreur(ErreurInfo())
RETOUR
SINON
Info("Socket serveur SSL démarrée")
SocketFerme(sSocketSSL)
FIN
Syntaxe
<Résultat> = SocketCréeSSL(<Nom du socket> , <Numéro de port> , <Identifiant du certificat> [, <Options SSL> [, <Adresse> [, <Nom du magasin>]]])
<Résultat> : Booléen - Vrai si le socket a été créé,
- Faux dans le cas contraire. En cas d'erreur, il est possible de connaître le détail de l'erreur grâce à la fonction ErreurInfo.
<Nom du socket> : Chaîne de caractères Nom à donner au socket. Ce nom sera utilisé dans toutes les fonctions socket. Attention le nom du socket est "case-sensitive". <Numéro de port> : Entier Numéro de port à donner au socket. Ce numéro doit être compris entre 5000 et 65000. Ce numéro sera indiqué lors de la connexion des postes client au poste serveur. Cette connexion sera réalisée par la fonction SocketConnecteSSL. <Identifiant du certificat> : Chaîne de caractères Nom ou hash du certificat à utiliser (en fonction des <Options SSL> indiquées) : - nom du certificat si la constante NomCertificat est utilisée,
- hash du certificat si la constante HashCertificat est utilisée. Les espaces sont autorisés dans le Hash. Le hash du certificat peut être obtenu dans la propriété "Empreinte numérique" dans le gestionnaire de certificats (certmgr.msc) du poste, exemple :
"9d a4 84 fc f6 62 92 90 9a 62 d4 ca 65 fb 08 7e 06 45 de 24"
<Options SSL> : Combinaison de constantes de type entier optionnelle Protocole et le mode d'identification utilisés : | | | ProtocoleSSL2 | Utilisation du protocole SSL2. | | ProtocoleSSL3 | Utilisation du protocole SSL3. | | ProtocoleTLS1 | Utilisation du protocole TLS1 | | ProtocoleTLS1_1 | Utilisation du protocole TLS 1.1 | | ProtocoleTLS1_2 | Utilisation du protocole TLS 1.2 | | ProtocoleTLS1_3 | Utilisation du protocole TLS 1.3 |
| | | HashCertificat | Le paramètre <Identifiant du certificat> correspond au hash du certificat. | | NomCertificat | Le paramètre <Identifiant du certificat> correspond au nom du certificat. |
Par défaut, la combinaison utilisée est : ProtocoleTLS1 + ProtocoleTLS1_1 + ProtocoleTLS1_2 + NomCertificat. <Adresse> : Chaîne de caractères optionnelle Adresse IP sur laquelle le socket doit être créé sur le poste en cours. Si le poste en cours est associé à plusieurs adresses IP (ou plusieurs cartes réseau), ce paramètre permet de choisir l'adresse IP à associer au socket.Cette adresse IP peut être donnée sous la forme : - adresse IP au format XXX.XXX.XXX.XXX ( par exemple 125.5.110.100).
- adresse IP contenant le nom du serveur (par exemple www.pcsoft.fr). Cette syntaxe est conseillée.
<Nom du magasin> : Chaîne de caractères optionnelle ou constante optionnelle  Nouveauté SaaSNom du magasin dans lequel les certificats doivent être recherchés. Ce paramètre peut correspondre : - à une chaîne de caractères,
- à une des constantes suivantes :
| | | certAutorité | Magasin des autorités de certification. | | certConfiance | Magasin de confiance. | certPersonnel
(Valeur par défaut) | Magasin personnel. | | certRacine | Magasin des racines |
Remarque : Ces constantes ne peuvent pas être combinées.
Attention : Cette fonctionnalité est disponible uniquement à partir de WINDEV Suite SaaS 2025 Update 3.
Pour plus de détails, consultez Utiliser les nouveautés de WINDEV Suite SaaS 2025.
Remarques Re-création de socket Si un socket n'est pas fermé correctement par la fonction SocketFerme (redémarrage du poste par exemple), la recréation du socket peut être relativement longue. Il est en effet nécessaire d'attendre que le système libère le socket. Réutilisation d'une adresse déjà utilisée Par défaut, la fonction SocketCréeSSL permet de réutiliser une adresse déjà utilisée (par l'application elle-même ou par une autre application). Pour ne pas autoriser ce fonctionnement, il suffit de saisir le code suivant : Socket.Option = SocketAdresseUnique
Remarque : Cette option permet également de savoir si une adresse ou un port est déjà utilisé. Dans ce cas, la fonction SocketCréeSSL renvoie une erreur. Classification Métier / UI : Code métier Composante : wd300com.dll
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|