DerToXmlDoc (String function) - Revision history

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

2018-09-06T15:06:55Z

JAL: /* Usage notes */ typos

2016-08-22T17:26:04Z

Usage notes: typos

← Older revision		Revision as of 17:26, 22 August 2016
Line 19:		Line 19:
	<li><var>DerToXmlDoc</var> does the same work as <var>[[X509CertificateToXmlDoc (String function)\|X509CertificateToXmlDoc]]</var>, <var>[[X509CrlToXmlDoc (String function)\|X509CrlToXmlDoc]]</var>, and		<li><var>DerToXmlDoc</var> does the same work as <var>[[X509CertificateToXmlDoc (String function)\|X509CertificateToXmlDoc]]</var>, <var>[[X509CrlToXmlDoc (String function)\|X509CrlToXmlDoc]]</var>, and
	<var>[[RSAPrivateKeyToXmlDoc (String function)\|RSAPrivateKeyToXmlDoc]]</var>, except that those methods understand the semantics of the standard tags for those items, so they provide more meaningful XML element names. Contrast the [[DerToXmlDoc (String function)#Examples\|DerToXmlDoc examples]] below with the examples for those more specific methods in their respective "Examples" sections.		<var>[[RSAPrivateKeyToXmlDoc (String function)\|RSAPrivateKeyToXmlDoc]]</var>, except that those methods understand the semantics of the standard tags for those items, so they provide more meaningful XML element names. Contrast the [[DerToXmlDoc (String function)#Examples\|DerToXmlDoc examples]] below with the examples for those more specific methods in their respective "Examples" sections.
	<p class="note"><b>Note:</b> Prior to version 7.7 of Model 204, input to these four <var class="term">xxx</var><var>ToXmlDoc</var> methods that created any element in the result <var>XmlDoc</var> with a text child whose length exceeded 650 characters produced an error. As of version 7.7, ~~that restriction is removed, and~~ the lengths of the created text nodes are not restricted. </p></li>		<p class="note"><b>Note:</b> Prior to version 7.7 of Model 204, input to these four <var class="term">xxx</var><var>ToXmlDoc</var> methods that created any element in the result <var>XmlDoc</var> with a text child whose length exceeded 650 characters produced an error. As of version 7.7, the lengths of the created text nodes are not restricted. </p></li>

	<li>Currently, no method is available to produce a DER stream from an <var>XmlDoc</var>. </li>		<li>Currently, no method is available to produce a DER stream from an <var>XmlDoc</var>. </li>

JAL: /* See also */ typo

2016-08-22T16:58:17Z

JAL: note re removal of length issue

2016-08-22T16:28:20Z

note re removal of length issue

← Older revision		Revision as of 16:28, 22 August 2016
Line 7:		Line 7:

	===Syntax terms===		===Syntax terms===
	<table ~~class="syntaxTable"~~>		<table>
	<tr><th>%doc</th>		<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>		<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~~. <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. </td></tr>
	</table>		</table>

	~~===Exceptions===~~
	~~<var>DerToXmlDoc</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==
Line 25:		Line 19:
	<li><var>DerToXmlDoc</var> does the same work as <var>[[X509CertificateToXmlDoc (String function)\|X509CertificateToXmlDoc]]</var>, <var>[[X509CrlToXmlDoc (String function)\|X509CrlToXmlDoc]]</var>, and		<li><var>DerToXmlDoc</var> does the same work as <var>[[X509CertificateToXmlDoc (String function)\|X509CertificateToXmlDoc]]</var>, <var>[[X509CrlToXmlDoc (String function)\|X509CrlToXmlDoc]]</var>, and
	<var>[[RSAPrivateKeyToXmlDoc (String function)\|RSAPrivateKeyToXmlDoc]]</var>, except that those methods understand the semantics of the standard tags for those items, so they provide more meaningful XML element names. Contrast the [[DerToXmlDoc (String function)#Examples\|DerToXmlDoc examples]] below with the examples for those more specific methods in their respective "Examples" sections.		<var>[[RSAPrivateKeyToXmlDoc (String function)\|RSAPrivateKeyToXmlDoc]]</var>, except that those methods understand the semantics of the standard tags for those items, so they provide more meaningful XML element names. Contrast the [[DerToXmlDoc (String function)#Examples\|DerToXmlDoc examples]] below with the examples for those more specific methods in their respective "Examples" sections.
			<p class="note"><b>Note:</b> Prior to version 7.7 of Model 204, input to these four <var class="term">xxx</var><var>ToXmlDoc</var> methods that created any element in the result <var>XmlDoc</var> with a text child whose length exceeded 650 characters produced an error. As of version 7.7, that restriction is removed, and the lengths of the created text nodes are not restricted. </p></li>

	~~<p>~~		<li>Currently, no method is available to produce a DER stream from an <var>XmlDoc</var>. </li>
	For all four of these <var class="term">xxx</var><var>ToXmlDoc</var> methods, there was a restriction, prior to version 7.7 of Model 204, which required that the input not create any element in the result <var>XmlDoc</var> with a text child whose length exceeded 650 characters. That restriction has been removed; there is no length restriction on the lengths of the created text nodes.
	~~</p>~~
	<li>Currently, no method is available to produce a DER stream from an <var>XmlDoc</var>.
	</ul>		</ul>

Line 66:		Line 58:
	... </p>		... </p>

	The ellipses indicate snipped content and are not part of the XmlDoc.		The ellipses indicate snipped content and are not part of the XmlDoc.</li>

	<li>In [[RSAPrivateKeyToXmlDoc (String function)#Examples\|the RSAPrivateKeyToXmlDoc example]], the <var>PemToString</var> method loads a <var>Longstring</var> with the contents of an RSA private key. If that <var>Longstring</var> is also <code>%ls</code> below, the following statement converts that string to the <var>XmlDoc</var> whose contents are printed below. Compare the XML tags in these results with the tags produced by <var>RSAPrivateKeyToXmlDoc</var>:		<li>In [[RSAPrivateKeyToXmlDoc (String function)#Examples\|the RSAPrivateKeyToXmlDoc example]], the <var>PemToString</var> method loads a <var>Longstring</var> with the contents of an RSA private key. If that <var>Longstring</var> is also <code>%ls</code> below, the following statement converts that string to the <var>XmlDoc</var> whose contents are printed below. Compare the XML tags in these results with the tags produced by <var>RSAPrivateKeyToXmlDoc</var>:
Line 89:		Line 81:
	<Integer>104154110092 ...		<Integer>104154110092 ...
	...977615354780</Integer>		...977615354780</Integer>
	</Sequence> </p>		</Sequence> </p></li>
	</ol>		</ol>

Dme: /* Usage notes */

2016-08-20T19:28:14Z

Usage notes

← Older revision		Revision as of 19:28, 20 August 2016
Line 25:		Line 25:
	<li><var>DerToXmlDoc</var> does the same work as <var>[[X509CertificateToXmlDoc (String function)\|X509CertificateToXmlDoc]]</var>, <var>[[X509CrlToXmlDoc (String function)\|X509CrlToXmlDoc]]</var>, and		<li><var>DerToXmlDoc</var> does the same work as <var>[[X509CertificateToXmlDoc (String function)\|X509CertificateToXmlDoc]]</var>, <var>[[X509CrlToXmlDoc (String function)\|X509CrlToXmlDoc]]</var>, and
	<var>[[RSAPrivateKeyToXmlDoc (String function)\|RSAPrivateKeyToXmlDoc]]</var>, except that those methods understand the semantics of the standard tags for those items, so they provide more meaningful XML element names. Contrast the [[DerToXmlDoc (String function)#Examples\|DerToXmlDoc examples]] below with the examples for those more specific methods in their respective "Examples" sections.		<var>[[RSAPrivateKeyToXmlDoc (String function)\|RSAPrivateKeyToXmlDoc]]</var>, except that those methods understand the semantics of the standard tags for those items, so they provide more meaningful XML element names. Contrast the [[DerToXmlDoc (String function)#Examples\|DerToXmlDoc examples]] below with the examples for those more specific methods in their respective "Examples" sections.

			<p>
			For all four of these <var class="term">xxx</var><var>ToXmlDoc</var> methods, there was a restriction, prior to version 7.7 of Model 204, which required that the input not create any element in the result <var>XmlDoc</var> with a text child whose length exceeded 650 characters. That restriction has been removed; there is no length restriction on the lengths of the created text nodes.
			</p>
	<li>Currently, no method is available to produce a DER stream from an <var>XmlDoc</var>.		<li>Currently, no method is available to produce a DER stream from an <var>XmlDoc</var>.
	</ul>		</ul>

JAL: /* See also */ add item

2016-05-16T21:17:10Z

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

2016-03-15T23:31:17Z

See also: add template for SL crypto methods

← Older revision		Revision as of 23:31, 15 March 2016
Line 89:		Line 89:

	==See also==		==See also==
	~~Related~~ methods:		<p>
			<var>String</var> methods:</p>
	<ul>		<ul>
	<li><var>String</var> class: <var>[[X509CrlToXmlDoc_(String_function)\|X509CrlToXmlDoc]]</var>, <var>[[X509CertificateToXmlDoc_(String_function)\|X509CertificateToXmlDoc]]</var>, <var>[[RSAPrivateKeyToXmlDoc (String function)\|RSAPrivateKeyToXmlDoc]]</var>, <var>[[CertificateRequest (String function)\|CertificateRequest]]</var> ~~<var>[[SignedCertificate (String function)\|SignedCertificate]]</var>, and multiple cryptographic cipher methods~~ </li>		<li><var>[[CertificateRequest (String function)\|CertificateRequest]]</var> </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>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>[[DerToXmlDoc (String function)\|DerToXmlDoc]]</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>[[RSAPrivateKeyToXmlDoc (String function)\|RSAPrivateKeyToXmlDoc]]</var></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:52:15Z

See also: add mention of String cipher methods

← Older revision		Revision as of 20:52, 15 March 2016
Line 91:		Line 91:
	Related methods:		Related methods:
	<ul>		<ul>
	<li><var>String</var> class: <var>[[X509CrlToXmlDoc_(String_function)\|X509CrlToXmlDoc]]</var>, <var>[[X509CertificateToXmlDoc_(String_function)\|X509CertificateToXmlDoc]]</var>, <var>[[RSAPrivateKeyToXmlDoc (String function)\|RSAPrivateKeyToXmlDoc]]</var>, <var>[[CertificateRequest (String function)\|CertificateRequest]]</var> <var>[[SignedCertificate (String function)\|SignedCertificate]]</var> </li>		<li><var>String</var> class: <var>[[X509CrlToXmlDoc_(String_function)\|X509CrlToXmlDoc]]</var>, <var>[[X509CertificateToXmlDoc_(String_function)\|X509CertificateToXmlDoc]]</var>, <var>[[RSAPrivateKeyToXmlDoc (String function)\|RSAPrivateKeyToXmlDoc]]</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-15T20:49:54Z

JAL: /* See also */ add links

2016-03-14T19:52:28Z

← Older revision		Revision as of 15:06, 6 September 2018
Line 93:		Line 93:

	<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 93:		Line 93:
	<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 20:49, 15 March 2016
Line 99:		Line 99:
	<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:52, 14 March 2016
Line 91:		Line 91:
	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>[[RSAPrivateKeyToXmlDoc _(~~String_function~~)\|RSAPrivateKeyToXmlDoc]]</var>		<li><var>String</var> class: <var>[[X509CrlToXmlDoc_(String_function)\|X509CrlToXmlDoc]]</var>, <var>[[X509CertificateToXmlDoc_(String_function)\|X509CertificateToXmlDoc]]</var>, <var>[[RSAPrivateKeyToXmlDoc (String function)\|RSAPrivateKeyToXmlDoc]]</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>
	<li><var>Socket</var> class: <var>[[Certificate (Socket function)\|Certificate]]</var>		<li><var>System</var> class: <var>[[ClientCertificate (System function)\|ClientCertificate]]</var>, <var>[[GeneratedPrivateKey (System function)\|GeneratedPrivateKey]]</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>[[AppendPemData (Stringlist function)\|AppendPemData]]</var>, <var>[[PemToString_(Stringlist_function)\|PemToString]]</var>, <var>[[AppendCertificateRequest (Stringlist function)\|AppendCertificateRequest]]</var>, and several more </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:DerToXmlDoc footer}}		{{Template:String:DerToXmlDoc footer}}

← Older revision		Revision as of 16:58, 22 August 2016
Line 110:		Line 110:
	<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>