ssh2_connect
(PECL ssh2 >= 0.9.0)
ssh2_connect — Підключення до SSH-сервера
Опис
ssh2_connect( string $host, int $port = 22, array $methods = ?, array $callbacks = ?): resource|false
Встановлює з'єднання з сервером SSH.
После соединения, пользователь должен проверить ключ сервера, используя функциюssh2_fingerprint(), і після цього авторизуватись, використовуючи пароль або відкритий ключ.
Список параметрів
host
port
methods
Параметрmethods може бути асоціативним масивом, що містить до чотирьох записів, наведених нижче.
Параметрmethods може бути асоціативним масивом, що містить від одного до чотирьох параметрів
| Индекс | Что обозначает | Допустимые значения* |
|---|---|---|
| kex | Список методів обміну ключами, розділених комою, як перевагу. | diffie-hellman-group1-sha1diffie-hellman-group14-sha1, иdiffie-hellman-group-exchange-sha1 |
| hostkey | Список методів ключів хоста, розділених комою, як перевагу. | ssh-rsaиssh-dss |
| client_to_server | Асоціативний масив, що містить налаштування шифрування, стиснення та методу імітівставки ("message authentication code" або MAC) для повідомлень, надісланих клієнтом серверу. | |
| server_to_client | Асоціативний масив, що містить налаштування шифрування, стиснення та методу імітівставки ("message authentication code" або MAC) для повідомлень, надісланих сервером клієнту. |
* - Значення, що підтримуються, залежать від методів, що підтримуються базовою бібліотекою. Детальніше читайте документацію з » libssh2
client_to_serverиserver_to_client можуть бути асоціативними масивами, що містять будь-який або всі нижчеперелічені параметри.
| Индекс | Что обозначает | Допустимые значения* |
|---|---|---|
| crypt | Список методів шифрування, розділених комою, як перевагу. | rijndael-cbc@lysator.liu.seaes256-cbcaes192-cbcaes128-cbc3des-cbcblowfish-cbccast128-cbcarcfourиnone** |
| comp | Список методів стиснення, розділених комою, як перевагу. | zlibиnone |
| mac | Список методів MAC, розділених комою, у порядку переваги. | hmac-sha1hmac-sha1-96hmac-ripemd160hmac-ripemd160@openssh.comиnone** |
Зауваження Метод шифрування
noneі MACВ цілях безпеки
noneвідключений у базовій бібліотеці » libssh2, якщо ви не дозволили його самостійно на етапі збирання, використовуючи відповідні ключі ./configure. Дивіться документацію з базової бібліотеки для більш детальної інформації.
callbacks
callbacks може бути асоціативним масивом, що містить будь-який або всі нижчеперелічені параметри
Параметри callback-функції
| Индекс | Что обозначает | Прототип |
|---|---|---|
| ignore | Ім'я функції, що викликається після отримання пакета SSH2_MSG_IGNORE | void ignore_cb($message) |
| debug | Ім'я функції, що викликається після отримання пакета SSH2_MSG_DEBUG | void debug_cb($message, $language, $always_display) |
| macerror | Ім'я функції, що викликається, якщо пакет отримано, але MAC не вдався. Якщо callback-функція поверне true, розбіжність буде проігноровано, інакше з'єднання буде обірвано. | bool macerror_cb($packet) |
| disconnect | Ім'я функції, що викликається після отримання пакета SSH2_MSG_DISCONNECT | void disconnect_cb($reason, $message, $language) |
Значення, що повертаються
Повертає ресурс у разі успішного виконання або **false**в случае возникновения ошибки.
Приклади
Приклад #1 Прикладssh2_connect()****
Відкриємо з'єднання, примусово використовуючи такі налаштування: 3des-cbc під час відправлення пакетів, шифр aes будь-якої сили при отриманні пакетів, без стиснення в обох напрямках та обмін ключами Group1.
Дивіться також
- ssh2_fingerprint() - Отримання відбитка віддаленого сервера
- ssh2_auth_none() - Аутентифікація як "none"
- ssh2_auth_password() - Аутентифікація через SSH із використанням звичайного пароля
- ssh2_auth_pubkey_file() - Аутентифікація з відкритим ключем
- ssh2_disconnect() - Закрити з'єднання з віддаленим сервером SSH