Mercurial > hg > nginx-site
comparison xml/en/docs/http/ngx_http_proxy_module.xml @ 2624:bd676d1da957
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 |