33 lines
1.0 KiB
Python
33 lines
1.0 KiB
Python
# This file is dual licensed under the terms of the Apache License, Version
|
|
# 2.0, and the BSD License. See the LICENSE file in the root of this repository
|
|
# for complete details.
|
|
|
|
from __future__ import annotations
|
|
|
|
import abc
|
|
|
|
from cryptography.utils import Buffer
|
|
|
|
|
|
class KeyDerivationFunction(metaclass=abc.ABCMeta):
|
|
@abc.abstractmethod
|
|
def derive(self, key_material: bytes) -> bytes:
|
|
"""
|
|
Deterministically generates and returns a new key based on the existing
|
|
key material.
|
|
"""
|
|
|
|
@abc.abstractmethod
|
|
def derive_into(self, key_material: bytes, buffer: Buffer) -> None:
|
|
"""
|
|
Deterministically generates a new key based on the existing key
|
|
material and stores it in the provided buffer.
|
|
"""
|
|
|
|
@abc.abstractmethod
|
|
def verify(self, key_material: bytes, expected_key: bytes) -> None:
|
|
"""
|
|
Checks whether the key generated by the key material matches the
|
|
expected derived key. Raises an exception if they do not match.
|
|
"""
|