Phpseclib: Безопасное общение с удаленными серверами через PHP

PHP имеет библиотеку SSH2, которая обеспечивает доступ к ресурсам (оболочка, удаленное выполнение, туннелирование, передача файлов) на удаленной машине с использованием безопасного криптографического транспорта. Объективно, это трудоемкая и очень разочаровывающая задача для разработчика, чтобы реализовать ее из-за ее огромных возможностей конфигурации и сложного API с небольшим количеством документации.

Пакет phpseclib ( PHP Scuure C ommunications Lib rary) имеет дружественный к разработчику API. Он использует некоторые необязательные расширения PHP, если они доступны, и в противном случае использует внутреннюю реализацию PHP. Чтобы использовать этот пакет, вам не нужны никакие не установленные по умолчанию расширения PHP.

Установка

composer require phpseclib/phpseclib

Это установит самую последнюю стабильную версию библиотеки через Composer .

Случаи использования

Прежде чем погрузиться вслепую, я бы хотел перечислить несколько вариантов использования, подходящих для использования этой библиотеки:

1. Выполнение сценариев развертывания на удаленном сервере
2. Загрузка и выгрузка файлов через SFTP
3. Динамическая генерация ключей SSH в приложении
4. Отображение вывода в реальном времени для удаленных команд, выполняемых на сервере
5. Тестирование соединения SSH или SFTP

Подключение к удаленному серверу

Используя phpseclib , вы можете подключиться к удаленному серверу любым из следующих способов аутентификации:

1. Ключ RSA
2. Защищенный паролем ключ RSA
3. Имя пользователя и пароль ( не рекомендуется )

Ключ RSA

Мы предполагаем, что у вас уже есть безопасный ключ RSA . Если вы не знакомы с созданием безопасной пары ключей RSA, вы можете прочитать эту статью . Для объяснения видео вы можете обратиться к разделу Создание и использование ключей SSH с серверов для хакеров.

Чтобы войти на удаленный сервер с использованием аутентификации по ключу RSA :

 namespace App;

use phpseclib\Crypt\RSA;
use phpseclib\Net\SSH2;

$key = new RSA();
$key->loadKey(file_get_contents('privatekey'));

//Remote server's ip address or hostname
$ssh = new SSH2('192.168.0.1');

if (!$ssh->login('username', $key)) {
    exit('Login Failed');
}

Защищенный паролем ключ RSA

Если ваши ключи RSA защищены паролем, не беспокойтесь. Phpseclib позаботится об этом конкретном случае использования:

 namespace App;

use phpseclib\Crypt\RSA;
use phpseclib\Net\SSH2;

$key = new RSA();
$key->setPassword('your-secure-password');
$key->loadKey(file_get_contents('privatekey'));

//Remote server's ip address or hostname
$ssh = new SSH2('192.168.0.1');

if (!$ssh->login('username', $key)) {
    exit('Login Failed');
}

Имя пользователя и пароль

Кроме того, чтобы войти на удаленный сервер, используя имя пользователя и пароль (мы не рекомендуем эту практику):

 namespace App;

use phpseclib\Net\SSH2;

//Remote server's ip address or hostname
$ssh = new SSH2('192.168.0.1');

if (!$ssh->login('username', 'password')) {
    exit('Login Failed');
}

Для других опций, таких как Без Аутентификации или Многофакторной аутентификации, пожалуйста, обратитесь к документации

Выполнение команд на удаленном сервере

Код для выполнения команд на удаленном сервере довольно прост. Вы вызываете метод $ssh->exec($cmd)

 namespace App;

use phpseclib\Crypt\RSA;
use phpseclib\Net\SSH2;

$key = new RSA();
$key->loadKey(file_get_contents('privatekey'));

//Remote server's ip address or hostname
$ssh = new SSH2('192.168.0.1');

if (!$ssh->login('username', $key)) {
    exit('Login Failed');
}

$ssh->exec('ls -la');

Выполнение нескольких команд на удаленном сервере

В реальных приложениях мы редко выполняем одну команду. Нам часто нужно обходить сервер с помощью cd Если вы попытаетесь выполнить несколько команд на удаленном сервере, как показано ниже, это не даст вам желаемого результата:

 $ssh->exec('pwd'); //outputs /home/username

$ssh->exec('cd mysite.com');

$ssh->exec('pwd'); //outputs /home/username

Причина вышеизложенного заключается в том, что вызов метода execexec Чтобы выполнить несколько команд без потери состояния:

 $ssh->exec('cd /home/username; ls -la'); //Lists all files at /home/username

 $ssh->exec(
      "git pull origin master" . PHP_EOL
        . "composer install --no-interaction --no-dev --prefer-dist" . PHP_EOL
        . "composer dump-autoload -o" . PHP_EOL
        . "php artisan optimize" . PHP_EOL
        . "php artisan migrate --force"
);

 $ssh->exec(
    "set -e" . PHP_EOL
        . "git pull origin master" . PHP_EOL 
        . "composer install --no-interaction --no-dev --prefer-dist" . PHP_EOL
        . "composer dump-autoload -o" . PHP_EOL
        . "php artisan optimize" . PHP_EOL
        . "php artisan migrate --force"
);

 $output = $ssh->exec('ls -la');
echo $output;

 $ssh->exec(
    $deployment_script, function ($str) {
        $output .= $str;
});

echo $output;

 $ssh->exec($deployment_script, function ($str) {
    echo $str;
});

 $ssh->exec(
    $deployment_script, function ($str) {
        echo $str;
        flush();
        ob_flush();
});