ST_ExtendedConnectionSettings

Présentation

Type :

Structure

Disponible à partir de :

V2.0.0.0

Hérite de :

Description

La structure ST_ExtendedConnectionSettings contient les informations de connexion à une SQL Gateway et les informations concernant la base de données SQL.

Éléments de la structure

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 SQL Gateway - Guide 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 :
  • Un certificat doit être fourni par la SQL Gateway.

  • La SQL Gateway (serveur) est configurée pour vérifier le certificat du client (paramètres de SQL Gateway).

  • Le 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.

  • Le 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 SQL Gateway - Guide utilisateur.

Utilisé par

  • FB_SqlDbRequest