View source for AppendEncryptedSecurityData (Stringlist subroutine)

{{Template:Stringlist:AppendEncryptedSecurityData subtitle}}
This subroutine RC4-encrypts a <var>Stringlist</var> that contains a base64 encoded, SSL-certificate related item (certificate request, certificate, private key, etc.).

==Syntax==
{{Template:Stringlist:AppendEncryptedSecurityData syntax}}

===Syntax terms===
<table class="syntaxTable">
<tr><th>sl</th>
<td>A <var>Stringlist</var> object to contain the encrypted, base64 data.</td></tr>
<tr><th>sl</th>
<td>A <var>Stringlist</var> object that contains unencrypted, base64 data.</td></tr>

<tr><th><var>Password</var></th>
<td>This [[Notation conventions for methods#Named parameters|name allowed]] parameter is a string that contains a password (encryption key) to seed the RC4 algorithm. This value must be at least five characters long. </td></tr>

<tr><th><var>Identifier</var></th>
<td>This optional, name allowed, parameter is a string that is part of a data-identifying text at the beginning and end of the base64 data to be encrypted. The text is in the form <code>-----BEGIN <i>string</i>-----</code> and <code>-----END <i>string</i>-----</code>, where the default for <var class="term">string</var> is <code>RSA PRIVATE KEY</code>. Some other <var class="term">string</var> replacements, for example, include <code>X509 CERTIFICATE</code>, and <code>X509 CRL</code>. 
<p>
This is a case-sensitive, value; if it does not match the first and last items of data within <var class="term">sl</var>, no data is returned to the method object, <var class="term">sl</var>. </p> </td></tr>
</table>

==Usage notes==
<ul>
<li>The length of the encrypted data matches the length of the unencrypted data.
</ul>

==Examples==
In the following example, the <code>%creq</code> <var>Stringlist</var> is loaded with a base64 encoded SSL certificate request, which is then RC4-encrypted and added to <var>Stringlist</var> <code>%sl</code> by the <var>AppendEncryptedSecurityData</var> method. The encrypted contents are then printed: <p class="code">...
text to %creq = new raw
&#45;----BEGIN NEW CERTIFICATE REQUEST-----
MIIBSDCB8wIBADCBjzEMMAoGA1UEBhMDVVNBMQswCQYDVQQIEwJNQTESMBAGA1UE
BxMJQ2FtYnJpZGdlMR0wGwYDVQQKExRTaXJpdXMgU29mdHdhcmUgSW5jLjEdMBsG
A1UECxMUU29mdHdhcmUgRGV2ZWxvcG1lbnQxIDAeBgNVBAMTF3d3dy5zaXJpdXMt
c29mdHdhcmUuY29tMFowDQYJKoZIhvcNAQEBBQADSQAwRgJBAMIofDUItsJLIREb
8UJ93Xm3sJRkYI9qus6lPj76iGOLoQEExSVMved24YxtBlC84IPQrl1+foNcFYSv
OAnfA0ECAQOgADANBgkqhkiG9w0BAQQFAANBAFY6cU6+8p2E9xejVNACmQx2quSV
rudOnjS3jGeKl4Ga/wqg3Yrvg5BwMAWxGn1reh7DhX9j/ScjuBWVIgBkU9M=
&#45;----END NEW CERTIFICATE REQUEST-----
end text 

%sl:APPENDENCRYPTEDSECURITYDATA(%creq, Password='12345', Identifier='NEW CERTIFICATE REQUEST')
%sl:print
...
</p>

The result is shown below:
<p class="code">&#45;----BEGIN NEW CERTIFICATE REQUEST-----                         
mzU3hcc5C0PhBbRWKhFeysu/SEn1oNSuv8tldCRTgQGSSx/9WQIarg9Q60gYqoVP
lNivlNniqBLnw69pf4bdsg+Nhb+t2SBImuQ6Ar9eCMqNQa1Lfa0IAf/akuIqDdMa
8N5aIIwTIlDuy0P4agbLZg1tG5oUKTbfcCgEibAfNm+qKazxV0G39s4SGFW+Turf
68byY3fPD1kumMAPJBUCgvLf5iI+ayOSH5K6hQJtCAInXmG+DnqHfnUgS9F80Jcb
/BzgIFktn/GV1POVX5VXZxQWDFzYXIVZJkyflsLdl1qWuAeXmwEHZRXy9yIxDc0R
zTxxOmI18406SojaHK7HUN9UcCrlT1BWsbBsuD81eWw7FpAImI/z3sAfqg37cEgp
Df75M4koUrT8wD6SHSx9ezII0GPaiAr1EUTzATRSoq6hoWS/TrpvE2STOyI=    
&#45;----END NEW CERTIFICATE REQUEST-----
</p>

==See also==
<ul>
<li><var>[[AppendCertificateInfo (Stringlist function)|AppendCertificateInfo]]</var>
<li><var>[[AppendCertificateRequest (Stringlist function)|AppendCertificateRequest]]</var>
<li><var>[[AppendCertificateRequestInfo (Stringlist function)|AppendCertificateRequestInfo]]</var>
<li><var>[[AppendClientCertificateRequest (Stringlist function)|AppendClientCertificateRequest]]</var>
<li><var>[[AppendGeneratedPrivateKey (Stringlist subroutine)|AppendGeneratedPrivateKey]]</var>
<li><var>[[AppendPrivateKeyInfo (Stringlist function)|AppendPrivateKeyInfo]]</var>
<li><var>[[AppendSignedCertificate (Stringlist function)|AppendSignedCertificate]]</var>
<li><var>[[AppendSignedClientCertificate (Stringlist function)|AppendSignedClientCertificate]]</var></li>
<li><var>[[CheckCertificate (Stringlist function)|CheckCertificate]]</var>
<li><var>[[CheckCertificateRequest (Stringlist function)|CheckCertificateRequest]]</var>
<li>[[Release notes for Sirius Mods V8.0#DER2Xml|DER-to-XmlDoc methods (String class)]]</li>
</ul>

{{Template:Stringlist:AppendEncryptedSecurityData footer}}