Coverage for /pythoncovmergedfiles/medio/medio/usr/local/lib/python3.8/site-packages/cryptography/hazmat/primitives/asymmetric/x25519.py: 72%

1# This file is dual licensed under the terms of the Apache License, Version 

2# 2.0, and the BSD License. See the LICENSE file in the root of this repository 

3# for complete details. 

4 

5from __future__ import annotations 

6 

7import abc 

8 

9from cryptography.exceptions import UnsupportedAlgorithm, _Reasons 

10from cryptography.hazmat.bindings._rust import openssl as rust_openssl 

11from cryptography.hazmat.primitives import _serialization 

12 

13 

14class X25519PublicKey(metaclass=abc.ABCMeta): 

15 @classmethod 

16 def from_public_bytes(cls, data: bytes) -> X25519PublicKey: 

17 from cryptography.hazmat.backends.openssl.backend import backend 

18 

19 if not backend.x25519_supported(): 

20 raise UnsupportedAlgorithm( 

21 "X25519 is not supported by this version of OpenSSL.", 

22 _Reasons.UNSUPPORTED_EXCHANGE_ALGORITHM, 

23 ) 

24 

25 return backend.x25519_load_public_bytes(data) 

26 

27 @abc.abstractmethod 

28 def public_bytes( 

29 self, 

30 encoding: _serialization.Encoding, 

31 format: _serialization.PublicFormat, 

32 ) -> bytes: 

33 """ 

34 The serialized bytes of the public key. 

35 """ 

36 

37 @abc.abstractmethod 

38 def public_bytes_raw(self) -> bytes: 

39 """ 

40 The raw bytes of the public key. 

41 Equivalent to public_bytes(Raw, Raw). 

42 """ 

43 

44 @abc.abstractmethod 

45 def __eq__(self, other: object) -> bool: 

46 """ 

47 Checks equality. 

48 """ 

49 

50 

51# For LibreSSL 

52if hasattr(rust_openssl, "x25519"): 

53 X25519PublicKey.register(rust_openssl.x25519.X25519PublicKey) 

54 

55 

56class X25519PrivateKey(metaclass=abc.ABCMeta): 

57 @classmethod 

58 def generate(cls) -> X25519PrivateKey: 

59 from cryptography.hazmat.backends.openssl.backend import backend 

60 

61 if not backend.x25519_supported(): 

62 raise UnsupportedAlgorithm( 

63 "X25519 is not supported by this version of OpenSSL.", 

64 _Reasons.UNSUPPORTED_EXCHANGE_ALGORITHM, 

65 ) 

66 return backend.x25519_generate_key() 

67 

68 @classmethod 

69 def from_private_bytes(cls, data: bytes) -> X25519PrivateKey: 

70 from cryptography.hazmat.backends.openssl.backend import backend 

71 

72 if not backend.x25519_supported(): 

73 raise UnsupportedAlgorithm( 

74 "X25519 is not supported by this version of OpenSSL.", 

75 _Reasons.UNSUPPORTED_EXCHANGE_ALGORITHM, 

76 ) 

77 

78 return backend.x25519_load_private_bytes(data) 

79 

80 @abc.abstractmethod 

81 def public_key(self) -> X25519PublicKey: 

82 """ 

83 Returns the public key assosciated with this private key 

84 """ 

85 

86 @abc.abstractmethod 

87 def private_bytes( 

88 self, 

89 encoding: _serialization.Encoding, 

90 format: _serialization.PrivateFormat, 

91 encryption_algorithm: _serialization.KeySerializationEncryption, 

92 ) -> bytes: 

93 """ 

94 The serialized bytes of the private key. 

95 """ 

96 

97 @abc.abstractmethod 

98 def private_bytes_raw(self) -> bytes: 

99 """ 

100 The raw bytes of the private key. 

101 Equivalent to private_bytes(Raw, Raw, NoEncryption()). 

102 """ 

103 

104 @abc.abstractmethod 

105 def exchange(self, peer_public_key: X25519PublicKey) -> bytes: 

106 """ 

107 Performs a key exchange operation using the provided peer's public key. 

108 """ 

109 

110 

111# For LibreSSL 

112if hasattr(rust_openssl, "x25519"): 

113 X25519PrivateKey.register(rust_openssl.x25519.X25519PrivateKey)