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
<PackageReference Include="OPCFoundation.NetStandard.Opc.Ua.Gds.Server" Version="2.0.2" />
<PackageVersion Include="OPCFoundation.NetStandard.Opc.Ua.Gds.Server" Version="2.0.2" />
<PackageReference Include="OPCFoundation.NetStandard.Opc.Ua.Gds.Server" />
paket add OPCFoundation.NetStandard.Opc.Ua.Gds.Server --version 2.0.2
#r "nuget: OPCFoundation.NetStandard.Opc.Ua.Gds.Server, 2.0.2"
#:package OPCFoundation.NetStandard.Opc.Ua.Gds.Server@2.0.2
#addin nuget:?package=OPCFoundation.NetStandard.Opc.Ua.Gds.Server&version=2.0.2
#tool nuget:?package=OPCFoundation.NetStandard.Opc.Ua.Gds.Server&version=2.0.2
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 | Versions 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. |
-
.NETFramework 4.8
- BitFaster.Caching (>= 2.6.1)
- BouncyCastle.Cryptography (>= 2.7.0)
- Microsoft.Bcl.AsyncInterfaces (>= 10.0.13)
- Microsoft.Bcl.HashCode (>= 6.0.0)
- Microsoft.Bcl.TimeProvider (>= 10.0.13)
- Microsoft.Extensions.Compliance.Abstractions (>= 10.11.0)
- Microsoft.Extensions.Configuration (>= 10.0.13)
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.13)
- Microsoft.Extensions.DependencyInjection (>= 10.0.13)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Diagnostics (>= 10.0.13)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Http (>= 10.0.13)
- Microsoft.Extensions.Http.Resilience (>= 10.11.0)
- Microsoft.Extensions.Logging (>= 10.0.13)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Options (>= 10.0.13)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.13)
- Microsoft.Extensions.Telemetry (>= 10.11.0)
- Microsoft.Extensions.Telemetry.Abstractions (>= 10.11.0)
- OPCFoundation.NetStandard.Opc.Ua.Client (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Gds (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Server (>= 2.0.2)
- System.Buffers (>= 4.6.1)
- System.Collections.Immutable (>= 9.0.0)
- System.Diagnostics.DiagnosticSource (>= 10.0.13)
- System.Formats.Asn1 (>= 10.0.13)
- System.Memory (>= 4.6.3)
- System.Runtime.CompilerServices.Unsafe (>= 6.1.2)
- System.Text.Json (>= 10.0.13)
- System.Threading.Channels (>= 10.0.13)
- System.Threading.RateLimiting (>= 10.0.13)
- System.Threading.Tasks.Extensions (>= 4.6.3)
-
net10.0
- BitFaster.Caching (>= 2.6.1)
- Microsoft.Bcl.TimeProvider (>= 10.0.13)
- Microsoft.Extensions.Compliance.Abstractions (>= 10.11.0)
- Microsoft.Extensions.Configuration (>= 10.0.13)
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.13)
- Microsoft.Extensions.DependencyInjection (>= 10.0.13)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Diagnostics (>= 10.0.13)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Http (>= 10.0.13)
- Microsoft.Extensions.Http.Resilience (>= 10.11.0)
- Microsoft.Extensions.Logging (>= 10.0.13)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Options (>= 10.0.13)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.13)
- Microsoft.Extensions.Telemetry (>= 10.11.0)
- Microsoft.Extensions.Telemetry.Abstractions (>= 10.11.0)
- OPCFoundation.NetStandard.Opc.Ua.Client (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Gds (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Server (>= 2.0.2)
- System.Threading.RateLimiting (>= 10.0.13)
-
net8.0
- BitFaster.Caching (>= 2.6.1)
- Microsoft.Bcl.TimeProvider (>= 10.0.13)
- Microsoft.Extensions.Compliance.Abstractions (>= 10.11.0)
- Microsoft.Extensions.Configuration (>= 10.0.13)
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.13)
- Microsoft.Extensions.DependencyInjection (>= 10.0.13)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Diagnostics (>= 10.0.13)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Http (>= 10.0.13)
- Microsoft.Extensions.Http.Resilience (>= 10.11.0)
- Microsoft.Extensions.Logging (>= 10.0.13)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Options (>= 10.0.13)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.13)
- Microsoft.Extensions.Telemetry (>= 10.11.0)
- Microsoft.Extensions.Telemetry.Abstractions (>= 10.11.0)
- OPCFoundation.NetStandard.Opc.Ua.Client (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Gds (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Server (>= 2.0.2)
- System.Collections.Immutable (>= 9.0.0)
- System.Diagnostics.DiagnosticSource (>= 10.0.13)
- System.Formats.Asn1 (>= 10.0.13)
- System.Text.Json (>= 10.0.13)
- System.Threading.Channels (>= 10.0.13)
- System.Threading.RateLimiting (>= 10.0.13)
-
net9.0
- BitFaster.Caching (>= 2.6.1)
- Microsoft.Bcl.TimeProvider (>= 10.0.13)
- Microsoft.Extensions.Compliance.Abstractions (>= 10.11.0)
- Microsoft.Extensions.Configuration (>= 10.0.13)
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.13)
- Microsoft.Extensions.DependencyInjection (>= 10.0.13)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Diagnostics (>= 10.0.13)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Http (>= 10.0.13)
- Microsoft.Extensions.Http.Resilience (>= 10.11.0)
- Microsoft.Extensions.Logging (>= 10.0.13)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Options (>= 10.0.13)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.13)
- Microsoft.Extensions.Telemetry (>= 10.11.0)
- Microsoft.Extensions.Telemetry.Abstractions (>= 10.11.0)
- OPCFoundation.NetStandard.Opc.Ua.Client (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Gds (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Server (>= 2.0.2)
- System.Diagnostics.DiagnosticSource (>= 10.0.13)
- System.Formats.Asn1 (>= 10.0.13)
- System.Text.Json (>= 10.0.13)
- System.Threading.Channels (>= 10.0.13)
- System.Threading.RateLimiting (>= 10.0.13)
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 |