Perl

Client Certificate in REST

See more REST Examples

Demonstrates how to use a client certificate with a REST connection. Chilkat2 Perl

use strict;
use warnings;
use Chilkat2;

# 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.
my $rest = Chilkat2::Rest->new;
my $socket = Chilkat2::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.
my $success = $socket->SetSslClientCertPfx('/home/bob/pfxFiles/myClientSideCertWithPrivateKey.pfx', 'pfxPassword');
if (!$success) {
    print $socket->LastErrorText, "\n";
    exit;
}

# 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).
my $bTls = 1;
my $port = 443;
my $maxWaitMs = 5000;
$success = $socket->Connect('www.example.com', $port, $bTls, $maxWaitMs);
if (!$success) {
    print 'Connect Failure Error Code: ', $socket->ConnectFailReason, "\n";
    print $socket->LastErrorText, "\n";
    exit;
}

my $bAutoReconnect = 1;

# Use the connection:
$success = $rest->UseConnection($socket, $bAutoReconnect);
if (!$success) {
    print $rest->LastErrorText, "\n";
    exit;
}

# At this point we are connected and can make REST calls...
# For example..
my $responseJson = $rest->FullRequestNoBody('GET', '/someQuery');
if (!$rest->LastMethodSuccess) {
    print $rest->LastErrorText, "\n";
    exit;
}