forked from rachanon/stdbWeb
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
2957 lines
84 KiB
2957 lines
84 KiB
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" |
|
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
|
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> |
|
<head> |
|
<meta http-equiv="content-type" content="text/html; charset=utf-8" /> |
|
<meta name="generator" content="JsDoc Toolkit" /> |
|
|
|
<title>jsrsasign 4.8.7 JavaScript API Reference - KEYUTIL</title> |
|
|
|
<style type="text/css"> |
|
/* default.css */ |
|
body |
|
{ |
|
font: 12px "Lucida Grande", Tahoma, Arial, Helvetica, sans-serif; |
|
width: 800px; |
|
} |
|
|
|
.header |
|
{ |
|
clear: both; |
|
background-color: #ccc; |
|
padding: 8px; |
|
} |
|
|
|
h1 |
|
{ |
|
font-size: 150%; |
|
font-weight: bold; |
|
padding: 0; |
|
margin: 1em 0 0 .3em; |
|
} |
|
|
|
hr |
|
{ |
|
border: none 0; |
|
border-top: 1px solid #7F8FB1; |
|
height: 1px; |
|
} |
|
|
|
pre.code |
|
{ |
|
display: block; |
|
padding: 8px; |
|
border: 1px dashed #ccc; |
|
} |
|
|
|
#index |
|
{ |
|
margin-top: 24px; |
|
float: left; |
|
width: 160px; |
|
position: absolute; |
|
left: 8px; |
|
background-color: #F3F3F3; |
|
padding: 8px; |
|
} |
|
|
|
#content |
|
{ |
|
margin-left: 190px; |
|
width: 600px; |
|
} |
|
|
|
.classList |
|
{ |
|
list-style-type: none; |
|
padding: 0; |
|
margin: 0 0 0 8px; |
|
font-family: arial, sans-serif; |
|
font-size: 1em; |
|
overflow: auto; |
|
} |
|
|
|
.classList li |
|
{ |
|
padding: 0; |
|
margin: 0 0 8px 0; |
|
} |
|
|
|
.summaryTable { width: 100%; } |
|
|
|
h1.classTitle |
|
{ |
|
font-size:170%; |
|
line-height:130%; |
|
} |
|
|
|
h2 { font-size: 110%; } |
|
caption, div.sectionTitle |
|
{ |
|
background-color: #7F8FB1; |
|
color: #fff; |
|
font-size:130%; |
|
text-align: left; |
|
padding: 2px 6px 2px 6px; |
|
border: 1px #7F8FB1 solid; |
|
} |
|
|
|
div.sectionTitle { margin-bottom: 8px; } |
|
.summaryTable thead { display: none; } |
|
|
|
.summaryTable td |
|
{ |
|
vertical-align: top; |
|
padding: 4px; |
|
border-bottom: 1px #7F8FB1 solid; |
|
border-right: 1px #7F8FB1 solid; |
|
} |
|
|
|
/*col#summaryAttributes {}*/ |
|
.summaryTable td.attributes |
|
{ |
|
border-left: 1px #7F8FB1 solid; |
|
width: 140px; |
|
text-align: right; |
|
} |
|
|
|
td.attributes, .fixedFont |
|
{ |
|
line-height: 15px; |
|
color: #002EBE; |
|
font-family: "Courier New",Courier,monospace; |
|
font-size: 13px; |
|
} |
|
|
|
.summaryTable td.nameDescription |
|
{ |
|
text-align: left; |
|
font-size: 13px; |
|
line-height: 15px; |
|
} |
|
|
|
.summaryTable td.nameDescription, .description |
|
{ |
|
line-height: 15px; |
|
padding: 4px; |
|
padding-left: 4px; |
|
} |
|
|
|
.summaryTable { margin-bottom: 8px; } |
|
|
|
ul.inheritsList |
|
{ |
|
list-style: square; |
|
margin-left: 20px; |
|
padding-left: 0; |
|
} |
|
|
|
.detailList { |
|
margin-left: 20px; |
|
line-height: 15px; |
|
} |
|
.detailList dt { margin-left: 20px; } |
|
|
|
.detailList .heading |
|
{ |
|
font-weight: bold; |
|
padding-bottom: 6px; |
|
margin-left: 0; |
|
} |
|
|
|
.light, td.attributes, .light a:link, .light a:visited |
|
{ |
|
color: #777; |
|
font-style: italic; |
|
} |
|
|
|
.fineprint |
|
{ |
|
text-align: right; |
|
font-size: 10px; |
|
} |
|
</style> |
|
</head> |
|
|
|
<body> |
|
<!-- ============================== header ================================= --> |
|
<!-- begin static/header.html --> |
|
<div id="header" style="background: #7F8FB1; color: white; margin: -10px"> |
|
<b><a href="http://kjur.github.com/jsrsasign/" style="color: white">jsrsasign</a></b> JavaScript API Reference |
|
</div> |
|
|
|
<!-- end static/header.html --> |
|
|
|
<!-- ============================== classes index ============================ --> |
|
<div id="index"> |
|
<!-- begin publish.classesIndex --> |
|
<div align="center"><a href="../index.html">Class Index</a> |
|
| <a href="../files.html">File Index</a></div> |
|
<hr /> |
|
<h2>Classes</h2> |
|
<ul class="classList"> |
|
|
|
<li><i><a href="../symbols/global__.html">global__</a></i></li> |
|
|
|
<li><a href="../symbols/ASN1HEX.html">ASN1HEX</a></li> |
|
|
|
<li><a href="../symbols/Base64x.html">Base64x</a></li> |
|
|
|
<li><a href="../symbols/KEYUTIL.html">KEYUTIL</a></li> |
|
|
|
<li><a href="../symbols/KJUR.html">KJUR</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.html">KJUR.asn1</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.ASN1Object.html">KJUR.asn1.ASN1Object</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.ASN1Util.html">KJUR.asn1.ASN1Util</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.cades.html">KJUR.asn1.cades</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.cades.CAdESUtil.html">KJUR.asn1.cades.CAdESUtil</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.cades.CompleteCertificateRefs.html">KJUR.asn1.cades.CompleteCertificateRefs</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.cades.OtherCertID.html">KJUR.asn1.cades.OtherCertID</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.cades.OtherHash.html">KJUR.asn1.cades.OtherHash</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.cades.OtherHashAlgAndValue.html">KJUR.asn1.cades.OtherHashAlgAndValue</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.cades.SignaturePolicyIdentifier.html">KJUR.asn1.cades.SignaturePolicyIdentifier</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.cades.SignatureTimeStamp.html">KJUR.asn1.cades.SignatureTimeStamp</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.cms.html">KJUR.asn1.cms</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.cms.Attribute.html">KJUR.asn1.cms.Attribute</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.cms.AttributeList.html">KJUR.asn1.cms.AttributeList</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.cms.CMSUtil.html">KJUR.asn1.cms.CMSUtil</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.cms.ContentInfo.html">KJUR.asn1.cms.ContentInfo</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.cms.ContentType.html">KJUR.asn1.cms.ContentType</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.cms.EncapsulatedContentInfo.html">KJUR.asn1.cms.EncapsulatedContentInfo</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.cms.IssuerAndSerialNumber.html">KJUR.asn1.cms.IssuerAndSerialNumber</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.cms.MessageDigest.html">KJUR.asn1.cms.MessageDigest</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.cms.SignedData.html">KJUR.asn1.cms.SignedData</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.cms.SignerInfo.html">KJUR.asn1.cms.SignerInfo</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.cms.SigningCertificate.html">KJUR.asn1.cms.SigningCertificate</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.cms.SigningCertificateV2.html">KJUR.asn1.cms.SigningCertificateV2</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.cms.SigningTime.html">KJUR.asn1.cms.SigningTime</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.csr.html">KJUR.asn1.csr</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.csr.CertificationRequest.html">KJUR.asn1.csr.CertificationRequest</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.csr.CertificationRequestInfo.html">KJUR.asn1.csr.CertificationRequestInfo</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.csr.CSRUtil.html">KJUR.asn1.csr.CSRUtil</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.DERAbstractString.html">KJUR.asn1.DERAbstractString</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.DERAbstractStructured.html">KJUR.asn1.DERAbstractStructured</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.DERAbstractTime.html">KJUR.asn1.DERAbstractTime</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.DERBitString.html">KJUR.asn1.DERBitString</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.DERBoolean.html">KJUR.asn1.DERBoolean</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.DEREnumerated.html">KJUR.asn1.DEREnumerated</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.DERGeneralizedTime.html">KJUR.asn1.DERGeneralizedTime</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.DERIA5String.html">KJUR.asn1.DERIA5String</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.DERInteger.html">KJUR.asn1.DERInteger</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.DERNull.html">KJUR.asn1.DERNull</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.DERNumericString.html">KJUR.asn1.DERNumericString</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.DERObjectIdentifier.html">KJUR.asn1.DERObjectIdentifier</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.DEROctetString.html">KJUR.asn1.DEROctetString</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.DERPrintableString.html">KJUR.asn1.DERPrintableString</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.DERSequence.html">KJUR.asn1.DERSequence</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.DERSet.html">KJUR.asn1.DERSet</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.DERTaggedObject.html">KJUR.asn1.DERTaggedObject</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.DERTeletexString.html">KJUR.asn1.DERTeletexString</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.DERUTCTime.html">KJUR.asn1.DERUTCTime</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.DERUTF8String.html">KJUR.asn1.DERUTF8String</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.tsp.html">KJUR.asn1.tsp</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.tsp.AbstractTSAAdapter.html">KJUR.asn1.tsp.AbstractTSAAdapter</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.tsp.Accuracy.html">KJUR.asn1.tsp.Accuracy</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.tsp.FixedTSAAdapter.html">KJUR.asn1.tsp.FixedTSAAdapter</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.tsp.MessageImprint.html">KJUR.asn1.tsp.MessageImprint</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.tsp.PKIFailureInfo.html">KJUR.asn1.tsp.PKIFailureInfo</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.tsp.PKIFreeText.html">KJUR.asn1.tsp.PKIFreeText</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.tsp.PKIStatus.html">KJUR.asn1.tsp.PKIStatus</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.tsp.PKIStatusInfo.html">KJUR.asn1.tsp.PKIStatusInfo</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.tsp.SimpleTSAAdapter.html">KJUR.asn1.tsp.SimpleTSAAdapter</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.tsp.TimeStampReq.html">KJUR.asn1.tsp.TimeStampReq</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.tsp.TimeStampResp.html">KJUR.asn1.tsp.TimeStampResp</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.tsp.TSPUtil.html">KJUR.asn1.tsp.TSPUtil</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.tsp.TSTInfo.html">KJUR.asn1.tsp.TSTInfo</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.x509.html">KJUR.asn1.x509</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.x509.AlgorithmIdentifier.html">KJUR.asn1.x509.AlgorithmIdentifier</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.x509.AttributeTypeAndValue.html">KJUR.asn1.x509.AttributeTypeAndValue</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.x509.AuthorityKeyIdentifier.html">KJUR.asn1.x509.AuthorityKeyIdentifier</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.x509.BasicConstraints.html">KJUR.asn1.x509.BasicConstraints</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.x509.Certificate.html">KJUR.asn1.x509.Certificate</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.x509.CRL.html">KJUR.asn1.x509.CRL</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.x509.CRLDistributionPoints.html">KJUR.asn1.x509.CRLDistributionPoints</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.x509.CRLEntry.html">KJUR.asn1.x509.CRLEntry</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.x509.DistributionPoint.html">KJUR.asn1.x509.DistributionPoint</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.x509.DistributionPointName.html">KJUR.asn1.x509.DistributionPointName</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.x509.Extension.html">KJUR.asn1.x509.Extension</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.x509.ExtKeyUsage.html">KJUR.asn1.x509.ExtKeyUsage</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.x509.GeneralName.html">KJUR.asn1.x509.GeneralName</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.x509.GeneralNames.html">KJUR.asn1.x509.GeneralNames</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.x509.KeyUsage.html">KJUR.asn1.x509.KeyUsage</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.x509.OID.html">KJUR.asn1.x509.OID</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.x509.RDN.html">KJUR.asn1.x509.RDN</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.x509.SubjectPublicKeyInfo.html">KJUR.asn1.x509.SubjectPublicKeyInfo</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.x509.TBSCertificate.html">KJUR.asn1.x509.TBSCertificate</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.x509.TBSCertList.html">KJUR.asn1.x509.TBSCertList</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.x509.Time.html">KJUR.asn1.x509.Time</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.x509.X500Name.html">KJUR.asn1.x509.X500Name</a></li> |
|
|
|
<li><a href="../symbols/KJUR.asn1.x509.X509Util.html">KJUR.asn1.x509.X509Util</a></li> |
|
|
|
<li><a href="../symbols/KJUR.crypto.html">KJUR.crypto</a></li> |
|
|
|
<li><a href="../symbols/KJUR.crypto.DSA.html">KJUR.crypto.DSA</a></li> |
|
|
|
<li><a href="../symbols/KJUR.crypto.ECDSA.html">KJUR.crypto.ECDSA</a></li> |
|
|
|
<li><a href="../symbols/KJUR.crypto.ECParameterDB.html">KJUR.crypto.ECParameterDB</a></li> |
|
|
|
<li><a href="../symbols/KJUR.crypto.Mac.html">KJUR.crypto.Mac</a></li> |
|
|
|
<li><a href="../symbols/KJUR.crypto.MessageDigest.html">KJUR.crypto.MessageDigest</a></li> |
|
|
|
<li><a href="../symbols/KJUR.crypto.OID.html">KJUR.crypto.OID</a></li> |
|
|
|
<li><a href="../symbols/KJUR.crypto.Signature.html">KJUR.crypto.Signature</a></li> |
|
|
|
<li><a href="../symbols/KJUR.crypto.Util.html">KJUR.crypto.Util</a></li> |
|
|
|
<li><a href="../symbols/KJUR.jws.html">KJUR.jws</a></li> |
|
|
|
<li><a href="../symbols/KJUR.jws.IntDate.html">KJUR.jws.IntDate</a></li> |
|
|
|
<li><a href="../symbols/KJUR.jws.JWS.html">KJUR.jws.JWS</a></li> |
|
|
|
<li><a href="../symbols/KJUR.jws.JWSJS.html">KJUR.jws.JWSJS</a></li> |
|
|
|
<li><a href="../symbols/PKCS5PKEY.html">PKCS5PKEY</a></li> |
|
|
|
<li><a href="../symbols/RSAKey.html">RSAKey</a></li> |
|
|
|
<li><a href="../symbols/X509.html">X509</a></li> |
|
|
|
</ul> |
|
<hr /> |
|
<!-- end publish.classesIndex --> |
|
</div> |
|
|
|
<div id="content"> |
|
<!-- ============================== class title ============================ --> |
|
<h1 class="classTitle"> |
|
|
|
Class KEYUTIL |
|
</h1> |
|
|
|
<!-- ============================== class summary ========================== --> |
|
<p class="description"> |
|
|
|
|
|
|
|
class for RSA/ECC/DSA key utility |
|
|
|
|
|
<br /><i>Defined in: </i> <a href="../symbols/src/keyutil-1.0.js.html">keyutil-1.0.js</a>. |
|
|
|
</p> |
|
|
|
<!-- ============================== constructor summary ==================== --> |
|
|
|
<table class="summaryTable" cellspacing="0" summary="A summary of the constructor documented in the class KEYUTIL."> |
|
<caption>Class Summary</caption> |
|
<thead> |
|
<tr> |
|
<th scope="col">Constructor Attributes</th> |
|
<th scope="col">Constructor Name and Description</th> |
|
</tr> |
|
</thead> |
|
<tbody> |
|
<tr> |
|
<td class="attributes"> </td> |
|
<td class="nameDescription" > |
|
<div class="fixedFont"> |
|
<b><a href="../symbols/KEYUTIL.html#constructor">KEYUTIL</a></b>() |
|
</div> |
|
<div class="description"><br/> |
|
<a href="../symbols/KEYUTIL.html">KEYUTIL</a> class is an update of former <a href="../symbols/PKCS5PKEY.html">PKCS5PKEY</a> class.</div> |
|
</td> |
|
</tr> |
|
</tbody> |
|
</table> |
|
|
|
|
|
<!-- ============================== properties summary ===================== --> |
|
|
|
|
|
|
|
<table class="summaryTable" cellspacing="0" summary="A summary of the fields documented in the class KEYUTIL."> |
|
<caption>Field Summary</caption> |
|
<thead> |
|
<tr> |
|
<th scope="col">Field Attributes</th> |
|
<th scope="col">Field Name and Description</th> |
|
</tr> |
|
</thead> |
|
<tbody> |
|
|
|
<tr> |
|
<td class="attributes"><static> </td> |
|
<td class="nameDescription"> |
|
<div class="fixedFont"> |
|
KEYUTIL.<b><a href="../symbols/KEYUTIL.html#.version">version</a></b> |
|
</div> |
|
<div class="description">decrypt private key by shared key |
|
version string of KEYUTIL class</div> |
|
</td> |
|
</tr> |
|
|
|
</tbody> |
|
</table> |
|
|
|
|
|
|
|
|
|
|
|
<!-- ============================== methods summary ======================== --> |
|
|
|
|
|
|
|
<table class="summaryTable" cellspacing="0" summary="A summary of the methods documented in the class KEYUTIL."> |
|
<caption>Method Summary</caption> |
|
<thead> |
|
<tr> |
|
<th scope="col">Method Attributes</th> |
|
<th scope="col">Method Name and Description</th> |
|
</tr> |
|
</thead> |
|
<tbody> |
|
|
|
<tr> |
|
<td class="attributes"><static> </td> |
|
<td class="nameDescription"> |
|
<div class="fixedFont">KEYUTIL.<b><a href="../symbols/KEYUTIL.html#.generateKeypair">generateKeypair</a></b>(alg, keylenOrCurve) |
|
</div> |
|
<div class="description">This method generates a key pair of public key algorithm.</div> |
|
</td> |
|
</tr> |
|
|
|
<tr> |
|
<td class="attributes"><static> </td> |
|
<td class="nameDescription"> |
|
<div class="fixedFont">KEYUTIL.<b><a href="../symbols/KEYUTIL.html#.getDecryptedKeyHex">getDecryptedKeyHex</a></b>(sEncryptedPEM, passcode) |
|
</div> |
|
<div class="description">decrypt PEM formatted protected PKCS#5 private key with passcode</div> |
|
</td> |
|
</tr> |
|
|
|
<tr> |
|
<td class="attributes"><static> </td> |
|
<td class="nameDescription"> |
|
<div class="fixedFont">KEYUTIL.<b><a href="../symbols/KEYUTIL.html#.getDecryptedKeyHexByKeyIV">getDecryptedKeyHexByKeyIV</a></b>(encryptedKeyHex, algName, sharedKeyHex, ivHex) |
|
</div> |
|
<div class="description">decrypt private key by shared key</div> |
|
</td> |
|
</tr> |
|
|
|
<tr> |
|
<td class="attributes"><static> </td> |
|
<td class="nameDescription"> |
|
<div class="fixedFont">KEYUTIL.<b><a href="../symbols/KEYUTIL.html#.getEncryptedPKCS5PEMFromRSAKey">getEncryptedPKCS5PEMFromRSAKey</a></b>(pKey, passcode, alg, ivsaltHex) |
|
</div> |
|
<div class="description">(DEPRECATED) get PEM formatted encrypted PKCS#5 private key from RSAKey object of private key |
|
<br/> |
|
generate PEM formatted encrypted PKCS#5 private key by |
|
<a href="../symbols/RSAKey.html">RSAKey</a> object of RSA private key and passcode.</div> |
|
</td> |
|
</tr> |
|
|
|
<tr> |
|
<td class="attributes"><static> </td> |
|
<td class="nameDescription"> |
|
<div class="fixedFont">KEYUTIL.<b><a href="../symbols/KEYUTIL.html#.getHexFromPEM">getHexFromPEM</a></b>(sPEM, sHead) |
|
</div> |
|
<div class="description">get hexacedimal string of PEM format</div> |
|
</td> |
|
</tr> |
|
|
|
<tr> |
|
<td class="attributes"><static> </td> |
|
<td class="nameDescription"> |
|
<div class="fixedFont">KEYUTIL.<b><a href="../symbols/KEYUTIL.html#.getKey">getKey</a></b>(param, passcode, hextype) |
|
</div> |
|
<div class="description">get private or public key object from any arguments |
|
This method gets private or public key object(<a href="../symbols/RSAKey.html">RSAKey</a>, <a href="../symbols/KJUR.crypto.DSA.html">KJUR.crypto.DSA</a> or <a href="../symbols/KJUR.crypto.ECDSA.html">KJUR.crypto.ECDSA</a>) |
|
for RSA, DSA and ECC.</div> |
|
</td> |
|
</tr> |
|
|
|
<tr> |
|
<td class="attributes"><static> </td> |
|
<td class="nameDescription"> |
|
<div class="fixedFont">KEYUTIL.<b><a href="../symbols/KEYUTIL.html#.getKeyAndUnusedIvByPasscodeAndIvsalt">getKeyAndUnusedIvByPasscodeAndIvsalt</a></b>(algName, passcode, hexadecimal) |
|
</div> |
|
<div class="description">the same function as OpenSSL EVP_BytsToKey to generate shared key and IV</div> |
|
</td> |
|
</tr> |
|
|
|
<tr> |
|
<td class="attributes"><static> </td> |
|
<td class="nameDescription"> |
|
<div class="fixedFont">KEYUTIL.<b><a href="../symbols/KEYUTIL.html#.getKeyFromCSRHex">getKeyFromCSRHex</a></b>(csrHex) |
|
</div> |
|
<div class="description">get RSAKey/DSA/ECDSA public key object from hexadecimal string of PKCS#10 CSR</div> |
|
</td> |
|
</tr> |
|
|
|
<tr> |
|
<td class="attributes"><static> </td> |
|
<td class="nameDescription"> |
|
<div class="fixedFont">KEYUTIL.<b><a href="../symbols/KEYUTIL.html#.getKeyFromCSRPEM">getKeyFromCSRPEM</a></b>(csrPEM) |
|
</div> |
|
<div class="description">get RSAKey/DSA/ECDSA public key object from PEM formatted PKCS#10 CSR string</div> |
|
</td> |
|
</tr> |
|
|
|
<tr> |
|
<td class="attributes"><static> </td> |
|
<td class="nameDescription"> |
|
<div class="fixedFont">KEYUTIL.<b><a href="../symbols/KEYUTIL.html#.getKeyFromEncryptedPKCS8PEM">getKeyFromEncryptedPKCS8PEM</a></b>(pkcs8PEM, passcode) |
|
</div> |
|
<div class="description">get RSAKey/ECDSA private key object from encrypted PEM PKCS#8 private key</div> |
|
</td> |
|
</tr> |
|
|
|
<tr> |
|
<td class="attributes"><static> </td> |
|
<td class="nameDescription"> |
|
<div class="fixedFont">KEYUTIL.<b><a href="../symbols/KEYUTIL.html#.getKeyFromPlainPrivatePKCS8Hex">getKeyFromPlainPrivatePKCS8Hex</a></b>(prvKeyHex) |
|
</div> |
|
<div class="description">get RSAKey/ECDSA private key object from HEX plain PEM PKCS#8 private key</div> |
|
</td> |
|
</tr> |
|
|
|
<tr> |
|
<td class="attributes"><static> </td> |
|
<td class="nameDescription"> |
|
<div class="fixedFont">KEYUTIL.<b><a href="../symbols/KEYUTIL.html#.getKeyFromPlainPrivatePKCS8PEM">getKeyFromPlainPrivatePKCS8PEM</a></b>(pkcs8PEM) |
|
</div> |
|
<div class="description">get RSAKey/ECDSA private key object from PEM plain PEM PKCS#8 private key</div> |
|
</td> |
|
</tr> |
|
|
|
<tr> |
|
<td class="attributes"><static> </td> |
|
<td class="nameDescription"> |
|
<div class="fixedFont">KEYUTIL.<b><a href="../symbols/KEYUTIL.html#.getKeyFromPublicPKCS8Hex">getKeyFromPublicPKCS8Hex</a></b>(pkcsPub8Hex) |
|
</div> |
|
<div class="description">(DEPRECATED) get RSAKey/DSA/ECDSA public key object from hexadecimal string of PKCS#8 public key</div> |
|
</td> |
|
</tr> |
|
|
|
<tr> |
|
<td class="attributes"><static> </td> |
|
<td class="nameDescription"> |
|
<div class="fixedFont">KEYUTIL.<b><a href="../symbols/KEYUTIL.html#.getKeyFromPublicPKCS8PEM">getKeyFromPublicPKCS8PEM</a></b>(pkcsPub8PEM) |
|
</div> |
|
<div class="description">(DEPRECATED) get RSAKey/ECDSA public key object from PEM PKCS#8 public key</div> |
|
</td> |
|
</tr> |
|
|
|
<tr> |
|
<td class="attributes"><static> </td> |
|
<td class="nameDescription"> |
|
<div class="fixedFont">KEYUTIL.<b><a href="../symbols/KEYUTIL.html#.getPBKDF2KeyHexFromParam">getPBKDF2KeyHexFromParam</a></b>(info, passcode) |
|
</div> |
|
<div class="description">generate PBKDF2 key hexstring with specified passcode and information |
|
As for info, this uses following properties: |
|
<ul> |
|
<li>info.pbkdf2Salt - hexadecimal string of PBKDF2 salt</li> |
|
<li>info.pkbdf2Iter - iteration count</li> |
|
</ul> |
|
Currently, this method only supports PKCS#5v2.0 with PBES2/PBDKF2 of HmacSHA1 and TripleDES.</div> |
|
</td> |
|
</tr> |
|
|
|
<tr> |
|
<td class="attributes"><static> </td> |
|
<td class="nameDescription"> |
|
<div class="fixedFont">KEYUTIL.<b><a href="../symbols/KEYUTIL.html#.getPEM">getPEM</a></b>(keyObjOrHex, formatType, passwd, encAlg) |
|
</div> |
|
<div class="description">get PEM formatted private or public key file from a RSA/ECDSA/DSA key object |
|
<dl> |
|
<dt><b>NOTE1:</b> |
|
<dd> |
|
PKCS#5 encrypted private key protection algorithm supports DES-CBC, |
|
DES-EDE3-CBC and AES-{128,192,256}-CBC |
|
<dt><b>NOTE2:</b> |
|
<dd> |
|
OpenSSL supports |
|
</dl></div> |
|
</td> |
|
</tr> |
|
|
|
<tr> |
|
<td class="attributes"><static> </td> |
|
<td class="nameDescription"> |
|
<div class="fixedFont">KEYUTIL.<b><a href="../symbols/KEYUTIL.html#.getPlainPKCS8HexFromEncryptedPKCS8PEM">getPlainPKCS8HexFromEncryptedPKCS8PEM</a></b>(pkcs8PEM, passcode) |
|
</div> |
|
<div class="description">read PEM formatted encrypted PKCS#8 private key and returns hexadecimal string of plain PKCS#8 private key |
|
Currently, this method only supports PKCS#5v2.0 with PBES2/PBDKF2 of HmacSHA1 and TripleDES.</div> |
|
</td> |
|
</tr> |
|
|
|
<tr> |
|
<td class="attributes"><static> </td> |
|
<td class="nameDescription"> |
|
<div class="fixedFont">KEYUTIL.<b><a href="../symbols/KEYUTIL.html#.getRSAKeyFromEncryptedPKCS5PEM">getRSAKeyFromEncryptedPKCS5PEM</a></b>(sEncryptedP5PEM, passcode) |
|
</div> |
|
<div class="description">(DEPRECATED) read PEM formatted encrypted PKCS#5 private key and returns RSAKey object</div> |
|
</td> |
|
</tr> |
|
|
|
<tr> |
|
<td class="attributes"><static> </td> |
|
<td class="nameDescription"> |
|
<div class="fixedFont">KEYUTIL.<b><a href="../symbols/KEYUTIL.html#.getRSAKeyFromEncryptedPKCS8PEM">getRSAKeyFromEncryptedPKCS8PEM</a></b>(pkcs8PEM, passcode) |
|
</div> |
|
<div class="description">(DEPRECATED) read PEM formatted encrypted PKCS#8 private key and returns RSAKey object |
|
Currently, this method only supports PKCS#5v2.0 with PBES2/PBDKF2 of HmacSHA1 and TripleDES.</div> |
|
</td> |
|
</tr> |
|
|
|
<tr> |
|
<td class="attributes"><static> </td> |
|
<td class="nameDescription"> |
|
<div class="fixedFont">KEYUTIL.<b><a href="../symbols/KEYUTIL.html#.getRSAKeyFromPlainPKCS8Hex">getRSAKeyFromPlainPKCS8Hex</a></b>(prvKeyHex) |
|
</div> |
|
<div class="description">(DEPRECATED) provide hexadecimal string of unencrypted PKCS#8 private key and returns RSAKey object</div> |
|
</td> |
|
</tr> |
|
|
|
<tr> |
|
<td class="attributes"><static> </td> |
|
<td class="nameDescription"> |
|
<div class="fixedFont">KEYUTIL.<b><a href="../symbols/KEYUTIL.html#.getRSAKeyFromPlainPKCS8PEM">getRSAKeyFromPlainPKCS8PEM</a></b>(pkcs8PEM) |
|
</div> |
|
<div class="description">(DEPRECATED) read PEM formatted unencrypted PKCS#8 private key and returns RSAKey object</div> |
|
</td> |
|
</tr> |
|
|
|
<tr> |
|
<td class="attributes"><static> </td> |
|
<td class="nameDescription"> |
|
<div class="fixedFont">KEYUTIL.<b><a href="../symbols/KEYUTIL.html#.getRSAKeyFromPublicPKCS8Hex">getRSAKeyFromPublicPKCS8Hex</a></b>(pkcs8PubHex) |
|
</div> |
|
<div class="description">(DEPRECATED) provide hexadecimal string of unencrypted PKCS#8 private key and returns RSAKey object</div> |
|
</td> |
|
</tr> |
|
|
|
<tr> |
|
<td class="attributes"><static> </td> |
|
<td class="nameDescription"> |
|
<div class="fixedFont">KEYUTIL.<b><a href="../symbols/KEYUTIL.html#.getRSAKeyFromPublicPKCS8PEM">getRSAKeyFromPublicPKCS8PEM</a></b>(pkcs8PubPEM) |
|
</div> |
|
<div class="description">(DEPRECATED) read PEM formatted PKCS#8 public key and returns RSAKey object</div> |
|
</td> |
|
</tr> |
|
|
|
<tr> |
|
<td class="attributes"><static> </td> |
|
<td class="nameDescription"> |
|
<div class="fixedFont">KEYUTIL.<b><a href="../symbols/KEYUTIL.html#.newEncryptedPKCS5PEM">newEncryptedPKCS5PEM</a></b>(passcode, keyLen, hPublicExponent, alg) |
|
</div> |
|
<div class="description">generate RSAKey and PEM formatted encrypted PKCS#5 private key</div> |
|
</td> |
|
</tr> |
|
|
|
<tr> |
|
<td class="attributes"><static> </td> |
|
<td class="nameDescription"> |
|
<div class="fixedFont">KEYUTIL.<b><a href="../symbols/KEYUTIL.html#.parseCSRHex">parseCSRHex</a></b>(csrHex) |
|
</div> |
|
<div class="description">parse hexadecimal string of PKCS#10 CSR (certificate signing request) |
|
Resulted associative array has following properties: |
|
<ul> |
|
<li>p8pubkeyhex - hexadecimal string of subject public key in PKCS#8</li> |
|
</ul></div> |
|
</td> |
|
</tr> |
|
|
|
<tr> |
|
<td class="attributes"><static> </td> |
|
<td class="nameDescription"> |
|
<div class="fixedFont">KEYUTIL.<b><a href="../symbols/KEYUTIL.html#.parseHexOfEncryptedPKCS8">parseHexOfEncryptedPKCS8</a></b>(passcode) |
|
</div> |
|
<div class="description">generate PBKDF2 key hexstring with specified passcode and information |
|
The associative array which is returned by this method has following properties: |
|
<ul> |
|
<li>info.pbkdf2Salt - hexadecimal string of PBKDF2 salt</li> |
|
<li>info.pkbdf2Iter - iteration count</li> |
|
<li>info.ciphertext - hexadecimal string of encrypted private key</li> |
|
<li>info.encryptionSchemeAlg - encryption algorithm name (currently TripleDES only)</li> |
|
<li>info.encryptionSchemeIV - initial vector for encryption algorithm</li> |
|
</ul> |
|
Currently, this method only supports PKCS#5v2.0 with PBES2/PBDKF2 of HmacSHA1 and TripleDES.</div> |
|
</td> |
|
</tr> |
|
|
|
<tr> |
|
<td class="attributes"><static> </td> |
|
<td class="nameDescription"> |
|
<div class="fixedFont">KEYUTIL.<b><a href="../symbols/KEYUTIL.html#.parsePKCS5PEM">parsePKCS5PEM</a></b>(sEncryptedPEM) |
|
</div> |
|
<div class="description">parse PEM formatted passcode protected PKCS#5 private key |
|
Resulted hash has following attributes.</div> |
|
</td> |
|
</tr> |
|
|
|
<tr> |
|
<td class="attributes"><static> </td> |
|
<td class="nameDescription"> |
|
<div class="fixedFont">KEYUTIL.<b><a href="../symbols/KEYUTIL.html#.parsePlainPrivatePKCS8Hex">parsePlainPrivatePKCS8Hex</a></b>(pkcs8PrvHex) |
|
</div> |
|
<div class="description">parse hexadecimal string of plain PKCS#8 private key |
|
Resulted associative array has following properties: |
|
<ul> |
|
<li>algoid - hexadecimal string of OID of asymmetric key algorithm</li> |
|
<li>algparam - hexadecimal string of OID of ECC curve name or null</li> |
|
<li>keyidx - string starting index of key in pkcs8PrvHex</li> |
|
</ul></div> |
|
</td> |
|
</tr> |
|
|
|
<tr> |
|
<td class="attributes"><static> </td> |
|
<td class="nameDescription"> |
|
<div class="fixedFont">KEYUTIL.<b><a href="../symbols/KEYUTIL.html#.parsePrivateRawECKeyHexAtObj">parsePrivateRawECKeyHexAtObj</a></b>(pkcs8PrvHex) |
|
</div> |
|
<div class="description">parse hexadecimal string of ECC private key |
|
Following properties are added to associative array 'info' |
|
<ul> |
|
<li>key - hexadecimal string of ECC private key |
|
</ul></div> |
|
</td> |
|
</tr> |
|
|
|
<tr> |
|
<td class="attributes"><static> </td> |
|
<td class="nameDescription"> |
|
<div class="fixedFont">KEYUTIL.<b><a href="../symbols/KEYUTIL.html#.parsePrivateRawRSAKeyHexAtObj">parsePrivateRawRSAKeyHexAtObj</a></b>(pkcs8PrvHex) |
|
</div> |
|
<div class="description">parse hexadecimal string of RSA private key |
|
Following properties are added to associative array 'info' |
|
<ul> |
|
<li>n - hexadecimal string of public key |
|
<li>e - hexadecimal string of public exponent |
|
<li>d - hexadecimal string of private key |
|
<li>p - hexadecimal string |
|
<li>q - hexadecimal string |
|
<li>dp - hexadecimal string |
|
<li>dq - hexadecimal string |
|
<li>co - hexadecimal string |
|
</ul></div> |
|
</td> |
|
</tr> |
|
|
|
<tr> |
|
<td class="attributes"><static> </td> |
|
<td class="nameDescription"> |
|
<div class="fixedFont">KEYUTIL.<b><a href="../symbols/KEYUTIL.html#.parsePublicPKCS8Hex">parsePublicPKCS8Hex</a></b>(pkcs8PubHex) |
|
</div> |
|
<div class="description">parse hexadecimal string of PKCS#8 RSA/EC/DSA public key |
|
Resulted hash has following attributes.</div> |
|
</td> |
|
</tr> |
|
|
|
<tr> |
|
<td class="attributes"><static> </td> |
|
<td class="nameDescription"> |
|
<div class="fixedFont">KEYUTIL.<b><a href="../symbols/KEYUTIL.html#.parsePublicRawRSAKeyHex">parsePublicRawRSAKeyHex</a></b>(pubRawRSAHex) |
|
</div> |
|
<div class="description">parse hexadecimal string of plain PKCS#8 private key |
|
Resulted associative array has following properties: |
|
<ul> |
|
<li>n - hexadecimal string of public key |
|
<li>e - hexadecimal string of public exponent |
|
</ul></div> |
|
</td> |
|
</tr> |
|
|
|
</tbody> |
|
</table> |
|
|
|
|
|
|
|
|
|
<!-- ============================== events summary ======================== --> |
|
|
|
|
|
<!-- ============================== constructor details ==================== --> |
|
|
|
<div class="details"><a name="constructor"> </a> |
|
<div class="sectionTitle"> |
|
Class Detail |
|
</div> |
|
|
|
<div class="fixedFont"> |
|
<b>KEYUTIL</b>() |
|
</div> |
|
|
|
<div class="description"> |
|
<br/> |
|
<a href="../symbols/KEYUTIL.html">KEYUTIL</a> class is an update of former <a href="../symbols/PKCS5PKEY.html">PKCS5PKEY</a> class. |
|
So for now, <a href="../symbols/PKCS5PKEY.html">PKCS5PKEY</a> is deprecated class. |
|
<a href="../symbols/KEYUTIL.html">KEYUTIL</a> class has following features: |
|
<dl> |
|
<dt><b>key loading - <a href="../symbols/KEYUTIL.html#.getKey">KEYUTIL.getKey</a></b> |
|
<dd> |
|
<ul> |
|
<li>supports RSAKey and KJUR.crypto.{ECDSA,DSA} key object</li> |
|
<li>supports private key and public key</li> |
|
<li>supports encrypted and plain private key</li> |
|
<li>supports PKCS#1, PKCS#5 and PKCS#8 key</li> |
|
<li>supports public key in X.509 certificate</li> |
|
<li>key represented by JSON object</li> |
|
</ul> |
|
NOTE1: Encrypted PKCS#8 only supports PBKDF2/HmacSHA1/3DES <br/> |
|
NOTE2: Encrypted PKCS#5 supports DES-CBC, DES-EDE3-CBC, AES-{128,192.256}-CBC <br/> |
|
|
|
<dt><b>exporting key - <a href="../symbols/KEYUTIL.html#.getPEM">KEYUTIL.getPEM</a></b> |
|
<dd> |
|
<a href="../symbols/KEYUTIL.html#.getPEM">KEYUTIL.getPEM</a> method supports following formats: |
|
<ul> |
|
<li>supports RSA/EC/DSA keys</li> |
|
<li>PKCS#1 plain RSA/EC/DSA private key</li> |
|
<li>PKCS#5 encrypted RSA/EC/DSA private key with DES-CBC, DES-EDE3-CBC, AES-{128,192.256}-CBC</li> |
|
<li>PKCS#8 plain RSA/EC/DSA private key</li> |
|
<li>PKCS#8 encrypted RSA/EC/DSA private key with PBKDF2_HmacSHA1_3DES</li> |
|
</ul> |
|
|
|
<dt><b>keypair generation - <a href="../symbols/KEYUTIL.html#.generateKeypair">KEYUTIL.generateKeypair</a></b> |
|
<ul> |
|
<li>generate key pair of <a href="../symbols/RSAKey.html">RSAKey</a> or <a href="../symbols/KJUR.crypto.ECDSA.html">KJUR.crypto.ECDSA</a>.</li> |
|
<li>generate private key and convert it to PKCS#5 encrypted private key.</li> |
|
</ul> |
|
NOTE: <a href="../symbols/KJUR.crypto.DSA.html">KJUR.crypto.DSA</a> is not yet supported. |
|
</dl> |
|
|
|
</div> |
|
|
|
|
|
|
|
<pre class="code">// 1. loading PEM private key |
|
var key = KEYUTIL.getKey(pemPKCS1PrivateKey); |
|
var key = KEYUTIL.getKey(pemPKCS5EncryptedPrivateKey, "passcode"); |
|
var key = KEYUTIL.getKey(pemPKC85PlainPrivateKey); |
|
var key = KEYUTIL.getKey(pemPKC85EncryptedPrivateKey, "passcode"); |
|
// 2. loading PEM public key |
|
var key = KEYUTIL.getKey(pemPKCS8PublicKey); |
|
var key = KEYUTIL.getKey(pemX509Certificate); |
|
// 3. exporting private key |
|
var pem = KEYUTIL.getPEM(privateKeyObj, "PKCS1PRV"); |
|
var pem = KEYUTIL.getPEM(privateKeyObj, "PKCS5PRV", "passcode"); // DES-EDE3-CBC by default |
|
var pem = KEYUTIL.getPEM(privateKeyObj, "PKCS5PRV", "passcode", "DES-CBC"); |
|
var pem = KEYUTIL.getPEM(privateKeyObj, "PKCS8PRV"); |
|
var pem = KEYUTIL.getPEM(privateKeyObj, "PKCS8PRV", "passcode"); |
|
// 4. exporting public key |
|
var pem = KEYUTIL.getPEM(publicKeyObj);</pre> |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</div> |
|
|
|
|
|
<!-- ============================== field details ========================== --> |
|
|
|
<div class="sectionTitle"> |
|
Field Detail |
|
</div> |
|
|
|
<a name=".version"> </a> |
|
<div class="fixedFont"><static> |
|
|
|
|
|
<span class="light">KEYUTIL.</span><b>version</b> |
|
|
|
</div> |
|
<div class="description"> |
|
decrypt private key by shared key |
|
version string of KEYUTIL class |
|
|
|
|
|
</div> |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ============================== method details ========================= --> |
|
|
|
<div class="sectionTitle"> |
|
Method Detail |
|
</div> |
|
|
|
<a name=".generateKeypair"> </a> |
|
<div class="fixedFont"><static> |
|
|
|
<span class="light">{Array}</span> |
|
<span class="light">KEYUTIL.</span><b>generateKeypair</b>(alg, keylenOrCurve) |
|
|
|
</div> |
|
<div class="description"> |
|
This method generates a key pair of public key algorithm. |
|
The result will be an associative array which has following |
|
parameters: |
|
<ul> |
|
<li>prvKeyObj - RSAKey or ECDSA object of private key</li> |
|
<li>pubKeyObj - RSAKey or ECDSA object of public key</li> |
|
</ul> |
|
NOTE1: As for RSA algoirthm, public exponent has fixed |
|
value '0x10001'. |
|
NOTE2: As for EC algorithm, supported names of curve are |
|
secp256r1, secp256k1 and secp384r1. |
|
NOTE3: DSA is not supported yet. |
|
|
|
|
|
</div> |
|
|
|
|
|
|
|
<pre class="code">var rsaKeypair = KEYUTIL.generateKeypair("RSA", 1024); |
|
var ecKeypair = KEYUTIL.generateKeypair("EC", "secp256r1");</pre> |
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Parameters:</dt> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>alg</b> |
|
|
|
</dt> |
|
<dd>'RSA' or 'EC'</dd> |
|
|
|
<dt> |
|
<span class="light fixedFont">{Object}</span> <b>keylenOrCurve</b> |
|
|
|
</dt> |
|
<dd>key length for RSA or curve name for EC</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Since:</dt> |
|
<dd>keyutil 1.0.1</dd> |
|
</dl> |
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Returns:</dt> |
|
|
|
<dd><span class="light fixedFont">{Array}</span> associative array of keypair which has prvKeyObj and pubKeyObj parameters</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
|
|
<hr /> |
|
|
|
<a name=".getDecryptedKeyHex"> </a> |
|
<div class="fixedFont"><static> |
|
|
|
<span class="light">{String}</span> |
|
<span class="light">KEYUTIL.</span><b>getDecryptedKeyHex</b>(sEncryptedPEM, passcode) |
|
|
|
</div> |
|
<div class="description"> |
|
decrypt PEM formatted protected PKCS#5 private key with passcode |
|
|
|
|
|
</div> |
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Parameters:</dt> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>sEncryptedPEM</b> |
|
|
|
</dt> |
|
<dd>PEM formatted protected passcode protected PKCS#5 private key</dd> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>passcode</b> |
|
|
|
</dt> |
|
<dd>passcode to decrypt private key (ex. 'password')</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Returns:</dt> |
|
|
|
<dd><span class="light fixedFont">{String}</span> hexadecimal string of decrypted RSA priavte key</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
|
|
<hr /> |
|
|
|
<a name=".getDecryptedKeyHexByKeyIV"> </a> |
|
<div class="fixedFont"><static> |
|
|
|
<span class="light">{String}</span> |
|
<span class="light">KEYUTIL.</span><b>getDecryptedKeyHexByKeyIV</b>(encryptedKeyHex, algName, sharedKeyHex, ivHex) |
|
|
|
</div> |
|
<div class="description"> |
|
decrypt private key by shared key |
|
|
|
|
|
</div> |
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Parameters:</dt> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>encryptedKeyHex</b> |
|
|
|
</dt> |
|
<dd>hexadecimal string of encrypted private key</dd> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>algName</b> |
|
|
|
</dt> |
|
<dd>name of symmetric key algorithm (ex. 'DES-EBE3-CBC')</dd> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>sharedKeyHex</b> |
|
|
|
</dt> |
|
<dd>hexadecimal string of symmetric key</dd> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>ivHex</b> |
|
|
|
</dt> |
|
<dd>hexadecimal string of initial vector(IV).</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Returns:</dt> |
|
|
|
<dd><span class="light fixedFont">{String}</span> hexadecimal string of decrypted privated key</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
|
|
<hr /> |
|
|
|
<a name=".getEncryptedPKCS5PEMFromRSAKey"> </a> |
|
<div class="fixedFont"><static> |
|
|
|
<span class="light">{String}</span> |
|
<span class="light">KEYUTIL.</span><b>getEncryptedPKCS5PEMFromRSAKey</b>(pKey, passcode, alg, ivsaltHex) |
|
|
|
</div> |
|
<div class="description"> |
|
(DEPRECATED) get PEM formatted encrypted PKCS#5 private key from RSAKey object of private key |
|
<br/> |
|
generate PEM formatted encrypted PKCS#5 private key by |
|
<a href="../symbols/RSAKey.html">RSAKey</a> object of RSA private key and passcode. |
|
Following argument can be omitted. |
|
<ul> |
|
<li>alg - AES-256-CBC will be used if omitted.</li> |
|
<li>ivsaltHex - automatically generate IV and salt which length depends on algorithm</li> |
|
</ul> |
|
|
|
|
|
</div> |
|
|
|
|
|
|
|
<pre class="code">var pkey = new RSAKey(); |
|
pkey.generate(1024, '10001'); // generate 1024bit RSA private key with public exponent 'x010001' |
|
var pem = KEYUTIL.getEncryptedPKCS5PEMFromRSAKey(pkey, "password");</pre> |
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Parameters:</dt> |
|
|
|
<dt> |
|
<span class="light fixedFont">{<a href="../symbols/RSAKey.html">RSAKey</a>}</span> <b>pKey</b> |
|
|
|
</dt> |
|
<dd>RSAKey object of private key</dd> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>passcode</b> |
|
|
|
</dt> |
|
<dd>pass code to protect private key (ex. password)</dd> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>alg</b> |
|
|
|
</dt> |
|
<dd>algorithm name to protect private key (default AES-256-CBC)</dd> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>ivsaltHex</b> |
|
|
|
</dt> |
|
<dd>hexadecimal string of IV and salt (default generated random IV)</dd> |
|
|
|
</dl> |
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Deprecated:</dt> |
|
<dt> |
|
From jsrsasign 4.2.1 please use KEYUTIL.getPEM#. |
|
</dt> |
|
</dl> |
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Since:</dt> |
|
<dd>pkcs5pkey 1.0.2</dd> |
|
</dl> |
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Returns:</dt> |
|
|
|
<dd><span class="light fixedFont">{String}</span> string of PEM formatted encrypted PKCS#5 private key</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
|
|
<hr /> |
|
|
|
<a name=".getHexFromPEM"> </a> |
|
<div class="fixedFont"><static> |
|
|
|
<span class="light">{String}</span> |
|
<span class="light">KEYUTIL.</span><b>getHexFromPEM</b>(sPEM, sHead) |
|
|
|
</div> |
|
<div class="description"> |
|
get hexacedimal string of PEM format |
|
|
|
|
|
</div> |
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Parameters:</dt> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>sPEM</b> |
|
|
|
</dt> |
|
<dd>PEM formatted string</dd> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>sHead</b> |
|
|
|
</dt> |
|
<dd>PEM header string without BEGIN/END</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Since:</dt> |
|
<dd>pkcs5pkey 1.0.5</dd> |
|
</dl> |
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Returns:</dt> |
|
|
|
<dd><span class="light fixedFont">{String}</span> hexadecimal string data of PEM contents</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
|
|
<hr /> |
|
|
|
<a name=".getKey"> </a> |
|
<div class="fixedFont"><static> |
|
|
|
<span class="light">{Object}</span> |
|
<span class="light">KEYUTIL.</span><b>getKey</b>(param, passcode, hextype) |
|
|
|
</div> |
|
<div class="description"> |
|
get private or public key object from any arguments |
|
This method gets private or public key object(<a href="../symbols/RSAKey.html">RSAKey</a>, <a href="../symbols/KJUR.crypto.DSA.html">KJUR.crypto.DSA</a> or <a href="../symbols/KJUR.crypto.ECDSA.html">KJUR.crypto.ECDSA</a>) |
|
for RSA, DSA and ECC. |
|
Arguments for this methods depends on a key format you specify. |
|
Following key representations are supported. |
|
<ul> |
|
<li>ECC private/public key object(as is): param=KJUR.crypto.ECDSA</li> |
|
<li>DSA private/public key object(as is): param=KJUR.crypto.DSA</li> |
|
<li>RSA private/public key object(as is): param=RSAKey </li> |
|
<li>ECC private key parameters: param={d: d, curve: curveName}</li> |
|
<li>RSA private key parameters: param={n: n, e: e, d: d, p: p, q: q, dp: dp, dq: dq, co: co}<br/> |
|
NOTE: Each value shall be hexadecimal string of key spec.</li> |
|
<li>DSA private key parameters: param={p: p, q: q, g: g, y: y, x: x}<br/> |
|
NOTE: Each value shall be hexadecimal string of key spec.</li> |
|
<li>ECC public key parameters: param={xy: xy, curve: curveName}<br/> |
|
NOTE: ECC public key 'xy' shall be concatination of "04", x-bytes-hex and y-bytes-hex.</li> |
|
<li>DSA public key parameters: param={p: p, q: q, g: g, y: y}<br/> |
|
NOTE: Each value shall be hexadecimal string of key spec.</li> |
|
<li>RSA public key parameters: param={n: n, e: e} </li> |
|
<li>X.509v1/v3 PEM certificate (RSA/DSA/ECC): param=pemString</li> |
|
<li>PKCS#8 hexadecimal RSA/ECC public key: param=pemString, null, "pkcs8pub"</li> |
|
<li>PKCS#8 PEM RSA/DSA/ECC public key: param=pemString</li> |
|
<li>PKCS#5 plain hexadecimal RSA private key: param=hexString, null, "pkcs5prv"</li> |
|
<li>PKCS#5 plain PEM DSA/RSA private key: param=pemString</li> |
|
<li>PKCS#8 plain PEM RSA/ECDSA private key: param=pemString</li> |
|
<li>PKCS#5 encrypted PEM RSA/DSA private key: param=pemString, passcode</li> |
|
<li>PKCS#8 encrypted PEM RSA/ECDSA private key: param=pemString, passcode</li> |
|
</ul> |
|
Please note following limitation on encrypted keys: |
|
<ul> |
|
<li>Encrypted PKCS#8 only supports PBKDF2/HmacSHA1/3DES</li> |
|
<li>Encrypted PKCS#5 supports DES-CBC, DES-EDE3-CBC, AES-{128,192.256}-CBC</li> |
|
<li>JWT plain ECC private/public key</li> |
|
<li>JWT plain RSA public key</li> |
|
<li>JWT plain RSA private key with P/Q/DP/DQ/COEFF</li> |
|
<li>JWT plain RSA private key without P/Q/DP/DQ/COEFF (since jsrsasign 5.0.0)</li> |
|
</ul> |
|
NOTE1: <a href="https://tools.ietf.org/html/rfc7517">RFC 7517 JSON Web Key(JWK)</a> support for RSA/ECC private/public key from jsrsasign 4.8.1.<br/> |
|
NOTE2: X509v1 support is added since jsrsasign 5.0.11. |
|
|
|
<h5>EXAMPLE</h5> |
|
|
|
|
|
</div> |
|
|
|
|
|
|
|
<pre class="code">// 1. loading private key from PEM string |
|
keyObj = KEYUTIL.getKey("-----BEGIN RSA PRIVATE KEY..."); |
|
keyObj = KEYUTIL.getKey("-----BEGIN RSA PRIVATE KEY..., "passcode"); |
|
keyObj = KEYUTIL.getKey("-----BEGIN PRIVATE KEY..."); |
|
keyObj = KEYUTIL.getKey("-----BEGIN PRIVATE KEY...", "passcode"); |
|
// 2. loading public key from PEM string |
|
keyObj = KEYUTIL.getKey("-----BEGIN PUBLIC KEY..."); |
|
keyObj = KEYUTIL.getKey("-----BEGIN X509 CERTIFICATE..."); |
|
// 3. loading hexadecimal PKCS#5/PKCS#8 key |
|
keyObj = KEYUTIL.getKey("308205c1...", null, "pkcs8pub"); |
|
keyObj = KEYUTIL.getKey("3082048b...", null, "pkcs5prv"); |
|
// 4. loading JSON Web Key(JWK) |
|
keyObj = KEYUTIL.getKey({kty: "RSA", n: "0vx7...", e: "AQAB"}); |
|
keyObj = KEYUTIL.getKey({kty: "EC", crv: "P-256", |
|
x: "MKBC...", y: "4Etl6...", d: "870Mb..."}); |
|
// 5. bare hexadecimal key |
|
keyObj = KEYUTIL.getKey({n: "75ab..", e: "010001"});</pre> |
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Parameters:</dt> |
|
|
|
<dt> |
|
<span class="light fixedFont">{Object}</span> <b>param</b> |
|
|
|
</dt> |
|
<dd>parameter to get key object. see description in detail.</dd> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>passcode</b> |
|
|
|
</dt> |
|
<dd>(OPTION) parameter to get key object. see description in detail.</dd> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>hextype</b> |
|
|
|
</dt> |
|
<dd>(OPTOIN) parameter to get key object. see description in detail.</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Since:</dt> |
|
<dd>keyutil 1.0.0</dd> |
|
</dl> |
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Returns:</dt> |
|
|
|
<dd><span class="light fixedFont">{Object}</span> <a href="../symbols/RSAKey.html">RSAKey</a>, <a href="../symbols/KJUR.crypto.ECDSA.html">KJUR.crypto.ECDSA</a> or <a href="../symbols/KJUR.crypto.ECDSA.html">KJUR.crypto.ECDSA</a> object</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
|
|
<hr /> |
|
|
|
<a name=".getKeyAndUnusedIvByPasscodeAndIvsalt"> </a> |
|
<div class="fixedFont"><static> |
|
|
|
<span class="light">{Hash}</span> |
|
<span class="light">KEYUTIL.</span><b>getKeyAndUnusedIvByPasscodeAndIvsalt</b>(algName, passcode, hexadecimal) |
|
|
|
</div> |
|
<div class="description"> |
|
the same function as OpenSSL EVP_BytsToKey to generate shared key and IV |
|
|
|
|
|
</div> |
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Parameters:</dt> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>algName</b> |
|
|
|
</dt> |
|
<dd>name of symmetric key algorithm (ex. 'DES-EBE3-CBC')</dd> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>passcode</b> |
|
|
|
</dt> |
|
<dd>passcode to decrypt private key (ex. 'password')</dd> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>hexadecimal</b> |
|
|
|
</dt> |
|
<dd>string of IV. heading 8 bytes will be used for passcode salt</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Returns:</dt> |
|
|
|
<dd><span class="light fixedFont">{Hash}</span> hash of key and unused IV (ex. {keyhex:2fe3..., ivhex:3fad..})</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
|
|
<hr /> |
|
|
|
<a name=".getKeyFromCSRHex"> </a> |
|
<div class="fixedFont"><static> |
|
|
|
<span class="light">{Object}</span> |
|
<span class="light">KEYUTIL.</span><b>getKeyFromCSRHex</b>(csrHex) |
|
|
|
</div> |
|
<div class="description"> |
|
get RSAKey/DSA/ECDSA public key object from hexadecimal string of PKCS#10 CSR |
|
|
|
|
|
</div> |
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Parameters:</dt> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>csrHex</b> |
|
|
|
</dt> |
|
<dd>hexadecimal string of PKCS#10 CSR</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Since:</dt> |
|
<dd>keyutil 1.0.5</dd> |
|
</dl> |
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Returns:</dt> |
|
|
|
<dd><span class="light fixedFont">{Object}</span> RSAKey/DSA/ECDSA public key object</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
|
|
<hr /> |
|
|
|
<a name=".getKeyFromCSRPEM"> </a> |
|
<div class="fixedFont"><static> |
|
|
|
<span class="light">{Object}</span> |
|
<span class="light">KEYUTIL.</span><b>getKeyFromCSRPEM</b>(csrPEM) |
|
|
|
</div> |
|
<div class="description"> |
|
get RSAKey/DSA/ECDSA public key object from PEM formatted PKCS#10 CSR string |
|
|
|
|
|
</div> |
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Parameters:</dt> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>csrPEM</b> |
|
|
|
</dt> |
|
<dd>PEM formatted PKCS#10 CSR string</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Since:</dt> |
|
<dd>keyutil 1.0.5</dd> |
|
</dl> |
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Returns:</dt> |
|
|
|
<dd><span class="light fixedFont">{Object}</span> RSAKey/DSA/ECDSA public key object</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
|
|
<hr /> |
|
|
|
<a name=".getKeyFromEncryptedPKCS8PEM"> </a> |
|
<div class="fixedFont"><static> |
|
|
|
<span class="light">{Object}</span> |
|
<span class="light">KEYUTIL.</span><b>getKeyFromEncryptedPKCS8PEM</b>(pkcs8PEM, passcode) |
|
|
|
</div> |
|
<div class="description"> |
|
get RSAKey/ECDSA private key object from encrypted PEM PKCS#8 private key |
|
|
|
|
|
</div> |
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Parameters:</dt> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>pkcs8PEM</b> |
|
|
|
</dt> |
|
<dd>string of PEM formatted PKCS#8 private key</dd> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>passcode</b> |
|
|
|
</dt> |
|
<dd>passcode string to decrypt key</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Since:</dt> |
|
<dd>pkcs5pkey 1.0.5</dd> |
|
</dl> |
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Returns:</dt> |
|
|
|
<dd><span class="light fixedFont">{Object}</span> RSAKey or KJUR.crypto.ECDSA private key object</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
|
|
<hr /> |
|
|
|
<a name=".getKeyFromPlainPrivatePKCS8Hex"> </a> |
|
<div class="fixedFont"><static> |
|
|
|
<span class="light">{Object}</span> |
|
<span class="light">KEYUTIL.</span><b>getKeyFromPlainPrivatePKCS8Hex</b>(prvKeyHex) |
|
|
|
</div> |
|
<div class="description"> |
|
get RSAKey/ECDSA private key object from HEX plain PEM PKCS#8 private key |
|
|
|
|
|
</div> |
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Parameters:</dt> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>prvKeyHex</b> |
|
|
|
</dt> |
|
<dd>hexadecimal string of plain PKCS#8 private key</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Since:</dt> |
|
<dd>pkcs5pkey 1.0.5</dd> |
|
</dl> |
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Returns:</dt> |
|
|
|
<dd><span class="light fixedFont">{Object}</span> RSAKey or KJUR.crypto.ECDSA private key object</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
|
|
<hr /> |
|
|
|
<a name=".getKeyFromPlainPrivatePKCS8PEM"> </a> |
|
<div class="fixedFont"><static> |
|
|
|
<span class="light">{Object}</span> |
|
<span class="light">KEYUTIL.</span><b>getKeyFromPlainPrivatePKCS8PEM</b>(pkcs8PEM) |
|
|
|
</div> |
|
<div class="description"> |
|
get RSAKey/ECDSA private key object from PEM plain PEM PKCS#8 private key |
|
|
|
|
|
</div> |
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Parameters:</dt> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>pkcs8PEM</b> |
|
|
|
</dt> |
|
<dd>string of plain PEM formatted PKCS#8 private key</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Since:</dt> |
|
<dd>pkcs5pkey 1.0.5</dd> |
|
</dl> |
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Returns:</dt> |
|
|
|
<dd><span class="light fixedFont">{Object}</span> RSAKey or KJUR.crypto.ECDSA private key object</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
|
|
<hr /> |
|
|
|
<a name=".getKeyFromPublicPKCS8Hex"> </a> |
|
<div class="fixedFont"><static> |
|
|
|
<span class="light">{Object}</span> |
|
<span class="light">KEYUTIL.</span><b>getKeyFromPublicPKCS8Hex</b>(pkcsPub8Hex) |
|
|
|
</div> |
|
<div class="description"> |
|
(DEPRECATED) get RSAKey/DSA/ECDSA public key object from hexadecimal string of PKCS#8 public key |
|
|
|
|
|
</div> |
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Parameters:</dt> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>pkcsPub8Hex</b> |
|
|
|
</dt> |
|
<dd>hexadecimal string of PKCS#8 public key</dd> |
|
|
|
</dl> |
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Deprecated:</dt> |
|
<dt> |
|
From jsrsasign 4.2.1 please use KEYUTIL.getKey#. |
|
</dt> |
|
</dl> |
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Since:</dt> |
|
<dd>pkcs5pkey 1.0.5</dd> |
|
</dl> |
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Returns:</dt> |
|
|
|
<dd><span class="light fixedFont">{Object}</span> RSAKey or KJUR.crypto.{ECDSA,DSA} private key object</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
|
|
<hr /> |
|
|
|
<a name=".getKeyFromPublicPKCS8PEM"> </a> |
|
<div class="fixedFont"><static> |
|
|
|
<span class="light">{Object}</span> |
|
<span class="light">KEYUTIL.</span><b>getKeyFromPublicPKCS8PEM</b>(pkcsPub8PEM) |
|
|
|
</div> |
|
<div class="description"> |
|
(DEPRECATED) get RSAKey/ECDSA public key object from PEM PKCS#8 public key |
|
|
|
|
|
</div> |
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Parameters:</dt> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>pkcsPub8PEM</b> |
|
|
|
</dt> |
|
<dd>string of PEM formatted PKCS#8 public key</dd> |
|
|
|
</dl> |
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Deprecated:</dt> |
|
<dt> |
|
From jsrsasign 4.2.1 please use KEYUTIL.getKey#. |
|
</dt> |
|
</dl> |
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Since:</dt> |
|
<dd>pkcs5pkey 1.0.5</dd> |
|
</dl> |
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Returns:</dt> |
|
|
|
<dd><span class="light fixedFont">{Object}</span> RSAKey or KJUR.crypto.ECDSA private key object</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
|
|
<hr /> |
|
|
|
<a name=".getPBKDF2KeyHexFromParam"> </a> |
|
<div class="fixedFont"><static> |
|
|
|
<span class="light">{String}</span> |
|
<span class="light">KEYUTIL.</span><b>getPBKDF2KeyHexFromParam</b>(info, passcode) |
|
|
|
</div> |
|
<div class="description"> |
|
generate PBKDF2 key hexstring with specified passcode and information |
|
As for info, this uses following properties: |
|
<ul> |
|
<li>info.pbkdf2Salt - hexadecimal string of PBKDF2 salt</li> |
|
<li>info.pkbdf2Iter - iteration count</li> |
|
</ul> |
|
Currently, this method only supports PKCS#5v2.0 with PBES2/PBDKF2 of HmacSHA1 and TripleDES. |
|
<ul> |
|
<li>keyDerivationFunc = pkcs5PBKDF2 with HmacSHA1</li> |
|
<li>encryptionScheme = des-EDE3-CBC(i.e. TripleDES</li> |
|
</ul> |
|
|
|
|
|
</div> |
|
|
|
|
|
|
|
<pre class="code">// to convert plain PKCS#5 private key to encrypted PKCS#8 private |
|
// key with PBKDF2 with TripleDES |
|
% openssl pkcs8 -in plain_p5.pem -topk8 -v2 -des3 -out encrypted_p8.pem</pre> |
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Parameters:</dt> |
|
|
|
<dt> |
|
<span class="light fixedFont">{Array}</span> <b>info</b> |
|
|
|
</dt> |
|
<dd>result of parseHexOfEncryptedPKCS8 which has preference of PKCS#8 file</dd> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>passcode</b> |
|
|
|
</dt> |
|
<dd>passcode to decrypto private key</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Since:</dt> |
|
<dd>pkcs5pkey 1.0.3</dd> |
|
</dl> |
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Returns:</dt> |
|
|
|
<dd><span class="light fixedFont">{String}</span> hexadecimal string of PBKDF2 key</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
|
|
<hr /> |
|
|
|
<a name=".getPEM"> </a> |
|
<div class="fixedFont"><static> |
|
|
|
|
|
<span class="light">KEYUTIL.</span><b>getPEM</b>(keyObjOrHex, formatType, passwd, encAlg) |
|
|
|
</div> |
|
<div class="description"> |
|
get PEM formatted private or public key file from a RSA/ECDSA/DSA key object |
|
<dl> |
|
<dt><b>NOTE1:</b> |
|
<dd> |
|
PKCS#5 encrypted private key protection algorithm supports DES-CBC, |
|
DES-EDE3-CBC and AES-{128,192,256}-CBC |
|
<dt><b>NOTE2:</b> |
|
<dd> |
|
OpenSSL supports |
|
</dl> |
|
|
|
|
|
</div> |
|
|
|
|
|
|
|
<pre class="code">KEUUTIL.getPEM(publicKey) => generates PEM PKCS#8 public key |
|
KEUUTIL.getPEM(privateKey, "PKCS1PRV") => generates PEM PKCS#1 plain private key |
|
KEUUTIL.getPEM(privateKey, "PKCS5PRV", "pass") => generates PEM PKCS#5 encrypted private key |
|
with DES-EDE3-CBC (DEFAULT) |
|
KEUUTIL.getPEM(privateKey, "PKCS5PRV", "pass", "DES-CBC") => generates PEM PKCS#5 encrypted |
|
private key with DES-CBC |
|
KEUUTIL.getPEM(privateKey, "PKCS8PRV") => generates PEM PKCS#8 plain private key |
|
KEUUTIL.getPEM(privateKey, "PKCS8PRV", "pass") => generates PEM PKCS#8 encrypted private key |
|
with PBKDF2_HmacSHA1_3DES</pre> |
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Parameters:</dt> |
|
|
|
<dt> |
|
<span class="light fixedFont">{Object}</span> <b>keyObjOrHex</b> |
|
|
|
</dt> |
|
<dd>key object <a href="../symbols/RSAKey.html">RSAKey</a>, <a href="../symbols/KJUR.crypto.ECDSA.html">KJUR.crypto.ECDSA</a> or <a href="../symbols/KJUR.crypto.DSA.html">KJUR.crypto.DSA</a> to encode to</dd> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>formatType</b> |
|
|
|
</dt> |
|
<dd>(OPTION) output format type of "PKCS1PRV", "PKCS5PRV" or "PKCS8PRV" for private key</dd> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>passwd</b> |
|
|
|
</dt> |
|
<dd>(OPTION) password to protect private key</dd> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>encAlg</b> |
|
|
|
</dt> |
|
<dd>(OPTION) encryption algorithm for PKCS#5. currently supports DES-CBC, DES-EDE3-CBC and AES-{128,192,256}-CBC</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Since:</dt> |
|
<dd>keyutil 1.0.4</dd> |
|
</dl> |
|
</dl> |
|
|
|
|
|
|
|
|
|
|
|
|
|
<hr /> |
|
|
|
<a name=".getPlainPKCS8HexFromEncryptedPKCS8PEM"> </a> |
|
<div class="fixedFont"><static> |
|
|
|
<span class="light">{String}</span> |
|
<span class="light">KEYUTIL.</span><b>getPlainPKCS8HexFromEncryptedPKCS8PEM</b>(pkcs8PEM, passcode) |
|
|
|
</div> |
|
<div class="description"> |
|
read PEM formatted encrypted PKCS#8 private key and returns hexadecimal string of plain PKCS#8 private key |
|
Currently, this method only supports PKCS#5v2.0 with PBES2/PBDKF2 of HmacSHA1 and TripleDES. |
|
<ul> |
|
<li>keyDerivationFunc = pkcs5PBKDF2 with HmacSHA1</li> |
|
<li>encryptionScheme = des-EDE3-CBC(i.e. TripleDES</li> |
|
</ul> |
|
|
|
|
|
</div> |
|
|
|
|
|
|
|
<pre class="code">// to convert plain PKCS#5 private key to encrypted PKCS#8 private |
|
// key with PBKDF2 with TripleDES |
|
% openssl pkcs8 -in plain_p5.pem -topk8 -v2 -des3 -out encrypted_p8.pem</pre> |
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Parameters:</dt> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>pkcs8PEM</b> |
|
|
|
</dt> |
|
<dd>PEM formatted encrypted PKCS#8 private key</dd> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>passcode</b> |
|
|
|
</dt> |
|
<dd>passcode to decrypto private key</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Since:</dt> |
|
<dd>pkcs5pkey 1.0.3</dd> |
|
</dl> |
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Returns:</dt> |
|
|
|
<dd><span class="light fixedFont">{String}</span> hexadecimal string of plain PKCS#8 private key</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
|
|
<hr /> |
|
|
|
<a name=".getRSAKeyFromEncryptedPKCS5PEM"> </a> |
|
<div class="fixedFont"><static> |
|
|
|
<span class="light">{<a href="../symbols/RSAKey.html">RSAKey</a>}</span> |
|
<span class="light">KEYUTIL.</span><b>getRSAKeyFromEncryptedPKCS5PEM</b>(sEncryptedP5PEM, passcode) |
|
|
|
</div> |
|
<div class="description"> |
|
(DEPRECATED) read PEM formatted encrypted PKCS#5 private key and returns RSAKey object |
|
|
|
|
|
</div> |
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Parameters:</dt> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>sEncryptedP5PEM</b> |
|
|
|
</dt> |
|
<dd>PEM formatted encrypted PKCS#5 private key</dd> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>passcode</b> |
|
|
|
</dt> |
|
<dd>passcode to decrypt private key</dd> |
|
|
|
</dl> |
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Deprecated:</dt> |
|
<dt> |
|
From jsrsasign 4.2.1 please use KEYUTIL.getKey#. |
|
</dt> |
|
</dl> |
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Since:</dt> |
|
<dd>pkcs5pkey 1.0.2</dd> |
|
</dl> |
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Returns:</dt> |
|
|
|
<dd><span class="light fixedFont">{<a href="../symbols/RSAKey.html">RSAKey</a>}</span> loaded RSAKey object of RSA private key</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
|
|
<hr /> |
|
|
|
<a name=".getRSAKeyFromEncryptedPKCS8PEM"> </a> |
|
<div class="fixedFont"><static> |
|
|
|
<span class="light">{<a href="../symbols/RSAKey.html">RSAKey</a>}</span> |
|
<span class="light">KEYUTIL.</span><b>getRSAKeyFromEncryptedPKCS8PEM</b>(pkcs8PEM, passcode) |
|
|
|
</div> |
|
<div class="description"> |
|
(DEPRECATED) read PEM formatted encrypted PKCS#8 private key and returns RSAKey object |
|
Currently, this method only supports PKCS#5v2.0 with PBES2/PBDKF2 of HmacSHA1 and TripleDES. |
|
<ul> |
|
<li>keyDerivationFunc = pkcs5PBKDF2 with HmacSHA1</li> |
|
<li>encryptionScheme = des-EDE3-CBC(i.e. TripleDES</li> |
|
</ul> |
|
|
|
|
|
</div> |
|
|
|
|
|
|
|
<pre class="code">// to convert plain PKCS#5 private key to encrypted PKCS#8 private |
|
// key with PBKDF2 with TripleDES |
|
% openssl pkcs8 -in plain_p5.pem -topk8 -v2 -des3 -out encrypted_p8.pem</pre> |
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Parameters:</dt> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>pkcs8PEM</b> |
|
|
|
</dt> |
|
<dd>PEM formatted encrypted PKCS#8 private key</dd> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>passcode</b> |
|
|
|
</dt> |
|
<dd>passcode to decrypto private key</dd> |
|
|
|
</dl> |
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Deprecated:</dt> |
|
<dt> |
|
From jsrsasign 4.2.1 please use KEYUTIL.getKey#. |
|
</dt> |
|
</dl> |
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Since:</dt> |
|
<dd>pkcs5pkey 1.0.3</dd> |
|
</dl> |
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Returns:</dt> |
|
|
|
<dd><span class="light fixedFont">{<a href="../symbols/RSAKey.html">RSAKey</a>}</span> loaded RSAKey object of RSA private key</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
|
|
<hr /> |
|
|
|
<a name=".getRSAKeyFromPlainPKCS8Hex"> </a> |
|
<div class="fixedFont"><static> |
|
|
|
<span class="light">{<a href="../symbols/RSAKey.html">RSAKey</a>}</span> |
|
<span class="light">KEYUTIL.</span><b>getRSAKeyFromPlainPKCS8Hex</b>(prvKeyHex) |
|
|
|
</div> |
|
<div class="description"> |
|
(DEPRECATED) provide hexadecimal string of unencrypted PKCS#8 private key and returns RSAKey object |
|
|
|
|
|
</div> |
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Parameters:</dt> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>prvKeyHex</b> |
|
|
|
</dt> |
|
<dd>hexadecimal string of unencrypted PKCS#8 private key</dd> |
|
|
|
</dl> |
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Deprecated:</dt> |
|
<dt> |
|
From jsrsasign 4.2.1 please use KEYUTIL.getKey#. |
|
</dt> |
|
</dl> |
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Since:</dt> |
|
<dd>pkcs5pkey 1.0.3</dd> |
|
</dl> |
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Returns:</dt> |
|
|
|
<dd><span class="light fixedFont">{<a href="../symbols/RSAKey.html">RSAKey</a>}</span> loaded RSAKey object of RSA private key</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
|
|
<hr /> |
|
|
|
<a name=".getRSAKeyFromPlainPKCS8PEM"> </a> |
|
<div class="fixedFont"><static> |
|
|
|
<span class="light">{<a href="../symbols/RSAKey.html">RSAKey</a>}</span> |
|
<span class="light">KEYUTIL.</span><b>getRSAKeyFromPlainPKCS8PEM</b>(pkcs8PEM) |
|
|
|
</div> |
|
<div class="description"> |
|
(DEPRECATED) read PEM formatted unencrypted PKCS#8 private key and returns RSAKey object |
|
|
|
|
|
</div> |
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Parameters:</dt> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>pkcs8PEM</b> |
|
|
|
</dt> |
|
<dd>PEM formatted unencrypted PKCS#8 private key</dd> |
|
|
|
</dl> |
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Deprecated:</dt> |
|
<dt> |
|
From jsrsasign 4.2.1 please use KEYUTIL.getKey#. |
|
</dt> |
|
</dl> |
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Since:</dt> |
|
<dd>pkcs5pkey 1.0.1</dd> |
|
</dl> |
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Returns:</dt> |
|
|
|
<dd><span class="light fixedFont">{<a href="../symbols/RSAKey.html">RSAKey</a>}</span> loaded RSAKey object of RSA private key</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
|
|
<hr /> |
|
|
|
<a name=".getRSAKeyFromPublicPKCS8Hex"> </a> |
|
<div class="fixedFont"><static> |
|
|
|
<span class="light">{<a href="../symbols/RSAKey.html">RSAKey</a>}</span> |
|
<span class="light">KEYUTIL.</span><b>getRSAKeyFromPublicPKCS8Hex</b>(pkcs8PubHex) |
|
|
|
</div> |
|
<div class="description"> |
|
(DEPRECATED) provide hexadecimal string of unencrypted PKCS#8 private key and returns RSAKey object |
|
|
|
|
|
</div> |
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Parameters:</dt> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>pkcs8PubHex</b> |
|
|
|
</dt> |
|
<dd>hexadecimal string of unencrypted PKCS#8 public key</dd> |
|
|
|
</dl> |
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Deprecated:</dt> |
|
<dt> |
|
From jsrsasign 4.2.1 please use KEYUTIL.getKey#. |
|
</dt> |
|
</dl> |
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Since:</dt> |
|
<dd>pkcs5pkey 1.0.4</dd> |
|
</dl> |
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Returns:</dt> |
|
|
|
<dd><span class="light fixedFont">{<a href="../symbols/RSAKey.html">RSAKey</a>}</span> loaded RSAKey object of RSA public key</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
|
|
<hr /> |
|
|
|
<a name=".getRSAKeyFromPublicPKCS8PEM"> </a> |
|
<div class="fixedFont"><static> |
|
|
|
<span class="light">{<a href="../symbols/RSAKey.html">RSAKey</a>}</span> |
|
<span class="light">KEYUTIL.</span><b>getRSAKeyFromPublicPKCS8PEM</b>(pkcs8PubPEM) |
|
|
|
</div> |
|
<div class="description"> |
|
(DEPRECATED) read PEM formatted PKCS#8 public key and returns RSAKey object |
|
|
|
|
|
</div> |
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Parameters:</dt> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>pkcs8PubPEM</b> |
|
|
|
</dt> |
|
<dd>PEM formatted PKCS#8 public key</dd> |
|
|
|
</dl> |
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Deprecated:</dt> |
|
<dt> |
|
From jsrsasign 4.2.1 please use KEYUTIL.getKey#. |
|
</dt> |
|
</dl> |
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Since:</dt> |
|
<dd>pkcs5pkey 1.0.4</dd> |
|
</dl> |
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Returns:</dt> |
|
|
|
<dd><span class="light fixedFont">{<a href="../symbols/RSAKey.html">RSAKey</a>}</span> loaded RSAKey object of RSA public key</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
|
|
<hr /> |
|
|
|
<a name=".newEncryptedPKCS5PEM"> </a> |
|
<div class="fixedFont"><static> |
|
|
|
<span class="light">{String}</span> |
|
<span class="light">KEYUTIL.</span><b>newEncryptedPKCS5PEM</b>(passcode, keyLen, hPublicExponent, alg) |
|
|
|
</div> |
|
<div class="description"> |
|
generate RSAKey and PEM formatted encrypted PKCS#5 private key |
|
|
|
|
|
</div> |
|
|
|
|
|
|
|
<pre class="code">var pem1 = KEYUTIL.newEncryptedPKCS5PEM("password"); // RSA1024bit/10001/AES-256-CBC |
|
var pem2 = KEYUTIL.newEncryptedPKCS5PEM("password", 512); // RSA 512bit/10001/AES-256-CBC |
|
var pem3 = KEYUTIL.newEncryptedPKCS5PEM("password", 512, '3'); // RSA 512bit/ 3/AES-256-CBC</pre> |
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Parameters:</dt> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>passcode</b> |
|
|
|
</dt> |
|
<dd>pass code to protect private key (ex. password)</dd> |
|
|
|
<dt> |
|
<span class="light fixedFont">{Integer}</span> <b>keyLen</b> |
|
|
|
</dt> |
|
<dd>key bit length of RSA key to be generated. (default 1024)</dd> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>hPublicExponent</b> |
|
|
|
</dt> |
|
<dd>hexadecimal string of public exponent (default 10001)</dd> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>alg</b> |
|
|
|
</dt> |
|
<dd>shared key algorithm to encrypt private key (default AES-258-CBC)</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Since:</dt> |
|
<dd>pkcs5pkey 1.0.2</dd> |
|
</dl> |
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Returns:</dt> |
|
|
|
<dd><span class="light fixedFont">{String}</span> string of PEM formatted encrypted PKCS#5 private key</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
|
|
<hr /> |
|
|
|
<a name=".parseCSRHex"> </a> |
|
<div class="fixedFont"><static> |
|
|
|
<span class="light">{Array}</span> |
|
<span class="light">KEYUTIL.</span><b>parseCSRHex</b>(csrHex) |
|
|
|
</div> |
|
<div class="description"> |
|
parse hexadecimal string of PKCS#10 CSR (certificate signing request) |
|
Resulted associative array has following properties: |
|
<ul> |
|
<li>p8pubkeyhex - hexadecimal string of subject public key in PKCS#8</li> |
|
</ul> |
|
|
|
|
|
</div> |
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Parameters:</dt> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>csrHex</b> |
|
|
|
</dt> |
|
<dd>hexadecimal string of PKCS#10 CSR</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Since:</dt> |
|
<dd>keyutil 1.0.5</dd> |
|
</dl> |
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Returns:</dt> |
|
|
|
<dd><span class="light fixedFont">{Array}</span> associative array of parsed CSR</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
|
|
<hr /> |
|
|
|
<a name=".parseHexOfEncryptedPKCS8"> </a> |
|
<div class="fixedFont"><static> |
|
|
|
<span class="light">{Array}</span> |
|
<span class="light">KEYUTIL.</span><b>parseHexOfEncryptedPKCS8</b>(passcode) |
|
|
|
</div> |
|
<div class="description"> |
|
generate PBKDF2 key hexstring with specified passcode and information |
|
The associative array which is returned by this method has following properties: |
|
<ul> |
|
<li>info.pbkdf2Salt - hexadecimal string of PBKDF2 salt</li> |
|
<li>info.pkbdf2Iter - iteration count</li> |
|
<li>info.ciphertext - hexadecimal string of encrypted private key</li> |
|
<li>info.encryptionSchemeAlg - encryption algorithm name (currently TripleDES only)</li> |
|
<li>info.encryptionSchemeIV - initial vector for encryption algorithm</li> |
|
</ul> |
|
Currently, this method only supports PKCS#5v2.0 with PBES2/PBDKF2 of HmacSHA1 and TripleDES. |
|
<ul> |
|
<li>keyDerivationFunc = pkcs5PBKDF2 with HmacSHA1</li> |
|
<li>encryptionScheme = des-EDE3-CBC(i.e. TripleDES</li> |
|
</ul> |
|
|
|
|
|
</div> |
|
|
|
|
|
|
|
<pre class="code">// to convert plain PKCS#5 private key to encrypted PKCS#8 private |
|
// key with PBKDF2 with TripleDES |
|
% openssl pkcs8 -in plain_p5.pem -topk8 -v2 -des3 -out encrypted_p8.pem</pre> |
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Parameters:</dt> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>passcode</b> |
|
|
|
</dt> |
|
<dd>passcode to decrypto private key</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Since:</dt> |
|
<dd>pkcs5pkey 1.0.3</dd> |
|
</dl> |
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Returns:</dt> |
|
|
|
<dd><span class="light fixedFont">{Array}</span> info associative array of PKCS#8 parameters</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
|
|
<hr /> |
|
|
|
<a name=".parsePKCS5PEM"> </a> |
|
<div class="fixedFont"><static> |
|
|
|
<span class="light">{Hash}</span> |
|
<span class="light">KEYUTIL.</span><b>parsePKCS5PEM</b>(sEncryptedPEM) |
|
|
|
</div> |
|
<div class="description"> |
|
parse PEM formatted passcode protected PKCS#5 private key |
|
Resulted hash has following attributes. |
|
<ul> |
|
<li>cipher - symmetric key algorithm name (ex. 'DES-EBE3-CBC', 'AES-256-CBC')</li> |
|
<li>ivsalt - IV used for decrypt. Its heading 8 bytes will be used for passcode salt.</li> |
|
<li>type - asymmetric key algorithm name of private key described in PEM header.</li> |
|
<li>data - base64 encoded encrypted private key.</li> |
|
</ul> |
|
|
|
|
|
</div> |
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Parameters:</dt> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>sEncryptedPEM</b> |
|
|
|
</dt> |
|
<dd>PEM formatted protected passcode protected PKCS#5 private key</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Returns:</dt> |
|
|
|
<dd><span class="light fixedFont">{Hash}</span> hash of key information</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
|
|
<hr /> |
|
|
|
<a name=".parsePlainPrivatePKCS8Hex"> </a> |
|
<div class="fixedFont"><static> |
|
|
|
<span class="light">{Array}</span> |
|
<span class="light">KEYUTIL.</span><b>parsePlainPrivatePKCS8Hex</b>(pkcs8PrvHex) |
|
|
|
</div> |
|
<div class="description"> |
|
parse hexadecimal string of plain PKCS#8 private key |
|
Resulted associative array has following properties: |
|
<ul> |
|
<li>algoid - hexadecimal string of OID of asymmetric key algorithm</li> |
|
<li>algparam - hexadecimal string of OID of ECC curve name or null</li> |
|
<li>keyidx - string starting index of key in pkcs8PrvHex</li> |
|
</ul> |
|
|
|
|
|
</div> |
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Parameters:</dt> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>pkcs8PrvHex</b> |
|
|
|
</dt> |
|
<dd>hexadecimal string of PKCS#8 plain private key</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Since:</dt> |
|
<dd>pkcs5pkey 1.0.5</dd> |
|
</dl> |
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Returns:</dt> |
|
|
|
<dd><span class="light fixedFont">{Array}</span> associative array of parsed key</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
|
|
<hr /> |
|
|
|
<a name=".parsePrivateRawECKeyHexAtObj"> </a> |
|
<div class="fixedFont"><static> |
|
|
|
<span class="light">{Array}</span> |
|
<span class="light">KEYUTIL.</span><b>parsePrivateRawECKeyHexAtObj</b>(pkcs8PrvHex) |
|
|
|
</div> |
|
<div class="description"> |
|
parse hexadecimal string of ECC private key |
|
Following properties are added to associative array 'info' |
|
<ul> |
|
<li>key - hexadecimal string of ECC private key |
|
</ul> |
|
|
|
|
|
</div> |
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Parameters:</dt> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>pkcs8PrvHex</b> |
|
|
|
</dt> |
|
<dd>hexadecimal string of PKCS#8 private key concluding EC private key</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Since:</dt> |
|
<dd>pkcs5pkey 1.0.5</dd> |
|
</dl> |
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Returns:</dt> |
|
|
|
<dd><span class="light fixedFont">{Array}</span> info associative array to add parsed ECC private key information</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
|
|
<hr /> |
|
|
|
<a name=".parsePrivateRawRSAKeyHexAtObj"> </a> |
|
<div class="fixedFont"><static> |
|
|
|
<span class="light">{Array}</span> |
|
<span class="light">KEYUTIL.</span><b>parsePrivateRawRSAKeyHexAtObj</b>(pkcs8PrvHex) |
|
|
|
</div> |
|
<div class="description"> |
|
parse hexadecimal string of RSA private key |
|
Following properties are added to associative array 'info' |
|
<ul> |
|
<li>n - hexadecimal string of public key |
|
<li>e - hexadecimal string of public exponent |
|
<li>d - hexadecimal string of private key |
|
<li>p - hexadecimal string |
|
<li>q - hexadecimal string |
|
<li>dp - hexadecimal string |
|
<li>dq - hexadecimal string |
|
<li>co - hexadecimal string |
|
</ul> |
|
|
|
|
|
</div> |
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Parameters:</dt> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>pkcs8PrvHex</b> |
|
|
|
</dt> |
|
<dd>hexadecimal string of PKCS#8 private key concluding RSA private key</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Since:</dt> |
|
<dd>pkcs5pkey 1.0.5</dd> |
|
</dl> |
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Returns:</dt> |
|
|
|
<dd><span class="light fixedFont">{Array}</span> info associative array to add parsed RSA private key information</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
|
|
<hr /> |
|
|
|
<a name=".parsePublicPKCS8Hex"> </a> |
|
<div class="fixedFont"><static> |
|
|
|
<span class="light">{Hash}</span> |
|
<span class="light">KEYUTIL.</span><b>parsePublicPKCS8Hex</b>(pkcs8PubHex) |
|
|
|
</div> |
|
<div class="description"> |
|
parse hexadecimal string of PKCS#8 RSA/EC/DSA public key |
|
Resulted hash has following attributes. |
|
<ul> |
|
<li>algoid - hexadecimal string of OID of asymmetric key algorithm</li> |
|
<li>algparam - hexadecimal string of OID of ECC curve name, parameter SEQUENCE of DSA or null</li> |
|
<li>key - hexadecimal string of public key</li> |
|
</ul> |
|
|
|
|
|
</div> |
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Parameters:</dt> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>pkcs8PubHex</b> |
|
|
|
</dt> |
|
<dd>hexadecimal string of PKCS#8 public key</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Returns:</dt> |
|
|
|
<dd><span class="light fixedFont">{Hash}</span> hash of key information</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
|
|
<hr /> |
|
|
|
<a name=".parsePublicRawRSAKeyHex"> </a> |
|
<div class="fixedFont"><static> |
|
|
|
<span class="light">{Array}</span> |
|
<span class="light">KEYUTIL.</span><b>parsePublicRawRSAKeyHex</b>(pubRawRSAHex) |
|
|
|
</div> |
|
<div class="description"> |
|
parse hexadecimal string of plain PKCS#8 private key |
|
Resulted associative array has following properties: |
|
<ul> |
|
<li>n - hexadecimal string of public key |
|
<li>e - hexadecimal string of public exponent |
|
</ul> |
|
|
|
|
|
</div> |
|
|
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Parameters:</dt> |
|
|
|
<dt> |
|
<span class="light fixedFont">{String}</span> <b>pubRawRSAHex</b> |
|
|
|
</dt> |
|
<dd>hexadecimal string of ASN.1 encoded PKCS#8 public key</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Since:</dt> |
|
<dd>pkcs5pkey 1.0.5</dd> |
|
</dl> |
|
</dl> |
|
|
|
|
|
|
|
<dl class="detailList"> |
|
<dt class="heading">Returns:</dt> |
|
|
|
<dd><span class="light fixedFont">{Array}</span> associative array of parsed key</dd> |
|
|
|
</dl> |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ============================== event details ========================= --> |
|
|
|
|
|
<hr /> |
|
</div> |
|
|
|
|
|
<!-- ============================== footer ================================= --> |
|
<div class="fineprint" style="clear:both"> |
|
© 2012-2015 Kenji Urushima, All rights reserved<br/> |
|
|
|
Documentation generated by <a href="http://code.google.com/p/jsdoc-toolkit/" target="_blank">JsDoc Toolkit</a> 2.4.0 |
|
</div> |
|
</body> |
|
</html>
|
|
|