bn8/ldapsaisie
1
0
Fork 0
mirror of https://gitlab.easter-eggs.com/ee/ldapsaisie.git synced 2024-11-18 08:19:05 +01:00
Code Issues Projects Releases Wiki Activity

Improve/fix SSH LSaddon documentation

Browse source
This commit is contained in:
Benjamin Renard 2019-03-26 20:09:40 +01:00
parent a0e6cea771
commit d3f719a4e5
2 changed files with 37 additions and 17 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

6
public_html/conf/LSaddons/config.LSaddons.ssh.php
View file

@ -21,9 +21,9 @@
******************************************************************************/ ******************************************************************************/
/* /*
************************************************ *********************************
* Données de configuration pour le support FTP * * Configuration for SSH support *
************************************************ *********************************
*/ */
// PhpSecLib autoload file path // PhpSecLib autoload file path

48
public_html/includes/addons/LSaddons.ssh.php
View file

@ -61,7 +61,7 @@ LSerror :: defineError('SSH_07',
/** /**
* Check LdapSaisie SSH support * Check LdapSaisie SSH support
* *
* @author Benjamin Renard <brenard@easter-eggs.com> * @author Benjamin Renard <brenard@easter-eggs.com>
* *
* @retval boolean true if SSH is fully supported, false otherwise * @retval boolean true if SSH is fully supported, false otherwise
@ -85,10 +85,30 @@ LSerror :: defineError('SSH_07',
/** /**
* Connect to an SFTP server * Connect to an SFTP server
* *
* @author Benjamin Renard <brenard@easter-eggs.com> * @author Benjamin Renard <brenard@easter-eggs.com>
* *
* @param[in] $params array The SSH connexion parameters * @param[in] $params array The SSH connexion parameters :
* array (
* 'host' => '[SSH server hostname/IP]', // required
* 'port' => [SSH port], // optional, default : 22
* 'timeout' => [SSH connection timeout], // optional, default : 10
*
* // Authentication
* 'user' => '[SSH remote user]', // required
*
* // Auth method :
* // One of the following method configuration is required.
*
* // Auth using simple password
* 'password' => '[secret password]'
*
* // Auth using a key
* 'auth_key' => array (
* 'file_path' => '[SSH private key file path]',
* 'password' => '[SSH private key file password]' // Only if need
* )
* )
* @param[in] $sftp boolean Enable SFTP mode (default : false) * @param[in] $sftp boolean Enable SFTP mode (default : false)
* *
* @retval mixed SSH2/SFTP object or false * @retval mixed SSH2/SFTP object or false
@ -147,17 +167,17 @@ LSerror :: defineError('SSH_07',
if (!$cnx->login($user, $password)) { if (!$cnx->login($user, $password)) {
LSerror :: addErrorCode('SSH_04', array('host' => $host, 'port' => $port)); LSerror :: addErrorCode('SSH_04', array('host' => $host, 'port' => $port));
return false; return false;
} }
return $cnx; return $cnx;
} }
/** /**
* Create one or more directories throught SFTP * Create one or more directories throught SFTP
* *
* @author Benjamin Renard <brenard@easter-eggs.com> * @author Benjamin Renard <brenard@easter-eggs.com>
* *
* @param[in] $connection_params array Connection parameters * @param[in] $connection_params array Connection parameters
* @param[in] $dirs array|string The directory/ies to add * @param[in] $dirs array|string The directory/ies to add
* @param[in] $mode integer The directory/ies mode (default : default umask on the SSH server) * @param[in] $mode integer The directory/ies mode (default : default umask on the SSH server)
@ -187,9 +207,9 @@ LSerror :: defineError('SSH_07',
/** /**
* Delete one or more directories throught SFTP * Delete one or more directories throught SFTP
* *
* @author Benjamin Renard <brenard@easter-eggs.com> * @author Benjamin Renard <brenard@easter-eggs.com>
* *
* @param[in] $connection_params array Connection parameters * @param[in] $connection_params array Connection parameters
* @param[in] $dirs array|string The directory/ies to remove * @param[in] $dirs array|string The directory/ies to remove
* @param[in] $recursive boolean Enable recursive mode (default : false) * @param[in] $recursive boolean Enable recursive mode (default : false)
@ -218,9 +238,9 @@ LSerror :: defineError('SSH_07',
/** /**
* Rename a directory throught SFTP * Rename a directory throught SFTP
* *
* @author Benjamin Renard <brenard@easter-eggs.com> * @author Benjamin Renard <brenard@easter-eggs.com>
* *
* @param[in] $connection_params array Connection parameters * @param[in] $connection_params array Connection parameters
* @param[in] $old string The actual directory path to rename * @param[in] $old string The actual directory path to rename
* @param[in] $new string The new directory path * @param[in] $new string The new directory path
@ -241,9 +261,9 @@ LSerror :: defineError('SSH_07',
/** /**
* Exec a command throught SSH * Exec a command throught SSH
* *
* @author Benjamin Renard <brenard@easter-eggs.com> * @author Benjamin Renard <brenard@easter-eggs.com>
* *
* @param[in] $connection_params array Connection parameters * @param[in] $connection_params array Connection parameters
* @param[in] $cmd string The command to run on remote server * @param[in] $cmd string The command to run on remote server
* *