Note
What a station checks before loading a module
Signing is not a formality bolted on at the end. It is a load-time gate with three settings, and the default one refuses unsigned code.
- Module signing
- Certificates
- Deployment
The three modes
A Niagara host decides how strict to be about module signatures with a single
system property, niagara.moduleVerificationMode. It takes three
values, and the distinction between them is about the certificate, not
about whether a signature exists.
| Mode | What the host requires |
|---|---|
| low | Warnings only — an unsigned module still loads. Documented as an option that will be removed in a future release, so anything depending on it has a deadline whether or not anyone has written it down. |
| medium | The current default. Modules must be signed by a valid, trusted certificate. Trusted means present in that host's trust store — which is a per-host fact, not a property of your certificate. |
| high | Valid, trusted and CA-issued. An internal CA is acceptable, so this does not automatically mean buying a certificate, but it does rule out a bare self-signed key. |
Default is medium, and that is the number that matters. An unsigned module does not install on a stock station or a stock controller. Not "warns", not "logs" — refused.
Trusted is a property of the host
The most common surprise is a module that installs on one host and is refused by the next, with the same jar and the same signature. Nothing about the module changed; the second host does not have the signing certificate in its trust store.
This is why "is it signed?" is the wrong question when something will not install. The question is "is this certificate trusted by this host, and does this host demand a CA behind it?" The answer is per host, and on an estate assembled over several years the answer varies across the estate.
You cannot talk a station out of it at the command line
There is a matching property, a command-line property blacklist, whose job is to stop somebody setting the verification mode — among other security-relevant properties — as a launch argument. The intent is plain: the strictness of module verification is a decision made in the host's configuration by whoever administers it, not something a process can lower for itself on the way up.
Treat a plan that involves relaxing verification as a plan that will be rejected during commissioning.
Program objects are gated separately
Modules are not the only executable thing in a station. Program objects have their own signing requirement, with its own property, defaulting to permissive — unsigned program objects run. A site that has tightened module verification and left program objects alone has a gap it very likely does not know about, and closing it is a one-line configuration change plus the work of signing what is already there.
Practical consequences
- Sign in development, not at the end. A build that produces unsigned jars for months and signs once before delivery discovers every trust and packaging problem on the day of delivery.
- Decide self-signed or CA early. Self-signed with the certificate distributed to the estate's trust stores is coherent for an internal estate. Anything sold or shipped to third parties needs a CA behind it, and obtaining a code-signing certificate now requires hardware key storage — which takes lead time and money, so it belongs in the plan, not the last week.
- Record which certificate signed which release. When a certificate expires or is replaced, the question "what is out there signed by the old one" needs an answer that is not an estate-wide search.
Related
Where this comes up in the work
Custom modules & drivers
Bespoke Niagara rt, wb and ux modules and drivers written against the Baja API: pure Java, signed, and stamped to install across a mixed estate.
Station engineering
Niagara station and controller setup end to end: platform commissioning, TLS, users and roles, BACnet and Modbus, tagging, histories, alarms, backups.
More notes
Other things worth writing down
Which Niagara version to stamp a module for
A module's declared dependency version is a floor, not a pin. Build against the newest SDK you have and stamp for the oldest station it has to load on.
- Module development
- Mixed estates
- Build tooling
Pure Java, or it will not run on a JACE
A controller is an ARM host with a fraction of a server's memory. Native libraries, JNI and heavyweight dependencies do not survive the move from a PC.
- JACE
- Controllers
- Module development
Renaming and tagging points in bulk
Point names arrive from the field device and there is no standard. What to use to select, rename and tag in bulk — and what a rename quietly breaks.
- Bulk engineering
- Tagging
- Workbench
Next step
Tell us the version, the hardware, and what it has to do.
You will get a written scope and a fixed price against it. If the honest answer is that you do not need us, you will get that instead.