$Sock Cert Levels - Revision history

JAL: link repair

2016-06-01T19:06:49Z

link repair

← Older revision		Revision as of 19:06, 1 June 2016
Line 30:		Line 30:
	Since all certificates accepted by <var class="product">Janus Network Security</var> must be signed, <var>$Sock_Cert_Levels</var> is always greater than or equal to 2, if non-zero. Level 3 indicates a certificate that includes an intermediate certificate.		Since all certificates accepted by <var class="product">Janus Network Security</var> must be signed, <var>$Sock_Cert_Levels</var> is always greater than or equal to 2, if non-zero. Level 3 indicates a certificate that includes an intermediate certificate.

	For information on the data that can be retrieved for each certificate level see <var>[[$Sock_Cert_Info]]</var>. To learn more about client certificates, see ~~the <var class="book">~~[[~~Media:JansslrNew.pdf\|~~Janus Network Security ~~Reference Manual~~]]~~</var>~~. </li>		For information on the data that can be retrieved for each certificate level see <var>[[$Sock_Cert_Info]]</var>. To learn more about client certificates, see [[Janus Network Security]]. </li>

	<li><var>$Sock_Cert_Levels</var> returns the value -1 if the socket is not open and <code>ONRESET CONTINUE</code> is in effect for the socket. </li>		<li><var>$Sock_Cert_Levels</var> returns the value -1 if the socket is not open and <code>ONRESET CONTINUE</code> is in effect for the socket. </li>

JAL: remove "Sirius"

2016-05-25T19:13:58Z

remove "Sirius"

← Older revision		Revision as of 19:13, 25 May 2016
Line 1:		Line 1:
	{{DISPLAYTITLE:$Sock_Cert_Levels}}		{{DISPLAYTITLE:$Sock_Cert_Levels}}
	<span class="pageSubtitle">Number of levels in partner's certificate</span>		<span class="pageSubtitle">Number of levels in partner's certificate</span>
	<p class="warn"><b>Note: </b>Most ~~Sirius~~ $functions have been deprecated in favor of Object Oriented		<p class="warn"><b>Note: </b>Most $functions have been deprecated in favor of Object Oriented
	methods. The OO equivalent for <var>$Sock_Cert_Levels</var> is the <var>[[CertLevels (Socket function)\|CertLevels]]</var> method.</p>		methods. The OO equivalent for <var>$Sock_Cert_Levels</var> is the <var>[[CertLevels (Socket function)\|CertLevels]]</var> method.</p>

Line 11:		Line 11:

	===Syntax terms===		===Syntax terms===
	<table ~~class="syntaxTable"~~>		<table>
	<tr><th>%num</th>		<tr><th>%num</th>
	<td>The number of levels in the certificate provided by the remote partner. </td></tr>		<td>The number of levels in the certificate provided by the remote partner. </td></tr>

JAL: /* Usage notes */ link repair

2016-05-25T19:07:26Z

Usage notes: link repair

← Older revision		Revision as of 19:07, 25 May 2016
Line 22:		Line 22:
	<li>For an SSL connection where the client sent a certificate, <var>$Sock_Cert_Levels</var> will return a number greater than 0:		<li>For an SSL connection where the client sent a certificate, <var>$Sock_Cert_Levels</var> will return a number greater than 0:
	<ul>		<ul>
	<li>Level 0 of a certificate always contains the client information.		<li>Level 0 of a certificate always contains the client information. </li>
	<li>Level 1 contains the information for the "signer" of the client certificate.
	<li>Level 2 would contain information for the "signer" of the level 1 signer's certificate, and so on.		<li>Level 1 contains the information for the "signer" of the client certificate. </li>

			<li>Level 2 would contain information for the "signer" of the level 1 signer's certificate, and so on. </li>
	</ul>		</ul>
	Since all certificates accepted by <var class="product">Janus Network Security</var> must be signed, <var>$Sock_Cert_Levels</var> is always greater than or equal to 2, if non-zero. Level 3 indicates a certificate that includes an intermediate certificate.		Since all certificates accepted by <var class="product">Janus Network Security</var> must be signed, <var>$Sock_Cert_Levels</var> is always greater than or equal to 2, if non-zero. Level 3 indicates a certificate that includes an intermediate certificate.

	For information on the data that can be retrieved for each certificate level see <var>[[$Sock_Cert_Info]]</var>. To learn more about client certificates, see the <i>[~~http~~:~~//www.sirius-software.com/maint/download/jansslr~~.pdf Janus Network Security Reference Manual]</i>.		For information on the data that can be retrieved for each certificate level see <var>[[$Sock_Cert_Info]]</var>. To learn more about client certificates, see the <var class="book">[[Media:JansslrNew.pdf\|Janus Network Security Reference Manual]]</var>. </li>
	<li><var>$Sock_Cert_Levels</var> returns the value -1 if the socket is not open and <code>ONRESET CONTINUE</code> is in effect for the socket.
	<li>A <var>$Sock_Cert_Levels</var> call may cause an SSL renegotiation in order to request a digital certificate from the client. See [[$Sock_Cert_Info#renegotiate\|this]] <var>$Sock_Cert_Info</var> usage note.		<li><var>$Sock_Cert_Levels</var> returns the value -1 if the socket is not open and <code>ONRESET CONTINUE</code> is in effect for the socket. </li>

			<li>A <var>$Sock_Cert_Levels</var> call may cause an SSL renegotiation in order to request a digital certificate from the client. See [[$Sock_Cert_Info#renegotiate\|this]] <var>$Sock_Cert_Info</var> usage note. </li>
	</ul>		</ul>

JAL at 21:34, 23 July 2013

2013-07-23T21:34:46Z

← Older revision		Revision as of 21:34, 23 July 2013
Line 2:		Line 2:
	<span class="pageSubtitle">Number of levels in partner's certificate</span>		<span class="pageSubtitle">Number of levels in partner's certificate</span>
	<p class="warn"><b>Note: </b>Most Sirius $functions have been deprecated in favor of Object Oriented		<p class="warn"><b>Note: </b>Most Sirius $functions have been deprecated in favor of Object Oriented
	methods. ~~There is currently no direct~~ OO equivalent for ~~this~~ $function.</p>		methods. The OO equivalent for <var>$Sock_Cert_Levels</var> is the <var>[[CertLevels (Socket function)\|CertLevels]]</var> method.</p>

	<var>$Sock_Cert_Levels</var> retrieves the number of		<var>$Sock_Cert_Levels</var> retrieves the number of

JALWiccan: Automatically generated page update

2013-07-19T18:59:23Z

Automatically generated page update

← Older revision		Revision as of 18:59, 19 July 2013
Line 1:		Line 1:
	{{DISPLAYTITLE:$Sock_Cert_Levels}}		{{DISPLAYTITLE:$Sock_Cert_Levels}}
	<span class="pageSubtitle">Number of levels in partner's certificate</span>		<span class="pageSubtitle">Number of levels in partner's certificate</span>
	<p class="~~warning~~">Most Sirius $functions have been deprecated in favor of Object Oriented		<p class="warn"><b>Note: </b>Most Sirius $functions have been deprecated in favor of Object Oriented
	methods. There is currently no direct OO equivalent for this $function.</p>		methods. There is currently no direct OO equivalent for this $function.</p>

JAL2: /* Usage notes */

2012-01-20T03:09:29Z

Usage notes

← Older revision		Revision as of 03:09, 20 January 2012
Line 30:		Line 30:
	For information on the data that can be retrieved for each certificate level see <var>[[$Sock_Cert_Info]]</var>. To learn more about client certificates, see the <i>[http://www.sirius-software.com/maint/download/jansslr.pdf Janus Network Security Reference Manual]</i>.		For information on the data that can be retrieved for each certificate level see <var>[[$Sock_Cert_Info]]</var>. To learn more about client certificates, see the <i>[http://www.sirius-software.com/maint/download/jansslr.pdf Janus Network Security Reference Manual]</i>.
	<li><var>$Sock_Cert_Levels</var> returns the value -1 if the socket is not open and <code>ONRESET CONTINUE</code> is in effect for the socket.		<li><var>$Sock_Cert_Levels</var> returns the value -1 if the socket is not open and <code>ONRESET CONTINUE</code> is in effect for the socket.
	<li>A $Sock_Cert_Levels call may cause an SSL renegotiation in order to request a digital certificate from the client. See [[$Sock_Cert_Info#renegotiate\|this]] <var>$Sock_Cert_Info</var> usage note.		<li>A <var>$Sock_Cert_Levels</var> call may cause an SSL renegotiation in order to request a digital certificate from the client. See [[$Sock_Cert_Info#renegotiate\|this]] <var>$Sock_Cert_Info</var> usage note.
	</ul>		</ul>

Admin: 1 revision

2012-01-20T02:53:45Z

1 revision

← Older revision	Revision as of 02:53, 20 January 2012
(No difference)

JAL: /* Usage notes */

2012-01-20T01:14:12Z

Usage notes

New page

{{DISPLAYTITLE:$Sock_Cert_Levels}}
Number of levels in partner's certificate
Most Sirius $functions have been deprecated in favor of Object Oriented
methods. There is currently no direct OO equivalent for this $function.

<var>$Sock_Cert_Levels</var> retrieves the number of
levels of the certificate provided on a socket by the remote partner.

==Syntax==
%num = $Sock_Cert_Levels(socket) 

===Syntax terms===
<table class="syntaxTable">
<tr><th>%num</th>
<td>The number of levels in the certificate provided by the remote partner. </td></tr>
<tr><th>socket</th>
<td>A string that is the socket identifier.</td></tr>
</table>

==Usage notes==
<ul>
<li>For an SSL connection where the client sent a certificate, <var>$Sock_Cert_Levels</var> will return a number greater than 0:
<ul>
<li>Level 0 of a certificate always contains the client information.
<li>Level 1 contains the information for the "signer" of the client certificate.
<li>Level 2 would contain information for the "signer" of the level 1 signer's certificate, and so on.
</ul>
Since all certificates accepted by <var class="product">Janus Network Security</var> must be signed, <var>$Sock_Cert_Levels</var> is always greater than or equal to 2, if non-zero. Level 3 indicates a certificate that includes an intermediate certificate.

For information on the data that can be retrieved for each certificate level see <var>[[$Sock_Cert_Info]]</var>. To learn more about client certificates, see the [http://www.sirius-software.com/maint/download/jansslr.pdf Janus Network Security Reference Manual].
<li><var>$Sock_Cert_Levels</var> returns the value -1 if the socket is not open and <code>ONRESET CONTINUE</code> is in effect for the socket.
<li>A $Sock_Cert_Levels call may cause an SSL renegotiation in order to request a digital certificate from the client. See [[$Sock_Cert_Info#renegotiate|this]] <var>$Sock_Cert_Info</var> usage note.
</ul>

==Example==
The following statement returns the number of levels of the certificate received from the partner using the server socket (<var>[[JANUS SRVSOCK|SRVSOCK]]</var>):
%count = $Sock_Cert_Levels(1) 

[[Category: Janus Sockets $functions]]