CXXVII. Shell2 sécurisé

Introduction

La liaison à la bibliothèque libssh2 fournit un accès à des ressources (shell, exécution distante, tunneling, transfert de fichiers) sur une machine distante en utilisant un transport crypté sécurisé.

Installation

Les binaires Windows peuvent être trouvés sur http://snaps.php.net/. Pour l'installation, téléchargez php_ssh2.dll dans le dossier spécifié par votre directive extension_dir du fichier php.ini. Activez-le en ajoutant extension=php_ssh2.dll dans votre fichier php.ini et redémarrez votre serveur web.

extension_dir=c:/php5/exts/
extension=php_ssh2.dll

Linux, BSD, et autres variantes *nix peuvent compiler cette extension en suivant les étapes suivantes :

  • Téléchargez et installez OpenSSL. Si vous installez OpenSSL via le système de paquetages de votre distribution, assurez-vous d'installer également les bibliothèques de développement. Elles seront typiquement paquetées sous le nom openssl-dev, openssl_devel, ou quelque chose comme cela.

  • Téléchargez et installez libssh2. Typiquement, cela signifie d'exécuter les commandes suivantes depuis les fichiers sources libssh2 : ./configure && make all install.

  • Exécutez l'installeur Pear depuis PECL/ssh2: pear install ssh2

  • Copiez le fichier ssh2.so depuis le dossier indiqué par le processus de compilation dans le dossier spécifié à l'intérieur du fichier spécifié par votre fichier php.ini, extension_dir.

  • Ajoutez extension=ssh2.so dans votre php.ini.

  • Redémarrez votre serveur web pour recharger votre configuration php.ini.

Versions de développement : Il n'y a actuellement aucune version stable de PECL/ssh2, pour forcer l'installation d'une version beta de PECL/ssh2, exécutez : pear install ssh2-beta

Compiler PECL/ssh2 sans utiliser les commandes PEAR : Plutôt que d'utiliser pear install ssh2 pour automatiquement télécharger et installer PECL/ssh2, vous pouvez télécharger l'archive depuis PECL. Depuis la racine de l'archive décompressée, exécutez : phpize && ./configure --with-ssh2 && make pour générer ssh2.so. Une fois compilé, continuez l'installation depuis l'étape 4 ci-dessus.

Des informations comme les notes sur les nouvelles versions, les téléchargements, les sources des fichiers, les informations concernant les mainteneurs ainsi qu'un CHANGELOG, peuvent être trouvées ici : http://pecl.php.net/package/ssh2.

Note : Vous avez besoin de la version 0.4 ou supérieure de la bibliothèque libssh2 (ou supérieure, lisez les notes de versions).

Constantes pré-définies

Ces constantes sont définies par cette extension, et ne sont disponibles que si cette extension a été compilée avec PHP, ou bien chargée au moment de l'exécution.

SSH2_FINGERPRINT_MD5 (integer)

Flag permettant à la fonction ssh2_fingerprint() de demander l'empreinte de la clé de l'hôte en tant que hash MD5.

SSH2_FINGERPRINT_SHA1 (integer)

Flag permettant à la fonction ssh2_fingerprint() de demander l'empreinte de la clé de l'hôte en tant que hash SHA1.

SSH2_FINGERPRINT_HEX (integer)

Flag permettant à la fonction ssh2_fingerprint() de demander l'empreinte de la clé de l'hôte en tant que chaîne hexits.

SSH2_FINGERPRINT_RAW (integer)

Flag permettant à la fonction ssh2_fingerprint() de demander l'empreinte de la clé de l'hôte en tant que chaîne de caractères 8-bit.

SSH2_TERM_UNIT_CHARS (integer)

Flag spécifiant à la fonction ssh2_shell() que les paramètres width et height sont fournis sous la forme de taille de caractères.

SSH2_TERM_UNIT_PIXELS (integer)

Flag spécifiant à la fonction ssh2_shell() que les paramètres width et height sont fournis sous la forme de pixels.

SSH2_DEFAULT_TERM_WIDTH (integer)

Largeur par défaut du terminal demandé par la fonction ssh2_shell().

SSH2_DEFAULT_TERM_HEIGHT (integer)

Hauteur par défaut du terminal demandé par la fonction ssh2_shell().

SSH2_DEFAULT_TERM_UNIT (integer)

Unité par défaut du terminal demandé par la fonction ssh2_shell().

SSH2_STREAM_STDIO (integer)

Flag pour que la fonction ssh2_fetch_stream() demande un sous-canal STDIO.

SSH2_STREAM_STDERR (integer)

Flag pour que la fonction ssh2_fetch_stream() demande un sous-canal STDERR.

SSH2_DEFAULT_TERMINAL (string)

Type par défaut du terminal (e.g. vt102, ansi, xterm, vanilla) demandé par la fonction ssh2_shell().

Table des matières
ssh2_auth_hostbased_file --  Identification en utilisant une clé d'hôte publique
ssh2_auth_none --  Identification en tant que "none"
ssh2_auth_password --  Identification via SSH en utilisant un mot de passe en clair
ssh2_auth_pubkey_file --  Identification en utilisant une clé publique
ssh2_connect --  Connexion à un serveur SSH
ssh2_exec --  Exécute une commande sur un serveur distant
ssh2_fetch_stream --  Parcours un flux étendu de données
ssh2_fingerprint --  Récupère l'empreinte d'un serveur distant
ssh2_methods_negotiated --  Retourne une liste de méthodes négociées
ssh2_publickey_add --  Ajoute une clé publique autorisée
ssh2_publickey_init --  Initialise un Publickey Subsystem (sous-système de clé publique)
ssh2_publickey_list --  Liste les clés publiques actuellement autorisées
ssh2_publickey_remove --  Supprime un clé publique autorisée
ssh2_scp_recv --  Demande un fichier via SCP
ssh2_scp_send --  Envoie un fichier via SCP
ssh2_sftp_lstat --  Statue un lien symbolique
ssh2_sftp_mkdir --  Crée un dossier
ssh2_sftp_readlink --  Retourne la cible d'un lien symbolique
ssh2_sftp_realpath --  Résoud le chemin réel d'un chemin fourni
ssh2_sftp_rename --  Renomme un fichier distant
ssh2_sftp_rmdir --  Efface un dossier
ssh2_sftp_stat --  Statue un fichier sur un système de fichiers distant
ssh2_sftp_symlink --  Crée un lien symbolique
ssh2_sftp_unlink --  Efface un fichier
ssh2_sftp --  Initialise un sous-système SFTP
ssh2_shell --  Demande un shell intéractif
ssh2_tunnel --  Ouvre un tunnel à travers un serveur distant

Hosting by: Hurra Communications GmbH
Generated: 2007-01-26 18:02:21