This repository has been archived on 2025-09-14. You can view files and clone it, but cannot push or open issues or pull requests.
Files

69 lines
2.9 KiB
C++

/**
* Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
* SPDX-License-Identifier: Apache-2.0.
*/
#pragma once
#include <aws/core/Aws.h>
#include <aws/core/utils/crypto/ContentCryptoMaterial.h>
#include <aws/s3-encryption/s3Encryption_EXPORTS.h>
#include <aws/s3/model/GetObjectResult.h>
#include <aws/s3/model/PutObjectRequest.h>
#include <aws/s3/model/HeadObjectResult.h>
namespace Aws
{
namespace S3Encryption
{
static const char* const MetadataHandler_Tag = "MetadataHandler";
static const char* const DEPRECATED_CONTENT_KEY_HEADER = "x-amz-key";
static const char* const CONTENT_KEY_HEADER = "x-amz-key-v2";
static const char* const IV_HEADER = "x-amz-iv";
static const char* const MATERIALS_DESCRIPTION_HEADER = "x-amz-matdesc";
static const char* const CONTENT_CRYPTO_SCHEME_HEADER = "x-amz-cek-alg";
static const char* const CRYPTO_TAG_LENGTH_HEADER = "x-amz-tag-len";
static const char* const KEY_WRAP_ALGORITHM = "x-amz-wrap-alg";
static const char* const INSTRUCTION_FILE_HEADER = "x-amz-crypto-instr-file";
static const size_t AES_GCM_IV_BYTES = 12;
static const size_t AES_GCM_KEY_BYTES = 32;
static const size_t AES_GCM_TAG_BYTES = 16;
static const size_t AES_KEY_WRAP_ENCRYPTED_CEK_BYTES = 40;
namespace Handlers
{
/*
Data handler class will be responsible for reading and writing metadata and instruction files to and from S3 object using a Put object
request or a Get object result.
*/
class AWS_S3ENCRYPTION_API DataHandler
{
public:
/*
Override this function to write content crypto material data to S3 object request.
*/
virtual void PopulateRequest(Aws::S3::Model::PutObjectRequest& request, const Aws::Utils::Crypto::ContentCryptoMaterial& contentCryptoMaterial) = 0;
/*
Override this function to read data from an S3 object and return a Content Crypto Material object.
*/
virtual Aws::Utils::Crypto::ContentCryptoMaterial ReadContentCryptoMaterial(Aws::S3::Model::GetObjectResult& result) = 0;
/*
Function to json serialize a map contianing pairs of strings.
*/
const Aws::String SerializeMap(const Aws::Map<Aws::String, Aws::String>& currentMap);
/*
Function to deserialize a string to map.
*/
const Aws::Map<Aws::String, Aws::String> DeserializeMap(const Aws::String& jsonString);
protected:
/*
* Function to read meta data and return a content crypto material object.
*/
Aws::Utils::Crypto::ContentCryptoMaterial ReadMetadata(const Aws::Map<Aws::String, Aws::String>& metadata);
};
}
}
}