AppendSignedCertificate (Stringlist function): Difference between revisions
m (SHA-256 is Janus default as of 7.5 of 204) |
m (→See also: add links) |
||
Line 94: | Line 94: | ||
==See also== | ==See also== | ||
<p> | |||
<var>Stringlist</var> methods: </p> | |||
<ul> | <ul> | ||
<li><var>[[AppendCertificateInfo (Stringlist function)|AppendCertificateInfo]]</var> | <li><var>[[AppendCertificateInfo (Stringlist function)|AppendCertificateInfo]]</var></li> | ||
<li><var>[[AppendCertificateRequest (Stringlist function)|AppendCertificateRequest]]</var> | |||
<li><var>[[AppendCertificateRequestInfo (Stringlist function)|AppendCertificateRequestInfo]]</var> | <li><var>[[AppendCertificateRequest (Stringlist function)|AppendCertificateRequest]]</var></li> | ||
<li><var>[[AppendClientCertificateRequest (Stringlist function)|AppendClientCertificateRequest]]</var> | |||
<li><var>[[AppendEncryptedSecurityData (Stringlist | <li><var>[[AppendCertificateRequestInfo (Stringlist function)|AppendCertificateRequestInfo]]</var></li> | ||
<li><var>[[AppendGeneratedPrivateKey (Stringlist subroutine)|AppendGeneratedPrivateKey]]</var> | |||
<li><var>[[AppendPrivateKeyInfo (Stringlist function)|AppendPrivateKeyInfo]]</var> | <li><var>[[AppendClientCertificateRequest (Stringlist function)|AppendClientCertificateRequest]]</var></li> | ||
<li><var>[[AppendEncryptedSecurityData (Stringlist function)|AppendEncryptedSecurityData]]</var></li> | |||
<li><var>[[AppendGeneratedPrivateKey (Stringlist subroutine)|AppendGeneratedPrivateKey]]</var></li> | |||
<li><var>[[AppendPrivateKeyInfo (Stringlist function)|AppendPrivateKeyInfo]]</var></li> | |||
<li><var>[[AppendSignedClientCertificate (Stringlist function)|AppendSignedClientCertificate]]</var></li> | <li><var>[[AppendSignedClientCertificate (Stringlist function)|AppendSignedClientCertificate]]</var></li> | ||
<li><var>[[CheckCertificate (Stringlist function)|CheckCertificate]]</var> | |||
<li><var>[[CheckCertificateRequest (Stringlist function)|CheckCertificateRequest]]</var> | <li><var>[[CheckCertificate (Stringlist function)|CheckCertificate]]</var></li> | ||
<li>[[Release notes for Sirius Mods V8.0#DER2Xml|DER-to-XmlDoc methods | |||
<li><var>[[CheckCertificateRequest (Stringlist function)|CheckCertificateRequest]]</var></li> | |||
</ul> | |||
<p> | |||
<var>String</var> methods:</p> | |||
<ul> | |||
<li>[[Release notes for Sirius Mods V8.0#DER2Xml|DER-to-XmlDoc methods]]</li> | |||
</ul> | </ul> | ||
{{Template:Stringlist:AppendSignedCertificate footer}} | {{Template:Stringlist:AppendSignedCertificate footer}} |
Revision as of 18:18, 14 March 2016
Add base64 encoded signed certificate to a Stringlist (Stringlist class)
[Requires Janus Network Security]
This callable method signs an X.509 certificate request and adds the lines of the signed certificate to the end of a Stringlist.
Syntax
[%rc =] sl:AppendSignedCertificate( [PrivateKey=] string, [Request=] string, - [[Signer=] string], - [[StartDate=] string], - [[EndDate=] string], - [[SerialNumber=] number], - [SignatureAlgorithm= digestAlgorithm])
Syntax terms
%rc | An, optional, numeric variable that is set to zero if the function is a success. The possible return codes are described below in Return codes. |
---|---|
sl | A Stringlist object. |
PrivateKey | This name allowed argument is a Stringlist that contains the private key to be used for signing. |
Request | This name allowed argument is a Stringlist that contains the base-64 encoded X.509 certificate request. |
Signer | This optional, name allowed, argument is a Stringlist that contains the base-64 encoded CA (certifying authority) X.509 certificate. If not specified, the Request Stringlist is used: that is, the certificate will be self-signed. |
StartDate | This optional, name allowed, argument is a string that contains the Start date for the signed certificate (in YYMMDDHHMISS format). The default is today's date. |
EndDate | This optional, name allowed, argument is a string that contains the End date for the signed certificate (in YYMMDDHHMISS format). The default is 24 hours from StartDate. |
SerialNumber | This optional, name allowed, argument is a numeric value that is the Serial number for the signed certificate. The default is a number guaranteed to increase by 1 for every call and guaranteed to increase from run to run, unless there is an extreme amount of signing occurrences. |
SignatureAlgorithm | This optional, name required, argument is a DigestAlgorithm enumeration value. Valid options are: MD5, SHA1, SHA256.
Note: Although supported, most modern browsers are deprecating SHA1. SHA256 is the Janus security default as of Model 204 version 7.5. |
Return codes
0 | All is well. |
---|---|
3 | Out of CCATEMP. |
5 | Stringlist identifier missing. |
6 | Invalid Stringlist identifier. |
7 | Insufficient storage. |
10 | Private key Stringlist identifier missing. |
11 | Invalid private key Stringlist identifier. |
12 | Invalid private key Stringlist data (not correctly base-64 encoded). |
13 | Certificate request Stringlist identifier missing. |
14 | Invalid certificate request Stringlist identifier. |
15 | Invalid certificate request. |
16 | Invalid CA certificate Stringlist identifier. |
17 | Invalid CA certificate. |
18 | Invalid start date. |
19 | Invalid end date. |
20 | Invalid serial number. |
21 | Private key does not match signer public key. |
Examples
See also
Stringlist methods:
- AppendCertificateInfo
- AppendCertificateRequest
- AppendCertificateRequestInfo
- AppendClientCertificateRequest
- AppendEncryptedSecurityData
- AppendGeneratedPrivateKey
- AppendPrivateKeyInfo
- AppendSignedClientCertificate
- CheckCertificate
- CheckCertificateRequest
String methods: