AdapterFramework.Data.Framework.DataProtectionProvider
2.1.0
dotnet add package AdapterFramework.Data.Framework.DataProtectionProvider --version 2.1.0
NuGet\Install-Package AdapterFramework.Data.Framework.DataProtectionProvider -Version 2.1.0
<PackageReference Include="AdapterFramework.Data.Framework.DataProtectionProvider" Version="2.1.0" />
<PackageVersion Include="AdapterFramework.Data.Framework.DataProtectionProvider" Version="2.1.0" />
<PackageReference Include="AdapterFramework.Data.Framework.DataProtectionProvider" />
paket add AdapterFramework.Data.Framework.DataProtectionProvider --version 2.1.0
#r "nuget: AdapterFramework.Data.Framework.DataProtectionProvider, 2.1.0"
#:package AdapterFramework.Data.Framework.DataProtectionProvider@2.1.0
#addin nuget:?package=AdapterFramework.Data.Framework.DataProtectionProvider&version=2.1.0
#tool nuget:?package=AdapterFramework.Data.Framework.DataProtectionProvider&version=2.1.0
AVEVA Adapter Framework
The AVEVA Adapter Framework is a cross-platform, modular .NET framework for building Edge Data Store and AVEVA Adapter applications that collect data from various data sources and egress it to OMF (Open Message Format) endpoints, such as CONNECT data services and on-premises PI Server via PI Web API.
The framework is published as a set of composable NuGet packages that provide the runtime, abstractions, and supporting services needed to build, host, and operate adapters on modern .NET. Reference only the packages you need — each is designed to be used independently or together as part of a complete adapter host.
Features
- Adapter hosting and lifecycle management
- Common abstractions and base classes for building adapters
- Configuration, registry, component identity, and endpoint management
- Data buffering, compression, and durable persistent queueing
- Reliable OMF egress with failover and high-availability support
- Serialization, messaging, and message processing pipelines
- Structured logging, diagnostics, health monitoring, and data protection
Getting started
Install the packages you need from NuGet. For example, to implement and run a basic adapter:
dotnet add package AdapterFramework.Data.Framework.Abstractions
dotnet add package AdapterFramework.Data.Framework.AdapterCommon
dotnet add package AdapterFramework.Data.Framework.Host
Typical usage:
- Reference Abstractions and AdapterCommon to implement an adapter.
- Reference Host to compose and run the full adapter system.
- Add capability-specific packages (buffering, compression, failover, etc.) as your scenario requires.
See the package reference below for the capability each package provides.
Package reference
The AVEVA Adapter Framework is distributed as the following NuGet packages. All
packages share the AdapterFramework.Data prefix and can be installed with
dotnet add package <PackageName>.
Core
| Package | Description |
|---|---|
| AdapterFramework.Data.DataModel | Core data model/types shared across the adapter framework. |
| AdapterFramework.Data.Framework.Abstractions | Shared interfaces and contracts for configuration, security, events, health, and message processing. |
| AdapterFramework.Data.Framework.Common | Common shared utilities, HTTP communication constants, security helpers, and health models. |
| AdapterFramework.Data.Framework.AdapterCommon | Common adapter base classes, history recovery, scheduling, and discovery. |
| AdapterFramework.Data.Framework.Host | Executable host application that composes and runs the full adapter system. |
Configuration and identity
| Package | Description |
|---|---|
| AdapterFramework.Data.Framework.ConfigurationProvider | Configuration management and persistence with ASP.NET Core integration and command handling. |
| AdapterFramework.Data.Framework.ComponentIdProvider | Component identity service for registering and resolving adapter component IDs. |
| AdapterFramework.Data.Framework.Registry | Component registry for adapter registration, discovery, and configuration mapping. |
| AdapterFramework.Data.Framework.CancellationTokenService | Centralized cancellation-token management for framework operations. |
Messaging and data flow
| Package | Description |
|---|---|
| AdapterFramework.Data.Framework.Messages | OMF message type definitions and serialized message models. |
| AdapterFramework.Data.Framework.Messageprocessor | Adapter message processing logic with data filtering and partitioning. |
| AdapterFramework.Data.Framework.Dataflow | Data flow pipeline components for routing and processing OMF messages between adapter stages. |
| AdapterFramework.Data.Framework.Serialization | OMF message serialization and deserialization. |
| AdapterFramework.Data.Framework.Compression | Message compression and decompression for OMF payloads sent to endpoints. |
Buffering and delivery
| Package | Description |
|---|---|
| AdapterFramework.Data.Framework.Buffering | Persistent OMF message buffering and queuing for reliable delivery. |
| AdapterFramework.Data.Framework.PersistentQueue | Low-level durable file-based queue implementation with CRC32 integrity checks. |
| AdapterFramework.Data.Framework.EgressComponent | Egress component for outbound OMF data delivery to configured endpoints. |
| AdapterFramework.Data.Framework.EndpointManager | HTTP endpoint management, OMF egress, and multi-endpoint orchestration. |
| AdapterFramework.Data.Framework.Failover | Failover and high-availability support with heartbeat-based group coordination. |
Diagnostics, logging, and security
| Package | Description |
|---|---|
| AdapterFramework.Data.Framework.Logger | Structured logging implementation using Serilog with console and file sinks. |
| AdapterFramework.Data.Framework.Diagnostics | Health monitoring, diagnostics counters, and status reporting for adapter components. |
| AdapterFramework.Data.Framework.Dataprotectionprovider | Bootstraps and provides ASP.NET Core Data Protection services for the adapter. |
| AdapterFramework.Data.Framework.DataProtector | Encryption and decryption of sensitive configuration values using ASP.NET Core Data Protection. |
| AdapterFramework.Data.Framework.Extensions | Low-level utility and extension methods with unsafe code support. |
Target framework
These packages target .NET 10.
Project and source
- Project site: https://github.com/AVEVA/adapter-framework
- Source repository: https://github.com/AVEVA/adapter-framework
License
Licensed under the Apache License, Version 2.0.
Copyright 2018-2026 AVEVA Group Limited
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
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License 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.
SPDX-License-Identifier: Apache-2.0
About AVEVA
AVEVA is a global leader in industrial software. For more information, visit https://www.aveva.com.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- AdapterFramework.Data.Framework.Abstractions (>= 2.1.0)
- AdapterFramework.Data.Framework.Common (>= 2.1.0)
- AdapterFramework.Data.Framework.Extensions (>= 2.1.0)
- Microsoft.AspNetCore.DataProtection.Extensions (>= 10.0.10)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on AdapterFramework.Data.Framework.DataProtectionProvider:
| Package | Downloads |
|---|---|
|
AdapterFramework.Data.Framework.Host
AVEVA Adapter Framework - AdapterFramework.Data.Framework.Host. Part of the Adapter Framework used to build data adapters for AVEVA CONNECT and PI System. |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 2.1.0 | 195 | 8/17/2026 |