cvs: phpdoc-ru /features safe-mode.xml
| From: | Alexander Voytsekhovskyy | Date: | Sun, 16 May 2004 17:38:44 +0000 |
| Subject: | cvs: phpdoc-ru /features safe-mode.xml | ||
| Groups: | php.doc.ru | ||
| Request: | Send a blank email to doc-ru+get-336@lists.php.net to get a copy of this message | ||
young Sun May 16 13:38:44 2004 EDT
Added files:
/phpdoc-ru/features safe-mode.xml
Log:
Add new translated file
http://cvs.php.net/co.php/phpdoc-ru/features/safe-mode.xml?r=1.1&p=1 Index: phpdoc-ru/features/safe-mode.xml +++ phpdoc-ru/features/safe-mode.xml <?xml version="1.0" encoding="windows-1251"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.49 Maintainer: young Status: ready --> <chapter id="features.safe-mode"> <title>Çàùèùåííûé ðåæèì</title> <para> Çàùèùåííûé ðåæèì â PHP - ýòî ïîïûòêà ðåøèòü ïðîáëåìó áåçîïàñíîñòè íà ñîâìåñòíî èñïîëüçóåìûõ ñåðâåðàõ. Íåñìîòðÿ íà òî, ÷òî êîíöåïòóàëüíî íåâåðíî ðåøàòü ýòó ïðîáëåìó íà óðîâíå PHP, íî ïîñêîëüêó àëüòåðíàòèâû óðîâíÿ âåá-ñåðâåðà èëè îïåðàöèîííîé ñèñòåìû íà ñåãîäíÿøíèé äåíü îòñóòñòâóþò, ìíîãèå ïîëüçîâàòåëè, îñîáåííî ïðîâàéäåðû, èñïîëüçóþò èìåííî çàùèùåííûé ðåæèì. </para> <sect1 id="ini.sect.safe-mode"> <title>Áåçîïàñíîñòü è çàùèùåííûé ðåæèì</title> <para> <table> <title>Êîíôèãóðàöèîííûå îïöèè, óïðàâëÿþùèå çàùèùåííûì ðåæèìîì è âîïðîñàìè áåçîïàñíîñòè</title> <tgroup cols="3"> <thead> <row> <entry>Èìÿ</entry> <entry>Çíà÷åíèå ïî óìîë÷àíèþ</entry> <entry>Èçìåíÿåìîñòü</entry> </row> </thead> <tbody> <row> <entry>safe_mode</entry> <entry>"0"</entry> <entry>PHP_INI_SYSTEM</entry> </row> <row> <entry>safe_mode_gid</entry> <entry>"0"</entry> <entry>PHP_INI_SYSTEM</entry> </row> <row> <entry>safe_mode_include_dir</entry> <entry>NULL</entry> <entry>PHP_INI_SYSTEM</entry> </row> <row> <entry>safe_mode_exec_dir</entry> <entry>""</entry> <entry>PHP_INI_SYSTEM</entry> </row> <row> <entry>safe_mode_allowed_env_vars</entry> <entry>PHP_</entry> <entry>PHP_INI_SYSTEM</entry> </row> <row> <entry>safe_mode_protected_env_vars</entry> <entry>LD_LIBRARY_PATH</entry> <entry>PHP_INI_SYSTEM</entry> </row> <row> <entry>open_basedir</entry> <entry>NULL</entry> <entry>PHP_INI_SYSTEM</entry> </row> <row> <entry>disable_functions</entry> <entry>""</entry> <entry>PHP_INI_SYSTEM</entry> </row> <row> <entry>disable_classes</entry> <entry>""</entry> <entry>PHP_INI_SYSTEM</entry> </row> </tbody> </tgroup> </table> Äëÿ ïîëó÷åíèÿ áîëåå äåòàëüíîé èíôîðìàöèè î êîíñòàíòàõ âèäà PHP_INI_* îçíàêîìüòåñü ñ ôóíêöèåé <function>ini_set</function>. </para> &ini.descriptions.title; <para> <variablelist> <varlistentry id="ini.safe-mode"> <term> <parameter>safe_mode</parameter> <type>boolean</type> </term> <listitem> <para> Âêëþ÷àåò/îòêëþ÷àåò çàùèùåííûé ðåæèì â PHP. Äëÿ ïîëó÷åíèÿ áîëåå äåòàëüíîé èíôîðìàöèè îçíàêîìüòåñü ñ ðàçäåëîì <link linkend="security.index">Áåçîïàñíîñòü</link>. </para> </listitem> </varlistentry> <varlistentry id="ini.safe-mode-gid"> <term> <parameter>safe_mode_gid</parameter> <type>boolean</type> </term> <listitem> <para> Ïî óìîë÷àíèþ â çàùèùåííîì ðåæèìå ïðè îòêðûòèè ôàéëà âûïîëíÿåòñÿ ïðîâåðêà çíà÷åíèÿ UID. Äëÿ òîãî, ÷òîáû íåìíîãî ñìÿã÷èòü ýòî óñëîâèå è âûïîëíÿòü ïðîâåðêó GID, íåîáõîäèìî óñòàíîâèòü çíà÷åíèå on äëÿ ôëàãà safe_mode_gid. Îïðåäåëÿåò, èñïîëüçîâàòü èëè íåò ïðîâåðêó <literal>UID</literal> (&false;) èëè <literal>GID</literal> (&true;) ïðîâåðêó ïðè îáðàùåíèè ê ôàéëó. </para> </listitem> </varlistentry> <varlistentry id="ini.safe-mode-include-dir"> <term> <parameter>safe_mode_include_dir</parameter> <type>string</type> </term> <listitem> <para> Ïðè ïîäêëþ÷åíèè ôàéëîâ, ðàñïîëîæåííûõ â óêàçàííîé äèðåêòîðèè è âñåõ åå ïîäêàòàëîãàõ, ïðîâåðêà íà ñîîòâåòñòâèå çíà÷åíèé <literal>UID</literal>/<literal>GID</literal> íå âûïîëíÿåòñÿ ( ñëó÷àå, åñëè óñòàíîâëåííàÿ äèðåêòîðèÿ íå óêàçàíà â <link linkend="ini.include-path">include_path</link>, íåîáõîäèìî óêàçûâàòü ïîëíûé ïóòü ïðè âêëþ÷åíèè). </para> <simpara> Íà÷èíàÿ ñ PHP 4.2.0 çíà÷åíèåì ýòîé äèðåêòèâû ìîæåò áûòü ñïèñîê êàòàëîãîâ, ðàçäåëåííûõ äâîåòî÷èåì (òî÷êîé ñ çàïÿòîé íà windows-ñèñòåìàõ), ÷òî àíàëîãè÷íî ñèíòàêñèñó <link linkend="ini.include-path">include_path</link>. </simpara> <simpara> Óêàçàííîå çíà÷åíèå â äåéñòâèòåëüíîñòè ÿâëÿåòñÿ ïðåôèêñîì, à íå íàçâàíèåì äèðåêòîðèè. Ýòî îçíà÷àåò, ÷òî çàïèñü "safe_mode_include_dir = /dir/incl" ïîçâîëÿåò ïîäêëþ÷àòü ôàéëû, íàõîäÿùèåñÿ â äèðåêòîðèÿõ "/dir/include" è "/dir/incls", â ñëó÷àå, åñëè îíè ñóùåñòâóþò. Åñëè âû õîòèòå óêàçàòü äîñòóï ê êîíêðåòíîé äèðåêòîðèè, èñïîëüçóéòå çàâåðøàþùèé ñëåø, íàïðèìåð: "safe_mode_include_dir = /dir/incl/". </simpara> </listitem> </varlistentry> <varlistentry id="ini.safe-mode-exec-dir"> <term> <parameter>safe_mode_exec_dir</parameter> <type>string</type> </term> <listitem> <para>  ñëó÷àå, êîãäà PHP ðàáîòàåò â çàùèùåííîì ðåæèìå, <function>system</function> è äðóãèå <link linkend="ref.exec">ôóíêöèè äëÿ âûïîëíåíèÿ ñèñòåìíûõ êîìàíä è ïðîãðàìì</link> îòêëîíÿþò âûïîëíåíèå ïðîãðàìì, íàõîäÿùèõñÿ âñå äàííîé äèðåêòîðèè. </para> </listitem> </varlistentry> <varlistentry id="ini.safe-mode-allowed-env-vars"> <term> <parameter>safe_mode_allowed_env_vars</parameter> <type>string</type> </term> <listitem> <para> Âîçìîæíîñòü óñòàíàâëèâàòü ïåðåìåííûå îêðóæåíèÿ - ïîòåíöèàëüíàÿ áðåøü â áåçîïàñíîñòè. Çíà÷åíèåì ýòîé äèðåêòèâû ÿâëÿåòñÿ ñïèñîê ïðåôèêñîâ, ðàçäåëåííûõ äâîåòî÷èÿìè.  çàùèùåííîì ðåæèìå ïîëüçîâàòåëü ìîæåò ìîäèôèöèðîâàòü òîëüêî òå ïåðåìåííûå îêðóæåíèÿ, èìåíà êîòîðûõ íà÷èíàþòñÿ ñ îäíîãî èç óêàçàííûõ ïðåôèêñîâ. Ïî óìîë÷àíèþ, ïîëüçîâàòåëþ äîñòóïíû ïåðåìåííûå, êîòîðûå íà÷èíàþòñÿ ñ ïðåôèêñà PHP_ (íàïðèìåð, PHP_FOO=BAR). </para> <note> <para>  ñëó÷àå, åñëè ýòîé äèðåêòèâå óêàçàòü ïóñòîå çíà÷åíèå, ïîëüçîâàòåëü ïîëó÷èò âîçìîæíîñòü ìîäèôèöèðîâàòü ëþáóþ ïåðåìåííóþ îêðóæåíèÿ! </para> </note> </listitem> </varlistentry> <varlistentry id="ini.safe-mode-protected-env-vars"> <term> <parameter>safe_mode_protected_env_vars</parameter> <type>string</type> </term> <listitem> <para> Ýòà äèðåêòèâà ñîäåðæèò ñïèñîê ïåðåìåííûõ îêðóæåíèÿ, ðàçäåëåííûõ äâîåòî÷èåì, çíà÷åíèå êîòîðûõ ïîëüçîâàòåëü íå ñìîæåò èçìåíèòü, èñïîëüçóÿ ôóíêöèþ <function>putenv</function>. Çíà÷åíèÿ ýòèõ ïåðåìåííûõ îñòàþòñÿ çàùèùåííûìè, äàæå åñëè èõ ìîäèôèêàöèÿ ðàçðåøåíà äèðåêòèâîé safe_mode_allowed_env_vars. </para> </listitem> </varlistentry> <varlistentry id="ini.open-basedir"> <term> <parameter>open_basedir</parameter> <type>string</type> </term> <listitem> <para> Îãðàíè÷èâàåò ñïèñîê ôàéëîâ, êîòîðûå ìîãóò áûòü îòêðûòû â PHP, óêàçàííûì äåðåâîì äèðåêòîðèé <emphasis>íåçàâèñèìî</emphasis> îò òîãî, èñïîëüçóåòñÿ çàùèùåííûé ðåæèì èëè íåò. </para> <para> Êàæäûé ðàç, êîãäà ñêðèïò ïûòàåòñÿ îòêðûòü ôàéë, íàïðèìåð, ïðè ïîìîùè ôóíêöèè <function>fopen</function> èëè <function>gzopen</function>, ïðîâåðÿåòñÿ ìåñòîðàñïîëîæåíèå ôàéëà.  ñëó÷àå, åñëè îí íàõîäèòñÿ âíå óêàçàííîãî äåðåâà äèðåêòîðèé, PHP îòêàçûâàåò â îòêðûòèÿ ôàéëà. Âñå ñèìâîëè÷åñêèå ññûëêè ðàñïîçíàþòñÿ è ïðåîáðàçóþòñÿ, ïîýòîìó îáîéòè ýòî îãðàíè÷åíèå ïðè ïîìîùè ñèìâîëè÷åñêèõ ññûëîê íåâîçìîæíî. </para> <para> Ñïåöèàëüíîå çíà÷åíèå <systemitem class="constant">.</systemitem> óêàçûâàåò, ÷òî áàçîâîé ñëåäóåò ñ÷èòàòü äèðåêòîðèþ, â êîòîðîé ðàñïîëîæåí ñàì ñêðèïò. </para> <para> Äëÿ Windows-ñèñòåì ðàçäåëèòåëåì ñïèñêà äèðåêòîðèé ñëóæèò òî÷êà ñ çàïÿòîé. Äëÿ âñåõ äðóãèõ îïåðàöèîííûõ ñèñòåì â êà÷åñòâå ðàçäåëèòåëÿ èñïîëüçóåòñÿ äâîåòî÷èå.  ñëó÷àå, åñëè PHP ðàáîòàåò êàê ìîäóëü âåá-ñåðâåðà Apache, âñå óêàçàíèÿ open_basedir äëÿ ðîäèòåëüñêèõ äèðåêòîðèé íàñëåäóþòñÿ. </para> <para> Óêàçàííîå çíà÷åíèå â äåéñòâèòåëüíîñòè ÿâëÿåòñÿ ïðåôèêñîì, à íå íàçâàíèåì äèðåêòîðèè. Ýòî îçíà÷àåò, ÷òî çàïèñü "safe_mode_include_dir = /dir/incl" ïîçâîëÿåò îòêðûâàòü ôàéëû, íàõîäÿùèåñÿ â äèðåêòîðèÿõ "/dir/include" è "/dir/incls", â ñëó÷àå, åñëè îíè ñóùåñòâóþò. Åñëè âû õîòèòå óêàçàòü äîñòóï ê êîíêðåòíîé äèðåêòîðèè, èñïîëüçóéòå çàâåðøàþùèé ñëåø, íàïðèìåð: "safe_mode_include_dir = /dir/incl/". </para> <note> <para> Âîçìîæíîñòü ðàáîòû ñ íåñêîëüêèìè äèðåêòîðèÿìè äîáàâëåíà â âåðñèè 3.0.7. </para> </note> <para> Ïî óìîë÷àíèþ ðàçðåøåí äîñòóï êî âñåì ôàéëàì. </para> </listitem> </varlistentry> <varlistentry id="ini.disable-functions"> <term> <parameter>disable_functions</parameter> <type>string</type> </term> <listitem> <simpara> Ýòà äèðåêòèâà ïîçâîëÿåò âàì çàïðåòèòü íåêîòîðûå ôóíêöèè èç ñîîáðàæåíèé <link linkend="security.index">áåçîïàñíîñòè</link>.  êà÷åñòâå çíà÷åíèÿ îíà ïðèíèìàåò ñïèñîê ôóíêöèé, ðàçäåëåííûõ äâîåòî÷èåì. disable_functions íå çàâèñèò îò òîãî, èñïîëüçóåòñÿ <link linkend="ini.safe-mode">Çàùèùåííûé ðåæèì</link> èëè íåò. </simpara> <simpara> Ýòà äèðåêòèâà äîëæíà áûòü óêàçàíà â &php.ini;. Âû íå ìîæåòå èñïîëüçîâàòü åå, íàïðèìåð, â &httpd.conf;. </simpara> </listitem> </varlistentry> <varlistentry id="ini.disable-classes"> <term> <parameter>disable_classes</parameter> <type>string</type> </term> <listitem> <simpara> Ýòà äèðåêòèâà ïîçâîëÿåò âàì çàïðåòèòü íåêîòîðûå êëàññû èç ñîîáðàæåíèé <link linkend="security.index">áåçîïàñíîñòè</link>.  êà÷åñòâå çíà÷åíèÿ îíà ïðèíèìàåò ñïèñîê êëàñîâ, ðàçäåëåííûõ äâîåòî÷èåì. disable_classes íå çàâèñèò îò òîãî, èñïîëüçóåòñÿ <link linkend="ini.safe-mode">Çàùèùåííûé ðåæèì</link> èëè íåò. </simpara> <simpara> Ýòà äèðåêòèâà äîëæíà áûòü óêàçàíà â &php.ini;. Âû íå ìîæåòå èñïîëüçîâàòü åå, íàïðèìåð, â &httpd.conf;. </simpara> <note> <para> Ýòà äèðåêòèâà äîñòóïíà, íà÷èíàÿ ñ PHP 4.3.2 </para> </note> </listitem> </varlistentry> </variablelist> </para> <para> Îçíàêîìüòåñü òàêæå ñî ñëåäóþùèìè êîíôèãóðàöèîííûìè äèðåêòèâàìè: <link linkend="ini.register-globals">register_globals</link>, <link linkend="ini.display-errors">display_errors</link>, è <link linkend="ini.log-errors">log_errors</link> </para> <para>  ñëó÷àå, åñëè äèðåêòèâà <link linkend="ini.safe-mode">safe_mode</link> óñòàíîâëåíà çíà÷åíèåì on, PHP ïðîâåðèò, ñîâïàäàåò ëè âëàäåëåö ñêðèïòà è âëàäåëåö ôàéëà, êîòîðûì îïåðèðóåò ñêðèïò. Íàïðèìåð: <programlisting role="ls"> <![CDATA[ -rw-rw-r-- 1 rasmus rasmus 33 Jul 1 19:20 script.php -rw-r--r-- 1 root root 1116 May 26 18:01 /etc/passwd ]]> </programlisting> âûïîëíèå ñðèïòà script.php <programlisting role="php"> <![CDATA[ <?php readfile('/etc/passwd'); ?> ]]> </programlisting> â ñëó÷àå èñïîëüçîâàíèÿ çàùèùåííîãî ðåæèìà ïðèâîäèò ê ñëåäóþùåé îøèáêå: <screen> <![CDATA[ Warning: SAFE MODE Restriction in effect. The script whose uid is 500 is not allowed to access /etc/passwd owned by uid 0 in /docroot/script.php on line 2 ]]> </screen> </para> <para> Òåì íå ìåíåå, ïðåäóñìîòðåíà âîçìîæíîñòü âìåñòî ïðîâåðêè íà ñîîòâåòñòâèå <literal>UID</literal> èñïîëüçîâàòü áîëåå ìÿãêóþ ïðîâåðêó íà ñîîòâåòñòâèå <literal>GID</literal>. Äëÿ ýòîãî íåîáõîäèìî èñïîëüçîâàòü äèðåêòèâó <link linkend="ini.safe-mode-gid">safe_mode_gid</link>.  ñëó÷àå, åñëè îíà óñòàíîâëåíà çíà÷åíèåì <literal>On</literal>, èñïîëüçóåòñÿ áîëåå ìÿãêàÿ ïðîâåðêà <literal>GID</literal>.  ïðîòèâíîì ñëó÷àå, åñëè óñòàíîâëåíî çíà÷åíèå <literal>Off</literal> (çíà÷åíèå ïî óìîë÷àíèþ), âûïîëíÿåòñÿ áîëåå ñòðîãàÿ ïðîâåðêà íà ñîîòâåòñòâèå <literal>UID</literal>. </para> <para>  êà÷åñòâå àëüòåðíàòèâû äèðåêòèâå <link linkend="ini.safe-mode">safe_mode</link> âû ìîæåòå îãðàíè÷èòü âñå âûïîëíÿåìûå ñêðèïòû æåñòêî çàäàííûì äåðåâîì äèðåêòîðèé ïðè ïîìîùè îïöèè <link linkend="ini.open-basedir">open_basedir</link>. Íàïðèìåð (ôðàãìåíò êîíôèãóðàöèîííîãî ôàéëà &httpd.conf;): <programlisting role="ini"> <![CDATA[ <Directory /docroot> php_admin_value open_basedir /docroot </Directory> ]]> </programlisting> Ïðè ïîïûòêå âûïîëíèòü òîò æå ñàìûé ñêðèïò script.php ñ óêàçàííîé îïöèåé <link linkend="ini.open-basedir">open_basedir</link> âû ïîëó÷èòå ñëåäóþùèé ðåçóëüòàò: <screen> <![CDATA[ Warning: open_basedir restriction in effect. File is in wrong directory in /docroot/script.php on line 2 ]]> </screen> </para> <para> Âû òàêæå ìîæåòå çàïðåòèòü îòäåëüíûå ôóíêöèè. Ñëåäóåò çàìåòèòü, ÷òî äèðåêòèâà <link linkend="ini.disable-functions">disable_functions</link> ìîæåò áûòü óêàçàíà èñêëþ÷èòåëüíî â êîíôèãóðàöèîííîì ôàéëå &php.ini;, ýòî îçíà÷àåò, ÷òî âû íå ìîæåòå, îòðåäàêòèðîâàâ &httpd.conf;, óñòàíîâèòü èíäèâèäóàëüíûå çíà÷åíèÿ äëÿ êîíêðåòíîãî âèðòóàëüíîãî õîñòà èëè êàòàëîãà. Åñëè äîáàâèòü â &php.ini; ñëåäóþùóþ ñòðîêó: <programlisting role="ini"> <![CDATA[ disable_functions readfile,system ]]> </programlisting> Ðåçóëüòàòîì ðàáîòû ñêðèïòà áóäåò ñëåäóþùèé âûâîä: <screen> <![CDATA[ Warning: readfile() has been disabled for security reasons in /docroot/script.php on line 2 ]]> </screen> </para> </sect1> <sect1 id="features.safe-mode.functions"> <title>Îãðàíè÷åííûå èëè íåäîñòóïíûå â çàùèùåííîì ðåæèìå ôóíêöèè</title> <para> Íèæå ïðèâåäåí, âåðîÿòíî, íåïîëíûé è, âîçìîæíî, íå âïîëíå êîððåêòíûé ñïèñîê ôóíêöèé, îãðàíè÷åííûõ â <link linkend="features.safe-mode">çàùèùåííîì ðåæèìå</link>. <!-- TODO: add ¬e.sm.*; to the functions mentioned here. That entity should link to this section --> <table> <title>Ôóíêöèè, îãðàíè÷åííûå â áåçîïàñíîì ðåæèìå</title> <tgroup cols="2"> <thead> <row> <entry>Ôóíêöèÿ</entry> <entry>Îãðàíè÷åíèÿ</entry> </row> </thead> <tbody> <row> <entry><function>dbmopen</function></entry> <entry>&sm.uidcheck;</entry> </row> <row> <entry><function>dbase_open</function></entry> <entry>&sm.uidcheck;</entry> </row> <row> <entry><function>filepro</function></entry> <entry>&sm.uidcheck;</entry> </row> <row> <entry><function>filepro_rowcount</function></entry> <entry>&sm.uidcheck;</entry> </row> <row> <entry><function>filepro_retrieve</function></entry> <entry>&sm.uidcheck;</entry> </row> <row> <entry>ifx_*</entry> <entry>sql_safe_mode îãðàíè÷åíèÿ (íå ïóòàòü ñ safe_mode)</entry> <!-- TODO: more info on sql-safe-mode --> </row> <row> <entry>ingres_*</entry> <entry>sql_safe_mode îãðàíè÷åíèÿ (íå ïóòàòü ñ safe_mode)</entry> <!-- TODO: more info on sql-safe-mode --> </row> <row> <entry>mysql_*</entry> <entry>sql_safe_mode îãðàíè÷åíèÿ (íå ïóòàòü ñ safe_mode)</entry> <!-- TODO: more info on sql-safe-mode --> </row> <row> <entry><function>pg_lo_import</function></entry> <entry>&sm.uidcheck;</entry> <!-- source TODO: there is no PHP-warning for that safe-mode-restriction --> </row> <row> <entry><function>posix_mkfifo</function></entry> <entry>&sm.uidcheck.dir;</entry> </row> <row> <entry><function>putenv</function></entry> <entry>Ïîä÷èíÿåòñÿ íàñòðîéêàì the safe_mode_protected_env_vars è safe_mode_allowed_env_vars. Îçíàêîìüòåñü ñ áîëåå ïîäðîáíûì îïèñàíèåì ôóíêöèè <function>putenv</function>.</entry> <!-- TODO: document those directives in chapters/config.xml --> </row> <row> <entry><function>move_uploaded_file</function></entry> <entry>&sm.uidcheck; <!-- TODO: check this --></entry> </row> <!-- TODO: from here on, add warning to the function itself --> <row> <entry><function>chdir</function></entry> <entry>&sm.uidcheck.dir;</entry> </row> <row> <entry><function>dl</function></entry> <entry>&sm.disabled;</entry> </row> <row> <entry><link linkend="language.operators.execution">backtick operator</link></entry> <entry>&sm.disabled;</entry> </row> <row> <entry><function>shell_exec</function> (functional equivalent of backticks)</entry> <entry>&sm.disabled;</entry> </row> <row> <entry><function>exec</function></entry> <entry>Âû ìîæåòå çàïóñêàòü èñïîëíÿåìûå ôàéëû, îãðàíè÷åííûå äåðåâîì êàòàëîãîâ, óêàçàííûì â <link linkend="ini.safe-mode-exec-dir">safe_mode_exec_dir</link>. Èñõîäÿ èç ïðàêòè÷åñêèõ ñîîáðàæåíèé, èñïîëüçîâàòü <literal>..</literal> ïðè óêàçàíèè ïóòè çàïðåùåíî. </entry> </row> <row> <entry><function>system</function></entry> <entry>Âû ìîæåòå çàïóñêàòü èñïîëíÿåìûå ôàéëû, îãðàíè÷åííûå äåðåâîì êàòàëîãîâ, óêàçàííûì â <link linkend="ini.safe-mode-exec-dir">safe_mode_exec_dir</link>. Èñõîäÿ èç ïðàêòè÷åñêèõ ñîîáðàæåíèé, èñïîëüçîâàòü <literal>..</literal> ïðè óêàçàíèè ïóòè çàïðåùåíî. </entry> </row> <row> <entry><function>passthru</function></entry> <entry>Âû ìîæåòå çàïóñêàòü èñïîëíÿåìûå ôàéëû, îãðàíè÷åííûå äåðåâîì êàòàëîãîâ, óêàçàííûì â <link linkend="ini.safe-mode-exec-dir">safe_mode_exec_dir</link>. Èñõîäÿ èç ïðàêòè÷åñêèõ ñîîáðàæåíèé, èñïîëüçîâàòü <literal>..</literal> ïðè óêàçàíèè ïóòè çàïðåùåíî. </entry> </row> <row> <entry><function>popen</function></entry> <entry>Âû ìîæåòå çàïóñêàòü èñïîëíÿåìûå ôàéëû, îãðàíè÷åííûå äåðåâîì êàòàëîãîâ, óêàçàííûì â <link linkend="ini.safe-mode-exec-dir">safe_mode_exec_dir</link>. Èñõîäÿ èç ïðàêòè÷åñêèõ ñîîáðàæåíèé, èñïîëüçîâàòü <literal>..</literal> ïðè óêàçàíèè ïóòè çàïðåùåíî. </entry> <!-- TODO: not sure. popen uses a completely different implementation Don't know why, don't know whether it's behaving the same --> </row> <row> <entry><function>fopen</function></entry> <entry>&sm.uidcheck.dir;</entry> </row> <row> <entry><function>mkdir</function></entry> <entry>&sm.uidcheck.dir;</entry> </row> <row> <entry><function>rmdir</function></entry> <entry>&sm.uidcheck.dir;</entry> </row> <row> <entry><function>rename</function></entry> <entry>&sm.uidcheck; &sm.uidcheck.dir;<!-- on the old name only, it seems. Is rename preventing moving files? --></entry> </row> <row> <entry><function>unlink</function></entry> <entry>&sm.uidcheck; &sm.uidcheck.dir;</entry> </row> <row> <entry><function>copy</function></entry> <entry>&sm.uidcheck; &sm.uidcheck.dir; (Äëÿ ïàðàìåòðîâ <parameter>source</parameter> è <parameter>target</parameter>). </entry> </row> <row> <entry><function>chgrp</function></entry> <entry>&sm.uidcheck;</entry> </row> <row> <entry><function>chown</function></entry> <entry>&sm.uidcheck;</entry> </row> <row> <entry><function>chmod</function></entry> <entry>&sm.uidcheck; Êðîìå òîãî, âû íå ìîæåòå óñòàíàâëèâàòü UID, SGID è sticky-áèòû.</entry> </row> <row> <entry><function>touch</function></entry> <entry>&sm.uidcheck; &sm.uidcheck.dir;</entry> </row> <row> <entry><function>symlink</function></entry> <entry>&sm.uidcheck; &sm.uidcheck.dir; (Çàìå÷àíèå: ïðîâåðêà âûïîëíÿåòñÿ òîëüêî äëÿ ïàðàìåòðà <parameter>target</parameter>) </entry> </row> <row> <entry><function>link</function></entry> <entry>&sm.uidcheck; &sm.uidcheck.dir; (Çàìå÷àíèå: ïðîâåðêà âûïîëíÿåòñÿ òîëüêî äëÿ ïàðàìåòðà <parameter>target</parameter>) </entry> </row> <row> <entry><function>apache_request_headers</function></entry> <entry> çàùèùåííîì ðåæèìå, çàãîëîâêè, íà÷èíàþùèåñÿ ñ 'authorization' (íåçàâèñèìî îò ðåãèñòðà), íå âîçâðàùàþòñÿ.</entry> </row> <row> <entry><function>header</function></entry> <entry> çàùèùåííîì ðåæèìå, òåêóùèé UID ñêðèïòà áóäåò äîáàâëåí ê <literal>realm</literal>-÷àñòè çàãîëîâêà <literal>WWW-Authenticate</literal>, åñëè âû åãî óñòàíàâëèâàåòå (èñïîëüçóåòñÿ äëÿ HTTP-àóòåíòèôèêàöèè)</entry> </row> <row> <entry><link linkend="features.http-auth">ïåðåìåííûå PHP_AUTH</link></entry> <entry>  çàùèùåííîì ðåæèìå, ïåðåìåííûå <varname>PHP_AUTH_USER</varname>, <varname>PHP_AUTH_PW</varname>, è <varname>AUTH_TYPE</varname> íåäîñòóïíû êàê ýëåìåíòû ìàññèâà <varname>$_SERVER</varname>. Íåñìîòðÿ íà ýòî, âû âñå åùå ìîæåòå èñïîëüçîâàòü ïåðåìåííóþ <varname>REMOTE_USER</varname> äëÿ èäåíòèôèêàöèè ïîëüçîâàòåëÿ. (Çàìå÷àíèå: àêòóàëüíî òîëüêî äëÿ PHP 4.3.0 è âûøå) </entry> </row> <row> <entry> <function>highlight_file</function>, <function>show_source</function> </entry> <entry> &sm.uidcheck; &sm.uidcheck.dir; (Çàìå÷àíèå: àêòóàëüíî òîëüêî äëÿ PHP 4.2.1 è âûøå) </entry> </row> <row> <entry> <function>parse_ini_file</function> </entry> <entry> &sm.uidcheck; &sm.uidcheck.dir; (Çàìå÷àíèå: àêòóàëüíî òîëüêî äëÿ PHP 4.2.1 è âûøå) </entry> </row> <row> <entry> <function>set_time_limit</function> </entry> <entry> Íå èìååò íèêàêîãî ýôôåêòà, åñëè &safemode; èñïîëüçóåòñÿ </entry> </row> <row> <entry> <link linkend="ini.max-execution-time">max_execution_time</link> </entry> <entry> Íå èìååò íèêàêîãî ýôôåêòà, åñëè &safemode; èñïîëüçóåòñÿ </entry> </row> <row> <entry> <function>mail</function> </entry> <entry>  çàùèùåííîì ðåæèìå ïÿòûé ïàðàìåòð íåäîñòóïåí. (Çàìå÷àíèå: àêòóàëüíî òîëüêî äëÿ PHP 4.2.3 è âûøå) </entry> </row> <row> <entry>Ëþáàÿ ôóíêöèÿ, êîòîðàÿ èñïîëüçóåò <filename>php4/main/fopen_wrappers.c</filename> </entry> <entry>Âðåìåííî íå äîêóìåíòèðîâàíî</entry> </row> </tbody> </tgroup> </table> </para> </sect1> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
http://cvs.php.net/co.php/phpdoc-ru/features/safe-mode.xml?r=1.1&p=1 Index: phpdoc-ru/features/safe-mode.xml +++ phpdoc-ru/features/safe-mode.xml <?xml version="1.0" encoding="windows-1251"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.49 Maintainer: young Status: ready --> <chapter id="features.safe-mode"> <title>Çàùèùåííûé ðåæèì</title> <para> Çàùèùåííûé ðåæèì â PHP - ýòî ïîïûòêà ðåøèòü ïðîáëåìó áåçîïàñíîñòè íà ñîâìåñòíî èñïîëüçóåìûõ ñåðâåðàõ. Íåñìîòðÿ íà òî, ÷òî êîíöåïòóàëüíî íåâåðíî ðåøàòü ýòó ïðîáëåìó íà óðîâíå PHP, íî ïîñêîëüêó àëüòåðíàòèâû óðîâíÿ âåá-ñåðâåðà èëè îïåðàöèîííîé ñèñòåìû íà ñåãîäíÿøíèé äåíü îòñóòñòâóþò, ìíîãèå ïîëüçîâàòåëè, îñîáåííî ïðîâàéäåðû, èñïîëüçóþò èìåííî çàùèùåííûé ðåæèì. </para> <sect1 id="ini.sect.safe-mode"> <title>Áåçîïàñíîñòü è çàùèùåííûé ðåæèì</title> <para> <table> <title>Êîíôèãóðàöèîííûå îïöèè, óïðàâëÿþùèå çàùèùåííûì ðåæèìîì è âîïðîñàìè áåçîïàñíîñòè</title> <tgroup cols="3"> <thead> <row> <entry>Èìÿ</entry> <entry>Çíà÷åíèå ïî óìîë÷àíèþ</entry> <entry>Èçìåíÿåìîñòü</entry> </row> </thead> <tbody> <row> <entry>safe_mode</entry> <entry>"0"</entry> <entry>PHP_INI_SYSTEM</entry> </row> <row> <entry>safe_mode_gid</entry> <entry>"0"</entry> <entry>PHP_INI_SYSTEM</entry> </row> <row> <entry>safe_mode_include_dir</entry> <entry>NULL</entry> <entry>PHP_INI_SYSTEM</entry> </row> <row> <entry>safe_mode_exec_dir</entry> <entry>""</entry> <entry>PHP_INI_SYSTEM</entry> </row> <row> <entry>safe_mode_allowed_env_vars</entry> <entry>PHP_</entry> <entry>PHP_INI_SYSTEM</entry> </row> <row> <entry>safe_mode_protected_env_vars</entry> <entry>LD_LIBRARY_PATH</entry> <entry>PHP_INI_SYSTEM</entry> </row> <row> <entry>open_basedir</entry> <entry>NULL</entry> <entry>PHP_INI_SYSTEM</entry> </row> <row> <entry>disable_functions</entry> <entry>""</entry> <entry>PHP_INI_SYSTEM</entry> </row> <row> <entry>disable_classes</entry> <entry>""</entry> <entry>PHP_INI_SYSTEM</entry> </row> </tbody> </tgroup> </table> Äëÿ ïîëó÷åíèÿ áîëåå äåòàëüíîé èíôîðìàöèè î êîíñòàíòàõ âèäà PHP_INI_* îçíàêîìüòåñü ñ ôóíêöèåé <function>ini_set</function>. </para> &ini.descriptions.title; <para> <variablelist> <varlistentry id="ini.safe-mode"> <term> <parameter>safe_mode</parameter> <type>boolean</type> </term> <listitem> <para> Âêëþ÷àåò/îòêëþ÷àåò çàùèùåííûé ðåæèì â PHP. Äëÿ ïîëó÷åíèÿ áîëåå äåòàëüíîé èíôîðìàöèè îçíàêîìüòåñü ñ ðàçäåëîì <link linkend="security.index">Áåçîïàñíîñòü</link>. </para> </listitem> </varlistentry> <varlistentry id="ini.safe-mode-gid"> <term> <parameter>safe_mode_gid</parameter> <type>boolean</type> </term> <listitem> <para> Ïî óìîë÷àíèþ â çàùèùåííîì ðåæèìå ïðè îòêðûòèè ôàéëà âûïîëíÿåòñÿ ïðîâåðêà çíà÷åíèÿ UID. Äëÿ òîãî, ÷òîáû íåìíîãî ñìÿã÷èòü ýòî óñëîâèå è âûïîëíÿòü ïðîâåðêó GID, íåîáõîäèìî óñòàíîâèòü çíà÷åíèå on äëÿ ôëàãà safe_mode_gid. Îïðåäåëÿåò, èñïîëüçîâàòü èëè íåò ïðîâåðêó <literal>UID</literal> (&false;) èëè <literal>GID</literal> (&true;) ïðîâåðêó ïðè îáðàùåíèè ê ôàéëó. </para> </listitem> </varlistentry> <varlistentry id="ini.safe-mode-include-dir"> <term> <parameter>safe_mode_include_dir</parameter> <type>string</type> </term> <listitem> <para> Ïðè ïîäêëþ÷åíèè ôàéëîâ, ðàñïîëîæåííûõ â óêàçàííîé äèðåêòîðèè è âñåõ åå ïîäêàòàëîãàõ, ïðîâåðêà íà ñîîòâåòñòâèå çíà÷åíèé <literal>UID</literal>/<literal>GID</literal> íå âûïîëíÿåòñÿ ( ñëó÷àå, åñëè óñòàíîâëåííàÿ äèðåêòîðèÿ íå óêàçàíà â <link linkend="ini.include-path">include_path</link>, íåîáõîäèìî óêàçûâàòü ïîëíûé ïóòü ïðè âêëþ÷åíèè). </para> <simpara> Íà÷èíàÿ ñ PHP 4.2.0 çíà÷åíèåì ýòîé äèðåêòèâû ìîæåò áûòü ñïèñîê êàòàëîãîâ, ðàçäåëåííûõ äâîåòî÷èåì (òî÷êîé ñ çàïÿòîé íà windows-ñèñòåìàõ), ÷òî àíàëîãè÷íî ñèíòàêñèñó <link linkend="ini.include-path">include_path</link>. </simpara> <simpara> Óêàçàííîå çíà÷åíèå â äåéñòâèòåëüíîñòè ÿâëÿåòñÿ ïðåôèêñîì, à íå íàçâàíèåì äèðåêòîðèè. Ýòî îçíà÷àåò, ÷òî çàïèñü "safe_mode_include_dir = /dir/incl" ïîçâîëÿåò ïîäêëþ÷àòü ôàéëû, íàõîäÿùèåñÿ â äèðåêòîðèÿõ "/dir/include" è "/dir/incls", â ñëó÷àå, åñëè îíè ñóùåñòâóþò. Åñëè âû õîòèòå óêàçàòü äîñòóï ê êîíêðåòíîé äèðåêòîðèè, èñïîëüçóéòå çàâåðøàþùèé ñëåø, íàïðèìåð: "safe_mode_include_dir = /dir/incl/". </simpara> </listitem> </varlistentry> <varlistentry id="ini.safe-mode-exec-dir"> <term> <parameter>safe_mode_exec_dir</parameter> <type>string</type> </term> <listitem> <para>  ñëó÷àå, êîãäà PHP ðàáîòàåò â çàùèùåííîì ðåæèìå, <function>system</function> è äðóãèå <link linkend="ref.exec">ôóíêöèè äëÿ âûïîëíåíèÿ ñèñòåìíûõ êîìàíä è ïðîãðàìì</link> îòêëîíÿþò âûïîëíåíèå ïðîãðàìì, íàõîäÿùèõñÿ âñå äàííîé äèðåêòîðèè. </para> </listitem> </varlistentry> <varlistentry id="ini.safe-mode-allowed-env-vars"> <term> <parameter>safe_mode_allowed_env_vars</parameter> <type>string</type> </term> <listitem> <para> Âîçìîæíîñòü óñòàíàâëèâàòü ïåðåìåííûå îêðóæåíèÿ - ïîòåíöèàëüíàÿ áðåøü â áåçîïàñíîñòè. Çíà÷åíèåì ýòîé äèðåêòèâû ÿâëÿåòñÿ ñïèñîê ïðåôèêñîâ, ðàçäåëåííûõ äâîåòî÷èÿìè.  çàùèùåííîì ðåæèìå ïîëüçîâàòåëü ìîæåò ìîäèôèöèðîâàòü òîëüêî òå ïåðåìåííûå îêðóæåíèÿ, èìåíà êîòîðûõ íà÷èíàþòñÿ ñ îäíîãî èç óêàçàííûõ ïðåôèêñîâ. Ïî óìîë÷àíèþ, ïîëüçîâàòåëþ äîñòóïíû ïåðåìåííûå, êîòîðûå íà÷èíàþòñÿ ñ ïðåôèêñà PHP_ (íàïðèìåð, PHP_FOO=BAR). </para> <note> <para>  ñëó÷àå, åñëè ýòîé äèðåêòèâå óêàçàòü ïóñòîå çíà÷åíèå, ïîëüçîâàòåëü ïîëó÷èò âîçìîæíîñòü ìîäèôèöèðîâàòü ëþáóþ ïåðåìåííóþ îêðóæåíèÿ! </para> </note> </listitem> </varlistentry> <varlistentry id="ini.safe-mode-protected-env-vars"> <term> <parameter>safe_mode_protected_env_vars</parameter> <type>string</type> </term> <listitem> <para> Ýòà äèðåêòèâà ñîäåðæèò ñïèñîê ïåðåìåííûõ îêðóæåíèÿ, ðàçäåëåííûõ äâîåòî÷èåì, çíà÷åíèå êîòîðûõ ïîëüçîâàòåëü íå ñìîæåò èçìåíèòü, èñïîëüçóÿ ôóíêöèþ <function>putenv</function>. Çíà÷åíèÿ ýòèõ ïåðåìåííûõ îñòàþòñÿ çàùèùåííûìè, äàæå åñëè èõ ìîäèôèêàöèÿ ðàçðåøåíà äèðåêòèâîé safe_mode_allowed_env_vars. </para> </listitem> </varlistentry> <varlistentry id="ini.open-basedir"> <term> <parameter>open_basedir</parameter> <type>string</type> </term> <listitem> <para> Îãðàíè÷èâàåò ñïèñîê ôàéëîâ, êîòîðûå ìîãóò áûòü îòêðûòû â PHP, óêàçàííûì äåðåâîì äèðåêòîðèé <emphasis>íåçàâèñèìî</emphasis> îò òîãî, èñïîëüçóåòñÿ çàùèùåííûé ðåæèì èëè íåò. </para> <para> Êàæäûé ðàç, êîãäà ñêðèïò ïûòàåòñÿ îòêðûòü ôàéë, íàïðèìåð, ïðè ïîìîùè ôóíêöèè <function>fopen</function> èëè <function>gzopen</function>, ïðîâåðÿåòñÿ ìåñòîðàñïîëîæåíèå ôàéëà.  ñëó÷àå, åñëè îí íàõîäèòñÿ âíå óêàçàííîãî äåðåâà äèðåêòîðèé, PHP îòêàçûâàåò â îòêðûòèÿ ôàéëà. Âñå ñèìâîëè÷åñêèå ññûëêè ðàñïîçíàþòñÿ è ïðåîáðàçóþòñÿ, ïîýòîìó îáîéòè ýòî îãðàíè÷åíèå ïðè ïîìîùè ñèìâîëè÷åñêèõ ññûëîê íåâîçìîæíî. </para> <para> Ñïåöèàëüíîå çíà÷åíèå <systemitem class="constant">.</systemitem> óêàçûâàåò, ÷òî áàçîâîé ñëåäóåò ñ÷èòàòü äèðåêòîðèþ, â êîòîðîé ðàñïîëîæåí ñàì ñêðèïò. </para> <para> Äëÿ Windows-ñèñòåì ðàçäåëèòåëåì ñïèñêà äèðåêòîðèé ñëóæèò òî÷êà ñ çàïÿòîé. Äëÿ âñåõ äðóãèõ îïåðàöèîííûõ ñèñòåì â êà÷åñòâå ðàçäåëèòåëÿ èñïîëüçóåòñÿ äâîåòî÷èå.  ñëó÷àå, åñëè PHP ðàáîòàåò êàê ìîäóëü âåá-ñåðâåðà Apache, âñå óêàçàíèÿ open_basedir äëÿ ðîäèòåëüñêèõ äèðåêòîðèé íàñëåäóþòñÿ. </para> <para> Óêàçàííîå çíà÷åíèå â äåéñòâèòåëüíîñòè ÿâëÿåòñÿ ïðåôèêñîì, à íå íàçâàíèåì äèðåêòîðèè. Ýòî îçíà÷àåò, ÷òî çàïèñü "safe_mode_include_dir = /dir/incl" ïîçâîëÿåò îòêðûâàòü ôàéëû, íàõîäÿùèåñÿ â äèðåêòîðèÿõ "/dir/include" è "/dir/incls", â ñëó÷àå, åñëè îíè ñóùåñòâóþò. Åñëè âû õîòèòå óêàçàòü äîñòóï ê êîíêðåòíîé äèðåêòîðèè, èñïîëüçóéòå çàâåðøàþùèé ñëåø, íàïðèìåð: "safe_mode_include_dir = /dir/incl/". </para> <note> <para> Âîçìîæíîñòü ðàáîòû ñ íåñêîëüêèìè äèðåêòîðèÿìè äîáàâëåíà â âåðñèè 3.0.7. </para> </note> <para> Ïî óìîë÷àíèþ ðàçðåøåí äîñòóï êî âñåì ôàéëàì. </para> </listitem> </varlistentry> <varlistentry id="ini.disable-functions"> <term> <parameter>disable_functions</parameter> <type>string</type> </term> <listitem> <simpara> Ýòà äèðåêòèâà ïîçâîëÿåò âàì çàïðåòèòü íåêîòîðûå ôóíêöèè èç ñîîáðàæåíèé <link linkend="security.index">áåçîïàñíîñòè</link>.  êà÷åñòâå çíà÷åíèÿ îíà ïðèíèìàåò ñïèñîê ôóíêöèé, ðàçäåëåííûõ äâîåòî÷èåì. disable_functions íå çàâèñèò îò òîãî, èñïîëüçóåòñÿ <link linkend="ini.safe-mode">Çàùèùåííûé ðåæèì</link> èëè íåò. </simpara> <simpara> Ýòà äèðåêòèâà äîëæíà áûòü óêàçàíà â &php.ini;. Âû íå ìîæåòå èñïîëüçîâàòü åå, íàïðèìåð, â &httpd.conf;. </simpara> </listitem> </varlistentry> <varlistentry id="ini.disable-classes"> <term> <parameter>disable_classes</parameter> <type>string</type> </term> <listitem> <simpara> Ýòà äèðåêòèâà ïîçâîëÿåò âàì çàïðåòèòü íåêîòîðûå êëàññû èç ñîîáðàæåíèé <link linkend="security.index">áåçîïàñíîñòè</link>.  êà÷åñòâå çíà÷åíèÿ îíà ïðèíèìàåò ñïèñîê êëàñîâ, ðàçäåëåííûõ äâîåòî÷èåì. disable_classes íå çàâèñèò îò òîãî, èñïîëüçóåòñÿ <link linkend="ini.safe-mode">Çàùèùåííûé ðåæèì</link> èëè íåò. </simpara> <simpara> Ýòà äèðåêòèâà äîëæíà áûòü óêàçàíà â &php.ini;. Âû íå ìîæåòå èñïîëüçîâàòü åå, íàïðèìåð, â &httpd.conf;. </simpara> <note> <para> Ýòà äèðåêòèâà äîñòóïíà, íà÷èíàÿ ñ PHP 4.3.2 </para> </note> </listitem> </varlistentry> </variablelist> </para> <para> Îçíàêîìüòåñü òàêæå ñî ñëåäóþùèìè êîíôèãóðàöèîííûìè äèðåêòèâàìè: <link linkend="ini.register-globals">register_globals</link>, <link linkend="ini.display-errors">display_errors</link>, è <link linkend="ini.log-errors">log_errors</link> </para> <para>  ñëó÷àå, åñëè äèðåêòèâà <link linkend="ini.safe-mode">safe_mode</link> óñòàíîâëåíà çíà÷åíèåì on, PHP ïðîâåðèò, ñîâïàäàåò ëè âëàäåëåö ñêðèïòà è âëàäåëåö ôàéëà, êîòîðûì îïåðèðóåò ñêðèïò. Íàïðèìåð: <programlisting role="ls"> <![CDATA[ -rw-rw-r-- 1 rasmus rasmus 33 Jul 1 19:20 script.php -rw-r--r-- 1 root root 1116 May 26 18:01 /etc/passwd ]]> </programlisting> âûïîëíèå ñðèïòà script.php <programlisting role="php"> <![CDATA[ <?php readfile('/etc/passwd'); ?> ]]> </programlisting> â ñëó÷àå èñïîëüçîâàíèÿ çàùèùåííîãî ðåæèìà ïðèâîäèò ê ñëåäóþùåé îøèáêå: <screen> <![CDATA[ Warning: SAFE MODE Restriction in effect. The script whose uid is 500 is not allowed to access /etc/passwd owned by uid 0 in /docroot/script.php on line 2 ]]> </screen> </para> <para> Òåì íå ìåíåå, ïðåäóñìîòðåíà âîçìîæíîñòü âìåñòî ïðîâåðêè íà ñîîòâåòñòâèå <literal>UID</literal> èñïîëüçîâàòü áîëåå ìÿãêóþ ïðîâåðêó íà ñîîòâåòñòâèå <literal>GID</literal>. Äëÿ ýòîãî íåîáõîäèìî èñïîëüçîâàòü äèðåêòèâó <link linkend="ini.safe-mode-gid">safe_mode_gid</link>.  ñëó÷àå, åñëè îíà óñòàíîâëåíà çíà÷åíèåì <literal>On</literal>, èñïîëüçóåòñÿ áîëåå ìÿãêàÿ ïðîâåðêà <literal>GID</literal>.  ïðîòèâíîì ñëó÷àå, åñëè óñòàíîâëåíî çíà÷åíèå <literal>Off</literal> (çíà÷åíèå ïî óìîë÷àíèþ), âûïîëíÿåòñÿ áîëåå ñòðîãàÿ ïðîâåðêà íà ñîîòâåòñòâèå <literal>UID</literal>. </para> <para>  êà÷åñòâå àëüòåðíàòèâû äèðåêòèâå <link linkend="ini.safe-mode">safe_mode</link> âû ìîæåòå îãðàíè÷èòü âñå âûïîëíÿåìûå ñêðèïòû æåñòêî çàäàííûì äåðåâîì äèðåêòîðèé ïðè ïîìîùè îïöèè <link linkend="ini.open-basedir">open_basedir</link>. Íàïðèìåð (ôðàãìåíò êîíôèãóðàöèîííîãî ôàéëà &httpd.conf;): <programlisting role="ini"> <![CDATA[ <Directory /docroot> php_admin_value open_basedir /docroot </Directory> ]]> </programlisting> Ïðè ïîïûòêå âûïîëíèòü òîò æå ñàìûé ñêðèïò script.php ñ óêàçàííîé îïöèåé <link linkend="ini.open-basedir">open_basedir</link> âû ïîëó÷èòå ñëåäóþùèé ðåçóëüòàò: <screen> <![CDATA[ Warning: open_basedir restriction in effect. File is in wrong directory in /docroot/script.php on line 2 ]]> </screen> </para> <para> Âû òàêæå ìîæåòå çàïðåòèòü îòäåëüíûå ôóíêöèè. Ñëåäóåò çàìåòèòü, ÷òî äèðåêòèâà <link linkend="ini.disable-functions">disable_functions</link> ìîæåò áûòü óêàçàíà èñêëþ÷èòåëüíî â êîíôèãóðàöèîííîì ôàéëå &php.ini;, ýòî îçíà÷àåò, ÷òî âû íå ìîæåòå, îòðåäàêòèðîâàâ &httpd.conf;, óñòàíîâèòü èíäèâèäóàëüíûå çíà÷åíèÿ äëÿ êîíêðåòíîãî âèðòóàëüíîãî õîñòà èëè êàòàëîãà. Åñëè äîáàâèòü â &php.ini; ñëåäóþùóþ ñòðîêó: <programlisting role="ini"> <![CDATA[ disable_functions readfile,system ]]> </programlisting> Ðåçóëüòàòîì ðàáîòû ñêðèïòà áóäåò ñëåäóþùèé âûâîä: <screen> <![CDATA[ Warning: readfile() has been disabled for security reasons in /docroot/script.php on line 2 ]]> </screen> </para> </sect1> <sect1 id="features.safe-mode.functions"> <title>Îãðàíè÷åííûå èëè íåäîñòóïíûå â çàùèùåííîì ðåæèìå ôóíêöèè</title> <para> Íèæå ïðèâåäåí, âåðîÿòíî, íåïîëíûé è, âîçìîæíî, íå âïîëíå êîððåêòíûé ñïèñîê ôóíêöèé, îãðàíè÷åííûõ â <link linkend="features.safe-mode">çàùèùåííîì ðåæèìå</link>. <!-- TODO: add ¬e.sm.*; to the functions mentioned here. That entity should link to this section --> <table> <title>Ôóíêöèè, îãðàíè÷åííûå â áåçîïàñíîì ðåæèìå</title> <tgroup cols="2"> <thead> <row> <entry>Ôóíêöèÿ</entry> <entry>Îãðàíè÷åíèÿ</entry> </row> </thead> <tbody> <row> <entry><function>dbmopen</function></entry> <entry>&sm.uidcheck;</entry> </row> <row> <entry><function>dbase_open</function></entry> <entry>&sm.uidcheck;</entry> </row> <row> <entry><function>filepro</function></entry> <entry>&sm.uidcheck;</entry> </row> <row> <entry><function>filepro_rowcount</function></entry> <entry>&sm.uidcheck;</entry> </row> <row> <entry><function>filepro_retrieve</function></entry> <entry>&sm.uidcheck;</entry> </row> <row> <entry>ifx_*</entry> <entry>sql_safe_mode îãðàíè÷åíèÿ (íå ïóòàòü ñ safe_mode)</entry> <!-- TODO: more info on sql-safe-mode --> </row> <row> <entry>ingres_*</entry> <entry>sql_safe_mode îãðàíè÷åíèÿ (íå ïóòàòü ñ safe_mode)</entry> <!-- TODO: more info on sql-safe-mode --> </row> <row> <entry>mysql_*</entry> <entry>sql_safe_mode îãðàíè÷åíèÿ (íå ïóòàòü ñ safe_mode)</entry> <!-- TODO: more info on sql-safe-mode --> </row> <row> <entry><function>pg_lo_import</function></entry> <entry>&sm.uidcheck;</entry> <!-- source TODO: there is no PHP-warning for that safe-mode-restriction --> </row> <row> <entry><function>posix_mkfifo</function></entry> <entry>&sm.uidcheck.dir;</entry> </row> <row> <entry><function>putenv</function></entry> <entry>Ïîä÷èíÿåòñÿ íàñòðîéêàì the safe_mode_protected_env_vars è safe_mode_allowed_env_vars. Îçíàêîìüòåñü ñ áîëåå ïîäðîáíûì îïèñàíèåì ôóíêöèè <function>putenv</function>.</entry> <!-- TODO: document those directives in chapters/config.xml --> </row> <row> <entry><function>move_uploaded_file</function></entry> <entry>&sm.uidcheck; <!-- TODO: check this --></entry> </row> <!-- TODO: from here on, add warning to the function itself --> <row> <entry><function>chdir</function></entry> <entry>&sm.uidcheck.dir;</entry> </row> <row> <entry><function>dl</function></entry> <entry>&sm.disabled;</entry> </row> <row> <entry><link linkend="language.operators.execution">backtick operator</link></entry> <entry>&sm.disabled;</entry> </row> <row> <entry><function>shell_exec</function> (functional equivalent of backticks)</entry> <entry>&sm.disabled;</entry> </row> <row> <entry><function>exec</function></entry> <entry>Âû ìîæåòå çàïóñêàòü èñïîëíÿåìûå ôàéëû, îãðàíè÷åííûå äåðåâîì êàòàëîãîâ, óêàçàííûì â <link linkend="ini.safe-mode-exec-dir">safe_mode_exec_dir</link>. Èñõîäÿ èç ïðàêòè÷åñêèõ ñîîáðàæåíèé, èñïîëüçîâàòü <literal>..</literal> ïðè óêàçàíèè ïóòè çàïðåùåíî. </entry> </row> <row> <entry><function>system</function></entry> <entry>Âû ìîæåòå çàïóñêàòü èñïîëíÿåìûå ôàéëû, îãðàíè÷åííûå äåðåâîì êàòàëîãîâ, óêàçàííûì â <link linkend="ini.safe-mode-exec-dir">safe_mode_exec_dir</link>. Èñõîäÿ èç ïðàêòè÷åñêèõ ñîîáðàæåíèé, èñïîëüçîâàòü <literal>..</literal> ïðè óêàçàíèè ïóòè çàïðåùåíî. </entry> </row> <row> <entry><function>passthru</function></entry> <entry>Âû ìîæåòå çàïóñêàòü èñïîëíÿåìûå ôàéëû, îãðàíè÷åííûå äåðåâîì êàòàëîãîâ, óêàçàííûì â <link linkend="ini.safe-mode-exec-dir">safe_mode_exec_dir</link>. Èñõîäÿ èç ïðàêòè÷åñêèõ ñîîáðàæåíèé, èñïîëüçîâàòü <literal>..</literal> ïðè óêàçàíèè ïóòè çàïðåùåíî. </entry> </row> <row> <entry><function>popen</function></entry> <entry>Âû ìîæåòå çàïóñêàòü èñïîëíÿåìûå ôàéëû, îãðàíè÷åííûå äåðåâîì êàòàëîãîâ, óêàçàííûì â <link linkend="ini.safe-mode-exec-dir">safe_mode_exec_dir</link>. Èñõîäÿ èç ïðàêòè÷åñêèõ ñîîáðàæåíèé, èñïîëüçîâàòü <literal>..</literal> ïðè óêàçàíèè ïóòè çàïðåùåíî. </entry> <!-- TODO: not sure. popen uses a completely different implementation Don't know why, don't know whether it's behaving the same --> </row> <row> <entry><function>fopen</function></entry> <entry>&sm.uidcheck.dir;</entry> </row> <row> <entry><function>mkdir</function></entry> <entry>&sm.uidcheck.dir;</entry> </row> <row> <entry><function>rmdir</function></entry> <entry>&sm.uidcheck.dir;</entry> </row> <row> <entry><function>rename</function></entry> <entry>&sm.uidcheck; &sm.uidcheck.dir;<!-- on the old name only, it seems. Is rename preventing moving files? --></entry> </row> <row> <entry><function>unlink</function></entry> <entry>&sm.uidcheck; &sm.uidcheck.dir;</entry> </row> <row> <entry><function>copy</function></entry> <entry>&sm.uidcheck; &sm.uidcheck.dir; (Äëÿ ïàðàìåòðîâ <parameter>source</parameter> è <parameter>target</parameter>). </entry> </row> <row> <entry><function>chgrp</function></entry> <entry>&sm.uidcheck;</entry> </row> <row> <entry><function>chown</function></entry> <entry>&sm.uidcheck;</entry> </row> <row> <entry><function>chmod</function></entry> <entry>&sm.uidcheck; Êðîìå òîãî, âû íå ìîæåòå óñòàíàâëèâàòü UID, SGID è sticky-áèòû.</entry> </row> <row> <entry><function>touch</function></entry> <entry>&sm.uidcheck; &sm.uidcheck.dir;</entry> </row> <row> <entry><function>symlink</function></entry> <entry>&sm.uidcheck; &sm.uidcheck.dir; (Çàìå÷àíèå: ïðîâåðêà âûïîëíÿåòñÿ òîëüêî äëÿ ïàðàìåòðà <parameter>target</parameter>) </entry> </row> <row> <entry><function>link</function></entry> <entry>&sm.uidcheck; &sm.uidcheck.dir; (Çàìå÷àíèå: ïðîâåðêà âûïîëíÿåòñÿ òîëüêî äëÿ ïàðàìåòðà <parameter>target</parameter>) </entry> </row> <row> <entry><function>apache_request_headers</function></entry> <entry> çàùèùåííîì ðåæèìå, çàãîëîâêè, íà÷èíàþùèåñÿ ñ 'authorization' (íåçàâèñèìî îò ðåãèñòðà), íå âîçâðàùàþòñÿ.</entry> </row> <row> <entry><function>header</function></entry> <entry> çàùèùåííîì ðåæèìå, òåêóùèé UID ñêðèïòà áóäåò äîáàâëåí ê <literal>realm</literal>-÷àñòè çàãîëîâêà <literal>WWW-Authenticate</literal>, åñëè âû åãî óñòàíàâëèâàåòå (èñïîëüçóåòñÿ äëÿ HTTP-àóòåíòèôèêàöèè)</entry> </row> <row> <entry><link linkend="features.http-auth">ïåðåìåííûå PHP_AUTH</link></entry> <entry>  çàùèùåííîì ðåæèìå, ïåðåìåííûå <varname>PHP_AUTH_USER</varname>, <varname>PHP_AUTH_PW</varname>, è <varname>AUTH_TYPE</varname> íåäîñòóïíû êàê ýëåìåíòû ìàññèâà <varname>$_SERVER</varname>. Íåñìîòðÿ íà ýòî, âû âñå åùå ìîæåòå èñïîëüçîâàòü ïåðåìåííóþ <varname>REMOTE_USER</varname> äëÿ èäåíòèôèêàöèè ïîëüçîâàòåëÿ. (Çàìå÷àíèå: àêòóàëüíî òîëüêî äëÿ PHP 4.3.0 è âûøå) </entry> </row> <row> <entry> <function>highlight_file</function>, <function>show_source</function> </entry> <entry> &sm.uidcheck; &sm.uidcheck.dir; (Çàìå÷àíèå: àêòóàëüíî òîëüêî äëÿ PHP 4.2.1 è âûøå) </entry> </row> <row> <entry> <function>parse_ini_file</function> </entry> <entry> &sm.uidcheck; &sm.uidcheck.dir; (Çàìå÷àíèå: àêòóàëüíî òîëüêî äëÿ PHP 4.2.1 è âûøå) </entry> </row> <row> <entry> <function>set_time_limit</function> </entry> <entry> Íå èìååò íèêàêîãî ýôôåêòà, åñëè &safemode; èñïîëüçóåòñÿ </entry> </row> <row> <entry> <link linkend="ini.max-execution-time">max_execution_time</link> </entry> <entry> Íå èìååò íèêàêîãî ýôôåêòà, åñëè &safemode; èñïîëüçóåòñÿ </entry> </row> <row> <entry> <function>mail</function> </entry> <entry>  çàùèùåííîì ðåæèìå ïÿòûé ïàðàìåòð íåäîñòóïåí. (Çàìå÷àíèå: àêòóàëüíî òîëüêî äëÿ PHP 4.2.3 è âûøå) </entry> </row> <row> <entry>Ëþáàÿ ôóíêöèÿ, êîòîðàÿ èñïîëüçóåò <filename>php4/main/fopen_wrappers.c</filename> </entry> <entry>Âðåìåííî íå äîêóìåíòèðîâàíî</entry> </row> </tbody> </tgroup> </table> </para> </sect1> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->