OPCFoundation.NetStandard.Opc.Ua.Gds.Server 2.0.2

Prefix Reserved
dotnet add package OPCFoundation.NetStandard.Opc.Ua.Gds.Server --version 2.0.2
                    
NuGet\Install-Package OPCFoundation.NetStandard.Opc.Ua.Gds.Server -Version 2.0.2
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="OPCFoundation.NetStandard.Opc.Ua.Gds.Server" Version="2.0.2" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="OPCFoundation.NetStandard.Opc.Ua.Gds.Server" Version="2.0.2" />
                    
Directory.Packages.props
<PackageReference Include="OPCFoundation.NetStandard.Opc.Ua.Gds.Server" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add OPCFoundation.NetStandard.Opc.Ua.Gds.Server --version 2.0.2
                    
#r "nuget: OPCFoundation.NetStandard.Opc.Ua.Gds.Server, 2.0.2"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package OPCFoundation.NetStandard.Opc.Ua.Gds.Server@2.0.2
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=OPCFoundation.NetStandard.Opc.Ua.Gds.Server&version=2.0.2
                    
Install as a Cake Addin
#tool nuget:?package=OPCFoundation.NetStandard.Opc.Ua.Gds.Server&version=2.0.2
                    
Install as a Cake Tool

OPC UA .NET Standard — GDS server

OPCFoundation.NetStandard.Opc.Ua.Gds.Server is the server-side library for the OPC UA Global Discovery Server (GDS) — OPC 10000-12 (Part 12). It implements the GDS service-call surface on top of Opc.Ua.Server, with pluggable ICertificateGroupProvider / IApplicationsDatabase / ICertificateRequest providers so the backing certificate authority and applications store can be swapped to match the deployment.

Overview

Reference this package from a GDS executable. The standard applications-database provider ships an in-process LINQ implementation; production deployments usually plug a real database back-end behind the same IApplicationsDatabase surface.

The package also provides the OPC 10000-21 registrar administration surface. Load the generated Opc.Ua.Onboarding nodes from Opc.Ua.Gds, then bind DeviceRegistrarAdminState to an ITicketStore with BindToTicketStore. MemoryTicketStore is provided for samples and tests. AddFileSystemOnboardingTicketStore selects the filesystem implementation for a single writer, retaining exact ticket envelopes and metadata across restarts without changing trust policy. It rejects damaged state and competing store registrations. Hosts sharing storage across processes need a provider with storage-level coordination; the filesystem adapter only serializes calls within one instance.

AddDeviceRegistrarPushScheduler<TProcessor> connects one bounded in-memory queue to the host lifetime and IDeviceRegistrarPushScheduler. The processor owns actual provisioning and retained recovery state. Queue failures are reported; uncertain remote operations are not automatically repeated. Durable acceptance requires a separately supplied scheduler.

OnboardingPushIdentityValidator uses the registrar's ticket-scoped identity selector to check the actual authenticated server certificate of a push device. It reads RequestTickets through a generation-bound encrypted session; discovery metadata cannot substitute for the channel peer. CaptureAsync retains that generation for subsequent generated clients through OnboardingPushSession.Session; replacement sessions and channels cannot receive requests authorized by the earlier admission. Disposing the context never closes the caller's connection. This validator does not install certificates or complete the push onboarding flow.

AddDeviceRegistrarPush selects a generated-client processor and the bounded queue. The processor checks actual-peer identity and persisted software approval, uploads an existing request-correlated certificate and complete trust list, and requires a new channel proving the installed credential before promotion. AddDeviceRegistrarPushConnections supplies fresh authenticated sessions through the existing session factory, with host-selected endpoints, credentials and namespace-stable model addresses. It checks the actual installed peer and retains cleanup failures without changing global certificate trust. AddDeviceRegistrarPushEnrollments binds a secret-store enrollment journal to the actual hosted GDS, reusing its authority, approval queue and issuance receipt store. It retains original CSR and request evidence, resumes accepted issuance through its receipt and requires explicit original-evidence recovery after an uncertain key-creation or queue-insertion outcome. FindRequestAsync exposes retained requests for administrative approval. Hosts must select storage that survives restart and ensure one provider owns each journal scope; the default in-memory secret store does not meet that durability requirement. Custom hosts can still supply IDeviceRegistrarPushEnrollmentProvider.

ProvisionableDeviceSecurityInstaller supplies local application-certificate installation, explicit endpoint activation and reset through a separate retained device-identity key and captured TrustList defaults. The selected secret and certificate stores own restart durability. The device security gate retains the first authorized registrar before protected configuration proceeds; restart preserves that owner, and reset releases it. Fluent hosting installs that same owner as IPushConfigurationAuthorization for standard push mutations and TrustList writes. The existing transaction coordinator records installed device security after committing the store changes and compensates them if completion fails. Recovery verifies applied credentials against actual keyed certificate and trust stores instead of replaying them over a compensated transaction. Custom installers and coordinators need the applied-security capture and transaction-completion contracts for standard push. The repository's OnboardingDevice sample composes these providers with retained factory keys, restricted public journals and local/network reset. It hosts a singleton device by default; --managedApplicationUris selects a non-singleton device with separate managed Client application components and URI-specific certificate stores. The sample does not run those client applications, so it does not exercise active-channel rotation or trust revalidation for them. The device node manager adds a Part 22 Resources parent reference; the shared Base Network integration and verified connected interoperability evidence remain pending.

For a non-singleton device, implement IProvisionableDeviceApplicationsProvider and register it with AddProvisionableDeviceApplications on the server builder. The device node manager publishes each returned ApplicationConfigurationType as a component before the address space is available. This provider is separate from the GDS IManagedApplicationPushProvider; its targets own their application runtimes and certificate managers. Each binding requires installed device registrar trust and applies the optional software-update policy before the application-specific authorization. A singleton device with application components is rejected. This API does not proxy remote ConfigurationFile transactions for GDS-managed applications.

Deployments requiring software updates register IProvisionableDeviceSoftwareUpdatePolicy through AddProvisionableDeviceSoftwareUpdatePolicy. The concrete installer checks the existing software manager's durable readiness state before changing credentials or accepting an applied DCA certificate, including during startup recovery. Incomplete updates or missing approval stop that operation. Factory identity capture and security reset do not require approval or modify software state. Omitting the policy declares that no software update is required; it does not perform an update.

Singleton application scope is retained in the shared lifecycle and enforced for subsequent managed-application registration and certificate access. The filesystem provider writes version 2 checkpoints; version 1 devices load with managed-application access prohibited because those checkpoints contain no scope evidence. Custom lifecycle providers need IDeviceRegistrarApplicationScopeLifecycle to authorize managed applications.

Target frameworks

net48, net8.0, net9.0, net10.0.

Additional documentation

See the main repository README and the GDS guide.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  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. 
.NET Framework net48 is compatible.  net481 was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (2)

Showing the top 2 NuGet packages that depend on OPCFoundation.NetStandard.Opc.Ua.Gds.Server:

Package Downloads
OPCFoundation.NetStandard.Opc.Ua

This package contains the OPC UA reference implementation and is targeting the .NET Standard Library.

OPCFoundation.NetStandard.Opc.Ua.Quickstarts.Servers

OPC UA Quickstarts Servers Class Library

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2.0.2 2,687 11/11/2026
2.0.1 17,658 10/12/2026
2.0.0 2,587 10/7/2026
2.0.0-preview.6 119 9/30/2026
2.0.0-preview.5 176 9/17/2026