|
|
|
|
|
- Propriétés spécifiques à la description des variables de type sshSession
- Mode d'authentification
- Utilisation des variables de type sshSession
sshSession (Type de variable) En anglais : sshSession
Le type sshSession permet de définir toutes les caractéristiques d'une connexion à un serveur SSH. Les caractéristiques de cette connexion sont décrites à l'aide de différentes propriétés WLangage. Remarque : Pour plus de détails sur la déclaration de ce type de variable et l'utilisation des propriétés WLangage, consultez Déclaration d'une variable. cMaSession est une sshSession cMaSession.Adresse = "127.0.0.1" cMaSession.Port = 22 cMaSession.Utilisateur = "login" cMaSession.MotDePasseUtilisateur = "pass"
Remarques Propriétés spécifiques à la description des variables de type sshSession Les propriétés suivantes peuvent être utilisées pour définir une connexion à un serveur SSH : | | | Nom de la propriété | Type manipulé | Effet |
---|
Adresse | Chaîne de caractères | Adresse du serveur SSH. Cette adresse 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, ServeurSSH). Cette syntaxe est conseillée.
| CléPrivée | Chaîne de caractères ou variable de type Certificat | Nom de la variable de type Certificat ou fichiers de clés au format OpenSSH (pour connexion par clé privée). Si cette propriété est renseignée, une authentification par clé est réalisée : seules les propriétés Utilisateur, CléPrivée et MotDePasseCléPrivée sont prises en compte. | Nouveauté SaaSIntervalleKeepAlive | Entier ou Durée | Temps d'attente entre deux envois d'une requête spécifique permettant de maintenir la connexion ouverte et de vérifier que le serveur SSH répond toujours. Si le serveur SSH s'arrête brutalement lors d'une commande "longue" exécutée via la fonction SSHCommande, l'activation du "Keep Alive" peut permettre de détecter la déconnexion de l'application au serveur. Cette propriété peut correspondre à : - un entier correspondant au nombre de secondes,
- une variable de type Durée,
- l'indication directe de la durée (par exemple 20 s ou 20000 ms).
Si cette propriété vaut : - 0, le "Keep Alive" sera désactivé.
- une durée en dessous de 2 secondes, cette durée sera fixée à 2 secondes pour des contraintes techniques.
| MotDePasseCléPrivée | Chaîne de caractères | Mot de passe du fichier de clés (dans le cas d'une connexion par clé privée). La propriété CléPrivée correspond à la clé privée à utiliser. | MotDePasseUtilisateur | Chaîne de caractères | Mot de passe de l'utilisateur utilisé dans le cadre d'une authentification par mot de passe (la propriété Utilisateur correspond au nom de l'utilisateur). | Port | Entier | Port de connexion (par défaut, 22). | TimeoutConnexion | Entier ou Durée | Temps d'attente de connexion exprimé en millisecondes (par défaut 20 secondes, soit 20000 millisecondes). Cette propriété peut correspondre à : - un entier correspondant au nombre de millisecondes,
- une variable de type Durée,
- l'indication directe de la durée (par exemple 20 s ou 20000 ms).
| Utilisateur | Chaîne de caractères | Nom de l'utilisateur. |
Mode d'authentification L'authentification par clé est prioritaire sur l'authentification par mot de passe. L'authentification par clé est tentée si : - le serveur supporte ce mode d'authentification.
- la propriété CléPrivée est renseignée.
L'authentification par mot de passe est tentée si : - le serveur supporte ce mode d'authentification.
- la propriété MotDePasseUtilisateur est renseignée.
Utilisation des variables de type sshSession Les variables de type sshSession peuvent être utilisées dans les fonctions WLangage : - syntaxe classique :
| | SSHCommande | Envoie une commande à un serveur SSH. La session est ouverte et refermée automatiquement après l'envoi de la commande. | SSHConnecteShell | Ouvre une nouvelle session SSH de type "Shell". | SSHDéconnecteShell | Ferme une session SSH précédemment ouverte grâce à la fonction SSHConnecteShell. | SSHEcrit | Ecrit des données dans la session SSH spécifiée. | SSHLit | Lit les données présentes sur le buffer de sortie de la session SSH. |
- syntaxe préfixée :
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|