<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/security.database.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ru',
  ),
  'this' => 
  array (
    0 => 'security.database.sql-injection.php',
    1 => 'SQL-инъекции',
    2 => 'SQL-инъекции',
  ),
  'up' => 
  array (
    0 => 'security.database.php',
    1 => 'Безопасность баз данных',
  ),
  'prev' => 
  array (
    0 => 'security.database.storage.php',
    1 => 'Шифрование хранилища базы данных',
  ),
  'next' => 
  array (
    0 => 'security.errors.php',
    1 => 'Сообщения об ошибках',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ru',
    'path' => 'security/database.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="security.database.sql-injection" class="sect1">
  <h2 class="title">SQL-инъекции</h2>
  <p class="simpara">
   SQL-инъекция — техника, при которой злоумышленник пользуется недостатками в коде приложения,
   который отвечает за построение динамических SQL-запросов.
   Злоумышленник получает доступ к привилегированным разделам приложения,
   получает информацию из базы данных, подменяет данные
   или даже выполняет опасные команды системного уровня на узле базы данных.
   Уязвимость возникает, когда разработчики конкатенируют или интерполируют
   произвольные входные данные в SQL-запросах.
  </p>
  <p class="para">
   <div class="example" id="example-1">
    <p><strong>Пример #1 
     Постраничный вывод результата и… создание суперпользователя в СУБД PostgreSQL
    </strong></p>
    <div class="example-contents"><p>
     В следующем примере пользовательский ввод интерполируется в SQL-запрос,
     что помогает злоумышленнику получить учётную запись суперпользователя в базе данных.
    </p></div>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br />$offset </span><span style="color: #007700">= </span><span style="color: #0000BB">$_GET</span><span style="color: #007700">[</span><span style="color: #DD0000">'offset'</span><span style="color: #007700">]; </span><span style="color: #FF8000">// Осторожно, нет валидации ввода!<br /></span><span style="color: #0000BB">$query  </span><span style="color: #007700">= </span><span style="color: #DD0000">"SELECT id, name FROM products ORDER BY name LIMIT 20 OFFSET </span><span style="color: #0000BB">$offset</span><span style="color: #DD0000">;"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$result </span><span style="color: #007700">= </span><span style="color: #0000BB">pg_query</span><span style="color: #007700">(</span><span style="color: #0000BB">$conn</span><span style="color: #007700">, </span><span style="color: #0000BB">$query</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
   В стандартном сценарии пользователи нажимают на ссылки «Вперёд» и «Назад»,
   в <abbr title="Uniform Resource Locator">URL</abbr>-адресах которых закодировано смещение,
   значение которого получает переменная <var class="varname">$offset</var>.
   Скрипт ожидает, что входящее значение для переменной <var class="varname">$offset</var> — число.
   Однако, что если взломщик выполнит попытку взломать систему
   и добавит к <abbr title="Uniform Resource Locator">URL</abbr>-адресу следующее значение:
   <div class="informalexample">
    <div class="example-contents">
<div class="sqlcode"><pre class="sqlcode">0;
insert into pg_shadow(usename,usesysid,usesuper,usecatupd,passwd)
  select &#039;crack&#039;, usesysid, &#039;t&#039;,&#039;t&#039;,&#039;crack&#039;
  from pg_shadow where usename=&#039;postgres&#039;;
--</pre>
</div>
    </div>

   </div>
   Если бы это случилось, скрипт предоставил бы злоумышленнику доступ суперпользователя.
   Обратите внимание, что значение <code class="literal">0;</code> записали,
   чтобы передать правильное смещение для исходного запроса
   и завершить запрос.
  </p>
  <blockquote class="note"><p><strong class="note">Замечание</strong>: 
   <p class="para">
    Распространённый приём, который заставляет SQL-парсер
    игнорировать остальную часть запроса разработчика, —
    последовательность символов <code class="literal">--</code>, которая играет в SQL роль синтаксиса комментариев.
   </p>
  </p></blockquote>
  <p class="para">
   Ещё один способ раскрыть пароли учётных записей в БД — атаковать страницы
   с результатами поиска. Злоумышленнику требуется только проверить,
   есть ли в запросе к серверу переменные, которые попадут в SQL-запрос и которые
   не обрабатываются правильно. Эти фильтры обычно устанавливают в форме перед выполнением поиска,
   чтобы изменить поведение условий <code class="literal">WHERE, ORDER BY, LIMIT</code> и <code class="literal">OFFSET</code>
   в запросе <code class="literal">SELECT</code>.
   Если база данных поддерживает конструкцию <code class="literal">UNION</code>, злоумышленник попробует
   добавить к оригинальному запросу ещё один, чтобы вывести список паролей из произвольной таблицы.
   Настоятельно рекомендуется хранить только зашифрованные пароли.
   <div class="example" id="example-2">
    <p><strong>Пример #2 
     Вывод списка статей… и ряда паролей (любой сервер базы данных)
    </strong></p>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br />$query  </span><span style="color: #007700">= </span><span style="color: #DD0000">"SELECT id, name, inserted, size FROM products<br />         WHERE size = '</span><span style="color: #0000BB">$size</span><span style="color: #DD0000">'"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$result </span><span style="color: #007700">= </span><span style="color: #0000BB">odbc_exec</span><span style="color: #007700">(</span><span style="color: #0000BB">$conn</span><span style="color: #007700">, </span><span style="color: #0000BB">$query</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
   Статическую часть запроса комбинируют с другим <code class="literal">SELECT</code>-запросом,
   который раскроет все пароли:
   <div class="informalexample">
    <div class="example-contents">
<div class="sqlcode"><pre class="sqlcode">&#039;
union select &#039;1&#039;, concat(uname||&#039;-&#039;||passwd) as name, &#039;1971-01-01&#039;, &#039;0&#039; from usertable;
--</pre>
</div>
    </div>

   </div>
  </p>
  <p class="para">
   Инструкции <code class="literal">UPDATE</code> и <code class="literal">INSERT</code> также подвержены таким атакам.
   <div class="example" id="example-3">
    <p><strong>Пример #3 
     От сброса пароля до… получения дополнительных привилегий (любой сервер баз данных)
    </strong></p>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br />$query </span><span style="color: #007700">= </span><span style="color: #DD0000">"UPDATE usertable SET pwd='</span><span style="color: #0000BB">$pwd</span><span style="color: #DD0000">' WHERE uid='</span><span style="color: #0000BB">$uid</span><span style="color: #DD0000">';"</span><span style="color: #007700">;<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
   Если злоумышленник отправляет значение
   <code class="literal">&#039; or uid like&#039;%admin%&#039;</code> для переменной <var class="varname">$uid</var>,
   чтобы изменить пароль администратора, или просто присваивает переменной <var class="varname">$pwd</var>
   значение <code class="literal">hehehe&#039;, trusted=100, admin=&#039;yes</code>,
   чтобы получить дополнительные привилегии, тогда запросы переплетаются:
   <div class="informalexample">
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br /></span><span style="color: #FF8000">// Значение переменной $uid: ' or uid like '%admin%<br /></span><span style="color: #0000BB">$query </span><span style="color: #007700">= </span><span style="color: #DD0000">"UPDATE usertable SET pwd='...' WHERE uid='' or uid like '%admin%';"</span><span style="color: #007700">;<br /><br /></span><span style="color: #FF8000">// Значение переменной $pwd: hehehe', trusted=100, admin='yes<br /></span><span style="color: #0000BB">$query </span><span style="color: #007700">= </span><span style="color: #DD0000">"UPDATE usertable SET pwd='hehehe', trusted=100, admin='yes' WHERE<br />...;"</span><span style="color: #007700">;<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
  </p>
  <p class="simpara">
   Хотя остаётся ясным, что для успешной атаки злоумышленнику нужны
   хотя бы частичные знания об архитектуре базы данных, эту информацию часто получают легко.
   Например, когда код — часть открытого программного обеспечения и лежит в открытом доступе.
   Информация также раскрывается и закрытым исходным кодом, даже если код закодировали,
   обфусцировали или скомпилировали, и даже собственным кодом через отображение сообщений об ошибках.
   Другие методы включают подстановку типичных имён таблиц и столбцов: форма входа в систему,
   которая использует таблицу users с именами столбцов id, username и password.
  </p>
  <p class="para">
   <div class="example" id="example-4">
    <p><strong>Пример #4 Атака на операционную систему сервера базы данных (MSSQL Server)</strong></p>
    <div class="example-contents"><p>
     Страшный пример получения доступа к командам уровня операционной системы
     на отдельных хостах баз данных.
    </p></div>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br />$query  </span><span style="color: #007700">= </span><span style="color: #DD0000">"SELECT * FROM products WHERE id LIKE '%</span><span style="color: #0000BB">$prod</span><span style="color: #DD0000">%'"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$result </span><span style="color: #007700">= </span><span style="color: #0000BB">mssql_query</span><span style="color: #007700">(</span><span style="color: #0000BB">$query</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
   Если злоумышленник отправит значение
   <code class="literal">a%&#039; exec master..xp_cmdshell &#039;net user test testpass /ADD&#039; --</code>
   для переменной <var class="varname">$prod</var>, то переменная <var class="varname">$query</var> будет равна:
   <div class="informalexample">
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br />$query  </span><span style="color: #007700">= </span><span style="color: #DD0000">"SELECT * FROM products<br />         WHERE id LIKE '%a%'<br />         exec master..xp_cmdshell 'net user test testpass /ADD' --%'"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$result </span><span style="color: #007700">= </span><span style="color: #0000BB">mssql_query</span><span style="color: #007700">(</span><span style="color: #0000BB">$query</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
   MSSQL Server выполняет пакетные SQL-запросы, включая команду для добавления
   нового пользователя в базу данных локальных учётных записей.
   Если бы это приложение запустили от имени суперадминистратора <code class="literal">sa</code>,
   а службу MSSQLSERVER запустили бы с достаточными привилегиями,
   у злоумышленника появилась бы учётная запись с доступом к локальной машине.
  </p>
  <blockquote class="note"><p><strong class="note">Замечание</strong>: 
   <p class="para">
    Часть приведённых примеров привязана к конкретному серверу базы данных,
    но это не говорит о невозможности похожей атаки на другие продукты.
    Сервер базы данных подвержен и другим уязвимостям.
   </p>
  </p></blockquote>
  <p class="para">
   <div class="mediaobject">
    
    <div class="imageobject">
     <img src="images/fa7c5b5f326e3c4a6cc9db19e7edbaf0-xkcd-bobby-tables.png" alt="Забавный пример проблем, связанных с SQL-инъекциями" width="666" height="205" />
    </div>
    <div class="caption">
       <p class="simpara">
        Изображение любезно предоставил сайт веб-комиксов <a href="http://xkcd.com/327" class="link external">&raquo;&nbsp;xkcd</a>
       </p>
      </div>
   </div>
  </p>

  <div class="sect2" id="security.database.avoiding">
   <h3 class="title">Техники защиты</h3>
   <p class="para">
    Рекомендуемый способ избежать SQL-инъекций — связать данные подготовленными инструкциями.
    Параметризованных запросов недостаточно, чтобы на 100 процентов избежать внедрения SQL-инъекций,
    но это простейший и безопасный способ передать входные данные SQL-инструкциям.
    Литералы динамических данных в условиях <code class="literal">WHERE</code>, <code class="literal">SET</code>
    и <code class="literal">VALUES</code> требуется заменить заполнителями. Сервер базы данных свяжет
    фактические данные при выполнении и отправит отдельно от SQL-команды.
   </p>
   <p class="para">
    Сервер применяет связывание параметров только для данных.
    Другие динамические части SQL-запроса требуется отфильтровать по известному списку разрешённых значений.
   </p>
   <p class="para">
    <div class="example" id="example-5">
     <p><strong>Пример #5 
      Избегание SQL-инъекций средствами подготовленных инструкций модуля PDO
     </strong></p>
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br /></span><span style="color: #FF8000">// Динамическая часть SQL-запроса проверяется на соответствие ожидаемым значениям<br /></span><span style="color: #0000BB">$sortingOrder </span><span style="color: #007700">= </span><span style="color: #0000BB">$_GET</span><span style="color: #007700">[</span><span style="color: #DD0000">'sortingOrder'</span><span style="color: #007700">] === </span><span style="color: #DD0000">'DESC' </span><span style="color: #007700">? </span><span style="color: #DD0000">'DESC' </span><span style="color: #007700">: </span><span style="color: #DD0000">'ASC'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$productId </span><span style="color: #007700">= </span><span style="color: #0000BB">$_GET</span><span style="color: #007700">[</span><span style="color: #DD0000">'productId'</span><span style="color: #007700">];<br /><br /></span><span style="color: #FF8000">// SQL-запрос подготавливается с заполнителем<br /></span><span style="color: #0000BB">$stmt </span><span style="color: #007700">= </span><span style="color: #0000BB">$pdo</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">prepare</span><span style="color: #007700">(</span><span style="color: #DD0000">"SELECT * FROM products WHERE id LIKE ? ORDER BY price </span><span style="color: #007700">{</span><span style="color: #0000BB">$sortingOrder</span><span style="color: #007700">}</span><span style="color: #DD0000">"</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">// Значение передаётся с подстановочными знаками LIKE<br /></span><span style="color: #0000BB">$stmt</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">execute</span><span style="color: #007700">([</span><span style="color: #DD0000">"%</span><span style="color: #007700">{</span><span style="color: #0000BB">$productId</span><span style="color: #007700">}</span><span style="color: #DD0000">%"</span><span style="color: #007700">]);<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
     </div>

    </div>
   </p>

   <p class="simpara">
    Подготовленные инструкции предоставляют модули <a href="pdo.prepared-statements.php" class="link">PDO</a>,
    <a href="mysqli.quickstart.prepared-statements.php" class="link">MySQLi</a>
    и другие библиотеки баз данных.
   </p>

   <p class="simpara">
    Атаки с внедрением SQL-инъекций обычно основаны на коде,
    который написали без учёта требований безопасности.
    Разработчик не должен доверять никаким входным данным, особенно со стороны клиента,
    даже если входные значения поступают из HTML-блока SELECT,
    скрытого поля ввода или из cookie. Первый пример показывает, что такой простой запрос
    легко приводит к катастрофе.
   </p>

   <p class="para">
    Стратегия глубокой защиты включает набор практик хорошего кода:
    <ul class="itemizedlist">
     <li class="listitem">
      <span class="simpara">
       Не подключайтесь к базе данных как суперпользователь или владелец базы данных.
       Используйте только пользователей с минимальными привилегиями.
      </span>
     </li>
     <li class="listitem">
      <span class="simpara">
       Проверяйте входные данные на соответствие типу, который ожидался.
       В <abbr title="PHP: Hypertext Preprocessor">PHP</abbr> содержится много функции для проверки входных данных,
       от простейших
       <a href="ref.var.php" class="link">функций для работы с переменными</a>
       наподобие функции <span class="function"><a href="function.is-numeric.php" class="function">is_numeric()</a></span>
       и <a href="ref.ctype.php" class="link">функций проверки типа символов</a>
       наподобие функции <span class="function"><a href="function.ctype-digit.php" class="function">ctype_digit()</a></span> и далее к поддержке
       <a href="ref.pcre.php" class="link">Perl-совместимых регулярных выражений</a>.
      </span>
     </li>
     <li class="listitem">
      <span class="simpara">
       Если приложение ожидает числовые входные данные,
       рассмотрите применимость проверки данных функцией <span class="function"><a href="function.ctype-digit.php" class="function">ctype_digit()</a></span>,
       незаметно измените тип входных данных функцией <span class="function"><a href="function.settype.php" class="function">settype()</a></span>
       или получите числовое представление входных данных функцией <span class="function"><a href="function.sprintf.php" class="function">sprintf()</a></span>.
      </span>
     </li>
     <li class="listitem">
      <span class="simpara">
       Если на уровне базы данных не поддерживается связывание переменных,
       возьмите в кавычки каждое пользовательское нечисловое значение, которое передаётся в БД
       через характерную для конкретной базы данных функцию экранирования строки:
       <span class="function"><a href="function.mysql-real-escape-string.php" class="function">mysql_real_escape_string()</a></span>,
       <span class="function"><strong>sqlite_escape_string()</strong></span>  и т. д.
       Общие функции наподобие <span class="function"><a href="function.addslashes.php" class="function">addslashes()</a></span> полезны
       только в конкретных средах (например, СУБД MySQL в однобайтовой кодировке
       с отключённым режимом <var class="varname">NO_BACKSLASH_ESCAPES</var>), поэтому при работе с БД
       лучше избегать таких функций.
      </span>
     </li>
     <li class="listitem">
      <span class="simpara">
       Ни в каком случае не выводите информации о БД, особенно о структуре.
       Дополнительную информацию дают разделы «<a href="security.errors.php" class="link">Сообщения об ошибках</a>»
       и «<a href="ref.errorfunc.php" class="link">Функции обработки и логирования ошибок</a>».
      </span>
     </li>
    </ul>
   </p>

   <p class="simpara">
    Кроме сказанного, выгоду получают от логирования запросов либо внутри скрипта,
    либо на уровне базы данных, если БД поддерживает логирование. Очевидно, логирование
    не в состоянии предотвратить попытки навредить, но полезно при трассировке приложения,
    защиту которого получилось обойти. Польза файла журнала заключается не в самом файле,
    а в информации, которую содержит лог.
    Недостатку информации лучше предпочесть избыточное логирование.
   </p>
  </div>
 </div><?php manual_footer($setup); ?>