Overview
Licensing
This page explains licensing from the end user's perspective: what is needed, how to obtain the license, and how to apply it.
How to obtain a license
Review the prices and the databases covered by each tier (Launch price, Standard, Enterprise: all with every feature) and purchase on the public site:
- WUIC pricing and plans — wuic-framework.com/pricing
- Contact sales — no license is needed to evaluate: without one the framework runs in Trial mode (20 records per query)
- WUIC homepage
After purchase you will receive an email with license-payload + license-signature to install as described in the "End User Procedure" below.
How It Works
- The license is valid only if:
- correct signature.
machineFingerprintof the current server is present in themachineFingerprintslist of the signed payload.- the license has not expired (
expiryUtc). A license that expires while the server is running stops being valid within 5 minutes (the validation is cached for that long), with no restart needed. - maintenance: the installed version is not newer than the end of maintenance (
maintenanceExpiryUtc). If the build is later, the license is not valid (maintenance_expired), even if it has not expired. - database: if the signed payload has the
databasesfield, the installation'sdbmsvalue must be one of those listed (Standard tier:mysql,postgresql). Otherwise the license is not valid (database_not_licensed) and the installation stays in Trial. Without the field the license is valid on every database: that is the case of the Launch price and Enterprise tiers and of every license issued before the field. - If the license is not valid, data reading (
getFlatRecordData) is limited to a maximum of 20 records. That is the only Trial limit: every feature (spreadsheet, pivot, workflow, report and dashboard designers, RAG chatbot, offline-crud, host hooks such ascustomizeSelect) stays available, including with a license that lists only some features.
Where to Find the machineFingerprint
Backend endpoint:
GET /api/Meta/LicenseStatus→ fieldmachineFingerprint(also without a license; since 1.7.28 only to the verified superadmin, likelicenseEmailandforceRefresh=true). Without a sessionLicenseStatusreturns onlylicenseValid,tier,features,bundledHostandbundledHostAppId; with a session also expiry dates, reason and DBMS. With a session there is alsolicensedDatabases, the databases the license allows (empty = all), to be read next todataDbms.- During the first run it is also exposed by
GET /api/Meta/FirstRunStatus. - If the machine identity changes (cloned VM, recreated container) the fingerprint changes too: ask the vendor for a license for the new fingerprint (
machineFingerprintfromLicenseStatus).
Note: the local file installation.id is no longer used by licensing.
End User Procedure
1. Retrieve machineFingerprint from your host.
2. Send the value to the vendor/licensor.
3. Receive the license values:
license-payloadlicense-signature
4. Paste the values from the UI: Administration > AppSettings Editor, License section (fields License email, License payload, License signature), then save. The public key that verifies the signature is built into the framework and is not configurable (the editor no longer has a Public key (PEM) field, and license-public-key-pem in appsettings is ignored). Alternatively you can write them by hand in the AppSettings section of the running host's appsettings.{Environment}.json. The AppSettings editor requires a session with the superadmin role, checked server-side.
5. Verify the license status:
- from the API:
GET /api/Meta/LicenseStatus, expectedlicenseValid = true; - or from the page itself, which re-reads the license right after saving.
No backend restart is needed when you go through the editor. Saving license-payload / license-signature from the AppSettings Editor makes the backend refresh the validation service on its own, and the license applies from the next request. A restart is only needed in the other case, when the values are written by hand in the file: that one is read at startup.
Free apps
The free apps (FatturazioneElettronica, CrmApp, FlottaMezzi) ship in two distributions:
- binary (
-iis-zip): free, no license. The assembly is signed by the vendor and carries an embedded host binding license that authorizes the framework only for that application as distributed (LicenseStatusanswers withbundledHostandbundledHostAppId); - sources (
-src-zip): once recompiled, the vendor signature is gone and the procedure of this page applies, with the machine fingerprint. The free apps run on SQL Server: you need a tier that covers it (Launch price or Enterprise). Without a license the recompiled application runs in Trial mode.
Details on the page Free apps.
Multi-Machine License
A single license can authorize multiple machines by including multiple values in machineFingerprints.
Quick Troubleshooting
licenseReason = invalid_signature:- payload/signature are not consistent with each other (copied incompletely or modified) or were signed with a key other than the vendor's.
licenseReason = machine_fingerprint_not_authorized:- the current machine's fingerprint is not present in the received license.
licenseReason = machine_fingerprint_missing:- the runtime cannot calculate the local fingerprint.
licenseReason = license_expired:- the license has expired, request renewal.
licenseReason = maintenance_expired:- maintenance ended before the build date of the installed version: install a version released before the end of maintenance or renew maintenance.
licenseReason = database_not_licensed:- the license is valid only for the databases in
licensedDatabasesand the installation runs ondataDbms, which is not one of them: a Standard license covers MySQL and PostgreSQL, SQL Server and Oracle need Enterprise.
Screenshot
