Mercurial > hg > nginx-site

comparison xml/en/docs/http/ngx_http_proxy_module.xml @ 2624:bd676d1da957

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Clarified behavior of multiple proxy_cookie_ directives.
author Yaroslav Zhuravlev <yar@nginx.com>
date Wed, 25 Nov 2020 12:39:12 +0000
parents 6684517c9d19
children 50b90da82bc2
comparison
equal deleted inserted replaced
2623:2b71a9ef37c1 2624:bd676d1da957
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
9 9
10 <module name="Module ngx_http_proxy_module" 10 <module name="Module ngx_http_proxy_module"
11 link="/en/docs/http/ngx_http_proxy_module.html" 11 link="/en/docs/http/ngx_http_proxy_module.html"
12 lang="en" 12 lang="en"
13 rev="70"> 13 rev="71">
14 14
15 <section id="summary"> 15 <section id="summary">
16 16
17 <para> 17 <para>
18 The <literal>ngx_http_proxy_module</literal> module allows passing 18 The <literal>ngx_http_proxy_module</literal> module allows passing
865 can be specified on the same level: 865 can be specified on the same level:
866 <example> 866 <example>
867 proxy_cookie_domain localhost example.org; 867 proxy_cookie_domain localhost example.org;
868 proxy_cookie_domain ~\.([a-z]+\.[a-z]+)$ $1; 868 proxy_cookie_domain ~\.([a-z]+\.[a-z]+)$ $1;
869 </example> 869 </example>
870 If several directives can be applied to the cookie,
871 the first matching directive will be chosen.
872 </para>
873
874 <para>
870 The <literal>off</literal> parameter cancels the effect 875 The <literal>off</literal> parameter cancels the effect
871 of the <literal>proxy_cookie_domain</literal> directives 876 of the <literal>proxy_cookie_domain</literal> directives
872 inherited from the previous configuration level. 877 inherited from the previous configuration level.
873 </para> 878 </para>
874 879
914 can be specified on the same configuration level: 919 can be specified on the same configuration level:
915 <example> 920 <example>
916 proxy_cookie_flags one httponly; 921 proxy_cookie_flags one httponly;
917 proxy_cookie_flags ~ nosecure samesite=strict; 922 proxy_cookie_flags ~ nosecure samesite=strict;
918 </example> 923 </example>
924 If several directives can be applied to the cookie,
925 the first matching directive will be chosen.
919 In the example, the <literal>httponly</literal> flag 926 In the example, the <literal>httponly</literal> flag
920 is added to the cookie <literal>one</literal>, 927 is added to the cookie <literal>one</literal>,
921 for all other cookies 928 for all other cookies
922 the <literal>samesite=strict</literal> flag is added and 929 the <literal>samesite=strict</literal> flag is added and
923 the <literal>secure</literal> flag is deleted. 930 the <literal>secure</literal> flag is deleted.
982 can be specified on the same level: 989 can be specified on the same level:
983 <example> 990 <example>
984 proxy_cookie_path /one/ /; 991 proxy_cookie_path /one/ /;
985 proxy_cookie_path / /two/; 992 proxy_cookie_path / /two/;
986 </example> 993 </example>
994 If several directives can be applied to the cookie,
995 the first matching directive will be chosen.
996 </para>
997
998 <para>
987 The <literal>off</literal> parameter cancels the effect 999 The <literal>off</literal> parameter cancels the effect
988 of the <literal>proxy_cookie_path</literal> directives 1000 of the <literal>proxy_cookie_path</literal> directives
989 inherited from the previous configuration level. 1001 inherited from the previous configuration level.
990 </para> 1002 </para>
991 1003
1707 <example> 1719 <example>
1708 proxy_redirect default; 1720 proxy_redirect default;
1709 proxy_redirect http://localhost:8000/ /; 1721 proxy_redirect http://localhost:8000/ /;
1710 proxy_redirect http://www.example.com/ /; 1722 proxy_redirect http://www.example.com/ /;
1711 </example> 1723 </example>
1724 If several directives can be applied to
1725 the header fields of a proxied server response,
1726 the first matching directive will be chosen.
1727 </para>
1728
1729 <para>
1712 The <literal>off</literal> parameter cancels the effect 1730 The <literal>off</literal> parameter cancels the effect
1713 of the <literal>proxy_redirect</literal> directives 1731 of the <literal>proxy_redirect</literal> directives
1714 inherited from the previous configuration level. 1732 inherited from the previous configuration level.
1715 </para> 1733 </para>
1716 1734