signtool v1.0.0

node-signtool

node-signtool is a Node module wrapper around the SignTool binary.

Getting Started

node-signtool works as a wrapper around the SignTool library. It abstracts the commands' switches with JS object abstraction. Options mapping is available below.

Installation

node-signtool can be installed using NPM:

$ npm install node-signtool --save

Usage

First import node-signtool in your project:

var signtool = require("signtool");

Then use signtool's commands:

signtool.sign("path/to/my.exe", { certificate: "path/to/my/cert.pfx", password: "*******" });
signtool.verify("path/to/my.exe");

node-signtool uses native Promise to wrap asynchronous operations and resolves with the result of the command:

signtool.sign("path/to/my.exe", { certificate: "path/to/my/cert.pfx", password: "*******" });
	.then(result => {
		result.code 	// The signtool exit code.
		result.stdout 	// The signtool stdout content.
		result.stderr	// The signtool stderr content.
	});

Documentation

signtool.sign(file: string | string[], options: SignOptions, runOptions: RunOptions): Promise

The sign command allows to digitally signs files. If no options are provided, node-signtool use the default auto behavior.

signtool.verify(file: string | string[], options: VerifyOptions, runOptions: RunOptions): Promise

The verify command allows to verify the digital signature of files.

If no options are provided, node-signtool use the default useAllMethods behavior.

The SignTool verify command determines :

• whether the signing certificate was issued by a trusted authority,
• whether the signing certificate has been revoked,
• and, optionally, whether the signing certificate is valid for a specific policy.

signtool.timestamp(file: string | string[], options: TimestampOptions, runOptions: RunOptions): Promise

The timestamp command allows to time stamps files.

signtool.catdb(file: string | string[], options: CatDBOptions, runOptions: RunOptions): Promise

The catdb command allows to add or remove a catalog file to or from a catalog database.

RunOptions

Run options are optional. It allows to enable some common signtool switches and to specify some child_process.spawn() options.

Common Switches

Spawn Options

Contribute

Install Global Dependencies

node-signtool needs some development dependencies:

• typings

$ npm install -g typings

Install Project dependencies

$ npm install && typings install

Build project

$ npm run build