Skip to content

Commit 72b66ea

Browse files
committed
Expand documentation of reproducible builds
1 parent 0f92fce commit 72b66ea

File tree

1 file changed

+11
-2
lines changed

1 file changed

+11
-2
lines changed

README

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -74,6 +74,8 @@ In addition to the main `webauthn-server-core` module, there are also:
7474
- Optionally integrates with a "metadata service" to verify
7575
https://www.w3.org/TR/webauthn/#sctn-attestation[authenticator attestations]
7676
and annotate responses with additional authenticator metadata
77+
- Reproducible builds: release signatures match fresh builds from source. See
78+
[Building](#Building) below.
7779

7880

7981
=== Non-features
@@ -340,18 +342,25 @@ will have a plain `x.y.z` version number, while a build on any other commit will
340342
result in a version number containing the abbreviated commit hash.
341343

342344
Starting in version `1.4.0-RC2`, artifacts are built reproducibly. Fresh builds from
343-
tagged commits should therefore be verifiable by signatures from Maven Central:
345+
tagged commits should therefore be verifiable by signatures from Maven Central
346+
and GitHub releases:
344347

345348
```
346349
$ git checkout 1.4.0-RC2
347350
$ ./gradlew :webauthn-server-core:jar
351+
348352
$ wget https://repo1.maven.org/maven2/com/yubico/webauthn-server-core/1.4.0-RC2/webauthn-server-core-1.4.0-RC2.jar.asc
349353
$ gpg --verify webauthn-server-core-1.4.0-RC2.jar.asc webauthn-server-core/build/libs/webauthn-server-core-1.4.0-RC2.jar
354+
355+
$ wget https://github.com/Yubico/java-webauthn-server/releases/download/1.4.0-RC2/webauthn-server-core-1.4.0-RC2.jar.asc
356+
$ gpg --verify webauthn-server-core-1.4.0-RC2.jar.asc webauthn-server-core/build/libs/webauthn-server-core-1.4.0-RC2.jar
350357
```
351358

352359
Note that building with a different JDK may produce a different artifact. To
353360
ensure binary reproducibility, please build with the same JDK as specified in
354-
the release notes.
361+
the release notes. Reproducible builds also require building from a Git
362+
repository, since the build embeds version number and Git commit ID into the
363+
built artifacts.
355364

356365
Official Yubico software signing keys are listed on the
357366
https://developers.yubico.com/Software_Projects/Software_Signing.html[Yubico

0 commit comments

Comments
 (0)