Shortcuts on this page
r m x toggle line displays
j k next/prev highlighted chunk
0 (zero) top of page
1 (one) first highlighted chunk
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.
5from __future__ import annotations
7import abc
9from cryptography.exceptions import UnsupportedAlgorithm, _Reasons
10from cryptography.hazmat.bindings._rust import openssl as rust_openssl
11from cryptography.hazmat.primitives import _serialization
12from cryptography.utils import Buffer
15class X448PublicKey(metaclass=abc.ABCMeta):
16 @classmethod
17 def from_public_bytes(cls, data: bytes) -> X448PublicKey:
18 from cryptography.hazmat.backends.openssl.backend import backend
20 if not backend.x448_supported():
21 raise UnsupportedAlgorithm(
22 "X448 is not supported by this version of OpenSSL.",
23 _Reasons.UNSUPPORTED_EXCHANGE_ALGORITHM,
24 )
26 return rust_openssl.x448.from_public_bytes(data)
28 @abc.abstractmethod
29 def public_bytes(
30 self,
31 encoding: _serialization.Encoding,
32 format: _serialization.PublicFormat,
33 ) -> bytes:
34 """
35 The serialized bytes of the public key.
36 """
38 @abc.abstractmethod
39 def public_bytes_raw(self) -> bytes:
40 """
41 The raw bytes of the public key.
42 Equivalent to public_bytes(Raw, Raw).
43 """
45 @abc.abstractmethod
46 def __eq__(self, other: object) -> bool:
47 """
48 Checks equality.
49 """
51 @abc.abstractmethod
52 def __copy__(self) -> X448PublicKey:
53 """
54 Returns a copy.
55 """
57 @abc.abstractmethod
58 def __deepcopy__(self, memo: dict) -> X448PublicKey:
59 """
60 Returns a deep copy.
61 """
64if hasattr(rust_openssl, "x448"):
65 X448PublicKey.register(rust_openssl.x448.X448PublicKey)
68class X448PrivateKey(metaclass=abc.ABCMeta):
69 @classmethod
70 def generate(cls) -> X448PrivateKey:
71 from cryptography.hazmat.backends.openssl.backend import backend
73 if not backend.x448_supported():
74 raise UnsupportedAlgorithm(
75 "X448 is not supported by this version of OpenSSL.",
76 _Reasons.UNSUPPORTED_EXCHANGE_ALGORITHM,
77 )
79 return rust_openssl.x448.generate_key()
81 @classmethod
82 def from_private_bytes(cls, data: Buffer) -> X448PrivateKey:
83 from cryptography.hazmat.backends.openssl.backend import backend
85 if not backend.x448_supported():
86 raise UnsupportedAlgorithm(
87 "X448 is not supported by this version of OpenSSL.",
88 _Reasons.UNSUPPORTED_EXCHANGE_ALGORITHM,
89 )
91 return rust_openssl.x448.from_private_bytes(data)
93 @abc.abstractmethod
94 def public_key(self) -> X448PublicKey:
95 """
96 Returns the public key associated with this private key
97 """
99 @abc.abstractmethod
100 def private_bytes(
101 self,
102 encoding: _serialization.Encoding,
103 format: _serialization.PrivateFormat,
104 encryption_algorithm: _serialization.KeySerializationEncryption,
105 ) -> bytes:
106 """
107 The serialized bytes of the private key.
108 """
110 @abc.abstractmethod
111 def private_bytes_raw(self) -> bytes:
112 """
113 The raw bytes of the private key.
114 Equivalent to private_bytes(Raw, Raw, NoEncryption()).
115 """
117 @abc.abstractmethod
118 def exchange(self, peer_public_key: X448PublicKey) -> bytes:
119 """
120 Performs a key exchange operation using the provided peer's public key.
121 """
123 @abc.abstractmethod
124 def __copy__(self) -> X448PrivateKey:
125 """
126 Returns a copy.
127 """
129 @abc.abstractmethod
130 def __deepcopy__(self, memo: dict) -> X448PrivateKey:
131 """
132 Returns a deep copy.
133 """
136if hasattr(rust_openssl, "x448"):
137 X448PrivateKey.register(rust_openssl.x448.X448PrivateKey)