aboutsummaryrefslogtreecommitdiffstats
path: root/docs/hazmat/primitives/key-exchange-agreements.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/hazmat/primitives/key-exchange-agreements.rst')
-rw-r--r--docs/hazmat/primitives/key-exchange-agreements.rst23
1 files changed, 23 insertions, 0 deletions
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`