# coding: utf-8
# PyGOST -- Pure Python GOST cryptographic functions library
-# Copyright (C) 2015-2016 Sergey Matveev <stargrave@stargrave.org>
+# Copyright (C) 2015-2018 Sergey Matveev <stargrave@stargrave.org>
#
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <http://www.gnu.org/licenses/>.
-"""Diffie-Hellman functions, VKO GOST R 34.10-2001/2012
+"""Key agreement functions, VKO GOST R 34.10-2001/2012
"""
from pygost.gost3410 import pub_marshal
def kek_34102001(curve, prv, pub, ukm):
- """ Make Diffie-Hellman computation (34.10-2001, 34.11-94)
+ """ Key agreement (34.10-2001, 34.11-94)
:param GOST3410Curve curve: curve to use
:param long prv: private key
def kek_34102012256(curve, prv, pub, ukm=1):
- """ Make Diffie-Hellman computation (34.10-2012, 34.11-2012 256 bit)
+ """ Key agreement (34.10-2012, 34.11-2012 256 bit)
:param GOST3410Curve curve: curve to use
:param long prv: private key
:param long ukm: user keying material, VKO-factor
:returns: Key Encryption Key (shared key)
:rtype: bytes, 32 bytes
+
+ Shared Key Encryption Key computation is based on
+ :rfc:`7836` VKO GOST R 34.10-2012.
"""
return GOST34112012256(kek(curve, prv, pub, ukm, mode=2012)).digest()
def kek_34102012512(curve, prv, pub, ukm=1):
- """ Make Diffie-Hellman computation (34.10-2012, 34.11-2012 512 bit)
+ """ Key agreement (34.10-2012, 34.11-2012 512 bit)
:param GOST3410Curve curve: curve to use
:param long prv: private key
:param long ukm: user keying material, VKO-factor
:returns: Key Encryption Key (shared key)
:rtype: bytes, 32 bytes
+
+ Shared Key Encryption Key computation is based on
+ :rfc:`7836` VKO GOST R 34.10-2012.
"""
return GOST34112012512(kek(curve, prv, pub, ukm, mode=2012)).digest()