Lianja Requires Chilkat v11.0.0+

Examine Client Certificates for an Accepted TLS Connection

See more Socket/SSL/TLS Examples

Demonstrates how to access the client certificates for a TLS connection accepted by your application acting as the server. Lianja

llSuccess = .F.

//  This example requires the Chilkat API to have been previously unlocked.
//  See Global Unlock Sample for sample code.

loListenSslSocket = createobject("CkSocket")

//  An SSL/TLS server needs a digital certificate.  This example loads it from a PFX file.
//  This is the server's certificate.

loCert = createobject("CkCert")
llSuccess = loCert.LoadPfxFile("qa_data/serverCert/myServerCert.pfx","pfx_password")
if (llSuccess = .F.) then
    ? loCert.LastErrorText
    release loListenSslSocket
    release loCert
    return
endif

//  To accept client client certificates in the TLS handshake,
//  we must indicate a list of acceptable client certificate root CA DN's
//  that are allowed.  (DN is an acronym for Distinguished Name.)
//  Call AddSslAcceptableClientCaDn once for each acceptable CA DN.
//  Here are a few examples so you can see the general format of a DN.
loListenSslSocket.AddSslAcceptableClientCaDn("C=SE, O=AddTrust AB, OU=AddTrust External TTP Network, CN=AddTrust External CA Root")
loListenSslSocket.AddSslAcceptableClientCaDn("O=Digital Signature Trust Co., CN=DST Root CA X3")

//  Initialize with our server's TLS certificate.
llSuccess = loListenSslSocket.InitSslServer(loCert)
if (llSuccess = .F.) then
    ? loListenSslSocket.LastErrorText
    release loListenSslSocket
    release loCert
    return
endif

//  Bind and listen on a port:
lnMyPort = 8123
//  Allow for a max of 5 queued connect requests.
lnBackLog = 5
llSuccess = loListenSslSocket.BindAndListen(lnMyPort,lnBackLog)
if (llSuccess = .F.) then
    ? loListenSslSocket.LastErrorText
    release loListenSslSocket
    release loCert
    return
endif

//  Accept the next incoming connection.
lnMaxWaitMillisec = 20000

loClientSock = createobject("CkSocket")
llSuccess = loListenSslSocket.AcceptNext(lnMaxWaitMillisec,loClientSock)
if (llSuccess = .F.) then
    ? loListenSslSocket.LastErrorText
    release loListenSslSocket
    release loCert
    release loClientSock
    return
endif

//  Examine the client certs chain.  The 1st cert will be the client certificate, and
//  the subsequent certs will be the certs in the chain of authentication.
lnNumClientCerts = loClientSock.NumReceivedClientCerts
? "numClientCerts = " + str(lnNumClientCerts)

loClientCert = createobject("CkCert")
i = 0
do while i < lnNumClientCerts
    loClientSock.GetRcvdClientCert(i,loClientCert)
    ? loClientCert.SubjectDN
    i = i + 1
enddo

//  Close the connection with the client
llSuccess = loClientSock.Close(1000)


release loListenSslSocket
release loCert
release loClientSock
release loClientCert