RSAPrivateKeyToXmlDoc (String function) - Revision history

JAL: /* See also */ add method to list

2018-09-06T15:07:41Z

JAL: /* Usage notes */ typos

2016-08-22T17:25:02Z

Usage notes: typos

← Older revision		Revision as of 17:25, 22 August 2016
Line 17:		Line 17:
	==Usage notes==		==Usage notes==
	<ul>		<ul>
	<li>Prior to version 7.7 of Model 204, input to this method that created any element in the result <var>XmlDoc</var> with a text child whose length exceeded 650 characters produced an error. An example of such input is a 4096-bit key (which requires 1024 hex characters). As of version 7.7, ~~that restriction is removed, and~~ the lengths of ~~the~~ created text nodes are not restricted. </li>		<li>Prior to version 7.7 of Model 204, input to this method that created any element in the result <var>XmlDoc</var> with a text child whose length exceeded 650 characters produced an error. An example of such input is a 4096-bit key (which requires 1024 hex characters). As of version 7.7, the lengths of created text nodes are not restricted. </li>

	<li><var>RSAPrivateKeyToXmlDoc</var> is very similar to		<li><var>RSAPrivateKeyToXmlDoc</var> is very similar to

JAL: note re removal of length issue

2016-08-22T16:57:04Z

note re removal of length issue

← Older revision		Revision as of 16:57, 22 August 2016
Line 12:		Line 12:

	<tr><th>string</th>		<tr><th>string</th>
	<td>A DER encoded string that contains the contents of a digital certificate. ~~<p class="note">'''Note:''' This method fails if the XML representation of <var class="term">string</var> is longer than 650 characters. </p>~~</td></tr>		<td>A DER encoded string that contains the contents of a digital certificate. </td></tr>
	</table>		</table>

	~~===Exceptions===~~
	~~<var>RSAPrivateKeyToXmlDoc</var> can throw the following [[Exceptions\|exception]]:~~
	~~<dl>~~
	~~<dt><var>[[InvalidBerData class\|InvalidBerData]]</var>~~
	~~<dd>If the method encounters non-BER-conforming data, properties of the exception object may indicate the position and description of the error.~~
	~~</dl>~~

	==Usage notes==		==Usage notes==
	<ul>		<ul>
			<li>Prior to version 7.7 of Model 204, input to this method that created any element in the result <var>XmlDoc</var> with a text child whose length exceeded 650 characters produced an error. An example of such input is a 4096-bit key (which requires 1024 hex characters). As of version 7.7, that restriction is removed, and the lengths of the created text nodes are not restricted. </li>

	<li><var>RSAPrivateKeyToXmlDoc</var> is very similar to		<li><var>RSAPrivateKeyToXmlDoc</var> is very similar to
	<var>[[DerToXmlDoc (String function)\|DerToXmlDoc]]</var>, except that <var>RSAPrivateKeyToXmlDoc</var> understands the semantics of the private key tags, so it provides more meaningful XML element names. </li>		<var>[[DerToXmlDoc (String function)\|DerToXmlDoc]]</var>, except that <var>RSAPrivateKeyToXmlDoc</var> understands the semantics of the private key tags, so it provides more meaningful XML element names. </li>
Line 30:		Line 25:

	<li>Currently, no method is available to produce a DER stream from an <var>XmlDoc</var> nor to validate the signature on a certificate. </li>		<li>Currently, no method is available to produce a DER stream from an <var>XmlDoc</var> nor to validate the signature on a certificate. </li>

	~~<li>This method's limit of an XML representation of 650 characters means that it cannot process a 4096-bit key (which requires 1024 hex characters). Fortunately, 4K keys are still uncommon. </li>~~
	</ul>		</ul>

Line 104:		Line 97:
	<var>System</var> methods: </p>		<var>System</var> methods: </p>
	<ul>		<ul>
	<li><var>[[ClientCertificate (System function)\|ClientCertificate]]</var>, <li><var>[[GeneratedPrivateKey (System function)\|GeneratedPrivateKey]]</var> </li>		<li><var>[[ClientCertificate (System function)\|ClientCertificate]]</var></li>
			<li><var>[[GeneratedPrivateKey (System function)\|GeneratedPrivateKey]]</var> </li>
	</ul>		</ul>
	<p>		<p>

JAL: /* See also */ add item

2016-05-16T21:17:44Z

JAL: /* See also */ add template for SL crypto methods

2016-03-15T23:25:00Z

See also: add template for SL crypto methods

← Older revision		Revision as of 23:25, 15 March 2016
Line 79:		Line 79:

	==See also==		==See also==
	~~Related~~ methods:		<p>
			<var>String</var> methods:</p>
	<ul>		<ul>
	<li>~~<var>String</var> class:~~		<li><var>[[CertificateRequest (String function)\|CertificateRequest]]</var> </li>
	<var>[[DerToXmlDoc_(String_function)\|DerToXmlDoc]]</var>, <var>[[X509CertificateToXmlDoc_(String_function)\|X509CertificateToXmlDoc]]</var>, <var>[[X509CrlToXmlDoc_(String_function)\|X509CrlToXmlDoc]]</var>, <var>[[CertificateRequest (String function)\|CertificateRequest]]</var> ~~<var>[[SignedCertificate (String function)\|SignedCertificate]]</var>, and multiple cryptographic cipher methods~~ </li>

	<li>~~<var>System</var> class:~~ <var>[[~~ClientCertificate~~ (~~System~~ function)\|~~ClientCertificate]]</var>, <var>[[GeneratedPrivateKey (System function)\|GeneratedPrivateKey~~]]</var></li>		<li><var>[[SignedCertificate (String function)\|SignedCertificate]]</var> </li>

	<li>~~<var>Socket</var> class:~~ <var>[[~~Certificate~~ (~~Socket~~ function)\|~~Certificate~~]]</var> </li>		<li><var>[[DerToXmlDoc (String function)\|DerToXmlDoc]]</var> </li>

	<li>~~<var>HttpRequest</var> class:~~ <var>[[~~Get~~ (~~HttpRequest~~ function)\|~~Get]]</var>, <var>[[Post (HttpRequest function)\|Post]]</var>, and <var>[[Send (HttpRequest function)\|Send~~]]</var> </li>		<li><var>[[RSAPrivateKeyToXmlDoc (String function)\|RSAPrivateKeyToXmlDoc]]</var></li>

	<li><var>Stringlist</var> ~~class~~: <var>[[~~AppendPemData~~ (~~Stringlist subroutine~~)\|~~AppendPemData~~]]</var>, <var>[[~~PemToString_~~(~~Stringlist_function~~)\|~~PemToString~~]]</var>, <var>[[~~AppendCertificateRequest~~ (~~Stringlist~~ function)\|~~AppendCertificateRequest~~]]</var>~~, and several more~~ </li>		<li><var>[[X509CertificateToXmlDoc (String function)\|X509CertificateToXmlDoc]]</var> </li>

			<li><var>[[X509CrlToXmlDoc (String function)\|X509CrlToXmlDoc]]</var> </li>

			<li>Multiple cryptographic cipher methods </li>
			</ul>
			<p>
			<var>Stringlist</var> methods: </p>
			{{Template:Stringlist crypto methods}}
			<p>
			<var>System</var> methods: </p>
			<ul>
			<li><var>[[ClientCertificate (System function)\|ClientCertificate]]</var>, <li><var>[[GeneratedPrivateKey (System function)\|GeneratedPrivateKey]]</var> </li>
			</ul>
			<p>
			<var>Socket</var> methods: </p>
			<ul>
			<li><var>[[Certificate (Socket function)\|Certificate]]</var> </li>
	</ul>		</ul>

JAL: /* See also */ add mention of String cipher methods

2016-03-15T20:55:00Z

See also: add mention of String cipher methods

← Older revision		Revision as of 20:55, 15 March 2016
Line 82:		Line 82:
	<ul>		<ul>
	<li><var>String</var> class:		<li><var>String</var> class:
	<var>[[DerToXmlDoc_(String_function)\|DerToXmlDoc]]</var>, <var>[[X509CertificateToXmlDoc_(String_function)\|X509CertificateToXmlDoc]]</var>, <var>[[X509CrlToXmlDoc_(String_function)\|X509CrlToXmlDoc]]</var>, <var>[[CertificateRequest (String function)\|CertificateRequest]]</var> <var>[[SignedCertificate (String function)\|SignedCertificate]]</var> </li>		<var>[[DerToXmlDoc_(String_function)\|DerToXmlDoc]]</var>, <var>[[X509CertificateToXmlDoc_(String_function)\|X509CertificateToXmlDoc]]</var>, <var>[[X509CrlToXmlDoc_(String_function)\|X509CrlToXmlDoc]]</var>, <var>[[CertificateRequest (String function)\|CertificateRequest]]</var> <var>[[SignedCertificate (String function)\|SignedCertificate]]</var>, and multiple cryptographic cipher methods </li>

	<li><var>System</var> class: <var>[[ClientCertificate (System function)\|ClientCertificate]]</var>, <var>[[GeneratedPrivateKey (System function)\|GeneratedPrivateKey]]</var></li>		<li><var>System</var> class: <var>[[ClientCertificate (System function)\|ClientCertificate]]</var>, <var>[[GeneratedPrivateKey (System function)\|GeneratedPrivateKey]]</var></li>

JAL: /* See also */ typo

2016-03-14T21:00:51Z

JAL: /* See also */ add links

2016-03-14T19:58:39Z

JAL: minor cleanup

2016-03-05T00:28:23Z

minor cleanup

← Older revision		Revision as of 00:28, 5 March 2016
Line 1:		Line 1:
	{{Template:String:RSAPrivateKeyToXmlDoc subtitle}}		{{Template:String:RSAPrivateKeyToXmlDoc subtitle}}
	~~X509 is a general authentication framework that establishes standard formats for public-key certificates, certificate revocation list (CRLs), and more.~~		<var>RSAPrivateKeyToXmlDoc</var> converts a string (<var>Longstring</var>) that contains an RSA-generated private key to an <var>[[XmlDoc class\|XmlDoc]]</var>.
	<var>~~X509CertificateToXmlDoc~~</var> converts a string (<var>Longstring</var>) that contains an RSA-generated private key to an <var>[[XmlDoc class\|XmlDoc]]</var>.
	DER (Distinguished Encoding Rules), a subset of BER (Basic Encoding Rules, provide a way to uniquely encode an Abstract Syntax Notation One (ASN.1) type value as a string of eight-bit octets.		DER (Distinguished Encoding Rules), a subset of BER (Basic Encoding Rules, provide a way to uniquely encode an Abstract Syntax Notation One (ASN.1) type value as a string of eight-bit octets.

Line 8:		Line 7:

	===Syntax terms===		===Syntax terms===
	<table ~~class="syntaxTable"~~>		<table>
	<tr><th>%doc</th><td>An <var>XmlDoc</var> object variable to contain the decoded value of the method object, <var class="term">string</var>.</td></tr>		<tr><th>%doc</th>
			<td>An <var>XmlDoc</var> object variable to contain the decoded value of the method object, <var class="term">string</var>.</td></tr>

	<tr><th>string</th>		<tr><th>string</th>
	<td>A DER encoded string that contains the contents of a digital certificate. <br>'''Note:''' This method fails if the XML representation of <var class="term">string</var> is longer than 650 characters.</td></tr>		<td>A DER encoded string that contains the contents of a digital certificate. <p class="note">'''Note:''' This method fails if the XML representation of <var class="term">string</var> is longer than 650 characters. </p></td></tr>
	</table>		</table>

Line 24:		Line 25:
	<ul>		<ul>
	<li><var>RSAPrivateKeyToXmlDoc</var> is very similar to		<li><var>RSAPrivateKeyToXmlDoc</var> is very similar to
	<var>[[DerToXmlDoc (String function)\|DerToXmlDoc]]</var>, except that <var>RSAPrivateKeyToXmlDoc</var> understands the semantics of the private key tags, so it provides more meaningful XML element names.		<var>[[DerToXmlDoc (String function)\|DerToXmlDoc]]</var>, except that <var>RSAPrivateKeyToXmlDoc</var> understands the semantics of the private key tags, so it provides more meaningful XML element names. </li>
	<li><var>RSAPrivateKeyToXmlDoc</var> is a complete implementation of the PKCS standards for private key syntax.
	<li>Currently, no method is available to produce a DER stream from an <var>XmlDoc</var> nor to validate the signature on a certificate.		<li><var>RSAPrivateKeyToXmlDoc</var> is a complete implementation of the PKCS standards for private key syntax. </li>
	<li>This method's limit of an XML representation of 650 characters means that it cannot process a 4096-bit key (which requires 1024 hex characters). Fortunately, 4K keys are still uncommon.
			<li>Currently, no method is available to produce a DER stream from an <var>XmlDoc</var> nor to validate the signature on a certificate. </li>

			<li>This method's limit of an XML representation of 650 characters means that it cannot process a 4096-bit key (which requires 1024 hex characters). Fortunately, 4K keys are still uncommon. </li>
	</ul>		</ul>

	==Examples==		==Examples==
	In the following example, the <var>[[PemToString (Stringlist function)\|PemToString]]</var> method loads <var>Longstring</var> <code>%ls</code> with the contents of an RSA private key. <var>RSAPrivateKeyToXmlDoc</var> then converts the <var>Longstring</var> to an <var>XmlDoc</var> whose contents are printed: <p class="code"> ...		In the following example, the <var>[[PemToString (Stringlist function)\|PemToString]]</var> method loads <var>Longstring</var> <code>%ls</code> with the contents of an RSA private key. <var>RSAPrivateKeyToXmlDoc</var> then converts the <var>Longstring</var> to an <var>XmlDoc</var> whose contents are printed:
			<p class="code"> ...
	text to %sl = new raw		text to %sl = new raw
	-----BEGIN RSA PRIVATE KEY-----		-----BEGIN RSA PRIVATE KEY-----
Line 76:		Line 81:
	Related methods:		Related methods:
	<ul>		<ul>
	<li><var>String</var> class: <var>[[X509CrlToXmlDoc_(String_function)\|X509CrlToXmlDoc]]</var>, <var>[[X509CertificateToXmlDoc_(String_function)\|X509CertificateToXmlDoc]]</var>, and <var>[[DerToXmlDoc _(String_function)\|DerToXmlDoc]]</var>		<li><var>String</var> class: <var>[[X509CrlToXmlDoc_(String_function)\|X509CrlToXmlDoc]]</var>, <var>[[X509CertificateToXmlDoc_(String_function)\|X509CertificateToXmlDoc]]</var>, and <var>[[DerToXmlDoc _(String_function)\|DerToXmlDoc]]</var> </li>
	<li><var>System</var> class: <var>[[ClientCertificate (System function)\|ClientCertificate]]</var>
	<li><var>Socket</var> class: <var>[[Certificate (Socket function)\|Certificate]]</var>		<li><var>System</var> class: <var>[[ClientCertificate (System function)\|ClientCertificate]]</var> </li>
	<li><var>HttpRequest</var> class: <var>[[Get (HttpRequest function)\|Get]]</var>, <var>[[Post (HttpRequest function)\|Post]]</var>, and <var>[[Send (HttpRequest function)\|Send]]</var>
	<li><var>Stringlist</var> class: <var>[[PemToString_(Stringlist_function)\|PemToString]]</var>		<li><var>Socket</var> class: <var>[[Certificate (Socket function)\|Certificate]]</var> </li>

			<li><var>HttpRequest</var> class: <var>[[Get (HttpRequest function)\|Get]]</var>, <var>[[Post (HttpRequest function)\|Post]]</var>, and <var>[[Send (HttpRequest function)\|Send]]</var> </li>

			<li><var>Stringlist</var> class: <var>[[PemToString_(Stringlist_function)\|PemToString]]</var> </li>
	</ul>		</ul>

	Background information:		Background information:
	<ul>		<ul>
	<li>[http://en.wikipedia.org/wiki/Abstract_Syntax_Notation_One "Abstract Syntax Notation One"]		<li>[http://en.wikipedia.org/wiki/Abstract_Syntax_Notation_One "Abstract Syntax Notation One"] </li>
	<li>[http://luca.ntop.org/Teaching/Appunti/asn1.html "A Layman's Guide to a Subset of ASN.1, BER, and DER"]		<li>[http://luca.ntop.org/Teaching/Appunti/asn1.html "A Layman's Guide to a Subset of ASN.1, BER, and DER"] </li>
	</ul>		</ul>

	{{Template:String:RSAPrivateKeyToXmlDoc footer}}		{{Template:String:RSAPrivateKeyToXmlDoc footer}}

ELowell at 21:32, 3 September 2015

2015-09-03T21:32:18Z

← Older revision		Revision as of 21:32, 3 September 2015
Line 1:		Line 1:
	{{Template:String:RSAPrivateKeyToXmlDoc subtitle}}		{{Template:String:RSAPrivateKeyToXmlDoc subtitle}}

	X509 is a general authentication framework that establishes standard formats for public-key certificates, certificate revocation list (CRLs), and more.		X509 is a general authentication framework that establishes standard formats for public-key certificates, certificate revocation list (CRLs), and more.
	<var>X509CertificateToXmlDoc</var> converts a string (<var>Longstring</var>) that contains an RSA-generated private key to an <var>[[XmlDoc class\|XmlDoc]]</var>.		<var>X509CertificateToXmlDoc</var> converts a string (<var>Longstring</var>) that contains an RSA-generated private key to an <var>[[XmlDoc class\|XmlDoc]]</var>.
Line 86:		Line 85:
	Background information:		Background information:
	<ul>		<ul>
	<li>[http://en.wikipedia.org/wiki/Abstract_Syntax_Notation_One\|"Abstract Syntax Notation One"]		<li>[http://en.wikipedia.org/wiki/Abstract_Syntax_Notation_One "Abstract Syntax Notation One"]
	<li>[http://luca.ntop.org/Teaching/Appunti/asn1.html\|"A Layman's Guide to a Subset of ASN.1, BER, and DER"]		<li>[http://luca.ntop.org/Teaching/Appunti/asn1.html "A Layman's Guide to a Subset of ASN.1, BER, and DER"]
	</ul>		</ul>

	{{Template:String:RSAPrivateKeyToXmlDoc footer}}		{{Template:String:RSAPrivateKeyToXmlDoc footer}}

← Older revision		Revision as of 15:07, 6 September 2018
Line 80:		Line 80:

	<li><var>[[SignedCertificate (String function)\|SignedCertificate]]</var> </li>		<li><var>[[SignedCertificate (String function)\|SignedCertificate]]</var> </li>

			<li><var>[[SignedClientCertificate (String function)\|SignedClientCertificate]]</var> </li>

	<li><var>[[DerToXmlDoc (String function)\|DerToXmlDoc]]</var> </li>		<li><var>[[DerToXmlDoc (String function)\|DerToXmlDoc]]</var> </li>

← Older revision		Revision as of 21:17, 16 May 2016
Line 83:		Line 83:
	<ul>		<ul>
	<li><var>[[CertificateRequest (String function)\|CertificateRequest]]</var> </li>		<li><var>[[CertificateRequest (String function)\|CertificateRequest]]</var> </li>

			<li><var>[[ClientCertificateRequest (String function)\|ClientCertificateRequest]]</var> </li>

	<li><var>[[SignedCertificate (String function)\|SignedCertificate]]</var> </li>		<li><var>[[SignedCertificate (String function)\|SignedCertificate]]</var> </li>

← Older revision		Revision as of 21:00, 14 March 2016
Line 90:		Line 90:
	<li><var>HttpRequest</var> class: <var>[[Get (HttpRequest function)\|Get]]</var>, <var>[[Post (HttpRequest function)\|Post]]</var>, and <var>[[Send (HttpRequest function)\|Send]]</var> </li>		<li><var>HttpRequest</var> class: <var>[[Get (HttpRequest function)\|Get]]</var>, <var>[[Post (HttpRequest function)\|Post]]</var>, and <var>[[Send (HttpRequest function)\|Send]]</var> </li>

	<li><var>Stringlist</var> class: <var>[[AppendPemData (Stringlist ~~function~~)\|AppendPemData]]</var>, <var>[[PemToString_(Stringlist_function)\|PemToString]]</var>, <var>[[AppendCertificateRequest (Stringlist function)\|AppendCertificateRequest]]</var>, and several more </li>		<li><var>Stringlist</var> class: <var>[[AppendPemData (Stringlist subroutine)\|AppendPemData]]</var>, <var>[[PemToString_(Stringlist_function)\|PemToString]]</var>, <var>[[AppendCertificateRequest (Stringlist function)\|AppendCertificateRequest]]</var>, and several more </li>
	</ul>		</ul>

← Older revision		Revision as of 19:58, 14 March 2016
Line 81:		Line 81:
	Related methods:		Related methods:
	<ul>		<ul>
	<li><var>String</var> class: <var>[[~~X509CrlToXmlDoc_~~(String_function)\|~~X509CrlToXmlDoc~~]]</var>, <var>[[X509CertificateToXmlDoc_(String_function)\|X509CertificateToXmlDoc]]</var>, ~~and~~ <var>[[~~DerToXmlDoc _~~(String_function)\|~~DerToXmlDoc~~]]</var> </li>		<li><var>String</var> class:
			<var>[[DerToXmlDoc_(String_function)\|DerToXmlDoc]]</var>, <var>[[X509CertificateToXmlDoc_(String_function)\|X509CertificateToXmlDoc]]</var>, <var>[[X509CrlToXmlDoc_(String_function)\|X509CrlToXmlDoc]]</var>, <var>[[CertificateRequest (String function)\|CertificateRequest]]</var> <var>[[SignedCertificate (String function)\|SignedCertificate]]</var> </li>

			<li><var>System</var> class: <var>[[ClientCertificate (System function)\|ClientCertificate]]</var>, <var>[[GeneratedPrivateKey (System function)\|GeneratedPrivateKey]]</var></li>

	~~<li><var>System</var> class: <var>[[ClientCertificate (System function)\|ClientCertificate]]</var> </li>~~

	<li><var>Socket</var> class: <var>[[Certificate (Socket function)\|Certificate]]</var> </li>		<li><var>Socket</var> class: <var>[[Certificate (Socket function)\|Certificate]]</var> </li>

	<li><var>HttpRequest</var> class: <var>[[Get (HttpRequest function)\|Get]]</var>, <var>[[Post (HttpRequest function)\|Post]]</var>, and <var>[[Send (HttpRequest function)\|Send]]</var> </li>		<li><var>HttpRequest</var> class: <var>[[Get (HttpRequest function)\|Get]]</var>, <var>[[Post (HttpRequest function)\|Post]]</var>, and <var>[[Send (HttpRequest function)\|Send]]</var> </li>

	<li><var>Stringlist</var> class: <var>[[PemToString_(Stringlist_function)\|PemToString]]</var> </li>		<li><var>Stringlist</var> class: <var>[[AppendPemData (Stringlist function)\|AppendPemData]]</var>, <var>[[PemToString_(Stringlist_function)\|PemToString]]</var>, <var>[[AppendCertificateRequest (Stringlist function)\|AppendCertificateRequest]]</var>, and several more </li>
	</ul>		</ul>