org.jvnet.hudson.update_center

Class Signer

java.lang.Object

org.jvnet.hudson.update_center.Signer

public class Signer
extends Object

Author:

Kohsuke Kawaguchi

Field Summary

Fields

Modifier and Type	Field and Description
File	canonical
List<File>	certificates
File	privateKey
List<File>	rootCA

Constructor Summary

Constructors

Constructor and Description
Signer()

Method Summary

Modifier and Type	Method and Description
Signer	configureFromEnvironment() Parses JENKINS_SIGNER environment variable as the argument list and configure the instance.
protected List<X509Certificate>	getCertificateChain() Loads a certificate chain and makes sure it's valid.
boolean	isConfigured() Checks if the signer is properly configured to generate a signature
net.sf.json.JSONObject	sign(net.sf.json.JSONObject o) Generates a canonicalized JSON format of the given object, and put the signature in it.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

privateKey

public File privateKey

certificates

public List<File> certificates

rootCA

public List<File> rootCA

canonical

public File canonical

Constructor Detail

Signer

public Signer()

Method Detail

configureFromEnvironment

public Signer configureFromEnvironment()
                                throws org.kohsuke.args4j.CmdLineException

Parses JENKINS_SIGNER environment variable as the argument list and configure the instance.

Throws:

org.kohsuke.args4j.CmdLineException

isConfigured

public boolean isConfigured()
                     throws org.kohsuke.args4j.CmdLineException

Checks if the signer is properly configured to generate a signature

Throws:

org.kohsuke.args4j.CmdLineException - If the configuration is partial and it's not clear whether the user intended to sign or not to sign.

sign

public net.sf.json.JSONObject sign(net.sf.json.JSONObject o)
                            throws GeneralSecurityException,
                                   IOException,
                                   org.kohsuke.args4j.CmdLineException

Generates a canonicalized JSON format of the given object, and put the signature in it. Because it mutates the signed object itself, validating the signature needs a bit of work, but this enables a signature to be added transparently.

Returns:

The same value passed as the argument so that the method can be used like a filter.

Throws:

GeneralSecurityException

IOException

org.kohsuke.args4j.CmdLineException

getCertificateChain

protected List<X509Certificate> getCertificateChain()
                                             throws IOException,
                                                    GeneralSecurityException

Loads a certificate chain and makes sure it's valid.

Throws:

IOException

GeneralSecurityException