Test-Signing a Driver through an Embedded Signature
A signed catalog file is all that you must have to correctly install and load most driver packages. However, embedded-signing might also be an option. Embedded-signing refers to adding a digital signature to the driver's binary image file itself, instead of saving the digital signature in a catalog file. As a result, the driver's binary image is modified when the driver is embedded-signed.
Embedded-signing of kernel-mode binaries (for example, drivers and associated .dll files) are required whenever:
The driver is a boot-start driver. In 64-bit versions of Windows Vista and later versions of Windows, the kernel-mode code signing requirements state that a boot-start driver must have an embedded signature. This is required regardless of whether the driver's driver package has a digitally-signed catalog file.
The driver is installed through a driver package that does not include a catalog file.
As with catalog files, SignTool is used to embed a digital signature within kernel-mode binary files by using a test certificate. The following command line shows how to run SignTool to do the following:
Test-sign the 64-bit version of the Toastpkg sample's binary file, toaster.sys. Within the WDK installation directory, this file is located in the src\general\toaster\toastpkg\toastcd\amd64 directory.
Use the Contoso.com(Test) certificate from the PrivateCertStore for the test signature. For more information about how this certificate was created, see Creating Test Certificates.
Time stamp the digital signature through a time stamp authority (TSA).
To test-sign the toaster.sys file, run the following command line:
Signtool sign /v /s PrivateCertStore /n Contoso.com(Test) /t http://timestamp.verisign.com/scripts/timestamp.dll amd64\toaster.sys
The sign command configures SignTool to sign the specified catalog file, tstamd64.cat.
The /v option enables verbose operations, in which SignTool displays successful execution and warning messages.
The /s option specifies the name of the certificate store (PrivateCertStore) that contains the test certificate.
The /n option specifies the name of the certificate (Contoso.com(Test)) that is installed in the specified certificate store.
- The /t option specifies URL of the TSA (http://timestamp.verisign.com/scripts/timestamp.dll) which will time stamp the digital signature.Important Including a time stamp provides the necessary information for key revocation in case the signer's code signing private key is compromised.
amd64\toaster.sys specifies the name of the kernel-mode binary file which will be embedded-signed.
For more information about SignTool and its command-line arguments, see SignTool.
For more information about how to test-sign a driver by using an embedded signature, see Test-Signing a Driver File.