Modified: maven/website/components/plugins-archives/maven-jarsigner-plugin-LATEST/sign-mojo.html ============================================================================== --- maven/website/components/plugins-archives/maven-jarsigner-plugin-LATEST/sign-mojo.html (original) +++ maven/website/components/plugins-archives/maven-jarsigner-plugin-LATEST/sign-mojo.html Tue Sep 3 16:39:49 2024 @@ -1,891 +1,627 @@ -<!DOCTYPE html> -<!-- - | Generated by Apache Maven Doxia Site Renderer 1.8.1 from target\generated-site\xdoc/sign-mojo.xml at 2018-11-03 - | Rendered using Apache Maven Fluido Skin 1.7 ---> -<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> - <head> - <meta charset="UTF-8" /> - <meta name="viewport" content="width=device-width, initial-scale=1.0" /> - <meta name="Date-Revision-yyyymmdd" content="20181103" /> - <meta http-equiv="Content-Language" content="en" /> - <title>Apache Maven Jarsigner Plugin – jarsigner:sign</title> - <link rel="stylesheet" href="./css/apache-maven-fluido-1.7.min.css" /> - <link rel="stylesheet" href="./css/site.css" /> - <link rel="stylesheet" href="./css/print.css" media="print" /> - <script type="text/javascript" src="./js/apache-maven-fluido-1.7.min.js"></script> - <!-- Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-140879-1']); - _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - </head> - <body class="topBarDisabled"> - <div class="container-fluid"> - <div id="banner"> - <div class="pull-left"><a href="https://www.apache.org/"; id="bannerLeft"><img src="../../images/apache-maven-project.png" alt="Apache Maven Jarsigner Plugin"/></a></div> - <div class="pull-right"><a href="../../" id="bannerRight"><img src="../../images/maven-logo-black-on-white.png" alt=""/></a></div> - <div class="clear"><hr/></div> - </div> - - <div id="breadcrumbs"> - <ul class="breadcrumb"> - <li class=""><a href="https://www.apache.org/"; class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> - <li class=""><a href="../../index.html" title="Maven">Maven</a><span class="divider">/</span></li> - <li class=""><a href="../index.html" title="Plugins">Plugins</a><span class="divider">/</span></li> - <li class=""><a href="index.html" title="Apache Maven Jarsigner Plugin">Apache Maven Jarsigner Plugin</a><span class="divider">/</span></li> - <li class="active ">jarsigner:sign</li> - <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2018-11-03</li> - <li id="projectVersion" class="pull-right">Version: 3.0.0</li> - </ul> - </div> - <div class="row-fluid"> - <div id="leftColumn" class="span2"> - <div class="well sidebar-nav"> - <ul class="nav nav-list"> - <li class="nav-header">Overview</li> - <li><a href="index.html" title="Introduction"><span class="none"></span>Introduction</a></li> - <li><a href="plugin-info.html" title="Goals"><span class="none"></span>Goals</a></li> - <li><a href="usage.html" title="Usage"><span class="none"></span>Usage</a></li> - <li><a href="faq.html" title="FAQ"><span class="none"></span>FAQ</a></li> - <li><a href="http://www.apache.org/licenses/"; class="externalLink" title="License"><span class="none"></span>License</a></li> - <li><a href="download.html" title="Download"><span class="none"></span>Download</a></li> - <li class="nav-header">Examples</li> - <li><a href="examples/sign-and-verify-project.html" title="Sign and Verify Project"><span class="none"></span>Sign and Verify Project</a></li> - <li class="nav-header">Project Documentation</li> - <li><a href="project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li> - <li><a href="project-reports.html" title="Project Reports"><span class="icon-chevron-right"></span>Project Reports</a></li> - <li class="nav-header">Maven Projects</li> - <li><a href="../../archetype/index.html" title="Archetype"><span class="none"></span>Archetype</a></li> - <li><a href="../../resolver/index.html" title="Artifact Resolver"><span class="none"></span>Artifact Resolver</a></li> - <li><a href="../../doxia/index.html" title="Doxia"><span class="none"></span>Doxia</a></li> - <li><a href="../../jxr/index.html" title="JXR"><span class="none"></span>JXR</a></li> - <li><a href="../../ref/current" title="Maven"><span class="none"></span>Maven</a></li> - <li><a href="../../pom/index.html" title="Parent POMs"><span class="none"></span>Parent POMs</a></li> - <li><a href="../index.html" title="Plugins"><span class="none"></span>Plugins</a></li> - <li><a href="../../plugin-testing/index.html" title="Plugin Testing"><span class="none"></span>Plugin Testing</a></li> - <li><a href="../../plugin-tools/index.html" title="Plugin Tools"><span class="none"></span>Plugin Tools</a></li> - <li><a href="../../apache-resource-bundles/index.html" title="Resource Bundles"><span class="none"></span>Resource Bundles</a></li> - <li><a href="../../scm/index.html" title="SCM"><span class="none"></span>SCM</a></li> - <li><a href="../../shared/index.html" title="Shared Components"><span class="none"></span>Shared Components</a></li> - <li><a href="../../skins/index.html" title="Skins"><span class="none"></span>Skins</a></li> - <li><a href="../../surefire/index.html" title="Surefire"><span class="none"></span>Surefire</a></li> - <li><a href="../../wagon/index.html" title="Wagon"><span class="none"></span>Wagon</a></li> - <li class="nav-header">ASF</li> - <li><a href="https://www.apache.org/foundation/how-it-works.html"; class="externalLink" title="How Apache Works"><span class="none"></span>How Apache Works</a></li> - <li><a href="https://www.apache.org/foundation/"; class="externalLink" title="Foundation"><span class="none"></span>Foundation</a></li> - <li><a href="https://www.apache.org/foundation/sponsorship.html"; class="externalLink" title="Sponsoring Apache"><span class="none"></span>Sponsoring Apache</a></li> - <li><a href="https://www.apache.org/foundation/thanks.html"; class="externalLink" title="Thanks"><span class="none"></span>Thanks</a></li> -</ul> -<form id="search-form" action="https://www.google.com/search"; method="get" > - <input value="$sitesearchValue" name="sitesearch" type="hidden"/> - <input class="search-query" name="q" id="query" type="text" /> -</form> -<script type="text/javascript">asyncJs( 'https://cse.google.com/brand?form=search-form' )</script> - <hr /> - <div id="poweredBy"> - <div class="clear"></div> - <div class="clear"></div> - <div id="twitter"> - <a href="https://twitter.com/ASFMavenProject"; class="twitter-follow-button" data-show-count="false" data-align="left" data-size="medium" data-show-screen-name="true" data-lang="en">Follow ASFMavenProject</a> - <script type="text/javascript">!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src="//platform.twitter.com/widgets.js";fjs.parentNode.insertBefore(js,fjs);}}(document,"script","twitter-wjs");</script> - </div> - <div class="clear"></div> - <div class="clear"></div> -<a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"><img class="builtBy" alt="Built by Maven" src="./images/logos/maven-feather.png" /></a> - </div> - </div> - </div> - <div id="bodyColumn" class="span10" > - - - <div class="section"> -<h2><a name="jarsigner:sign"></a>jarsigner:sign</h2> - -<p><b>Full name</b>:</p> - -<p>org.apache.maven.plugins:maven-jarsigner-plugin:3.0.0:sign</p> - -<p><b>Description</b>:</p> - -<div>Signs a project artifact and attachments using jarsigner.</div> - -<p><b>Attributes</b>:</p> - -<ul> - -<li>Requires a Maven project to be executed.</li> - -<li>Since version: <tt>1.0</tt>.</li> - -<li>Binds by default to the <a class="externalLink" href="http://maven.apache.org/ref/current/maven-core/lifecycles.html";>lifecycle phase</a>: <tt>package</tt>.</li> - </ul> - -<div class="section"> -<h3><a name="Optional_Parameters"></a>Optional Parameters</h3> - -<table class="table table-striped" border="0"> - -<tr class="a"> - -<th>Name</th> - -<th>Type</th> - -<th>Since</th> - -<th>Description</th> - </tr> - -<tr class="b"> - -<td><tt><a href="#alias"><alias></a></tt></td> - -<td><tt>String</tt></td> - -<td><tt>1.0</tt></td> - -<td>See <a class="externalLink" href="http://java.sun.com/javase/6/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.<br /><b>User property is</b>: <tt>jarsigner.alias</tt>.<br /></td> - </tr> - -<tr class="a"> - -<td><tt><a href="#archive"><archive></a></tt></td> - -<td><tt>File</tt></td> - -<td><tt>1.0</tt></td> - -<td>Archive to process. If set, neither the project artifact nor any -attachments or archive sets are processed.<br /><b>User property is</b>: <tt>jarsigner.archive</tt>.<br /></td> - </tr> - -<tr class="b"> - -<td><tt><a href="#archiveDirectory"><archiveDirectory></a></tt></td> - -<td><tt>File</tt></td> - -<td><tt>1.1</tt></td> - -<td>The base directory to scan for JAR files using Ant-like -inclusion/exclusion patterns.<br /><b>User property is</b>: <tt>jarsigner.archiveDirectory</tt>.<br /></td> - </tr> - -<tr class="a"> - -<td><tt><a href="#arguments"><arguments></a></tt></td> - -<td><tt>String[]</tt></td> - -<td><tt>1.0</tt></td> - -<td>List of additional arguments to append to the jarsigner command -line.<br /><b>User property is</b>: <tt>jarsigner.arguments</tt>.<br /></td> - </tr> - -<tr class="b"> - -<td><tt><a href="#excludeClassifiers"><excludeClassifiers></a></tt></td> - -<td><tt>String[]</tt></td> - -<td><tt>1.2</tt></td> - -<td>A set of artifact classifiers describing the project attachments -that should not be processed. This parameter is only relevant if -<tt>processAttachedArtifacts</tt> is <tt>true</tt>. If -empty, no attachments are excluded.<br /></td> - </tr> - -<tr class="a"> - -<td><tt><a href="#excludes"><excludes></a></tt></td> - -<td><tt>String[]</tt></td> - -<td><tt>1.1</tt></td> - -<td>The Ant-like exclusion patterns used to exclude JAR files from -processing. The patterns must be relative to the directory given by -the parameter <tt>archiveDirectory</tt>.<br /></td> - </tr> - -<tr class="b"> - -<td><tt><a href="#includeClassifiers"><includeClassifiers></a></tt></td> - -<td><tt>String[]</tt></td> - -<td><tt>1.2</tt></td> - -<td>A set of artifact classifiers describing the project attachments -that should be processed. This parameter is only relevant if -<tt>processAttachedArtifacts</tt> is <tt>true</tt>. If -empty, all attachments are included.<br /></td> - </tr> - -<tr class="a"> - -<td><tt><a href="#includes"><includes></a></tt></td> - -<td><tt>String[]</tt></td> - -<td><tt>1.1</tt></td> - -<td>The Ant-like inclusion patterns used to select JAR files to -process. The patterns must be relative to the directory given by -the parameter <tt>archiveDirectory</tt>. By default, the -pattern <tt>**/*.?ar</tt> is used.<br /></td> - </tr> - -<tr class="b"> - -<td><tt><a href="#keypass"><keypass></a></tt></td> - -<td><tt>String</tt></td> - -<td><tt>1.0</tt></td> - -<td>See <a class="externalLink" href="http://java.sun.com/javase/6/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.<br /><b>User property is</b>: <tt>jarsigner.keypass</tt>.<br /></td> - </tr> - -<tr class="a"> - -<td><tt><a href="#keystore"><keystore></a></tt></td> - -<td><tt>String</tt></td> - -<td><tt>1.0</tt></td> - -<td>See <a class="externalLink" href="http://java.sun.com/javase/6/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.<br /><b>User property is</b>: <tt>jarsigner.keystore</tt>.<br /></td> - </tr> - -<tr class="b"> - -<td><tt><a href="#maxMemory"><maxMemory></a></tt></td> - -<td><tt>String</tt></td> - -<td><tt>1.0</tt></td> - -<td>The maximum memory available to the JAR signer, e.g. -<tt>256M</tt>. See <a class="externalLink" href="http://java.sun.com/javase/6/docs/technotes/tools/windows/java.html#Xms";>-Xmx</a> -for more details.<br /><b>User property is</b>: <tt>jarsigner.maxMemory</tt>.<br /></td> - </tr> - -<tr class="a"> - -<td><tt><a href="#processAttachedArtifacts"><processAttachedArtifacts></a></tt></td> - -<td><tt>boolean</tt></td> - -<td><tt>1.1</tt></td> - -<td>Controls processing of project attachments. If enabled, attached -artifacts that are no JAR/ZIP files will be automatically excluded -from processing.<br /><b>Default value is</b>: <tt>true</tt>.<br /><b>User property is</b>: <tt>jarsigner.processAttachedArtifacts</tt>.<br /></td> - </tr> - -<tr class="b"> - -<td><tt><a href="#processMainArtifact"><processMainArtifact></a></tt></td> - -<td><tt>boolean</tt></td> - -<td><tt>1.1</tt></td> - -<td>Controls processing of the main artifact produced by the project.<br /><b>Default value is</b>: <tt>true</tt>.<br /><b>User property is</b>: <tt>jarsigner.processMainArtifact</tt>.<br /></td> - </tr> - -<tr class="a"> - -<td><tt><a href="#protectedAuthenticationPath"><protectedAuthenticationPath></a></tt></td> - -<td><tt>boolean</tt></td> - -<td><tt>1.3</tt></td> - -<td>Must be set to true if the password must be given via a protected -authentication path such as a dedicated PIN reader.<br /><b>Default value is</b>: <tt>false</tt>.<br /><b>User property is</b>: <tt>jarsigner.protectedAuthenticationPath</tt>.<br /></td> - </tr> - -<tr class="b"> - -<td><tt><a href="#providerArg"><providerArg></a></tt></td> - -<td><tt>String</tt></td> - -<td><tt>1.0</tt></td> - -<td>See <a class="externalLink" href="http://java.sun.com/javase/6/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.<br /><b>User property is</b>: <tt>jarsigner.providerArg</tt>.<br /></td> - </tr> - -<tr class="a"> - -<td><tt><a href="#providerClass"><providerClass></a></tt></td> - -<td><tt>String</tt></td> - -<td><tt>1.0</tt></td> - -<td>See <a class="externalLink" href="http://java.sun.com/javase/6/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.<br /><b>User property is</b>: <tt>jarsigner.providerClass</tt>.<br /></td> - </tr> - -<tr class="b"> - -<td><tt><a href="#providerName"><providerName></a></tt></td> - -<td><tt>String</tt></td> - -<td><tt>1.0</tt></td> - -<td>See <a class="externalLink" href="http://java.sun.com/javase/6/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.<br /><b>User property is</b>: <tt>jarsigner.providerName</tt>.<br /></td> - </tr> - -<tr class="a"> - -<td><tt><a href="#removeExistingSignatures"><removeExistingSignatures></a></tt></td> - -<td><tt>boolean</tt></td> - -<td><tt>1.1</tt></td> - -<td>Indicates whether existing signatures should be removed from the -processed JAR files prior to signing them. If enabled, the -resulting JAR will appear as being signed only once.<br /><b>Default value is</b>: <tt>false</tt>.<br /><b>User property is</b>: <tt>jarsigner.removeExistingSignatures</tt>.<br /></td> - </tr> - -<tr class="b"> - -<td><tt><a href="#sigfile"><sigfile></a></tt></td> - -<td><tt>String</tt></td> - -<td><tt>1.0</tt></td> - -<td>See <a class="externalLink" href="http://java.sun.com/javase/6/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.<br /><b>User property is</b>: <tt>jarsigner.sigfile</tt>.<br /></td> - </tr> - -<tr class="a"> - -<td><tt><a href="#skip"><skip></a></tt></td> - -<td><tt>boolean</tt></td> - -<td><tt>1.0</tt></td> - -<td>Set to <tt>true</tt> to disable the plugin.<br /><b>Default value is</b>: <tt>false</tt>.<br /><b>User property is</b>: <tt>jarsigner.skip</tt>.<br /></td> - </tr> - -<tr class="b"> - -<td><tt><a href="#storepass"><storepass></a></tt></td> - -<td><tt>String</tt></td> - -<td><tt>1.0</tt></td> - -<td>See <a class="externalLink" href="http://java.sun.com/javase/6/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.<br /><b>User property is</b>: <tt>jarsigner.storepass</tt>.<br /></td> - </tr> - -<tr class="a"> - -<td><tt><a href="#storetype"><storetype></a></tt></td> - -<td><tt>String</tt></td> - -<td><tt>1.0</tt></td> - -<td>See <a class="externalLink" href="http://java.sun.com/javase/6/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.<br /><b>User property is</b>: <tt>jarsigner.storetype</tt>.<br /></td> - </tr> - -<tr class="b"> - -<td><tt><a href="#tsa"><tsa></a></tt></td> - -<td><tt>String</tt></td> - -<td><tt>1.3</tt></td> - -<td>See <a class="externalLink" href="http://java.sun.com/javase/6/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.<br /><b>User property is</b>: <tt>jarsigner.tsa</tt>.<br /></td> - </tr> - -<tr class="a"> - -<td><tt><a href="#tsacert"><tsacert></a></tt></td> - -<td><tt>String</tt></td> - -<td><tt>1.3</tt></td> - -<td>See <a class="externalLink" href="http://java.sun.com/javase/6/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.<br /><b>User property is</b>: <tt>jarsigner.tsacert</tt>.<br /></td> - </tr> - -<tr class="b"> - -<td><tt><a href="#verbose"><verbose></a></tt></td> - -<td><tt>boolean</tt></td> - -<td><tt>1.0</tt></td> - -<td>See <a class="externalLink" href="http://java.sun.com/javase/6/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.<br /><b>Default value is</b>: <tt>false</tt>.<br /><b>User property is</b>: <tt>jarsigner.verbose</tt>.<br /></td> - </tr> - -<tr class="a"> - -<td><tt><a href="#workingDirectory"><workingDirectory></a></tt></td> - -<td><tt>File</tt></td> - -<td><tt>1.3</tt></td> - -<td>Location of the working directory.<br /><b>Default value is</b>: <tt>${project.basedir}</tt>.<br /></td> - </tr> - </table> - </div> - -<div class="section"> -<h3><a name="Parameter_Details"></a>Parameter Details</h3> - -<div class="section"> -<h4><a name="a.3Calias.3E"></a><b><a name="alias"><alias></a></b></h4> - -<div>See <a class="externalLink" href="http://java.sun.com/javase/6/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.</div> - -<ul> - -<li><b>Type</b>: <tt>java.lang.String</tt></li> - -<li><b>Since</b>: <tt>1.0</tt></li> - -<li><b>Required</b>: <tt>No</tt></li> - -<li><b>User Property</b>: <tt>jarsigner.alias</tt></li> - </ul><hr /></div> -<div class="section"> -<h4><a name="a.3Carchive.3E"></a><b><a name="archive"><archive></a></b></h4> - -<div>Archive to process. If set, neither the project artifact nor any -attachments or archive sets are processed.</div> - -<ul> - -<li><b>Type</b>: <tt>java.io.File</tt></li> - -<li><b>Since</b>: <tt>1.0</tt></li> - -<li><b>Required</b>: <tt>No</tt></li> - -<li><b>User Property</b>: <tt>jarsigner.archive</tt></li> - </ul><hr /></div> -<div class="section"> -<h4><a name="a.3CarchiveDirectory.3E"></a><b><a name="archiveDirectory"><archiveDirectory></a></b></h4> - -<div>The base directory to scan for JAR files using Ant-like -inclusion/exclusion patterns.</div> - -<ul> - -<li><b>Type</b>: <tt>java.io.File</tt></li> - -<li><b>Since</b>: <tt>1.1</tt></li> - -<li><b>Required</b>: <tt>No</tt></li> - -<li><b>User Property</b>: <tt>jarsigner.archiveDirectory</tt></li> - </ul><hr /></div> -<div class="section"> -<h4><a name="a.3Carguments.3E"></a><b><a name="arguments"><arguments></a></b></h4> - -<div>List of additional arguments to append to the jarsigner command -line.</div> - -<ul> - -<li><b>Type</b>: <tt>java.lang.String[]</tt></li> - -<li><b>Since</b>: <tt>1.0</tt></li> - -<li><b>Required</b>: <tt>No</tt></li> - -<li><b>User Property</b>: <tt>jarsigner.arguments</tt></li> - </ul><hr /></div> -<div class="section"> -<h4><a name="a.3CexcludeClassifiers.3E"></a><b><a name="excludeClassifiers"><excludeClassifiers></a></b></h4> - -<div>A set of artifact classifiers describing the project attachments -that should not be processed. This parameter is only relevant if -<tt>processAttachedArtifacts</tt> is <tt>true</tt>. If -empty, no attachments are excluded.</div> - -<ul> - -<li><b>Type</b>: <tt>java.lang.String[]</tt></li> - -<li><b>Since</b>: <tt>1.2</tt></li> - -<li><b>Required</b>: <tt>No</tt></li> - </ul><hr /></div> -<div class="section"> -<h4><a name="a.3Cexcludes.3E"></a><b><a name="excludes"><excludes></a></b></h4> - -<div>The Ant-like exclusion patterns used to exclude JAR files from -processing. The patterns must be relative to the directory given by -the parameter <tt>archiveDirectory</tt>.</div> - -<ul> - -<li><b>Type</b>: <tt>java.lang.String[]</tt></li> - -<li><b>Since</b>: <tt>1.1</tt></li> - -<li><b>Required</b>: <tt>No</tt></li> - </ul><hr /></div> -<div class="section"> -<h4><a name="a.3CincludeClassifiers.3E"></a><b><a name="includeClassifiers"><includeClassifiers></a></b></h4> - -<div>A set of artifact classifiers describing the project attachments -that should be processed. This parameter is only relevant if -<tt>processAttachedArtifacts</tt> is <tt>true</tt>. If -empty, all attachments are included.</div> - -<ul> - -<li><b>Type</b>: <tt>java.lang.String[]</tt></li> - -<li><b>Since</b>: <tt>1.2</tt></li> - -<li><b>Required</b>: <tt>No</tt></li> - </ul><hr /></div> -<div class="section"> -<h4><a name="a.3Cincludes.3E"></a><b><a name="includes"><includes></a></b></h4> - -<div>The Ant-like inclusion patterns used to select JAR files to -process. The patterns must be relative to the directory given by -the parameter <tt>archiveDirectory</tt>. By default, the -pattern <tt>**/*.?ar</tt> is used.</div> - -<ul> - -<li><b>Type</b>: <tt>java.lang.String[]</tt></li> - -<li><b>Since</b>: <tt>1.1</tt></li> - -<li><b>Required</b>: <tt>No</tt></li> - </ul><hr /></div> -<div class="section"> -<h4><a name="a.3Ckeypass.3E"></a><b><a name="keypass"><keypass></a></b></h4> - -<div>See <a class="externalLink" href="http://java.sun.com/javase/6/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.</div> - -<ul> - -<li><b>Type</b>: <tt>java.lang.String</tt></li> - -<li><b>Since</b>: <tt>1.0</tt></li> - -<li><b>Required</b>: <tt>No</tt></li> - -<li><b>User Property</b>: <tt>jarsigner.keypass</tt></li> - </ul><hr /></div> -<div class="section"> -<h4><a name="a.3Ckeystore.3E"></a><b><a name="keystore"><keystore></a></b></h4> - -<div>See <a class="externalLink" href="http://java.sun.com/javase/6/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.</div> - -<ul> - -<li><b>Type</b>: <tt>java.lang.String</tt></li> - -<li><b>Since</b>: <tt>1.0</tt></li> - -<li><b>Required</b>: <tt>No</tt></li> - -<li><b>User Property</b>: <tt>jarsigner.keystore</tt></li> - </ul><hr /></div> -<div class="section"> -<h4><a name="a.3CmaxMemory.3E"></a><b><a name="maxMemory"><maxMemory></a></b></h4> - -<div>The maximum memory available to the JAR signer, e.g. -<tt>256M</tt>. See <a class="externalLink" href="http://java.sun.com/javase/6/docs/technotes/tools/windows/java.html#Xms";>-Xmx</a> -for more details.</div> - -<ul> - -<li><b>Type</b>: <tt>java.lang.String</tt></li> - -<li><b>Since</b>: <tt>1.0</tt></li> - -<li><b>Required</b>: <tt>No</tt></li> - -<li><b>User Property</b>: <tt>jarsigner.maxMemory</tt></li> - </ul><hr /></div> -<div class="section"> -<h4><a name="a.3CprocessAttachedArtifacts.3E"></a><b><a name="processAttachedArtifacts"><processAttachedArtifacts></a></b></h4> - -<div>Controls processing of project attachments. If enabled, attached -artifacts that are no JAR/ZIP files will be automatically excluded -from processing.</div> - -<ul> - -<li><b>Type</b>: <tt>boolean</tt></li> - -<li><b>Since</b>: <tt>1.1</tt></li> - -<li><b>Required</b>: <tt>No</tt></li> - -<li><b>User Property</b>: <tt>jarsigner.processAttachedArtifacts</tt></li> - -<li><b>Default</b>: <tt>true</tt></li> - </ul><hr /></div> -<div class="section"> -<h4><a name="a.3CprocessMainArtifact.3E"></a><b><a name="processMainArtifact"><processMainArtifact></a></b></h4> - -<div>Controls processing of the main artifact produced by the project.</div> - -<ul> - -<li><b>Type</b>: <tt>boolean</tt></li> - -<li><b>Since</b>: <tt>1.1</tt></li> - -<li><b>Required</b>: <tt>No</tt></li> - -<li><b>User Property</b>: <tt>jarsigner.processMainArtifact</tt></li> - -<li><b>Default</b>: <tt>true</tt></li> - </ul><hr /></div> -<div class="section"> -<h4><a name="a.3CprotectedAuthenticationPath.3E"></a><b><a name="protectedAuthenticationPath"><protectedAuthenticationPath></a></b></h4> - -<div>Must be set to true if the password must be given via a protected -authentication path such as a dedicated PIN reader.</div> - -<ul> - -<li><b>Type</b>: <tt>boolean</tt></li> - -<li><b>Since</b>: <tt>1.3</tt></li> - -<li><b>Required</b>: <tt>No</tt></li> - -<li><b>User Property</b>: <tt>jarsigner.protectedAuthenticationPath</tt></li> - -<li><b>Default</b>: <tt>false</tt></li> - </ul><hr /></div> -<div class="section"> -<h4><a name="a.3CproviderArg.3E"></a><b><a name="providerArg"><providerArg></a></b></h4> - -<div>See <a class="externalLink" href="http://java.sun.com/javase/6/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.</div> - -<ul> - -<li><b>Type</b>: <tt>java.lang.String</tt></li> - -<li><b>Since</b>: <tt>1.0</tt></li> - -<li><b>Required</b>: <tt>No</tt></li> - -<li><b>User Property</b>: <tt>jarsigner.providerArg</tt></li> - </ul><hr /></div> -<div class="section"> -<h4><a name="a.3CproviderClass.3E"></a><b><a name="providerClass"><providerClass></a></b></h4> - -<div>See <a class="externalLink" href="http://java.sun.com/javase/6/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.</div> - -<ul> - -<li><b>Type</b>: <tt>java.lang.String</tt></li> - -<li><b>Since</b>: <tt>1.0</tt></li> - -<li><b>Required</b>: <tt>No</tt></li> - -<li><b>User Property</b>: <tt>jarsigner.providerClass</tt></li> - </ul><hr /></div> -<div class="section"> -<h4><a name="a.3CproviderName.3E"></a><b><a name="providerName"><providerName></a></b></h4> - -<div>See <a class="externalLink" href="http://java.sun.com/javase/6/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.</div> - -<ul> - -<li><b>Type</b>: <tt>java.lang.String</tt></li> - -<li><b>Since</b>: <tt>1.0</tt></li> - -<li><b>Required</b>: <tt>No</tt></li> - -<li><b>User Property</b>: <tt>jarsigner.providerName</tt></li> - </ul><hr /></div> -<div class="section"> -<h4><a name="a.3CremoveExistingSignatures.3E"></a><b><a name="removeExistingSignatures"><removeExistingSignatures></a></b></h4> - -<div>Indicates whether existing signatures should be removed from the -processed JAR files prior to signing them. If enabled, the -resulting JAR will appear as being signed only once.</div> - -<ul> - -<li><b>Type</b>: <tt>boolean</tt></li> - -<li><b>Since</b>: <tt>1.1</tt></li> - -<li><b>Required</b>: <tt>No</tt></li> - -<li><b>User Property</b>: <tt>jarsigner.removeExistingSignatures</tt></li> - -<li><b>Default</b>: <tt>false</tt></li> - </ul><hr /></div> -<div class="section"> -<h4><a name="a.3Csigfile.3E"></a><b><a name="sigfile"><sigfile></a></b></h4> - -<div>See <a class="externalLink" href="http://java.sun.com/javase/6/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.</div> - -<ul> - -<li><b>Type</b>: <tt>java.lang.String</tt></li> - -<li><b>Since</b>: <tt>1.0</tt></li> - -<li><b>Required</b>: <tt>No</tt></li> - -<li><b>User Property</b>: <tt>jarsigner.sigfile</tt></li> - </ul><hr /></div> -<div class="section"> -<h4><a name="a.3Cskip.3E"></a><b><a name="skip"><skip></a></b></h4> - -<div>Set to <tt>true</tt> to disable the plugin.</div> - -<ul> - -<li><b>Type</b>: <tt>boolean</tt></li> - -<li><b>Since</b>: <tt>1.0</tt></li> - -<li><b>Required</b>: <tt>No</tt></li> - -<li><b>User Property</b>: <tt>jarsigner.skip</tt></li> - -<li><b>Default</b>: <tt>false</tt></li> - </ul><hr /></div> -<div class="section"> -<h4><a name="a.3Cstorepass.3E"></a><b><a name="storepass"><storepass></a></b></h4> - -<div>See <a class="externalLink" href="http://java.sun.com/javase/6/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.</div> - -<ul> - -<li><b>Type</b>: <tt>java.lang.String</tt></li> - -<li><b>Since</b>: <tt>1.0</tt></li> - -<li><b>Required</b>: <tt>No</tt></li> - -<li><b>User Property</b>: <tt>jarsigner.storepass</tt></li> - </ul><hr /></div> -<div class="section"> -<h4><a name="a.3Cstoretype.3E"></a><b><a name="storetype"><storetype></a></b></h4> - -<div>See <a class="externalLink" href="http://java.sun.com/javase/6/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.</div> - -<ul> - -<li><b>Type</b>: <tt>java.lang.String</tt></li> - -<li><b>Since</b>: <tt>1.0</tt></li> - -<li><b>Required</b>: <tt>No</tt></li> - -<li><b>User Property</b>: <tt>jarsigner.storetype</tt></li> - </ul><hr /></div> -<div class="section"> -<h4><a name="a.3Ctsa.3E"></a><b><a name="tsa"><tsa></a></b></h4> - -<div>See <a class="externalLink" href="http://java.sun.com/javase/6/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.</div> - -<ul> - -<li><b>Type</b>: <tt>java.lang.String</tt></li> - -<li><b>Since</b>: <tt>1.3</tt></li> - -<li><b>Required</b>: <tt>No</tt></li> - -<li><b>User Property</b>: <tt>jarsigner.tsa</tt></li> - </ul><hr /></div> -<div class="section"> -<h4><a name="a.3Ctsacert.3E"></a><b><a name="tsacert"><tsacert></a></b></h4> - -<div>See <a class="externalLink" href="http://java.sun.com/javase/6/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.</div> - -<ul> - -<li><b>Type</b>: <tt>java.lang.String</tt></li> - -<li><b>Since</b>: <tt>1.3</tt></li> - -<li><b>Required</b>: <tt>No</tt></li> - -<li><b>User Property</b>: <tt>jarsigner.tsacert</tt></li> - </ul><hr /></div> -<div class="section"> -<h4><a name="a.3Cverbose.3E"></a><b><a name="verbose"><verbose></a></b></h4> - -<div>See <a class="externalLink" href="http://java.sun.com/javase/6/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.</div> - -<ul> - -<li><b>Type</b>: <tt>boolean</tt></li> - -<li><b>Since</b>: <tt>1.0</tt></li> - -<li><b>Required</b>: <tt>No</tt></li> - -<li><b>User Property</b>: <tt>jarsigner.verbose</tt></li> - -<li><b>Default</b>: <tt>false</tt></li> - </ul><hr /></div> -<div class="section"> -<h4><a name="a.3CworkingDirectory.3E"></a><b><a name="workingDirectory"><workingDirectory></a></b></h4> - -<div>Location of the working directory.</div> - -<ul> - -<li><b>Type</b>: <tt>java.io.File</tt></li> - -<li><b>Since</b>: <tt>1.3</tt></li> - -<li><b>Required</b>: <tt>No</tt></li> - -<li><b>Default</b>: <tt>${project.basedir}</tt></li> - </ul> - </div></div> - </div> - - - </div> - </div> - </div> - <hr/> - <footer> - <div class="container-fluid"> - <div class="row-fluid"> - <p>Copyright ©2002–2018 -<a href="https://www.apache.org/";>The Apache Software Foundation</a>. -All rights reserved.</p> - </div> - </div> - </footer> - </body> +<!DOCTYPE html> + + +<!-- + | Generated by Apache Maven Doxia Site Renderer 1.11.1 from org.apache.maven.plugins:maven-plugin-report-plugin:3.13.1:report at 2024-09-03 + | Rendered using Apache Maven Fluido Skin 1.12.0 +--> +<html xmlns="http://www.w3.org/1999/xhtml"; lang="en"> + <head> + <meta charset="UTF-8" /> + <meta name="viewport" content="width=device-width, initial-scale=1" /> + <meta name="generator" content="Apache Maven Doxia Site Renderer 1.11.1" /> + <title>Apache Maven Jarsigner Plugin – jarsigner:sign</title> + <link rel="stylesheet" href="./css/apache-maven-fluido-1.12.0.min.css" /> + <link rel="stylesheet" href="./css/site.css" /> + <link rel="stylesheet" href="./css/print.css" media="print" /> + <script src="./js/apache-maven-fluido-1.12.0.min.js"></script> + + <!-- Matomo --> + <script> + var _paq = window._paq = window._paq || []; + _paq.push(['disableCookies']); + _paq.push(['trackPageView']); + _paq.push(['enableLinkTracking']); + + (function() { + var u="https://analytics.apache.org/";; + _paq.push(['setTrackerUrl', u+'/matomo.php']); + _paq.push(['setSiteId', '3']); + var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0]; + g.async=true; g.src=u+'/matomo.js'; s.parentNode.insertBefore(g,s); + })(); + </script> + <!-- End Matomo Code --> + </head> + <body> + <div class="container-fluid container-fluid-top"> + <header> + <div id="banner"> + <div class="pull-left"><a href="https://www.apache.org/"; id="bannerLeft"><img src="../../images/apache-maven-project.png" style="" /></a></div> + <div class="pull-right"><a href="../../" id="bannerRight"><img src="../../images/maven-logo-black-on-white.png" style="" /></a></div> + <div class="clear"><hr/></div> + </div> + + <div id="breadcrumbs"> + <ul class="breadcrumb"> + <li><a href="https://www.apache.org/"; class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> + <li><a href="../../index.html" title="Maven">Maven</a><span class="divider">/</span></li> + <li><a href="../index.html" title="Plugins">Plugins</a><span class="divider">/</span></li> + <li><a href="index.html" title="Apache Maven Jarsigner Plugin">Apache Maven Jarsigner Plugin</a><span class="divider">/</span></li> + <li class="active ">jarsigner:sign</li> + <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-09-03</li> + <li id="projectVersion" class="pull-right">Version: 3.1.0</li> + </ul> + </div> + </header> + <div class="row-fluid"> + <header id="leftColumn" class="span2"> + <nav class="well sidebar-nav"> + <ul class="nav nav-list"> + <li class="nav-header">Overview</li> + <li><a href="index.html" title="Introduction"><span class="none"></span>Introduction</a></li> + <li><a href="plugin-info.html" title="Goals"><span class="none"></span>Goals</a></li> + <li><a href="usage.html" title="Usage"><span class="none"></span>Usage</a></li> + <li><a href="faq.html" title="FAQ"><span class="none"></span>FAQ</a></li> + <li><a href="https://www.apache.org/licenses/"; class="externalLink" title="License"><span class="none"></span>License</a></li> + <li><a href="download.html" title="Download"><span class="none"></span>Download</a></li> + <li class="nav-header">Examples</li> + <li><a href="examples/sign-and-verify-project.html" title="Sign and Verify Project"><span class="none"></span>Sign and Verify Project</a></li> + <li class="nav-header">Project Documentation</li> + <li><a href="project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li> + <li><a href="project-reports.html" title="Project Reports"><span class="icon-chevron-right"></span>Project Reports</a></li> + <li class="nav-header">Maven Projects</li> + <li><a href="../../ref/current" title="Maven"><span class="none"></span>Maven</a></li> + <li><a href="../../archetypes/index.html" title="Archetypes"><span class="none"></span>Archetypes</a></li> + <li><a href="../../extensions/index.html" title="Extensions"><span class="none"></span>Extensions</a></li> + <li><a href="../../pom/index.html" title="Parent POMs"><span class="none"></span>Parent POMs</a></li> + <li><a href="../index.html" title="Plugins"><span class="none"></span>Plugins</a></li> + <li><a href="../../skins/index.html" title="Skins"><span class="none"></span>Skins</a></li> + <li><a href="" title="Components"><span class="icon-chevron-down"></span>Components</a> + <ul class="nav nav-list"> + <li><a href="../../archetype/index.html" title="Archetype"><span class="none"></span>Archetype</a></li> + <li><a href="../../resolver/index.html" title="Artifact Resolver"><span class="none"></span>Artifact Resolver</a></li> + <li><a href="../../doxia/index.html" title="Doxia"><span class="none"></span>Doxia</a></li> + <li><a href="../../maven-indexer/index.html" title="Indexer"><span class="none"></span>Indexer</a></li> + <li><a href="../../jxr/index.html" title="JXR"><span class="none"></span>JXR</a></li> + <li><a href="../../plugin-testing/index.html" title="Plugin Testing"><span class="none"></span>Plugin Testing</a></li> + <li><a href="../../plugin-tools/index.html" title="Plugin Tools"><span class="none"></span>Plugin Tools</a></li> + <li><a href="../../apache-resource-bundles/index.html" title="Resource Bundles"><span class="none"></span>Resource Bundles</a></li> + <li><a href="../../scm/index.html" title="SCM"><span class="none"></span>SCM</a></li> + <li><a href="../../shared/index.html" title="Shared Components"><span class="none"></span>Shared Components</a></li> + <li><a href="../../surefire/index.html" title="Surefire"><span class="none"></span>Surefire</a></li> + <li><a href="../../wagon/index.html" title="Wagon"><span class="none"></span>Wagon</a></li> + </ul></li> + <li class="nav-header">ASF</li> + <li><a href="https://www.apache.org/foundation/how-it-works.html"; class="externalLink" title="How Apache Works"><span class="none"></span>How Apache Works</a></li> + <li><a href="https://www.apache.org/foundation/"; class="externalLink" title="Foundation"><span class="none"></span>Foundation</a></li> + <li><a href="https://privacy.apache.org/policies/privacy-policy-public.html"; class="externalLink" title="Data Privacy"><span class="none"></span>Data Privacy</a></li> + <li><a href="https://www.apache.org/foundation/sponsorship.html"; class="externalLink" title="Sponsoring Apache"><span class="none"></span>Sponsoring Apache</a></li> + <li><a href="https://www.apache.org/foundation/thanks.html"; class="externalLink" title="Thanks"><span class="none"></span>Thanks</a></li> + </ul> + </nav> + <div class="well sidebar-nav"> + <div id="poweredBy"> + <div class="clear"></div> + <div class="clear"></div> + <div class="clear"></div> +<a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"><img class="builtBy" alt="Built by Maven" src="./images/logos/maven-feather.png" /></a> + </div> + </div> + </header> + <main id="bodyColumn" class="span10" > +<section> +<h2><a name="jarsigner:sign"></a>jarsigner:sign</h2><a name="jarsigner:sign"></a> +<p><strong>Full name</strong>:</p> +<p>org.apache.maven.plugins:maven-jarsigner-plugin:3.1.0:sign</p> +<p><strong>Description</strong>:</p> +<p>Signs a project artifact and attachments using jarsigner.</p> +<p><strong>Attributes</strong>:</p> +<ul> +<li>Requires a Maven project to be executed.</li> +<li>The goal is thread-safe and supports parallel builds.</li> +<li>Since version: <code>1.0</code>.</li> +<li>Binds by default to the <a class="externalLink" href="https://maven.apache.org/ref/current/maven-core/lifecycles.html";>lifecycle phase</a>: <code>package</code>.</li></ul><section> +<h3><a name="Optional_Parameters"></a>Optional Parameters</h3><a name="Optional_Parameters"></a> +<table border="0" class="table table-striped"> +<tr class="a"> +<th>Name</th> +<th>Type</th> +<th>Since</th> +<th>Description</th></tr> +<tr class="b"> +<td align="left"><a href="#alias"><code><alias></code></a></td> +<td><code>String</code></td> +<td><code>-</code></td> +<td>See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.<br /><strong>User Property</strong>: <code>jarsigner.alias</code></td></tr> +<tr class="a"> +<td align="left"><a href="#archive"><code><archive></code></a></td> +<td><code>File</code></td> +<td><code>-</code></td> +<td>Archive to process. If set, neither the project artifact nor any attachments or archive sets are processed.<br /><strong>User Property</strong>: <code>jarsigner.archive</code></td></tr> +<tr class="b"> +<td align="left"><a href="#archiveDirectory"><code><archiveDirectory></code></a></td> +<td><code>File</code></td> +<td><code>1.1</code></td> +<td>The base directory to scan for JAR files using Ant-like inclusion/exclusion patterns.<br /><strong>User Property</strong>: <code>jarsigner.archiveDirectory</code></td></tr> +<tr class="a"> +<td align="left"><a href="#arguments"><code><arguments></code></a></td> +<td><code>String[]</code></td> +<td><code>-</code></td> +<td>List of additional arguments to append to the jarsigner command line. Each argument should be specified as a separate element. For example, to specify the name of the signed jar, two elements are needed: +<ul> + <li>Alternative using the command line: <code>-Djarsigner.arguments="-signedjar,my-project_signed.jar"</code></li> + <li>Alternative using the Maven POM configuration:</li> +</ul> +<pre><code><configuration> + <arguments> + <argument>-signedjar</argument> + <argument>my-project_signed.jar</argument> + </arguments> +</configuration> +</code></pre><br /><strong>User Property</strong>: <code>jarsigner.arguments</code></td></tr> +<tr class="b"> +<td align="left"><a href="#certchain"><code><certchain></code></a></td> +<td><code>File</code></td> +<td><code>1.5</code></td> +<td>Location of the extra certificate chain file. See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.<br /><strong>User Property</strong>: <code>jarsigner.certchain</code></td></tr> +<tr class="a"> +<td align="left"><a href="#excludeClassifiers"><code><excludeClassifiers></code></a></td> +<td><code>String[]</code></td> +<td><code>1.2</code></td> +<td>A set of artifact classifiers describing the project attachments that should not be processed. This parameter is only relevant if <a href="#processAttachedArtifacts"><code>processAttachedArtifacts</code></a> is <code>true</code>. If empty, no attachments are excluded.</td></tr> +<tr class="b"> +<td align="left"><a href="#excludes"><code><excludes></code></a></td> +<td><code>String[]</code></td> +<td><code>1.1</code></td> +<td>The Ant-like exclusion patterns used to exclude JAR files from processing. The patterns must be relative to the directory given by the parameter <a href="#archiveDirectory"><code>archiveDirectory</code></a>.</td></tr> +<tr class="a"> +<td align="left"><a href="#includeClassifiers"><code><includeClassifiers></code></a></td> +<td><code>String[]</code></td> +<td><code>1.2</code></td> +<td>A set of artifact classifiers describing the project attachments that should be processed. This parameter is only relevant if <a href="#processAttachedArtifacts"><code>processAttachedArtifacts</code></a> is <code>true</code>. If empty, all attachments are included.</td></tr> +<tr class="b"> +<td align="left"><a href="#includes"><code><includes></code></a></td> +<td><code>String[]</code></td> +<td><code>1.1</code></td> +<td>The Ant-like inclusion patterns used to select JAR files to process. The patterns must be relative to the directory given by the parameter <a href="#archiveDirectory"><code>archiveDirectory</code></a>. By default, the pattern <code>**/*.?ar</code> is used.</td></tr> +<tr class="a"> +<td align="left"><a href="#keypass"><code><keypass></code></a></td> +<td><code>String</code></td> +<td><code>-</code></td> +<td>See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.<br /><strong>User Property</strong>: <code>jarsigner.keypass</code></td></tr> +<tr class="b"> +<td align="left"><a href="#keystore"><code><keystore></code></a></td> +<td><code>String</code></td> +<td><code>-</code></td> +<td>See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.<br /><strong>User Property</strong>: <code>jarsigner.keystore</code></td></tr> +<tr class="a"> +<td align="left"><a href="#maxMemory"><code><maxMemory></code></a></td> +<td><code>String</code></td> +<td><code>-</code></td> +<td>The maximum memory available to the JAR signer, e.g. <code>256M</code>. See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/java.html#Xms";>-Xmx</a> for more details.<br /><strong>User Property</strong>: <code>jarsigner.maxMemory</code></td></tr> +<tr class="b"> +<td align="left"><a href="#maxRetryDelaySeconds"><code><maxRetryDelaySeconds></code></a></td> +<td><code>int</code></td> +<td><code>3.1.0</code></td> +<td>Maximum delay, in seconds, to wait after a failed attempt before re-trying. The delay after a failed attempt follows an exponential backoff strategy, with increasing delay times.<br /><strong>Default</strong>: <code>0</code><br /><strong>User Property</strong>: <code>jarsigner.maxRetryDelaySeconds</code></td></tr> +<tr class="a"> +<td align="left"><a href="#maxTries"><code><maxTries></code></a></td> +<td><code>int</code></td> +<td><code>3.1.0</code></td> +<td>How many times to try to sign a jar (assuming each previous attempt is a failure). This option may be desirable if any network operations are used during signing, for example using a Time Stamp Authority or network based PKCS11 HSM solution for storing code signing keys. The default value of 1 indicates that no retries should be made.<br /><strong>Default</strong>: <code>1</code><br /><strong>User Property</strong>: <code>jarsigner.maxTries</code></td></tr> +<tr class="b"> +<td align="left"><a href="#processAttachedArtifacts"><code><processAttachedArtifacts></code></a></td> +<td><code>boolean</code></td> +<td><code>1.1</code></td> +<td>Controls processing of project attachments. If enabled, attached artifacts that are no JAR/ZIP files will be automatically excluded from processing.<br /><strong>Default</strong>: <code>true</code><br /><strong>User Property</strong>: <code>jarsigner.processAttachedArtifacts</code></td></tr> +<tr class="a"> +<td align="left"><a href="#processMainArtifact"><code><processMainArtifact></code></a></td> +<td><code>boolean</code></td> +<td><code>1.1</code></td> +<td>Controls processing of the main artifact produced by the project.<br /><strong>Default</strong>: <code>true</code><br /><strong>User Property</strong>: <code>jarsigner.processMainArtifact</code></td></tr> +<tr class="b"> +<td align="left"><a href="#protectedAuthenticationPath"><code><protectedAuthenticationPath></code></a></td> +<td><code>boolean</code></td> +<td><code>1.3</code></td> +<td>Must be set to true if the password must be given via a protected authentication path such as a dedicated PIN reader.<br /><strong>Default</strong>: <code>false</code><br /><strong>User Property</strong>: <code>jarsigner.protectedAuthenticationPath</code></td></tr> +<tr class="a"> +<td align="left"><a href="#providerArg"><code><providerArg></code></a></td> +<td><code>String</code></td> +<td><code>-</code></td> +<td>See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.<br /><strong>User Property</strong>: <code>jarsigner.providerArg</code></td></tr> +<tr class="b"> +<td align="left"><a href="#providerClass"><code><providerClass></code></a></td> +<td><code>String</code></td> +<td><code>-</code></td> +<td>See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.<br /><strong>User Property</strong>: <code>jarsigner.providerClass</code></td></tr> +<tr class="a"> +<td align="left"><a href="#providerName"><code><providerName></code></a></td> +<td><code>String</code></td> +<td><code>-</code></td> +<td>See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.<br /><strong>User Property</strong>: <code>jarsigner.providerName</code></td></tr> +<tr class="b"> +<td align="left"><a href="#removeExistingSignatures"><code><removeExistingSignatures></code></a></td> +<td><code>boolean</code></td> +<td><code>1.1</code></td> +<td>Indicates whether existing signatures should be removed from the processed JAR files prior to signing them. If enabled, the resulting JAR will appear as being signed only once.<br /><strong>Default</strong>: <code>false</code><br /><strong>User Property</strong>: <code>jarsigner.removeExistingSignatures</code></td></tr> +<tr class="a"> +<td align="left"><a href="#sigfile"><code><sigfile></code></a></td> +<td><code>String</code></td> +<td><code>-</code></td> +<td>See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.<br /><strong>User Property</strong>: <code>jarsigner.sigfile</code></td></tr> +<tr class="b"> +<td align="left"><a href="#skip"><code><skip></code></a></td> +<td><code>boolean</code></td> +<td><code>-</code></td> +<td>Set to <code>true</code> to disable the plugin.<br /><strong>Default</strong>: <code>false</code><br /><strong>User Property</strong>: <code>jarsigner.skip</code></td></tr> +<tr class="a"> +<td align="left"><a href="#storepass"><code><storepass></code></a></td> +<td><code>String</code></td> +<td><code>-</code></td> +<td>See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.<br /><strong>User Property</strong>: <code>jarsigner.storepass</code></td></tr> +<tr class="b"> +<td align="left"><a href="#storetype"><code><storetype></code></a></td> +<td><code>String</code></td> +<td><code>-</code></td> +<td>See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.<br /><strong>User Property</strong>: <code>jarsigner.storetype</code></td></tr> +<tr class="a"> +<td align="left"><a href="#threadCount"><code><threadCount></code></a></td> +<td><code>int</code></td> +<td><code>3.1.0</code></td> +<td>Maximum number of parallel threads to use when signing jar files. Increases performance when signing multiple jar files, especially when network operations are used during signing, for example when using a Time Stamp Authority or network based PKCS11 HSM solution for storing code signing keys. Note: the logging from the signing process will be interleaved, and harder to read, when using many threads.<br /><strong>Default</strong>: <code>1</code><br /><strong>User Property</strong>: <code>jarsigner.threadCount</code></td></tr> +<tr class="b"> +<td align="left"><a href="#tsa"><code><tsa></code></a></td> +<td><code>String[]</code></td> +<td><code>1.3</code></td> +<td><p>URL(s) to Time Stamping Authority (TSA) server(s) to use to timestamp the signing. See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>. Separate multiple TSA URLs with comma (without space) or a nested XML tag.</p> +<pre><code><configuration> + <tsa>http://timestamp.digicert.com,http://timestamp.globalsign.com/tsa/r6advanced1</tsa> +</configuration> +</code></pre> +<pre><code><configuration> + <tsa> + <url>http://timestamp.digicert.com</url> + <url>http://timestamp.globalsign.com/tsa/r6advanced1</url> + </tsa> +</configuration> +</code></pre> +<p>Usage of multiple TSA servers only makes sense when <a href="#maxTries"><code>maxTries</code></a> is more than 1. A different TSA server will only be used at retries.</p> +<p>Changed to a list since 3.1.0. Single XML element (without comma) is still supported.</p><br /><strong>User Property</strong>: <code>jarsigner.tsa</code></td></tr> +<tr class="a"> +<td align="left"><a href="#tsacert"><code><tsacert></code></a></td> +<td><code>String[]</code></td> +<td><code>1.3</code></td> +<td><p>Alias(es) for certificate(s) in the active keystore used to find a TSA URL. From the certificate the X509v3 extension "Subject Information Access" field is examined to find the TSA server URL. See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>. Separate multiple aliases with comma (without space) or a nested XML tag.</p> +<pre><code><configuration> + <tsacert>alias1,alias2</tsacert> +</configuration> +</code></pre> +<pre><code><configuration> + <tsacert> + <alias>alias1</alias> + <alias>alias2</alias> + </tsacert> +</configuration> +</code></pre> +<p>Should not be used at the same time as the <a href="#tsa"><code>tsa</code></a> parameter (because jarsigner will typically ignore tsacert, if tsa is set).</p> +<p>Usage of multiple aliases only makes sense when <a href="#maxTries"><code>maxTries</code></a> is more than 1. A different TSA server will only be used at retries.</p> +<p>Changed to a list since 3.1.0. Single XML element (without comma) is still supported.</p><br /><strong>User Property</strong>: <code>jarsigner.tsacert</code></td></tr> +<tr class="b"> +<td align="left"><a href="#tsadigestalg"><code><tsadigestalg></code></a></td> +<td><code>String</code></td> +<td><code>3.1.0</code></td> +<td>The message digest algorithm to use in the messageImprint that the TSA server will timestamp. A default value (for example <code>SHA-384</code>) will be selected by jarsigner if this parameter is not set. Only available in Java 11 and later. See <a href="https://docs.oracle.com/en/java/javase/11/tools/jarsigner.html";>options</a>.<br /><strong>User Property</strong>: <code>jarsigner.tsadigestalg</code></td></tr> +<tr class="a"> +<td align="left"><a href="#tsapolicyid"><code><tsapolicyid></code></a></td> +<td><code>String[]</code></td> +<td><code>3.1.0</code></td> +<td><p>OID(s) to send to the TSA server to identify the policy ID the server should use. If not specified TSA server will choose a default policy ID. Each TSA server vendor will typically define their own policy OIDs. See <a href="https://docs.oracle.com/javase/8/docs/technotes/tools/windows/jarsigner.html#CCHIFIAD";>options</a>. Separate multiple OIDs with comma (without space) or a nested XML tag.</p> +<pre><code><configuration> + <tsapolicyid>1.3.6.1.4.1.4146.2.3.1.2,2.16.840.1.114412.7.1</tsapolicyid> +</configuration> +</code></pre> +<pre><code><configuration> + <tsapolicyid> + <oid>1.3.6.1.4.1.4146.2.3.1.2</oid> + <oid>2.16.840.1.114412.7.1</oid> + </tsapolicyid> +</configuration> +</code></pre> +<p>If used, the number of OIDs should be the same as the number of elements in <a href="#tsa"><code>tsa</code></a> or <a href="#tsacert"><code>tsacert</code></a>. The first OID will be used for the first TSA server, the second OID for the second TSA server and so on.</p><br /><strong>User Property</strong>: <code>jarsigner.tsapolicyid</code></td></tr> +<tr class="b"> +<td align="left"><a href="#verbose"><code><verbose></code></a></td> +<td><code>boolean</code></td> +<td><code>-</code></td> +<td>See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.<br /><strong>Default</strong>: <code>false</code><br /><strong>User Property</strong>: <code>jarsigner.verbose</code></td></tr> +<tr class="a"> +<td align="left"><a href="#workingDirectory"><code><workingDirectory></code></a></td> +<td><code>File</code></td> +<td><code>1.3</code></td> +<td>Location of the working directory.<br /><strong>Default</strong>: <code>${project.basedir}</code></td></tr></table></section><section> +<h3><a name="Parameter_Details"></a>Parameter Details</h3><a name="Parameter_Details"></a><a name="alias"></a><section> +<h4><a name="a.3Calias.3E"></a><alias></h4><a name="a.3Calias.3E"></a> +<div>See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.</div> +<ul> +<li><strong>Type</strong>: <code>java.lang.String</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>jarsigner.alias</code></li></ul><hr /></section><a name="archive"></a><section> +<h4><a name="a.3Carchive.3E"></a><archive></h4><a name="a.3Carchive.3E"></a> +<div>Archive to process. If set, neither the project artifact nor any attachments or archive sets are processed.</div> +<ul> +<li><strong>Type</strong>: <code>java.io.File</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>jarsigner.archive</code></li></ul><hr /></section><a name="archiveDirectory"></a><section> +<h4><a name="a.3CarchiveDirectory.3E"></a><archiveDirectory></h4><a name="a.3CarchiveDirectory.3E"></a> +<div>The base directory to scan for JAR files using Ant-like inclusion/exclusion patterns.</div> +<ul> +<li><strong>Type</strong>: <code>java.io.File</code></li> +<li><strong>Since</strong>: <code>1.1</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>jarsigner.archiveDirectory</code></li></ul><hr /></section><a name="arguments"></a><section> +<h4><a name="a.3Carguments.3E"></a><arguments></h4><a name="a.3Carguments.3E"></a> +<div>List of additional arguments to append to the jarsigner command line. Each argument should be specified as a separate element. For example, to specify the name of the signed jar, two elements are needed: +<ul> + <li>Alternative using the command line: <code>-Djarsigner.arguments="-signedjar,my-project_signed.jar"</code></li> + <li>Alternative using the Maven POM configuration:</li> +</ul> +<pre><code><configuration> + <arguments> + <argument>-signedjar</argument> + <argument>my-project_signed.jar</argument> + </arguments> +</configuration> +</code></pre></div> +<ul> +<li><strong>Type</strong>: <code>java.lang.String[]</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>jarsigner.arguments</code></li></ul><hr /></section><a name="certchain"></a><section> +<h4><a name="a.3Ccertchain.3E"></a><certchain></h4><a name="a.3Ccertchain.3E"></a> +<div>Location of the extra certificate chain file. See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.</div> +<ul> +<li><strong>Type</strong>: <code>java.io.File</code></li> +<li><strong>Since</strong>: <code>1.5</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>jarsigner.certchain</code></li></ul><hr /></section><a name="excludeClassifiers"></a><section> +<h4><a name="a.3CexcludeClassifiers.3E"></a><excludeClassifiers></h4><a name="a.3CexcludeClassifiers.3E"></a> +<div>A set of artifact classifiers describing the project attachments that should not be processed. This parameter is only relevant if <a href="#processAttachedArtifacts"><code>processAttachedArtifacts</code></a> is <code>true</code>. If empty, no attachments are excluded.</div> +<ul> +<li><strong>Type</strong>: <code>java.lang.String[]</code></li> +<li><strong>Since</strong>: <code>1.2</code></li> +<li><strong>Required</strong>: <code>No</code></li></ul><hr /></section><a name="excludes"></a><section> +<h4><a name="a.3Cexcludes.3E"></a><excludes></h4><a name="a.3Cexcludes.3E"></a> +<div>The Ant-like exclusion patterns used to exclude JAR files from processing. The patterns must be relative to the directory given by the parameter <a href="#archiveDirectory"><code>archiveDirectory</code></a>.</div> +<ul> +<li><strong>Type</strong>: <code>java.lang.String[]</code></li> +<li><strong>Since</strong>: <code>1.1</code></li> +<li><strong>Required</strong>: <code>No</code></li></ul><hr /></section><a name="includeClassifiers"></a><section> +<h4><a name="a.3CincludeClassifiers.3E"></a><includeClassifiers></h4><a name="a.3CincludeClassifiers.3E"></a> +<div>A set of artifact classifiers describing the project attachments that should be processed. This parameter is only relevant if <a href="#processAttachedArtifacts"><code>processAttachedArtifacts</code></a> is <code>true</code>. If empty, all attachments are included.</div> +<ul> +<li><strong>Type</strong>: <code>java.lang.String[]</code></li> +<li><strong>Since</strong>: <code>1.2</code></li> +<li><strong>Required</strong>: <code>No</code></li></ul><hr /></section><a name="includes"></a><section> +<h4><a name="a.3Cincludes.3E"></a><includes></h4><a name="a.3Cincludes.3E"></a> +<div>The Ant-like inclusion patterns used to select JAR files to process. The patterns must be relative to the directory given by the parameter <a href="#archiveDirectory"><code>archiveDirectory</code></a>. By default, the pattern <code>**/*.?ar</code> is used.</div> +<ul> +<li><strong>Type</strong>: <code>java.lang.String[]</code></li> +<li><strong>Since</strong>: <code>1.1</code></li> +<li><strong>Required</strong>: <code>No</code></li></ul><hr /></section><a name="keypass"></a><section> +<h4><a name="a.3Ckeypass.3E"></a><keypass></h4><a name="a.3Ckeypass.3E"></a> +<div>See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.</div> +<ul> +<li><strong>Type</strong>: <code>java.lang.String</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>jarsigner.keypass</code></li></ul><hr /></section><a name="keystore"></a><section> +<h4><a name="a.3Ckeystore.3E"></a><keystore></h4><a name="a.3Ckeystore.3E"></a> +<div>See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.</div> +<ul> +<li><strong>Type</strong>: <code>java.lang.String</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>jarsigner.keystore</code></li></ul><hr /></section><a name="maxMemory"></a><section> +<h4><a name="a.3CmaxMemory.3E"></a><maxMemory></h4><a name="a.3CmaxMemory.3E"></a> +<div>The maximum memory available to the JAR signer, e.g. <code>256M</code>. See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/java.html#Xms";>-Xmx</a> for more details.</div> +<ul> +<li><strong>Type</strong>: <code>java.lang.String</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>jarsigner.maxMemory</code></li></ul><hr /></section><a name="maxRetryDelaySeconds"></a><section> +<h4><a name="a.3CmaxRetryDelaySeconds.3E"></a><maxRetryDelaySeconds></h4><a name="a.3CmaxRetryDelaySeconds.3E"></a> +<div>Maximum delay, in seconds, to wait after a failed attempt before re-trying. The delay after a failed attempt follows an exponential backoff strategy, with increasing delay times.</div> +<ul> +<li><strong>Type</strong>: <code>int</code></li> +<li><strong>Since</strong>: <code>3.1.0</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>jarsigner.maxRetryDelaySeconds</code></li> +<li><strong>Default</strong>: <code>0</code></li></ul><hr /></section><a name="maxTries"></a><section> +<h4><a name="a.3CmaxTries.3E"></a><maxTries></h4><a name="a.3CmaxTries.3E"></a> +<div>How many times to try to sign a jar (assuming each previous attempt is a failure). This option may be desirable if any network operations are used during signing, for example using a Time Stamp Authority or network based PKCS11 HSM solution for storing code signing keys. The default value of 1 indicates that no retries should be made.</div> +<ul> +<li><strong>Type</strong>: <code>int</code></li> +<li><strong>Since</strong>: <code>3.1.0</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>jarsigner.maxTries</code></li> +<li><strong>Default</strong>: <code>1</code></li></ul><hr /></section><a name="processAttachedArtifacts"></a><section> +<h4><a name="a.3CprocessAttachedArtifacts.3E"></a><processAttachedArtifacts></h4><a name="a.3CprocessAttachedArtifacts.3E"></a> +<div>Controls processing of project attachments. If enabled, attached artifacts that are no JAR/ZIP files will be automatically excluded from processing.</div> +<ul> +<li><strong>Type</strong>: <code>boolean</code></li> +<li><strong>Since</strong>: <code>1.1</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>jarsigner.processAttachedArtifacts</code></li> +<li><strong>Default</strong>: <code>true</code></li></ul><hr /></section><a name="processMainArtifact"></a><section> +<h4><a name="a.3CprocessMainArtifact.3E"></a><processMainArtifact></h4><a name="a.3CprocessMainArtifact.3E"></a> +<div>Controls processing of the main artifact produced by the project.</div> +<ul> +<li><strong>Type</strong>: <code>boolean</code></li> +<li><strong>Since</strong>: <code>1.1</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>jarsigner.processMainArtifact</code></li> +<li><strong>Default</strong>: <code>true</code></li></ul><hr /></section><a name="protectedAuthenticationPath"></a><section> +<h4><a name="a.3CprotectedAuthenticationPath.3E"></a><protectedAuthenticationPath></h4><a name="a.3CprotectedAuthenticationPath.3E"></a> +<div>Must be set to true if the password must be given via a protected authentication path such as a dedicated PIN reader.</div> +<ul> +<li><strong>Type</strong>: <code>boolean</code></li> +<li><strong>Since</strong>: <code>1.3</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>jarsigner.protectedAuthenticationPath</code></li> +<li><strong>Default</strong>: <code>false</code></li></ul><hr /></section><a name="providerArg"></a><section> +<h4><a name="a.3CproviderArg.3E"></a><providerArg></h4><a name="a.3CproviderArg.3E"></a> +<div>See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.</div> +<ul> +<li><strong>Type</strong>: <code>java.lang.String</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>jarsigner.providerArg</code></li></ul><hr /></section><a name="providerClass"></a><section> +<h4><a name="a.3CproviderClass.3E"></a><providerClass></h4><a name="a.3CproviderClass.3E"></a> +<div>See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.</div> +<ul> +<li><strong>Type</strong>: <code>java.lang.String</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>jarsigner.providerClass</code></li></ul><hr /></section><a name="providerName"></a><section> +<h4><a name="a.3CproviderName.3E"></a><providerName></h4><a name="a.3CproviderName.3E"></a> +<div>See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.</div> +<ul> +<li><strong>Type</strong>: <code>java.lang.String</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>jarsigner.providerName</code></li></ul><hr /></section><a name="removeExistingSignatures"></a><section> +<h4><a name="a.3CremoveExistingSignatures.3E"></a><removeExistingSignatures></h4><a name="a.3CremoveExistingSignatures.3E"></a> +<div>Indicates whether existing signatures should be removed from the processed JAR files prior to signing them. If enabled, the resulting JAR will appear as being signed only once.</div> +<ul> +<li><strong>Type</strong>: <code>boolean</code></li> +<li><strong>Since</strong>: <code>1.1</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>jarsigner.removeExistingSignatures</code></li> +<li><strong>Default</strong>: <code>false</code></li></ul><hr /></section><a name="sigfile"></a><section> +<h4><a name="a.3Csigfile.3E"></a><sigfile></h4><a name="a.3Csigfile.3E"></a> +<div>See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.</div> +<ul> +<li><strong>Type</strong>: <code>java.lang.String</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>jarsigner.sigfile</code></li></ul><hr /></section><a name="skip"></a><section> +<h4><a name="a.3Cskip.3E"></a><skip></h4><a name="a.3Cskip.3E"></a> +<div>Set to <code>true</code> to disable the plugin.</div> +<ul> +<li><strong>Type</strong>: <code>boolean</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>jarsigner.skip</code></li> +<li><strong>Default</strong>: <code>false</code></li></ul><hr /></section><a name="storepass"></a><section> +<h4><a name="a.3Cstorepass.3E"></a><storepass></h4><a name="a.3Cstorepass.3E"></a> +<div>See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.</div> +<ul> +<li><strong>Type</strong>: <code>java.lang.String</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>jarsigner.storepass</code></li></ul><hr /></section><a name="storetype"></a><section> +<h4><a name="a.3Cstoretype.3E"></a><storetype></h4><a name="a.3Cstoretype.3E"></a> +<div>See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.</div> +<ul> +<li><strong>Type</strong>: <code>java.lang.String</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>jarsigner.storetype</code></li></ul><hr /></section><a name="threadCount"></a><section> +<h4><a name="a.3CthreadCount.3E"></a><threadCount></h4><a name="a.3CthreadCount.3E"></a> +<div>Maximum number of parallel threads to use when signing jar files. Increases performance when signing multiple jar files, especially when network operations are used during signing, for example when using a Time Stamp Authority or network based PKCS11 HSM solution for storing code signing keys. Note: the logging from the signing process will be interleaved, and harder to read, when using many threads.</div> +<ul> +<li><strong>Type</strong>: <code>int</code></li> +<li><strong>Since</strong>: <code>3.1.0</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>jarsigner.threadCount</code></li> +<li><strong>Default</strong>: <code>1</code></li></ul><hr /></section><a name="tsa"></a><section> +<h4><a name="a.3Ctsa.3E"></a><tsa></h4><a name="a.3Ctsa.3E"></a> +<div><p>URL(s) to Time Stamping Authority (TSA) server(s) to use to timestamp the signing. See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>. Separate multiple TSA URLs with comma (without space) or a nested XML tag.</p> +<pre><code><configuration> + <tsa>http://timestamp.digicert.com,http://timestamp.globalsign.com/tsa/r6advanced1</tsa> +</configuration> +</code></pre> +<pre><code><configuration> + <tsa> + <url>http://timestamp.digicert.com</url> + <url>http://timestamp.globalsign.com/tsa/r6advanced1</url> + </tsa> +</configuration> +</code></pre> +<p>Usage of multiple TSA servers only makes sense when <a href="#maxTries"><code>maxTries</code></a> is more than 1. A different TSA server will only be used at retries.</p> +<p>Changed to a list since 3.1.0. Single XML element (without comma) is still supported.</p></div> +<ul> +<li><strong>Type</strong>: <code>java.lang.String[]</code></li> +<li><strong>Since</strong>: <code>1.3</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>jarsigner.tsa</code></li></ul><hr /></section><a name="tsacert"></a><section> +<h4><a name="a.3Ctsacert.3E"></a><tsacert></h4><a name="a.3Ctsacert.3E"></a> +<div><p>Alias(es) for certificate(s) in the active keystore used to find a TSA URL. From the certificate the X509v3 extension "Subject Information Access" field is examined to find the TSA server URL. See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>. Separate multiple aliases with comma (without space) or a nested XML tag.</p> +<pre><code><configuration> + <tsacert>alias1,alias2</tsacert> +</configuration> +</code></pre> +<pre><code><configuration> + <tsacert> + <alias>alias1</alias> + <alias>alias2</alias> + </tsacert> +</configuration> +</code></pre> +<p>Should not be used at the same time as the <a href="#tsa"><code>tsa</code></a> parameter (because jarsigner will typically ignore tsacert, if tsa is set).</p> +<p>Usage of multiple aliases only makes sense when <a href="#maxTries"><code>maxTries</code></a> is more than 1. A different TSA server will only be used at retries.</p> +<p>Changed to a list since 3.1.0. Single XML element (without comma) is still supported.</p></div> +<ul> +<li><strong>Type</strong>: <code>java.lang.String[]</code></li> +<li><strong>Since</strong>: <code>1.3</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>jarsigner.tsacert</code></li></ul><hr /></section><a name="tsadigestalg"></a><section> +<h4><a name="a.3Ctsadigestalg.3E"></a><tsadigestalg></h4><a name="a.3Ctsadigestalg.3E"></a> +<div>The message digest algorithm to use in the messageImprint that the TSA server will timestamp. A default value (for example <code>SHA-384</code>) will be selected by jarsigner if this parameter is not set. Only available in Java 11 and later. See <a href="https://docs.oracle.com/en/java/javase/11/tools/jarsigner.html";>options</a>.</div> +<ul> +<li><strong>Type</strong>: <code>java.lang.String</code></li> +<li><strong>Since</strong>: <code>3.1.0</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>jarsigner.tsadigestalg</code></li></ul><hr /></section><a name="tsapolicyid"></a><section> +<h4><a name="a.3Ctsapolicyid.3E"></a><tsapolicyid></h4><a name="a.3Ctsapolicyid.3E"></a> +<div><p>OID(s) to send to the TSA server to identify the policy ID the server should use. If not specified TSA server will choose a default policy ID. Each TSA server vendor will typically define their own policy OIDs. See <a href="https://docs.oracle.com/javase/8/docs/technotes/tools/windows/jarsigner.html#CCHIFIAD";>options</a>. Separate multiple OIDs with comma (without space) or a nested XML tag.</p> +<pre><code><configuration> + <tsapolicyid>1.3.6.1.4.1.4146.2.3.1.2,2.16.840.1.114412.7.1</tsapolicyid> +</configuration> +</code></pre> +<pre><code><configuration> + <tsapolicyid> + <oid>1.3.6.1.4.1.4146.2.3.1.2</oid> + <oid>2.16.840.1.114412.7.1</oid> + </tsapolicyid> +</configuration> +</code></pre> +<p>If used, the number of OIDs should be the same as the number of elements in <a href="#tsa"><code>tsa</code></a> or <a href="#tsacert"><code>tsacert</code></a>. The first OID will be used for the first TSA server, the second OID for the second TSA server and so on.</p></div> +<ul> +<li><strong>Type</strong>: <code>java.lang.String[]</code></li> +<li><strong>Since</strong>: <code>3.1.0</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>jarsigner.tsapolicyid</code></li></ul><hr /></section><a name="verbose"></a><section> +<h4><a name="a.3Cverbose.3E"></a><verbose></h4><a name="a.3Cverbose.3E"></a> +<div>See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/jarsigner.html#Options";>options</a>.</div> +<ul> +<li><strong>Type</strong>: <code>boolean</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>jarsigner.verbose</code></li> +<li><strong>Default</strong>: <code>false</code></li></ul><hr /></section><a name="workingDirectory"></a><section> +<h4><a name="a.3CworkingDirectory.3E"></a><workingDirectory></h4><a name="a.3CworkingDirectory.3E"></a> +<div>Location of the working directory.</div> +<ul> +<li><strong>Type</strong>: <code>java.io.File</code></li> +<li><strong>Since</strong>: <code>1.3</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>Default</strong>: <code>${project.basedir}</code></li></ul></section></section></section> + </main> + </div> + </div> + <hr/> + <footer> + <div class="container-fluid"> + <div class="row-fluid"> + <p>© 2002â2024 +<a href="https://www.apache.org/";>The Apache Software Foundation</a> +</p> + </div> + </div> + </footer> +<script> + if(anchors) { + anchors.add(); + } +</script> + </body> </html> \ No newline at end of file
