cloud/blockstore/libs/encryption/encryption_key.cpp - main - githubmirror/nbs

cloud/blockstore/libs/encryption/encryption_key.cpp
289 строк8 KB
Kirill Pleshivtsev
Introduce UnsafeExtractValue for workaround broken semantics of TFuture::ExtractValue() (#5318)
25 фев 2026, 18:36
25 фев 2026, 18:365ab7a4d
#include "encryption_key.h"

#include <cloud/storage/core/libs/common/future_helper.h>
#include <cloud/storage/core/libs/endpoints/keyring/keyring.h>

#include <library/cpp/string_utils/base64/base64.h>

#include <util/string/builder.h>
#include <util/system/file.h>

#include <openssl/sha.h>

namespace NCloud::NBlockStore {

using namespace NThreading;

namespace {

////////////////////////////////////////////////////////////////////////////////

TString ComputeSHA384Hash(const TString& encryptionKey)
{
    SHA512_CTX ctx;
    SHA384_Init(&ctx);
    const ui8 version = 1;
    SHA384_Update(&ctx, &version, sizeof(version));
    ui32 keySize = encryptionKey.size();
    SHA384_Update(&ctx, &keySize, sizeof(keySize));
    SHA384_Update(&ctx, encryptionKey.data(), encryptionKey.size());

    TString hash;
    hash.resize(SHA384_DIGEST_LENGTH);
    SHA384_Final(reinterpret_cast<unsigned char*>(hash.Detach()), &ctx);
    return hash;
}

ui32 GetExpectedKeyLength(NProto::EEncryptionMode mode)
{
    switch (mode) {
        case NProto::NO_ENCRYPTION:
            return 0;
        case NProto::ENCRYPTION_AES_XTS:
        case NProto::ENCRYPTION_WITH_ROOT_KMS_PROVIDED_KEY:
            return 32;
        default:
            STORAGE_THROW_SERVICE_ERROR(E_ARGUMENT)
                << "Unknown encryption mode: "
                << static_cast<int>(mode);
    }
}

////////////////////////////////////////////////////////////////////////////////

class TEncryptionKeyProvider final
    : public IEncryptionKeyProvider
{
private:
    const IKmsKeyProviderPtr KmsKeyProvider;
    const IRootKmsKeyProviderPtr RootKmsKeyProvider;

public:
    TEncryptionKeyProvider(
            IKmsKeyProviderPtr kmsKeyProvider,
            IRootKmsKeyProviderPtr rootKmsKeyProvider)
        : KmsKeyProvider(std::move(kmsKeyProvider))
        , RootKmsKeyProvider(std::move(rootKmsKeyProvider))
    {}

    TFuture<TResponse> GetKey(
        const NProto::TEncryptionSpec& spec,
        const TString& diskId) override
    {
        auto len = GetExpectedKeyLength(spec.GetMode());
        const auto& keyPath = spec.GetKeyPath();

        if (keyPath.HasKeyringId()) {
            return MakeFuture(ReadKeyFromKeyring(keyPath.GetKeyringId(), len));
        }

        if (keyPath.HasFilePath()) {
            return MakeFuture(ReadKeyFromFile(keyPath.GetFilePath(), len));
        }

        if (keyPath.HasKmsKey()) {
            if (spec.GetMode() == NProto::ENCRYPTION_WITH_ROOT_KMS_PROVIDED_KEY)
            {
                return ReadKeyFromRootKMS(keyPath.GetKmsKey(), diskId, len);
            }

            return ReadKeyFromKMS(keyPath.GetKmsKey(), diskId, len);
        }

        return MakeFuture<TResponse>(TErrorResponse(
            E_ARGUMENT,
            "KeyPath should contain path to encryption key"));
    }

private:
    TResponse ReadKeyFromKeyring(ui32 keyringId, ui32 expectedLen)
    {
        return SafeExecute<TResponse>([&] () -> TResponse {
            auto keyring = TKeyring::Create(keyringId);

            if (keyring.GetValueSize() != expectedLen) {
                return MakeError(E_ARGUMENT, TStringBuilder()
                    << "Key from keyring " << keyringId
                    << " should has size " << expectedLen);
            }

            return TEncryptionKey(keyring.GetValue());
        });
    }

    TResponse ReadKeyFromFile(TString filePath, ui32 expectedLen)
    {
        return SafeExecute<TResponse>([&] () -> TResponse {
            TFile file(
                filePath,
                EOpenModeFlag::OpenExisting | EOpenModeFlag::RdOnly);

            if (file.GetLength() != expectedLen) {
                return MakeError(E_ARGUMENT, TStringBuilder()
                    << "Key file " << filePath.Quote()
                    << " size " << file.GetLength() << " != " << expectedLen);
            }

            TString key = TString::TUninitialized(expectedLen);
            auto size = file.Read(key.begin(), expectedLen);
            if (size != expectedLen) {
                return MakeError(E_ARGUMENT, TStringBuilder()
                    << "Read " << size << " bytes from key file "
                    << filePath.Quote() << ", expected " << expectedLen);
            }

            return TEncryptionKey(std::move(key));
        });
    }

    TFuture<TResponse> ReadKeyFromKMS(
        const NProto::TKmsKey& kmsKey,
        const TString& diskId,
        ui32 expectedLen)
    {
        auto future = KmsKeyProvider->GetKey(kmsKey, diskId);
        return future.Apply(
            [diskId, expectedLen]   //
            (const TFuture<TResultOrError<TEncryptionKey>>& f) -> TResponse
            {
                auto response = UnsafeExtractValue(f);
                if (HasError(response)) {
                    return response.GetError();
                }

                auto key = response.ExtractResult();
                if (key.GetKey().size() != expectedLen) {
                    return MakeError(
                        E_INVALID_STATE,
                        TStringBuilder() << "Key from KMS for disk " << diskId
                                         << " should has size " << expectedLen);
                }

                return std::move(key);
            });
    }

    TFuture<TResponse> ReadKeyFromRootKMS(
        const NProto::TKmsKey& kmsKey,
        const TString& diskId,
        ui32 expectedLen)
    {
        auto future = RootKmsKeyProvider->GetKey(kmsKey, diskId);
        return future.Apply(
            [diskId, expectedLen]   //
            (const TFuture<TResultOrError<TEncryptionKey>>& f) -> TResponse
            {
                auto response = UnsafeExtractValue(f);
                if (HasError(response)) {
                    return response.GetError();
                }

                auto key = response.ExtractResult();
                if (key.GetKey().size() != expectedLen) {
                    return MakeError(
                        E_INVALID_STATE,
                        TStringBuilder()
                            << "Key from Root KMS for disk " << diskId
                            << " should has size " << expectedLen);
                }

                return std::move(key);
            });
    }
};

////////////////////////////////////////////////////////////////////////////////

class TKmsKeyProviderStub
    : public IKmsKeyProvider
{
public:
    TFuture<TResponse> GetKey(
        const NProto::TKmsKey& kmsKey,
        const TString& diskId) override
    {
        Y_UNUSED(kmsKey);
        Y_UNUSED(diskId);
        return MakeFuture<TResponse>(
            MakeError(E_ARGUMENT, "KmsKeyProviderStub can't get key"));
    }
};

////////////////////////////////////////////////////////////////////////////////

class TRootKmsKeyProviderStub final
    : public IRootKmsKeyProvider
{
public:
    auto GetKey(const NProto::TKmsKey& kmsKey, const TString& diskId)
        -> TFuture<TResultOrError<TEncryptionKey>> override
    {
        Y_UNUSED(kmsKey);
        Y_UNUSED(diskId);

        return MakeFuture<TResultOrError<TEncryptionKey>>(
            MakeError(E_ARGUMENT, "RootKmsKeyProviderStub can't get key"));
    }

    auto GenerateDataEncryptionKey(const TString& diskId)
        -> TFuture<TResultOrError<NProto::TKmsKey>> override
    {
        Y_UNUSED(diskId);

        return MakeFuture<TResultOrError<NProto::TKmsKey>>(
            MakeError(E_ARGUMENT, "RootKmsKeyProviderStub can't generate key"));
    }
};

}   // namespace

////////////////////////////////////////////////////////////////////////////////

TEncryptionKey::TEncryptionKey(TString key)
    : Key(std::move(key))
{}

TEncryptionKey::~TEncryptionKey()
{
    SecureZero(Key.begin(), Key.size());
}

const TString& TEncryptionKey::GetKey() const
{
    return Key;
}

TString TEncryptionKey::GetHash() const
{
    return Base64Encode(ComputeSHA384Hash(Key));
}

////////////////////////////////////////////////////////////////////////////////

IKmsKeyProviderPtr CreateKmsKeyProviderStub()
{
    return std::make_shared<TKmsKeyProviderStub>();
}

IRootKmsKeyProviderPtr CreateRootKmsKeyProviderStub()
{
    return std::make_shared<TRootKmsKeyProviderStub>();
}

IEncryptionKeyProviderPtr CreateEncryptionKeyProvider(
    IKmsKeyProviderPtr kmsKeyProvider,
    IRootKmsKeyProviderPtr rootKmsKeyProvider)
{
    return std::make_shared<TEncryptionKeyProvider>(
        std::move(kmsKeyProvider),
        std::move(rootKmsKeyProvider));
}

IEncryptionKeyProviderPtr CreateDefaultEncryptionKeyProvider()
{
    return CreateEncryptionKeyProvider(
        CreateKmsKeyProviderStub(),
        CreateRootKmsKeyProviderStub());
}

}   // namespace NCloud::NBlockStore