blob: 4cb9f59c27fc05fbde0c92e0260ce369ea501519 [file] [log] [blame]
# Copyright 2019 Google LLC.
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# See the License for the specific language governing permissions and
# limitations under the License.
"""This module defines the interface for HybridEncrypt."""
from __future__ import absolute_import
from __future__ import division
from __future__ import google_type_annotations
from __future__ import print_function
import abc
# Special imports
import six
class HybridEncrypt(object):
"""The interface for hybrid encryption.
Implementations of this interface are secure against adaptive
chosen ciphertext attacks. In addition to 'plaintext' the
encryption takes an extra parameter 'context_info', which usually
is public data implicit from the context, but should be bound to
the resulting ciphertext: upon decryption the ciphertext allows for
checking the integrity of 'context_info' (but there are no
guarantees wrt. to secrecy or authenticity of 'context_info').
WARNING: hybrid encryption does not provide authenticity, that is the
recipient of an encrypted message does not know the identity of the sender.
Similar to general public-key encryption schemes the security goal of
hybrid encryption is to provide privacy only. In other words, hybrid
encryption is secure if and only if the recipient can accept anonymous
messages or can rely on other mechanisms to authenticate the sender.
'context_info' can be empty or null, but to ensure the correct
decryption of the resulting ciphertext the same value must be
provided for decryption operation (cf. HybridDecrypt-interface).
A concrete instantiation of this interface can implement the
binding of 'context_info' to the ciphertext in various ways, for
- use 'context_info' as "associated data"-input for the employed
AEAD symmetric encryption (cf.
- use 'context_info' as "CtxInfo"-input for HKDF (if the implementation uses
HKDF as key derivation function, cf.
def encrypt(self, plaintext: bytes, context_info: bytes) -> bytes:
"""Encrypts plaintext binding context_info to the resulting ciphertext."""
raise NotImplementedError()