From a7c65b5ccdc188d739a1e21e89e3863b69449b34 Mon Sep 17 00:00:00 2001 From: Simo Sorce Date: Thu, 30 Apr 2015 10:25:25 -0400 Subject: Introduce Key Exchange Agreements interface Signed-off-by: Simo Sorce --- docs/hazmat/primitives/index.rst | 1 + docs/hazmat/primitives/key-exchange-agreements.rst | 23 ++++++++++++++++++++++ 2 files changed, 24 insertions(+) create mode 100644 docs/hazmat/primitives/key-exchange-agreements.rst (limited to 'docs') diff --git a/docs/hazmat/primitives/index.rst b/docs/hazmat/primitives/index.rst index a9ab38a0..675111bb 100644 --- a/docs/hazmat/primitives/index.rst +++ b/docs/hazmat/primitives/index.rst @@ -15,3 +15,4 @@ Primitives constant-time interfaces twofactor + key-exchange-agreements diff --git a/docs/hazmat/primitives/key-exchange-agreements.rst b/docs/hazmat/primitives/key-exchange-agreements.rst new file mode 100644 index 00000000..8d79fbad --- /dev/null +++ b/docs/hazmat/primitives/key-exchange-agreements.rst @@ -0,0 +1,23 @@ +.. hazmat:: + +Key Exchange agreements +======================= + +.. module:: cryptography.hazmat.primitives.asymmetric.key_exchange + +Key exchange agreements are cryptographic operations, like Diffie-Hellman +key exchanges, that allow two parties to use their public-private key pairs +to establish a shared secret key over an insecure channel. Usually the +negotiated key is further derived before using it for symmetric operations. + +Interfaces +~~~~~~~~~~ + +.. class:: KeyExchangeContext + + .. versionadded:: 1.1 + + .. method:: agree(public_key) + + :param public_key: The peer public key, the type depends on the + crypto system used, for example :class:`~cryptography.hazmat.primitives.asymmetric.ec.EllipticCurvePublicKey` -- cgit v1.2.3