PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Optimisation des connexions dans le cas d'une adresse IP
  • Délai d'attente
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Permet d'établir une connexion sécurisée avec un serveur SSL.
Exemple
SI SocketConnecteSSL("Serveur", 8000, "150.134.20") = Faux ALORS
        Erreur("erreur de connexion " + ErreurInfo(errMessage))
FIN
Syntaxe
<Résultat> = SocketConnecteSSL(<Nom du socket> , <Numéro de port> , <Adresse> [, <Option SSL> [, <Attente maximale> [, <Certificat client>]]])
<Résultat> : Booléen
  • Vrai si la connexion a été réalisée,
  • 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 (avec guillemets)
Nom à donner à la connexion ouverte sur le socket du serveur. Ce nom sera utilisé dans toutes les fonctions socket.
WINDEV Attention : le nom du socket est "case-sensitive".
<Numéro de port> : Entier
Numéro de port du socket. Si vous utilisez un socket associé à un protocole prédéfini, utilisez le numéro de port associé au protocole.
Si le socket a été créé par une application WINDEV, ce numéro doit être compris entre 5 000 et 65 000. Dans ce cas, le numéro doit être identique au numéro de port indiqué dans la fonction SocketCréeSSL.
<Adresse> : Chaîne de caractères (avec guillemets)
Adresse du poste serveur. Si ce paramètre n'est pas spécifié, le serveur est recherché sur le poste en cours. Cette adresse peut être donnée sous la forme :
  • adresse IP au format XXX.XXX.XXX.XXX ( par exemple 125.5.110.100).
  • URL contenant le nom du serveur (par exemple www.pcsoft.fr). Cette syntaxe est conseillée.
WINDEVWEBDEV - Code Serveur L'adresse peut également correspondre à l'adresse IP obtenue par la fonction NetAdresseIP.
<Option SSL> : Combinaison de constantes de type entier optionnelle
Permet de choisir le protocole utilisé et le mode d'identification : par défaut, la combinaison utilisée est ProtocoleTLS1.
ProtocoleSSL2Utilisation du protocole SSL2
ProtocoleSSL3Utilisation du protocole SSL3
ProtocoleTLS1
(valeur par défaut)
Utilisation du protocole TLS1
<Attente maximale> : Entier optionnel ou Durée optionnelle
Attente maximale (en millisecondes) de réalisation de la connexion. Ce délai sert uniquement dans le cas où le serveur refuse la connexion (fonction SocketRefuse). La connexion ne sera alors pas bloquante.
Ce paramètre peut correspondre à :
  • un entier correspondant au nombre de millisecondes,
  • une variable de type Durée,
  • Versions 23 et supérieures
    l'indication directe de la durée (par exemple 1 s ou 10 ms).
    Nouveauté 23
    l'indication directe de la durée (par exemple 1 s ou 10 ms).
    l'indication directe de la durée (par exemple 1 s ou 10 ms).
Par défaut, cette attente est égale à 10 millisecondes.
<Certificat client> : Variable de type Certificat
Versions 19 et supérieures
Nom de la variable de type Certificat permettant au serveur d'authentifier le client qui se connecte et de vérifier que ce client est bien autorisé à accéder au serveur. Ce certificat doit être reconnu sur le poste serveur.
Nouveauté 19
Nom de la variable de type Certificat permettant au serveur d'authentifier le client qui se connecte et de vérifier que ce client est bien autorisé à accéder au serveur. Ce certificat doit être reconnu sur le poste serveur.
Nom de la variable de type Certificat permettant au serveur d'authentifier le client qui se connecte et de vérifier que ce client est bien autorisé à accéder au serveur. Ce certificat doit être reconnu sur le poste serveur.
Remarques

Optimisation des connexions dans le cas d'une adresse IP

Lorsqu'une adresse IP est passée à la fonction SocketConnecteSSL, il est possible d'optimiser la connexion en utilisant le code suivant :
Socket.Option = SocketOptimiseConnexionIP
Cette option n'est pas activée par défaut car la connexion peut échouer dans certaines configurations. Cependant, elle peut être intéressante dans certaines applications où les performances sont critiques.
Remarque : Pour retrouver le fonctionnement par défaut, il suffit d'utiliser la constante SocketOptionDéfaut :
Socket.Option = SocketOptionDéfaut

Délai d'attente

Le délai indiqué par le paramètre <Attente maximale> regroupe le délai de deux étapes :
  • le délai de résolution de l'adresse : ce délai est non paramétrable et peut être optimisé (voir ci-dessous).
  • le délai d'attente maximum d'acceptation de la connexion par le serveur. Plusieurs cas peuvent se présenter :
    • le serveur refuse la connexion.
    • le serveur accepte la connexion dans le délai imparti
    • le serveur n'est pas disponible.
    • l'adresse indiquée n'est pas valide.
Afin d'optimiser le délai de résolution de l'adresse (le temps de recherche de l'adresse), il est recommandé :
  • soit d'utiliser un DNS sur le réseau. Ainsi, la recherche de cette adresse sera faite auprès de ce serveur et non pour chaque poste (1 recherche au lieu de x recherches où x est le nombre de postes). Chaque poste doit être enregistré auprès de ce serveur.
  • soit dans le cas d'une adresse IP, d'utiliser la variable Socket.Option = SocketOptimiseConnexionIP.
Composantes
WINDEVWEBDEV - Code ServeurEtats et Requêtes wd230com.dll
Windows Mobile wp230com.dll
Version minimum requise
  • Version 12
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire