ClientCertificate (System function)

From m204wiki
Revision as of 20:25, 4 November 2011 by JAL2 (talk | contribs)
Jump to navigation Jump to search

Get client certificate (System class)

[Introduced in Sirius Mods 8.0]

The ClientCertificate function returns to a Janus server a longstring that contains the binary content of a client SSL certificate.

RequestCertificate=True indicates that if the port definition does not have SSLCLCERT or SLCLCERTR (client certificate requested at connection time), a certificate is requested from the client at the time of the method call.

If no client certificate is present (possibly because the port is not using SSL), the ClientCertificate method returns a null string.

Syntax

%string = %(System):ClientCertificate[( [RequestCertificate= boolean])] Throws NotJanusConnection

Syntax terms

%string This Longstring contains the binary content of the SSL certificate presented by this server's client.
%(System) The class name in parentheses denotes a shared method. String can also be invoked via a System object variable, which may be null.
RequestCertificate This name required argument is a Boolean enumeration. The argument defaults to False, which results .

Usage notes

  • This method can be used only on a Janus Web Server, Janus Telnet Server, or Janus Sockets Server thread. If used on any other kind of thread, it throws a NotJanusConnection exception.

NotJanusConnection is a new exception class that has no members other than the New constructor.

See also