Разрешить или запретить запросы к частным IP-адресам HttpClient::setPrivateIp
Модуль: main — подключать отдельно не нужно
Метод HttpClient::setPrivateIp разрешает или запрещает запросы к частным IP-адресам, например 10.0.0.1, 192.168.1.1 и 127.0.0.1. Запрет нужен, когда адрес запроса задает пользователь, например при загрузке картинки по ссылке. Так злоумышленник не сможет через сайт обратиться к серверам внутренней сети.
Сигнатура метода в классе Bitrix\Main\Web\HttpClient:
public function setPrivateIp($value)
Параметры
Обязательные параметры обозначены *
| Параметр | Тип | Описание |
|---|---|---|
| value* | bool |
Значение false запрещает запросы к частным IP-адресам, true разрешает. Начальное значение — true |
Тип в таблице описывает назначение аргумента. Сигнатура PHP не объявляет его.
Возвращаемое значение
Метод возвращает тот же объект HttpClient.
Особенности
- Если запрет включен, клиент определяет IP-адрес хоста функцией
gethostbynameдо подключения и подключается к этому адресу. Метод getPeerAddress возвращает его. - Если адрес частный, запрос возвращает
false, а getError возвращает ошибку с ключомPRIVATE_IP. Ту же ошибку клиент вернет для хоста, который не удалось найти в DNS, и для хоста только с IPv6-адресом. - Через прокси клиент подключается к прокси, а не к найденному адресу.
Примеры
Пример. Код запрещает запрос к локальному адресу:
<?php
use Bitrix\Main\Web\HttpClient;
require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';
$client = new HttpClient();
$client->setPrivateIp(false);
$result = $client->get('http://127.0.0.1/');
echo var_export($result, true) . ' ' . implode(',', array_keys($client->getError()));
Код выведет false PRIVATE_IP.
Смотрите также
Была ли статья полезна?
Предыдущая
Следующая