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. |
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 :