Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_proxy_module.xml @ 2599:5c5a36560f97

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Added the proxy_cookie_flags directive.
author Yaroslav Zhuravlev <yar@nginx.com>
date Tue, 29 Sep 2020 15:52:05 +0100
parents 361a28cca097
children 6684517c9d19
comparison
equal deleted inserted replaced
2598:361a28cca097 2599:5c5a36560f97
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
9 9
10 <module name="Модуль ngx_http_proxy_module" 10 <module name="Модуль ngx_http_proxy_module"
11 link="/ru/docs/http/ngx_http_proxy_module.html" 11 link="/ru/docs/http/ngx_http_proxy_module.html"
12 lang="ru" 12 lang="ru"
13 rev="68"> 13 rev="69">
14 14
15 <section id="summary"> 15 <section id="summary">
16 16
17 <para> 17 <para>
18 Модуль <literal>ngx_http_proxy_module</literal> позволяет передавать 18 Модуль <literal>ngx_http_proxy_module</literal> позволяет передавать
875 </para> 875 </para>
876 876
877 </directive> 877 </directive>
878 878
879 879
880 <directive name="proxy_cookie_flags">
881 <syntax>
882 <literal>off</literal> |
883 <value>кука</value>
884 [<value>флаг</value> ...]</syntax>
885 <default>off</default>
886 <context>http</context>
887 <context>server</context>
888 <context>location</context>
889 <appeared-in>1.19.3</appeared-in>
890
891 <para>
892 Задаёт один или несколько флагов для куки.
893 В качестве <value>куки</value>
894 можно использовать текст, переменные и их комбинации.
895 Параметры
896 <literal>secure</literal>,
897 <literal>httponly</literal>,
898 <literal>samesite=strict</literal>,
899 <literal>samesite=lax</literal>,
900 <literal>samesite=none</literal>
901 добавляют соответствующие флаги.
902 Параметры
903 <literal>nosecure</literal>,
904 <literal>nohttponly</literal>,
905 <literal>nosamesite</literal>
906 удаляют соответствующие флаги.
907 </para>
908
909 <para>
910 Куки также можно задать при помощи регулярных выражений.
911 При этом <value>кука</value> должна начинаться с символа
912 “<literal>~</literal>”.
913 </para>
914
915 <para>
916 На одном уровне конфигурации может быть указано
917 несколько директив <literal>proxy_cookie_flags</literal>:
918 <example>
919 proxy_cookie_flags one httponly;
920 proxy_cookie_flags ~ nosecure samesite=strict;
921 </example>
922 В данном примере флаг <literal>httponly</literal>
923 добавляется к куке <literal>one</literal>,
924 для остальных кук
925 добавляется флаг <literal>samesite=strict</literal> и
926 удаляется флаг <literal>secure</literal>.
927 </para>
928
929 <para>
930 Параметр <literal>off</literal> отменяет действие всех директив
931 <literal>proxy_cookie_flags</literal>
932 на данном уровне.
933 </para>
934
935 </directive>
936
937
880 <directive name="proxy_cookie_path"> 938 <directive name="proxy_cookie_path">
881 <syntax><literal>off</literal></syntax> 939 <syntax><literal>off</literal></syntax>
882 <syntax><value>путь</value> <value>замена</value></syntax> 940 <syntax><value>путь</value> <value>замена</value></syntax>
883 <default>off</default> 941 <default>off</default>
884 <context>http</context> 942 <context>http</context>