RepoMirrors/haproxy
1
0
Fork 0
mirror of http://git.haproxy.org/git/haproxy.git/ synced 2025-02-03 03:52:38 +00:00
Code Issues Packages Projects Releases Wiki Activity

DOC: clarify some points about SSL and the proxy protocol

Browse Source 
Make it clearer that some fields are in fact sub-types of the SSL
field.
This commit is contained in:
Nikos Mavrogiannopoulos 2015-08-24 15:53:18 +02:00 committed by Willy Tarreau
parent b157d73beb
commit f1650a8adf
1 changed files with 28 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

45
doc/proxy-protocol.txt
View File

@ -525,12 +525,15 @@ bytes specified by the length.
The following types have already been registered for the <type> field : The following types have already been registered for the <type> field :
#define PP2_TYPE_ALPN 0x01 #define PP2_TYPE_ALPN 0x01
#define PP2_TYPE_AUTHORITY 0x02 #define PP2_TYPE_AUTHORITY 0x02
#define PP2_TYPE_SSL 0x20 #define PP2_TYPE_SSL 0x20
#define PP2_TYPE_SSL_VERSION 0x21 #define PP2_SUBTYPE_SSL_VERSION 0x21
#define PP2_TYPE_SSL_CN 0x22 #define PP2_SUBTYPE_SSL_CN 0x22
#define PP2_TYPE_NETNS 0x30 #define PP2_TYPE_NETNS 0x30
2.2.1. The PP2_TYPE_SSL type and subtypes
For the type PP2_TYPE_SSL, the value is itselv a defined like this : For the type PP2_TYPE_SSL, the value is itselv a defined like this :
@ -540,27 +543,35 @@ For the type PP2_TYPE_SSL, the value is itselv a defined like this :
struct pp2_tlv sub_tlv[0]; struct pp2_tlv sub_tlv[0];
}; };
And the <client> field is made of a bit field from the following values, The <verify> field will be zero if the client presented a certificate
and it was successfully verified, and non-zero otherwise.
The <client> field is made of a bit field from the following values,
indicating which element is present : indicating which element is present :
#define PP2_CLIENT_SSL 0x01 #define PP2_CLIENT_SSL 0x01
#define PP2_CLIENT_CERT_CONN 0x02 #define PP2_CLIENT_CERT_CONN 0x02
#define PP2_CLIENT_CERT_SESS 0x04 #define PP2_CLIENT_CERT_SESS 0x04
Each of these elements may lead to extra data being appended to this TLV using Note, that each of these elements may lead to extra data being appended to
a second level of TLV encapsulation. It is thus possible to find multiple TLV this TLV using a second level of TLV encapsulation. It is thus possible to
values after this field. The total length of the upper TLV will reflect this. find multiple TLV values after this field. The total length of the pp2_tlv_ssl
TLV will reflect this.
PP2_CLIENT_SSL indicates that the client connected over SSL/TLS. When this The PP2_CLIENT_SSL flag indicates that the client connected over SSL/TLS. When
field is present, the string representation of the TLS version is appended at this field is present, the string representation of the TLS version is appended
the end of the field in the TLV format using the type PP2_TYPE_SSL_VERSION. at the end of the field in the TLV format using the type PP2_SUBTYPE_SSL_VERSION.
PP2_CLIENT_CERT_CONN indicates that the client provided a certificate over the PP2_CLIENT_CERT_CONN indicates that the client provided a certificate over the
current connection. PP2_CLIENT_CERT_SESS indicates that the client provided a current connection. PP2_CLIENT_CERT_SESS indicates that the client provided a
certificate at least once over the TLS session this connection belongs to. In certificate at least once over the TLS session this connection belongs to.
both cases, the string representation of the client certificate's CN may be
appended after the SSL/TLS version using the TLV format using the type In all cases, the string representation (in UTF8) of the Common Name field
PP2_TYPE_SSL_CN. (OID: 2.5.4.3) of the client certificate's DistinguishedName, is appended
using the TLV format and the type PP2_SUBTYPE_SSL_CN.
2.2.2. The PP2_TYPE_NETNS type
The type PP2_TYPE_NETNS defines the value as the string representation of the The type PP2_TYPE_NETNS defines the value as the string representation of the
namespace's name. namespace's name.