The ST team is happy to announce a new release of the stprov software, tag v0.3.5, which succeeds the previous release at tag v0.2.1. The source code for this release is available from the git repository:
git clone -b v0.3.5 https://git.glasklar.is/system-transparency/core/stprov.git
Authoritative ST release signing keys are published at
https://www.system-transparency.org/keys/
and the tag signature can be verified using the command
git -c gpg.format=ssh \ -c gpg.ssh.allowedSignersFile=allowed-ST-release-signers \ tag --verify v0.3.5
The expectations and intended use of the stprov software is documented in the repository's RELEASES file. This RELEASES file also contains more information concerning the overall release process, see:
https://git.glasklar.is/system-transparency/core/stprov/-/blob/v0.3.5/RELEAS...
Learn about what's new in a release from the repository's NEWS file. An excerpt from the latest NEWS-file entry is listed below for convenience.
If you find any bugs, please report them on the System Transparency discuss list or open an issue on GitLab in the stprov repository:
https://lists.system-transparency.org/mailman3/postorius/lists/st-discuss.li... https://git.glasklar.is/system-transparency/core/stprov/-/issues system-transparency-core-stprov-issues@incoming.glasklar.is
Cheers, The ST team
NEWS for stprov v0.3.5
This release mainly improves documentation, test coverage, and fixes bugs. There are a few minor features added relating to the stprov command-line UI, and a little bit of clean-up as summarized in the miscellaneous section.
Incompatible changes
* The -b option no longer accepts interface names that contain comma.
Security fixes:
* The -a option in stprov remote-run accepts addresses in CIDR notation, but falls back on /32 if an address omits the subnet mask. The same subnet mask was used for IPv6, resulting in a much larger subnet. This issue has been fixed, such that the default IPv6 subnet-mask is /128.
Bug fixes
* Produce host configurations that are compatible with stboot (stprov and stboot diverged on how to handle empty values, which has now been fixed). * Correctly set the host configuration fields "bonding_mode" and "bond_name". The bonded interface name is always set to "bond0". * Add a Makefile option for setting custom OS-package URLs. The built-in default used to be hardcoded without a good way of changing it. * Read TLS roots from a location that is consistent with stboot. The consulted location is "/etc/trust_policy/tls_roots.pem". * Several nits and confusions in the stprov usage message were fixed.
New features:
* Options with multiple values can be specified as a comma-separated list (-e val,val) and/or by repeating the option (-e val -e val). This makes the UX consistent for the -a, -b, and other multi-value options. * The -r option can accept multiple OS-package URLs. * The -d option can accept multiple DNS servers. The built-in default has as a result also been updated to include Quad9's secondary server.
New documentation:
* System documentation has been added, see docs/stprov-system.md. * Usage manual has been added, see docs/stprov-manual.md.
Miscellaneous:
* The OS package URL (-r) and user/password (-u/-p) options are no longer mutually exclusive. The user and password options are instead silently ignored for OS package URLs without the "user:password" pattern. * The host configuration fields "authentication" and "identity" were removed. So, the dummy "foo" and "bar" values are no longer written. Note that stprov never supported any real use of the removed fields. * The host configuration field "timestamp" was removed. In other words, the platform's host configuration no longer indicates a provisioning date. * Failing HEAD requests on OS package URLs are treated as errors rather than warnings. This behavior can be overridden with the force flag (-f). * Major improvements to the QEMU test coverage, see integration/qemu.sh.
This release implements the following specifications:
* The system documentation in this repository (docs/stprov-system.md) * https://git.glasklar.is/system-transparency/project/docs/-/blob/v0.2.0/conte... * https://git.glasklar.is/system-transparency/project/docs/-/blob/v0.2.0/conte... * https://git.glasklar.is/system-transparency/project/docs/-/blob/v0.2.0/conte...
This release has been tested to work with:
* stboot's provision mode, release tag v0.3.6: https://git.glasklar.is/system-transparency/core/stboot/-/tree/v0.3.6 * ISO building using stmgr, pre-release tag v0.3.2: https://git.glasklar.is/system-transparency/core/stmgr/-/tree/v0.3.2