Raw keyrings

requirements.txt

@@ -1,3 +1,4 @@
+six
 boto3>=1.4.4
 cryptography>=1.8.1
 attrs>=19.1.0

src/aws_encryption_sdk/keyring/__init__.py

@@ -0,0 +1,13 @@
+# Copyright 2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+# http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file is
+# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# ANY KIND, either express or implied. See the License for the specific
+# language governing permissions and limitations under the License.
+"""All provided Keyrings."""

src/aws_encryption_sdk/keyring/base.py

@@ -11,6 +11,10 @@
 # ANY KIND, either express or implied. See the License for the specific
 # language governing permissions and limitations under the License.
 """Base class interface for Keyrings."""
+import abc
+
+import six
+
 from aws_encryption_sdk.materials_managers import DecryptionMaterials, EncryptionMaterials
 from aws_encryption_sdk.structures import EncryptedDataKey
 
@@ -21,12 +25,14 @@
     pass
 
 
+@six.add_metaclass(abc.ABCMeta)
 class Keyring(object):
     """Parent interface for Keyring classes.
 
     .. versionadded:: 1.5.0
     """
 
+    @abc.abstractmethod
     def on_encrypt(self, encryption_materials):
         # type: (EncryptionMaterials) -> EncryptionMaterials
         """Generate a data key if not present and encrypt it using any available wrapping key.
@@ -39,6 +45,7 @@ def on_encrypt(self, encryption_materials):
         """
         raise NotImplementedError("Keyring does not implement on_encrypt function")
 
+    @abc.abstractmethod
     def on_decrypt(self, decryption_materials, encrypted_data_keys):
         # type: (DecryptionMaterials, Iterable[EncryptedDataKey]) -> DecryptionMaterials
         """Attempt to decrypt the encrypted data keys.