DNV.Dapr.DataProtection 2.1.0-preview.1756358515

DNV.Dapr.DataProtection

A .NET library that integrates Dapr's cryptography and state store capabilities with ASP.NET Core Data Protection system.

Overview

This library provides seamless integration between Dapr's distributed application building blocks and .NET's Data Protection APIs, enabling secure key storage and encryption in distributed environments.

Target Framework

• .NET 8.0

Features

• Dapr State Store Integration: Persist Data Protection keys in Dapr state stores
• Dapr Cryptography Integration: Protect keys using Dapr's cryptography building blocks
• XML Repository: Store and retrieve Data Protection keys as XML in Dapr state stores
• XML Cipher: Encrypt and decrypt Data Protection keys using Dapr crypto APIs

Dependencies

• Microsoft.AspNetCore.DataProtection
• Dapr.Client

Key Components

DaprStateStoreXmlRepository

Implements IXmlRepository to store Data Protection keys in a Dapr state store.

DaprXmlCipher

Implements IXmlEncryptor and IXmlDecryptor to encrypt and decrypt Data Protection keys using Dapr's cryptography APIs.

Extension Methods

Provides convenient extension methods for configuring Data Protection with Dapr:

• PersistKeysToDaprStateStore() - Configure key persistence to Dapr state store
• ProtectKeysWithDaprCrypto() - Configure key protection using Dapr crypto

Configuration Options

DaprStateStoreOptions

• ComponentName: Name of the Dapr state store component
• KeyName: Key name used to store the XML repository data

DaprXmlCipherOptions

• ComponentName: Name of the Dapr cryptography component
• KeyName: Key name used for encryption/decryption operations

Author

Eric Liu li.eric.liu@dnv.com

Usage

Basic Setup

services.AddDataProtection()
    .PersistKeysToDaprStateStore("statestore", "dataprotection-keys")
    .ProtectKeysWithDaprCrypto("crypto", "master-key");

Advanced Configuration

services.AddDataProtection()
    .PersistKeysToDaprStateStore(o => { 
        o.ComponentName = "my-state-store"; 
        o.KeyName = "custom-key-name";
    }) 
    .ProtectKeysWithDaprCrypto(o => { 
        o.ComponentName = "my-crypto-component"; 
        o.KeyName = "encryption-key";
    });

Configuration Options

DaprStateStoreOptions

• ComponentName: Name of the Dapr state store component
• KeyName: Key name used to store the XML repository data

DaprXmlCipherOptions

• ComponentName: Name of the Dapr cryptography component
• KeyName: Key name used for encryption/decryption operations

Author

Eric Liu li.eric.liu@dnv.com