Lua

Client Certificate in REST

See more REST Examples

Demonstrates how to use a client certificate with a REST connection. Lua

local chilkat = require("chilkat")

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

-- This example shows how to use the Chilkat socket object's connection.
local rest = chilkat.Rest.new()
local socket = chilkat.Socket.new()

-- Set the certificate to be used for mutual TLS authentication
-- (i.e. sets the client-side certificate for two-way TLS authentication)
-- Note: There are other ways to set the client certificate using Chilkat.
-- For example, on Windows systems, a Chilkat certificate object could be loaded with certificate
-- pre-installed (with private key) in a Windows certificate store, and then socket.SetSslClientCert could be called.
local success = socket:set_ssl_client_cert_pfx("/home/bob/pfxFiles/myClientSideCertWithPrivateKey.pfx", "pfxPassword")
if not success then
    print(socket.last_error_text)
    return
end

-- Note: The certificate used for the client-side of TLS mutual authentication
-- must have the associated private key available. (.pfx/.p12 files typically store both
-- the certificate and associated private key.)

-- Establish the connection using the socket object (with client certificate authentication).
local bTls = true
local port = 443
local maxWaitMs = 5000
success = socket:connect("www.example.com", port, bTls, maxWaitMs)
if not success then
    print("Connect Failure Error Code: " .. socket.connect_fail_reason)
    print(socket.last_error_text)
    return
end

local bAutoReconnect = true

-- Use the connection:
success = rest:use_connection(socket, bAutoReconnect)
if not success then
    print(rest.last_error_text)
    return
end

-- At this point we are connected and can make REST calls...
-- For example..
local responseJson = rest:full_request_no_body("GET", "/someQuery")
if not rest.last_method_success then
    print(rest.last_error_text)
    return
end