X509CrlToXmlDoc (String function) - Revision history

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

2018-09-06T15:09:06Z

JAL: /* Usage notes */ typos

2016-08-22T17:27:24Z

Usage notes: typos

← Older revision		Revision as of 17:27, 22 August 2016
Line 16:		Line 16:
	==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. 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. As of version 7.7, the lengths of the created text nodes are not restricted. </li>

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

JAL: /* See also */ typo

2016-08-22T17:00:05Z

JAL: note re removal of length issue

2016-08-22T16:40:05Z

note re removal of length issue

← Older revision		Revision as of 16:40, 22 August 2016
Line 6:		Line 6:

	===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 that contains the contents of a CRL (Certificate Revocation List)~~. <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 CRL (Certificate Revocation List). </td></tr>
	</table>		</table>

	~~===Exceptions===~~
	~~<var>X509CrlToXmlDoc</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. As of version 7.7, that restriction is removed, and the lengths of the created text nodes are not restricted. </li>

	<li><var>X509CrlToXmlDoc</var> is very similar to		<li><var>X509CrlToXmlDoc</var> is very similar to
	<var>[[DerToXmlDoc (String function)\|DerToXmlDoc]]</var>, except that <var>X509CrlToXmlDoc</var> understands the semantics of the CRL tags, so it provides more meaningful XML element names. Contrast the [[DerToXmlDoc (String function)#Examples\|DerToXmlDoc example]] with the <var>X509CrlToXmlDoc</var> [[X509CrlToXmlDoc (String function)#Examples\|example]], below.		<var>[[DerToXmlDoc (String function)\|DerToXmlDoc]]</var>, except that <var>X509CrlToXmlDoc</var> understands the semantics of the CRL tags, so it provides more meaningful XML element names. Contrast the [[DerToXmlDoc (String function)#Examples\|DerToXmlDoc example]] with the <var>X509CrlToXmlDoc</var> [[X509CrlToXmlDoc (String function)#Examples\|example]], below. </li>
	<li><var>X509CrlToXmlDoc</var> is a complete implementation of the PKCS standards for CRLs.
			<li><var>X509CrlToXmlDoc</var> is a complete implementation of the PKCS standards for CRLs. </li>

	<li><var class="product">Janus Web Server</var> is not equipped to use the <var>XmlDoc</var> CRLs automatically; you have to process them yourself. Probably, for efficiency, you want to get the CRL at startup time, then store it somewhere easy to get at (a global <var>[[NamedArraylist class\|NamedArraylist]]</var>, for example, or a file, depending on how many certificates are in the list.		<li><var class="product">Janus Web Server</var> is not equipped to use the <var>XmlDoc</var> CRLs automatically; you have to process them yourself. Probably, for efficiency, you want to get the CRL at startup time, then store it somewhere easy to get at (a global <var>[[NamedArraylist class\|NamedArraylist]]</var>, for example, or a file, depending on how many certificates are in the list.
	<li>Currently, no method is available to produce a DER stream from an <var>XmlDoc</var> nor to validate the signature on a CRL.		<li>Currently, no method is available to produce a DER stream from an <var>XmlDoc</var> nor to validate the signature on a CRL. </li>
	</ul>		</ul>

Line 84:		Line 82:
	...		...
	</CertificateList>		</CertificateList>
	</p>		</p></li>

	<li>If you have a web port from which you can get a CRL, you might do something like this:		<li>If you have a web port from which you can get a CRL, you might do something like this:
Line 90:		Line 88:
	%httpResponse = %httpRequest:[[Get (HttpRequest function)\|Get]]		%httpResponse = %httpRequest:[[Get (HttpRequest function)\|Get]]
	%doc = %httpResponse:X509CrlToXmlDoc </p>		%doc = %httpResponse:X509CrlToXmlDoc </p>
	'''Note:''' Janus will not validate a signature on a CRL returned by a <var>Get</var>.		<p class="note">'''Note:''' Janus will not validate a signature on a CRL returned by a <var>Get</var>. </p></li>
	</ol>		</ol>

JAL: /* Examples */ typo

2016-06-03T23:03:43Z

Examples: typo

← Older revision		Revision as of 23:03, 3 June 2016
Line 35:		Line 35:

	The result is shown in part below:		The result is shown in part below:
	<p class="code">		<p class="code"><CertificateList>
	<CertificateList>
	<tbsCertList>		<tbsCertList>
	<signature>		<signature>

JAL: /* See also */ add item

2016-05-16T21:19:00Z

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

2016-03-15T23:33:17Z

See also: add template for SL crypto methods

← Older revision		Revision as of 23:33, 15 March 2016
Line 95:		Line 95:

	==See also==		==See also==
	~~Related~~ methods:		<p>
			<var>String</var> methods:</p>
	<ul>		<ul>
	<li><var>String</var> class: <var>[[DerToXmlDoc_(String_function)\|DerToXmlDoc]]</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>[[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:53:36Z

See also: add mention of String cipher methods

← Older revision		Revision as of 20:53, 15 March 2016
Line 97:		Line 97:
	Related methods:		Related methods:
	<ul>		<ul>
	<li><var>String</var> class: <var>[[DerToXmlDoc_(String_function)\|DerToXmlDoc]]</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>[[DerToXmlDoc_(String_function)\|DerToXmlDoc]]</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>
Line 105:		Line 105:
	<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>

JAL: /* See also */ typo

2016-03-14T20:04:23Z

ELowell at 23:13, 3 September 2015

2015-09-03T23:13:10Z

← Older revision		Revision as of 23:13, 3 September 2015
Line 1:		Line 1:
	{{Template:String:X509CrlToXmlDoc subtitle}}		{{Template:String:X509CrlToXmlDoc subtitle}}

	X509 is a general authentication framework that establishes standard formats for for public-key certificates, certificate revocation list (CRLs), and more. <var>X509CrlToXmlDoc</var> converts a string (<var>Longstring</var>) that contains a CRL 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.		X509 is a general authentication framework that establishes standard formats for for public-key certificates, certificate revocation list (CRLs), and more. <var>X509CrlToXmlDoc</var> converts a string (<var>Longstring</var>) that contains a CRL 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.

Line 107:		Line 106:
	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:X509CrlToXmlDoc footer}}		{{Template:String:X509CrlToXmlDoc footer}}

← Older revision		Revision as of 15:09, 6 September 2018
Line 100:		Line 100:

	<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:19, 16 May 2016
Line 99:		Line 99:
	<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:04, 14 March 2016
Line 97:		Line 97:
	Related methods:		Related methods:
	<ul>		<ul>
	<li><var>String</var> class: <var>[[DerToXmlDoc_(String_function)\|DerToXmlDoc]]</var>, <var>[[X509CertificateToXmlDoc_(String_function)\|X509CertificateToXmlDoc]]</var>, ~~and~~ <var>[[RSAPrivateKeyToXmlDoc _(~~String_function~~)\|RSAPrivateKeyToXmlDoc]]</var>		<li><var>String</var> class: <var>[[DerToXmlDoc_(String_function)\|DerToXmlDoc]]</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>

← Older revision		Revision as of 17:00, 22 August 2016
Line 117:		Line 117:
	<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>