Type : |
Structure |
Disponible à partir de : |
V2.0.0.0 |
Hérite de : |
– |
La structure ST_ExtendedConnectionSettings contient les informations de connexion à une SQL Gateway et les informations concernant la base de données SQL.
Nom |
Type de données |
Description |
---|---|---|
xUseTls |
BOOL |
Défini sur la valeur TRUE pour indiquer l’utilisation d’une connexion sécurisée à l’aide de TLS. Valeur par défaut : TRUE |
wsDbConnectionName |
WSTRING[40] |
La valeur de cet élément doit correspondre au nom de connexion configuré dans la SQL Gateway. Consultez le document Passerelle SQL - Guide de l'utilisateur. |
wsGwIpAddress |
WSTRING[GPL.Gc_uiIpStringSize] |
Adresse IP de la SQL Gateway. Il s'agit de l'adresse IP du serveur qui exécute la passerelle. |
wGwPort |
WORD |
Numéro de port de la SQL Gateway. Valeur par défaut : 3458 (sécurisé) |
timSqlTimeout |
TIME |
Timeout appliqué aux requêtes SQL. Valeur par défaut : 60 s |
timSqlConnectionTimeout |
TIME |
Valeur de temporisation appliquée pour l'établisssement de la connexion permanente. Valeur par défaut : 10 s |
stTlsSettings |
ST_TlsSettings |
Structure qui définit la configuration TLS (Transport Layer Security). |
Considérations relatives à une connexion TCP sécurisée utilisant TLS
Si xUseTls = TRUE, TLS (Transport Layer Security) est utilisé pour chiffrer la communication entre le client (bloc fonction FB_SqlDbRequest) et le serveur (outil SQL Gateway). En plus du chiffrement, TLS vérifie l'identité du partenaire de communication (contrôleur et SQL Gateway) à l'aide de certificats.
Ces certificats sont échangés lors de l’établissement d’une connexion (transfert TLS). L'envoi de certificats pendant le transfert TLS est obligatoire.
Une connexion ne peut être établie avec le partenaire de communication que si la vérification de certificat a un résultat positif.
NOTE :
oUn certificat doit être fourni par la SQL Gateway.
oLa SQL Gateway (serveur) est configurée pour vérifier le certificat du client (paramètres de SQL Gateway).
oLe certificat SQL Gateway doit être déclaré comme approuvé. Pour cela, il est nécessaire de gérer manuellement les certificats sur votre contrôleur. Vous pouvez effectuer cette opération à l’aide de l’éditeur Security Screen dans EcoStruxure Machine Expert Logic Builder.
oLe certificat de contrôleur par défaut doit être disponible sur le contrôleur et la date de validité ne doit pas avoir expiré.
Pour plus d'informations sur la gestion des certificats sur le contrôleur, consultez le document Comment gérer les certificats sur le contrôleur - Guide utilisateur.
Pour plus d'informations sur la SQL Gateway, consultez le document Passerelle SQL - Guide de l'utilisateur.
oFB_SqlDbRequest