Signing code for the long-haul
By costlow on Oct 10, 2013
With recent code-signature requirements for Rich Internet Applications, I have received a few good questions from different types of developers
- What is the role of code signing?
- How do I prevent my signature from expiring?
What is the role of code signing?
Code signatures allow people who will receive and use your code to determine that you are, in fact, the publisher and that no one else has intentionally or accidentally modified your deliverable. Code signatures protect against these modifications within your supply chain, when moving across a network, or when appearing through 3rd party distribution channels. Code signatures offer a level of repudiation: even though an imposter tries to look like your app, both you and your customers can prove that it isn’t.
There are two concepts for this level of trust:
- Identity, the application providing a claim as to who wrote it.
- Authentication, the JRE automatically validating this claim against a set of known trust stores.
The way that this information is provided and checked is through industry standard Certificates, which tie together information about the signers (their identity) with the ability to mathematically verify it (through a key).
For a description on why code signatures are taking a more prominent role within the Java Platform, please see our previous entry, Code Signing – Understanding Who and When.
How do I prevent my signature from expiring?
Trusted Timestamping, introduced in Java 5 (2004), allows your customers to validate your signature even after the certificate has expired. When you sign a JAR file, the Timestamp Authority uses their clock to act as a notary and cryptographically write the date and time into your file.
Without this timestamp, users would only be able to validate your signature based on their current date and time. This could be problematic for long-running or embedded systems because the standard X.509 Certificates contain a NotAfter date that typically ranges from one to four years.
You interact with timestamp authorities when signing code with jarsigner’s TSA argument:
jarsigner -tsa http://timestamp.verisign.com …
When your signed file provides a timestamp, Java is able to use that information within the PKIXParameters and determine:
- Do I trust this timestamp authority to act as a notary?
- Is the signature date before the certificate’s time of expiration?
- Based on Certificate Revocation Lists, was this certificate valid on or before the signature date?
If the answer to all questions is yes, then the signature is deemed valid even if the certificate has expired. Therefore, signed code on embedded devices will continue to operate beyond the Certificate’s lifetime.
Several trusted timestamp authorities are listed in the previous post, “Code signing: Understanding who and when.”
A note about Certificate Authorities and revocation lists
Part of the acceptance criteria for being included in Java’s root certificate authority program is allowing back-dating of certificate revocation in the event that a private key is lost or stolen and continuing to publish revocation information even after a Certificate’s public expiration.