diff options
| author | Chuck Lever <chuck.lever@oracle.com> | 2023-05-11 11:49:50 -0400 |
|---|---|---|
| committer | Jakub Kicinski <kuba@kernel.org> | 2023-05-24 22:05:24 -0700 |
| commit | 26fb5480a27d34975cc2b680b77af189620dd740 (patch) | |
| tree | 6e14b559ee327c9fde86287f3ba99f47731308dc /Documentation/networking/tls-handshake.rst | |
| parent | 1ce77c998f0415d7d9d91cb9bd7665e25c8f75f1 (diff) | |
| download | linux-stable-26fb5480a27d34975cc2b680b77af189620dd740.tar.gz linux-stable-26fb5480a27d34975cc2b680b77af189620dd740.tar.bz2 linux-stable-26fb5480a27d34975cc2b680b77af189620dd740.zip | |
net/handshake: Enable the SNI extension to work properly
Enable the upper layer protocol to specify the SNI peername. This
avoids the need for tlshd to use a DNS lookup, which can return a
hostname that doesn't match the incoming certificate's SubjectName.
Fixes: 2fd5532044a8 ("net/handshake: Add a kernel API for requesting a TLSv1.3 handshake")
Reviewed-by: Simon Horman <simon.horman@corigine.com>
Signed-off-by: Chuck Lever <chuck.lever@oracle.com>
Signed-off-by: Jakub Kicinski <kuba@kernel.org>
Diffstat (limited to 'Documentation/networking/tls-handshake.rst')
| -rw-r--r-- | Documentation/networking/tls-handshake.rst | 5 |
1 files changed, 5 insertions, 0 deletions
diff --git a/Documentation/networking/tls-handshake.rst b/Documentation/networking/tls-handshake.rst index a2817a88e905..6f5ea1646a47 100644 --- a/Documentation/networking/tls-handshake.rst +++ b/Documentation/networking/tls-handshake.rst @@ -53,6 +53,7 @@ fills in a structure that contains the parameters of the request: struct socket *ta_sock; tls_done_func_t ta_done; void *ta_data; + const char *ta_peername; unsigned int ta_timeout_ms; key_serial_t ta_keyring; key_serial_t ta_my_cert; @@ -71,6 +72,10 @@ instantiated a struct file in sock->file. has completed. Further explanation of this function is in the "Handshake Completion" sesction below. +The consumer can provide a NUL-terminated hostname in the @ta_peername +field that is sent as part of ClientHello. If no peername is provided, +the DNS hostname associated with the server's IP address is used instead. + The consumer can fill in the @ta_timeout_ms field to force the servicing handshake agent to exit after a number of milliseconds. This enables the socket to be fully closed once both the kernel and the handshake agent |