Zig Requires Chilkat v11.0.0+

SSL Server Example

See more Socket/SSL/TLS Examples

Demonstrates how to create an SSL socket for accepting connections. This example is *very* simple in that it will create an SSL socket for accepting a single connection. It will read a message from the client, send a reply, and exit. Zig

const std = @import("std");
const chilkat = @import("chilkat");

pub fn main(init: std.process.Init) !void {
    const alloc = init.arena.allocator();

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

    const listen_ssl_socket = try chilkat.Socket.init();
    defer listen_ssl_socket.deinit();

    // An SSL server needs a digital certificate.  This example loads it from a PFX file.

    // Create an instance of a certificate store object, load a PFX file,
    // locate the certificate we need, and use it.
    // (a PFX file may contain more than one certificate.)
    const cert_store = try chilkat.CertStore.init();
    defer cert_store.deinit();
    // The 1st argument is the filename, the 2nd arg is the
    // PFX file's password:
    cert_store.loadPfxFile("chilkat.pfx", "test") catch {
        std.debug.print("{s}\n", .{try cert_store.getLastErrorText(alloc)});
        return;
    };

    // Find the certificate to be used for SSL:
    const json_cn = try chilkat.JsonObject.init();
    defer json_cn.deinit();
    json_cn.updateString("CN", "example.com") catch {};

    const cert = try chilkat.Cert.init();
    defer cert.deinit();
    cert_store.findCert(json_cn, cert) catch {
        std.debug.print("{s}\n", .{try cert_store.getLastErrorText(alloc)});
        return;
    };

    // Use the certificate:
    listen_ssl_socket.initSslServer(cert) catch {
        std.debug.print("{s}\n", .{try listen_ssl_socket.getLastErrorText(alloc)});
        return;
    };

    // Bind and listen on a port:
    const my_port = 8123;
    // Allow for a max of 5 queued connect requests.
    const back_log = 5;
    listen_ssl_socket.bindAndListen(my_port, back_log) catch {
        std.debug.print("{s}\n", .{try listen_ssl_socket.getLastErrorText(alloc)});
        return;
    };

    // If accepting an SSL/TLS connection, the SSL handshake is part of the connection
    // establishment process. This involves a few back-and-forth messages between the
    // client and server to establish algorithms and a shared key to create the secure
    // channel. The sending and receiving of these messages are governed by the
    // MaxReadIdleMs and MaxSendIdleMs properties. If these properties are set to 0
    // (and this is the default unless changed by your application), then the
    // AcceptNext can hang indefinitely during the SSL handshake process.
    // Make sure these properties are set to appropriate values before calling AcceptNext.

    // Set a 10 second max for waiting to read/write.  This is for the SSL/TLS handshake establishment.
    listen_ssl_socket.setMaxReadIdleMs(10000);
    listen_ssl_socket.setMaxSendIdleMs(10000);

    // Accept a single client connection and establish the secure SSL/TLS channel:
    const max_wait_millisec = 20000;
    const client_sock = try chilkat.Socket.init();
    defer client_sock.deinit();
    listen_ssl_socket.acceptNext(max_wait_millisec, client_sock) catch {
        std.debug.print("{s}\n", .{try listen_ssl_socket.getLastErrorText(alloc)});
        return;
    };

    // The client (in this example) is going to send a "Hello Server! -EOM-"
    // message.  Read it:
    const received_msg = client_sock.receiveUntilMatch(alloc, "-EOM-") catch {
        std.debug.print("{s}\n", .{try client_sock.getLastErrorText(alloc)});
        return;
    };

    std.debug.print("{s}\n", .{received_msg});

    // Send a "Hello Client! -EOM-" message:
    client_sock.sendString("Hello Client! -EOM-") catch {
        std.debug.print("{s}\n", .{try client_sock.getLastErrorText(alloc)});
        return;
    };

    // Close the connection with the client
    // Wait a max of 20 seconds (20000 millsec)
    try client_sock.close(20000);
}