mirror of
http://git.haproxy.org/git/haproxy.git/
synced 2025-01-10 16:00:08 +00:00
DOC: proxy_protocol: Reserve TLV type 0x05 as PP2_TYPE_UNIQUE_ID
This reserves and defines TLV type 0x05.
This commit is contained in:
parent
d726386421
commit
b435f77620
@ -1,4 +1,4 @@
|
|||||||
2017/03/10 Willy Tarreau
|
2020/03/05 Willy Tarreau
|
||||||
HAProxy Technologies
|
HAProxy Technologies
|
||||||
The PROXY protocol
|
The PROXY protocol
|
||||||
Versions 1 & 2
|
Versions 1 & 2
|
||||||
@ -27,6 +27,7 @@ Revision history
|
|||||||
reserved TLV type ranges, added TLV documentation, clarified
|
reserved TLV type ranges, added TLV documentation, clarified
|
||||||
string encoding. With contributions from Andriy Palamarchuk
|
string encoding. With contributions from Andriy Palamarchuk
|
||||||
(Amazon.com).
|
(Amazon.com).
|
||||||
|
2020/03/05 - added the unique ID TLV type (Tim Düsterhus)
|
||||||
|
|
||||||
|
|
||||||
1. Background
|
1. Background
|
||||||
@ -538,6 +539,7 @@ The following types have already been registered for the <type> field :
|
|||||||
#define PP2_TYPE_AUTHORITY 0x02
|
#define PP2_TYPE_AUTHORITY 0x02
|
||||||
#define PP2_TYPE_CRC32C 0x03
|
#define PP2_TYPE_CRC32C 0x03
|
||||||
#define PP2_TYPE_NOOP 0x04
|
#define PP2_TYPE_NOOP 0x04
|
||||||
|
#define PP2_TYPE_UNIQUE_ID 0x05
|
||||||
#define PP2_TYPE_SSL 0x20
|
#define PP2_TYPE_SSL 0x20
|
||||||
#define PP2_SUBTYPE_SSL_VERSION 0x21
|
#define PP2_SUBTYPE_SSL_VERSION 0x21
|
||||||
#define PP2_SUBTYPE_SSL_CN 0x22
|
#define PP2_SUBTYPE_SSL_CN 0x22
|
||||||
@ -602,7 +604,17 @@ bytes. Can be used for data padding or alignment. Note that it can be used
|
|||||||
to align only by 3 or more bytes because a TLV can not be smaller than that.
|
to align only by 3 or more bytes because a TLV can not be smaller than that.
|
||||||
|
|
||||||
|
|
||||||
2.2.5. The PP2_TYPE_SSL type and subtypes
|
2.2.5. PP2_TYPE_UNIQUE_ID
|
||||||
|
|
||||||
|
The value of the type PP2_TYPE_UNIQUE_ID is an opaque byte sequence of up to
|
||||||
|
128 bytes generated by the upstream proxy that uniquely identifies the
|
||||||
|
connection.
|
||||||
|
|
||||||
|
The unique ID can be used to easily correlate connections across multiple
|
||||||
|
layers of proxies, without needing to look up IP addresses and port numbers.
|
||||||
|
|
||||||
|
|
||||||
|
2.2.6. The PP2_TYPE_SSL type and subtypes
|
||||||
|
|
||||||
For the type PP2_TYPE_SSL, the value is itself a defined like this :
|
For the type PP2_TYPE_SSL, the value is itself a defined like this :
|
||||||
|
|
||||||
@ -654,13 +666,13 @@ In all cases, the string representation (in UTF8) of the Common Name field
|
|||||||
using the TLV format and the type PP2_SUBTYPE_SSL_CN. E.g. "example.com".
|
using the TLV format and the type PP2_SUBTYPE_SSL_CN. E.g. "example.com".
|
||||||
|
|
||||||
|
|
||||||
2.2.6. The PP2_TYPE_NETNS type
|
2.2.7. The PP2_TYPE_NETNS type
|
||||||
|
|
||||||
The type PP2_TYPE_NETNS defines the value as the US-ASCII string representation
|
The type PP2_TYPE_NETNS defines the value as the US-ASCII string representation
|
||||||
of the namespace's name.
|
of the namespace's name.
|
||||||
|
|
||||||
|
|
||||||
2.2.7. Reserved type ranges
|
2.2.8. Reserved type ranges
|
||||||
|
|
||||||
The following range of 16 type values is reserved for application-specific
|
The following range of 16 type values is reserved for application-specific
|
||||||
data and will be never used by the PROXY Protocol. If you need more values
|
data and will be never used by the PROXY Protocol. If you need more values
|
||||||
|
@ -558,6 +558,7 @@ struct proxy_hdr_v2 {
|
|||||||
#define PP2_TYPE_AUTHORITY 0x02
|
#define PP2_TYPE_AUTHORITY 0x02
|
||||||
#define PP2_TYPE_CRC32C 0x03
|
#define PP2_TYPE_CRC32C 0x03
|
||||||
#define PP2_TYPE_NOOP 0x04
|
#define PP2_TYPE_NOOP 0x04
|
||||||
|
#define PP2_TYPE_UNIQUE_ID 0x05
|
||||||
#define PP2_TYPE_SSL 0x20
|
#define PP2_TYPE_SSL 0x20
|
||||||
#define PP2_SUBTYPE_SSL_VERSION 0x21
|
#define PP2_SUBTYPE_SSL_VERSION 0x21
|
||||||
#define PP2_SUBTYPE_SSL_CN 0x22
|
#define PP2_SUBTYPE_SSL_CN 0x22
|
||||||
|
Loading…
Reference in New Issue
Block a user