Add AF_ALG (Linux Kernel crypto) to socket module

[tiran]

BPO	27744
Nosy	@vstinner, @tiran, @vadmium, @Lukasa, @zhangyangyu
Files	AF_ALG-kernel-crypto-support-for-socket-module.patch AF_ALG-kernel-crypto-support-for-socket-module-1.patch AF_ALG-kernel-crypto-support-for-socket-module-2.patch AF_ALG-kernel-crypto-support-for-socket-module-3.patch AF_ALG-kernel-crypto-support-for-socket-module-4.patch AF_ALG-kernel-crypto-support-for-socket-module-5.patch

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = <Date 2021-10-12.09:36:25.702>
created_at = <Date 2016-08-12.10:21:30.746>
labels = ['extension-modules', 'type-feature']
title = 'Add AF_ALG (Linux Kernel crypto) to socket module'
updated_at = <Date 2021-10-12.09:36:25.702>
user = 'https://github.com/tiran'

bugs.python.org fields:

activity = <Date 2021-10-12.09:36:25.702>
actor = 'christian.heimes'
assignee = 'none'
closed = True
closed_date = <Date 2021-10-12.09:36:25.702>
closer = 'christian.heimes'
components = ['Extension Modules']
creation = <Date 2016-08-12.10:21:30.746>
creator = 'christian.heimes'
dependencies = []
files = ['44118', '44140', '44248', '44268', '44295', '44359']
hgrepos = []
issue_num = 27744
keywords = ['patch']
message_count = 22.0
messages = ['272516', '272746', '272918', '273018', '273838', '274365', '274442', '274445', '274453', '274458', '274508', '274516', '274520', '274543', '274553', '274557', '275702', '275824', '276010', '287497', '287502', '287503']
nosy_count = 7.0
nosy_names = ['vstinner', 'christian.heimes', 'python-dev', 'martin.panter', 'Lukasa', 'xiang.zhang', 'Christian H']
pr_nums = []
priority = 'normal'
resolution = 'fixed'
stage = 'resolved'
status = 'closed'
superseder = None
type = 'enhancement'
url = 'https://bugs.python.org/issue27744'
versions = ['Python 3.6']

[tiran]

Linux has a netlink-based user-space interface for Kernel cryptography. Kernel based crypto has a couple of advantages that are explained at http://www.chronox.de/libkcapi/html/ch01s02.html . The document doesn't mention that a crypto socket also supports splicing and sendfile. Files no longer have to be copied to user-space.

My experimental branch https://github.com/tiran/cpython/commits/feature/af_alg implements af_alg support. Example:

from socket import socket, AF_ALG, SOCK_SEQPACKET, SOL_ALG, ALG_SET_KEY
from binascii import hexlify
with socket(AF_ALG, SOCK_SEQPACKET, 0) as alg:
    alg.bind(('hash', 'hmac(sha512)'))
    alg.setsockopt(SOL_ALG, ALG_SET_KEY, b'key')
    op, _ = alg.accept()
    with open('/etc/passwd', 'rb') as f:
        op.sendfile(f)
    print(hexlify(op.recv(64)))
    op.close()

[tiran]

Working patch with tests and documentation.

socket.algset() isn't strictly necessary but makes the feature much more pleasant to use. I accept ideas for a better name, though.

[vstinner]

I reviewed AF_ALG-kernel-crypto-support-for-socket-module.patch.

[tiran]

Thanks for your review, Victor. I have addressed most of your remarks.

• algset() is now called sendmsg_afalg(). It behaves more like a specialized version of sendmsg() and can optionally handle an array of iovec.

• I had to add another variant of setsockopt that sends NULL, int instead of (char*)int, sizeof(int) to get the AEAD GCM tests working. AEAD expects ALG_SET_AEAD_AUTHSIZE as (NULL, taglen). algo.setsockopt(SOL_ALG, ALG_SET_AEAD_AUTHSIZE, (None, taglen)) sends optval=NULL, optlen=taglen.

• Added tests for AES-CBC decryption, AEAD AES-GCM and DRBG.

[tiran]

New patch with setsockopt(socket.SOL_ALG, socket.ALG_SET_AEAD_AUTHSIZE, None, taglen) instead of (None, taglen).

[tiran]

I have removed binascii.(un)hexlify().

[python-dev]

New changeset 74ce062a0397 by Christian Heimes in branch 'default':
Issue bpo-27744: Add AF_ALG (Linux Kernel crypto) to socket module.
https://hg.python.org/cpython/rev/74ce062a0397

[python-dev]

New changeset 52404f9596b5 by Christian Heimes in branch 'default':
Issue bpo-27744: correct comment and markup
https://hg.python.org/cpython/rev/52404f9596b5

[python-dev]

New changeset ee32af890e27 by Christian Heimes in branch 'default':
bpo-27744: Check for AF_ALG support in Kernel
https://hg.python.org/cpython/rev/ee32af890e27

[python-dev]

New changeset 4ebe3ade6922 by Christian Heimes in branch 'default':
bpo-27744: AES-CBC and DRBG need Kernel 3.19+
https://hg.python.org/cpython/rev/4ebe3ade6922

[vadmium]

Despite the last changes, test_aes_cbc() hangs for fifteen minutes:
http://buildbot.python.org/all/builders/x86-64%20Ubuntu%2015.10%20Skylake%20CPU%203.x/builds/1298/steps/test/logs/stdio
running: test_socket (900 sec)
0:28:47 [332/402] test_socket crashed
Timeout (0:15:00)!
Thread 0x00007f2843d94700 (most recent call first):
File "/home/buildbot/buildarea/3.x.intel-ubuntu-skylake/build/Lib/test/test_socket.py", line 5389 in test_aes_cbc
File "/home/buildbot/buildarea/3.x.intel-ubuntu-skylake/build/Lib/test/support/init.py", line 523 in wrapper
File "/home/buildbot/buildarea/3.x.intel-ubuntu-skylake/build/Lib/unittest/case.py", line 600 in run
. . .

[vadmium]

Also, the Gentoo buildbots fail:
http://buildbot.python.org/all/builders/x86%20Gentoo%20Non-Debug%20with%20X%203.x/builds/1368/steps/test/logs/stdio
======================================================================
ERROR: test_aead_aes_gcm (test.test_socket.LinuxKernelCryptoAPI)
----------------------------------------------------------------------

Traceback (most recent call last):
  File "/buildbot/buildarea/3.x.ware-gentoo-x86.nondebug/build/Lib/test/support/__init__.py", line 523, in wrapper
    return func(*args, **kw)
  File "/buildbot/buildarea/3.x.ware-gentoo-x86.nondebug/build/Lib/test/test_socket.py", line 5428, in test_aead_aes_gcm
    with self.create_alg('aead', 'gcm(aes)') as algo:
  File "/buildbot/buildarea/3.x.ware-gentoo-x86.nondebug/build/Lib/test/test_socket.py", line 5346, in create_alg
    sock.bind((typ, name))
FileNotFoundError: [Errno 2] No such file or directory

Similar failures for test_aes_cbc test_drbg_pr_sha256 test_hmac_sha1 test_sha256.

[vstinner]

Also, the Gentoo buildbots fail:
http://buildbot.python.org/all/builders/x86%20Gentoo%20Non-Debug%20with%20X%203.x/builds/1368/steps/test/logs/stdio
======================================================================
ERROR: test_aead_aes_gcm (test.test_socket.LinuxKernelCryptoAPI)

It's Linux 4.4.6. configure says "checking for sockaddr_alg... yes".