ClientCertificate (XmlDoc function) - Revision history

JAL: /* Example */ minoir formatting

2016-05-25T18:48:13Z

Example: minoir formatting

← Older revision		Revision as of 18:48, 25 May 2016
Line 118:		Line 118:

	A sample result follows:		A sample result follows:
	<p class="~~code~~">		<p class="output"><subject>
	<subject>
	<commonName>USER</commonName>		<commonName>USER</commonName>
	<organizationalUnit>Local Services</organizationalUnit>		<organizationalUnit>Local Services</organizationalUnit>

JAL at 16:00, 25 August 2014

2014-08-25T16:00:31Z

JAL2 at 21:15, 19 June 2012

2012-06-19T21:15:19Z

← Older revision		Revision as of 21:15, 19 June 2012
Line 22:		Line 22:
	<td>This [[Notation conventions for methods#Named parameters\|name required]] argument (<tt>AttributeValues</tt>) is a <var>[[Boolean enumeration\|Boolean]]</var> value that indicates whether certificate detail values are to be displayed as text or as value attributes within their XML document elements.		<td>This [[Notation conventions for methods#Named parameters\|name required]] argument (<tt>AttributeValues</tt>) is a <var>[[Boolean enumeration\|Boolean]]</var> value that indicates whether certificate detail values are to be displayed as text or as value attributes within their XML document elements.

	For example, <code><serialNumber>016437FF8A</serialNumber></code> is text format,		For example, <code><serialNumber>016437FF8A</serialNumber></code> is text format,
	and <code><serialNumber value="016437FF8A"/></code> is attribute-value format.		and <code><serialNumber value="016437FF8A"/></code> is attribute-value format.

JAL2 at 21:10, 19 June 2012

2012-06-19T21:10:34Z

Show changes

JALWiccan: 1 revision

2012-06-19T20:55:37Z

1 revision

← Older revision	Revision as of 20:55, 19 June 2012
(No difference)

JALWiccan: 1 revision

2012-06-19T20:55:36Z

1 revision

← Older revision		Revision as of 20:55, 19 June 2012
Line 180:		Line 180:
	<ul>		<ul>
	<li>The ClientCertificate method provides much of the functionality of functions		<li>The ClientCertificate method provides much of the functionality of functions
	in <var class="product">[[Janus Web Server]]</var> ($Web_Cert_Info and $Web_Cert_Levels) and [[Janus Sockets]]		in <var class="product">[[Janus Web Server]]</var> ($Web_Cert_Info and $Web_Cert_Levels) and <var class="product">[[Janus Sockets]]</var>
	($Sock_Cert_Info and $Sock_Cert_Levels).		($Sock_Cert_Info and $Sock_Cert_Levels).
	</ul>		</ul>

JALWiccan: 1 revision

2012-06-19T20:54:45Z

1 revision

← Older revision	Revision as of 20:54, 19 June 2012
(No difference)

JALWiccan: 1 revision

2012-06-19T20:54:44Z

1 revision

← Older revision		Revision as of 20:54, 19 June 2012
Line 180:		Line 180:
	<ul>		<ul>
	<li>The ClientCertificate method provides much of the functionality of functions		<li>The ClientCertificate method provides much of the functionality of functions
	in [[Janus Web Server]] ($Web_Cert_Info and $Web_Cert_Levels) and [[Janus Sockets]]		in <var class="product">[[Janus Web Server]]</var> ($Web_Cert_Info and $Web_Cert_Levels) and [[Janus Sockets]]
	($Sock_Cert_Info and $Sock_Cert_Levels).		($Sock_Cert_Info and $Sock_Cert_Levels).
	</ul>		</ul>

JALWiccan: 1 revision

2012-06-19T20:49:49Z

1 revision

← Older revision	Revision as of 20:49, 19 June 2012
(No difference)

JAL2 at 20:49, 19 June 2012

2012-06-19T20:49:48Z

← Older revision		Revision as of 20:49, 19 June 2012
Line 6:		Line 6:
	The <var>XmlDoc</var> includes details about the client and about the certificate's signer.		The <var>XmlDoc</var> includes details about the client and about the certificate's signer.

	The <var>ClientCertificate</var> method is new as of version 7.5 of the ''Sirius Mods''.		The <var>ClientCertificate</var> method is new as of version 7.5 of the <var class="product">Sirius Mods</var>.

	==Syntax==		==Syntax==
Line 66:		Line 66:
	The information method can be used anywhere:		The information method can be used anywhere:
	no information in the client certificate is considered "secure."		no information in the client certificate is considered "secure."
	<li>As of ''Sirius Mods'' 7.7,		<li>As of <var class="product">Sirius Mods</var> 7.7,
	if a Janus SSL server program issues the ClientCertificate method, the returned		if a Janus SSL server program issues the ClientCertificate method, the returned
	XmlDoc will be Null if		XmlDoc will be Null if

← Older revision		Revision as of 16:00, 25 August 2014
Line 17:		Line 17:

	<tr><th nowrap="true"><var>[%(XmlDoc):]</var></th>		<tr><th nowrap="true"><var>[%(XmlDoc):]</var></th>
	<td>The optional class name in parentheses denotes a [[Notation conventions for methods#Shared methods\|virtual constructor]] method. See [[#Usage notes\|"Usage notes"]], below, for more information about invoking an <var>XmlDoc</var> virtual constructor.</td></tr>		<td>The optional class name in parentheses denotes a [[Notation conventions for methods#Shared methods\|virtual constructor]] method. See [[#Usage notes\|Usage notes]], below, for more information about invoking an <var>XmlDoc</var> virtual constructor.</td></tr>

	<tr><th nowrap><var>AttributeValues</var></th>		<tr><th nowrap><var>AttributeValues</var></th>
Line 53:		Line 53:

	%doc = %doc:ClientCertificate		%doc = %doc:ClientCertificate
	</p>		</p></li>

	<li>The <var>XmlDoc</var> object produced by the <var>ClientCertificate</var> method is <var>Null</var> if:		<li>The <var>XmlDoc</var> object produced by the <var>ClientCertificate</var> method is <var>Null</var> if:
	<ul>		<ul>
	<li>The method is invoked in a scenario where there is no client certificate.		<li>The method is invoked in a scenario where there is no client certificate.</li>
	<li>The method is invoked when you are not logged in on a Janus server port.		<li>The method is invoked when you are not logged in on a Janus server port.</li>
	<li>The Janus port is not defined to use SSL.		<li>The Janus port is not defined to use SSL.</li>
	<li>The client did not provide a certificate.		<li>The client did not provide a certificate.</li>
	</ul>		</ul></li>

	<li>If your site is using client certificate authentication,		<li>If your site is using client certificate authentication,
	the information returned by this method is most useful in the server port's		the information returned by this method is most useful in the server port's
	<var>JANUS DEFINE NEWSESCMD</var> processing.		<var>JANUS DEFINE NEWSESCMD</var> processing.
	The information method can be used anywhere:		The information method can be used anywhere:
	no information in the client certificate is considered "secure."		no information in the client certificate is considered "secure." </li>

	<li>As of <var class="product">Sirius Mods</var> 7.7,		<li>As of <var class="product">Sirius Mods</var> 7.7,
	if a Janus SSL server program issues the <var>ClientCertificate</var> method, the returned		if a Janus SSL server program issues the <var>ClientCertificate</var> method, the returned
	<var>XmlDoc</var> will be <var>Null</var> if		<var>XmlDoc</var> will be <var>Null</var> if
	the server port definition includes the <var>[[SSLCLCERT]]</var> or <var>[[SSLCLCERTR]]</var> parameter.		the server port definition includes the <var>[[SSLCLCERT and SSLCLCERTR\|SSLCERT]]</var> or <var>[[SSLCLCERT and SSLCLCERTR\|SSLCLCERTR]]</var> parameter.
	Those <var>[[JANUS DEFINE]]</var> parameters cause a request for a client certificate in the		Those <var>[[JANUS DEFINE]]</var> parameters cause a request for a client certificate in the
	initial server-client handshake that establishes the SSL connection.		initial server-client handshake that establishes the SSL connection.
Line 95:		Line 98:
	<ul>		<ul>
	<li>There is no reason a client would not return a certificate on an initial		<li>There is no reason a client would not return a certificate on an initial
	renegotiation, but return a certificate on a later renegotiation.		renegotiation, but return a certificate on a later renegotiation. </li>

	<li>There is no reason a client would return a certificate on an initial renegotiation, then		<li>There is no reason a client would return a certificate on an initial renegotiation, then
	return a different client certificate on a subsequent SSL renegotiation.		return a different client certificate on a subsequent SSL renegotiation. </li>
	</ul>		</ul></li>

	<li>The <var>ClientCertificate</var> method provides much of the functionality of functions		<li>The <var>ClientCertificate</var> method provides much of the functionality of functions
	in <var class="product">[[Janus Web Server]]</var> (<var>[[$Web_Cert_Info]]</var> and <var>[[$Web_Cert_Levels]]</var>) and <var class="product">[[Janus Sockets]]</var> (<var>[[$Sock_Cert_Info]]</var> and <var>[[$Sock_Cert_Levels]]</var>).		in <var class="product">[[Janus Web Server]]</var> (<var>[[$Web_Cert_Info]]</var> and <var>[[$Web_Cert_Levels]]</var>) and <var class="product">[[Janus Sockets]]</var> (<var>[[$Sock_Cert_Info]]</var> and <var>[[$Sock_Cert_Levels]]</var>). </li>
	</ul>		</ul>