Nilorea Library
C utilities for networking, threading, graphics
Loading...
Searching...
No Matches
ex_network_sni.c

MITM-style SNI accept: server mints a per-host leaf, client checks it and evaluates its trust.

MITM-style SNI accept: server mints a per-host leaf, client checks it and evaluates its trust

Author
Castagnier Mickael
Version
1.0
/*
* Nilorea Library
* Copyright (C) 2005-2026 Castagnier Mickael
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
* implied. See the License for the specific language governing
* permissions and limitations under the License.
*
* SPDX-License-Identifier: Apache-2.0
*/
#include "nilorea/n_log.h"
#include "nilorea/n_str.h"
#include "nilorea/n_x509.h"
#include <pthread.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <unistd.h>
#include <openssl/ssl.h>
#include <openssl/x509.h>
#define SNI_HOST "test.host.example"
#define MSG_LEN 18
typedef struct CA_CTX {
typedef struct SRV {
int ok;
} SRV;
/* Parse the -V LOG_LEVEL verbosity argument. */
void process_args(int argc, char** argv) {
int opt = 0;
while ((opt = getopt(argc, argv, "hvV:")) != EOF) {
switch (opt) {
case 'V':
if (!strncmp("LOG_NULL", optarg, 8))
else if (!strncmp("LOG_NOTICE", optarg, 10))
else if (!strncmp("LOG_INFO", optarg, 8))
else if (!strncmp("LOG_ERR", optarg, 7))
else if (!strncmp("LOG_DEBUG", optarg, 9))
else {
fprintf(stderr, "Unknown log level %s\n", optarg);
exit(1);
}
break;
case 'v':
fprintf(stderr, "ex_network_sni\n");
exit(1);
case 'h':
default:
fprintf(stderr, "usage: %s [-V LOG_LEVEL]\n", argv[0]);
break;
}
}
}
/* SNI pick callback: mint a leaf for the requested host signed by the CA. */
static int pick_cb(const char* sni, N_STR** cert_pem, N_STR** key_pem, void* user_data) {
CA_CTX* ca = (CA_CTX*)user_data;
const char* host = (sni && sni[0]) ? sni : "localhost";
n_log(LOG_DEBUG, "SNI pick for host '%s'", host);
return n_x509_mint_host_cert(host, ca->cert, ca->key, 825, cert_pem, key_pem);
}
/* Server thread: accept one SNI connection, echo one message, close. */
static void* server_fn(void* p) {
SRV* s = (SRV*)p;
if (c) {
char buf[64] = "";
char reply[] = "hello-from-server";
/* read exactly MSG_LEN, then reply MSG_LEN: recv_ssl_data waits for the
* full count, so both sides must agree on the size or they deadlock */
if (recv_ssl_data(c, buf, (uint32_t)MSG_LEN) > 0)
n_log(LOG_NOTICE, "server received: %s", buf);
send_ssl_data(c, reply, (uint32_t)MSG_LEN);
s->ok = 1;
}
return NULL;
}
/* Bind a loopback listening socket on the first free port in a range. */
static NETWORK* bind_free(char* port_out, size_t port_out_len) {
int p;
for (p = 18300; p < 18400; p++) {
NETWORK* l = NULL;
char ps[16];
snprintf(ps, sizeof(ps), "%d", p);
if (netw_make_listening(&l, "127.0.0.1", ps, 5, NETWORK_IPALL) == TRUE && l) {
snprintf(port_out, port_out_len, "%s", ps);
return l;
}
if (l)
}
return NULL;
}
int main(int argc, char** argv) {
CA_CTX ca = {NULL, NULL};
NETWORK* listen = NULL;
NETWORK* cli = NULL;
SRV srv;
pthread_t th;
char port[16] = "";
int failures = 0;
process_args(argc, argv);
/* initialize OpenSSL once in the main thread: the server and client threads
* both use TLS, and the lazy init guard is not synchronized */
if (n_x509_generate_ca("Nilorea SNI Test CA", 3650, &ca.cert, &ca.key) != 0 || !ca.cert || !ca.key) {
n_log(LOG_ERR, "CA generation failed");
return 1;
}
listen = bind_free(port, sizeof(port));
if (!listen) {
n_log(LOG_ERR, "could not bind a loopback port");
free_nstr(&ca.key);
return 1;
}
srv.listen = listen;
srv.ca = &ca;
srv.ok = 0;
pthread_create(&th, NULL, server_fn, &srv);
if (netw_ssl_connect_client_to(&cli, "127.0.0.1", port, NETWORK_IPALL, 5000) != TRUE || !cli) {
n_log(LOG_ERR, "client connect failed");
} else {
if (netw_ssl_do_handshake(cli, SNI_HOST) != TRUE) {
n_log(LOG_ERR, "client TLS handshake failed");
} else {
char msg[] = "hello-from-client";
char buf[64] = "";
X509* peer = NULL;
send_ssl_data(cli, msg, (uint32_t)MSG_LEN);
if (recv_ssl_data(cli, buf, (uint32_t)MSG_LEN) > 0)
n_log(LOG_NOTICE, "client received: %s", buf);
peer = SSL_get1_peer_certificate(cli->ssl);
if (!peer) {
n_log(LOG_ERR, "no server certificate presented");
} else {
char cn[256] = "";
X509_NAME_get_text_by_NID(X509_get_subject_name(peer), NID_commonName, cn, sizeof(cn));
n_log(LOG_NOTICE, "server presented a certificate with CN=%s", cn);
if (strcmp(cn, SNI_HOST) != 0) {
n_log(LOG_ERR, "certificate CN does not match the requested SNI host");
}
X509_free(peer);
}
{
char vrerr[128] = "";
int trusted = netw_ssl_get_verify_result(cli, SNI_HOST, vrerr, sizeof(vrerr));
/* the leaf is signed by a private test CA absent from the system
* trust store, so a trust evaluation must fail with a reason */
n_log(LOG_NOTICE, "verify result: trusted=%d reason='%s'", trusted, vrerr);
if (trusted != FALSE) {
n_log(LOG_ERR, "private-CA leaf was unexpectedly trusted");
}
if (vrerr[0] == '\0') {
n_log(LOG_ERR, "verify failure did not report a reason");
}
}
}
}
netw_close(&cli);
pthread_join(th, NULL);
if (!srv.ok) {
n_log(LOG_ERR, "server did not complete the exchange");
}
netw_close(&listen);
free_nstr(&ca.key);
if (failures) {
n_log(LOG_ERR, "ex_network_sni: %d failure(s)", failures);
return 1;
}
n_log(LOG_NOTICE, "ex_network_sni: all checks passed");
return 0;
}
static int failures
int main(void)
void process_args(int argc, char **argv)
Definition ex_common.c:48
N_STR * key
#define MSG_LEN
fixed exchange message length (both messages are 17 chars + NUL)
static void * server_fn(void *p)
N_STR * cert
NETWORK * listen
static NETWORK * bind_free(char *port_out, size_t port_out_len)
static int pick_cb(const char *sni, N_STR **cert_pem, N_STR **key_pem, void *user_data)
#define SNI_HOST
the host name the client requests via SNI
CA_CTX * ca
CA used by the server to mint per-host leaves.
server worker context
char * port
#define n_log(__LEVEL__,...)
Logging function wrapper to get line and func.
Definition n_log.h:89
#define LOG_DEBUG
debug-level messages
Definition n_log.h:84
#define LOG_ERR
error conditions
Definition n_log.h:76
void set_log_level(const int log_level)
Set the global log level value ( static int LOG_LEVEL )
Definition n_log.c:121
#define LOG_NOTICE
normal but significant condition
Definition n_log.h:80
#define LOG_NULL
no log output
Definition n_log.h:46
#define LOG_INFO
informational
Definition n_log.h:82
#define free_nstr(__ptr)
free a N_STR structure and set the pointer to NULL
Definition n_str.h:203
A box including a string and his lenght.
Definition n_str.h:61
int n_x509_generate_ca(const char *cn, int days, N_STR **ca_cert_pem, N_STR **ca_key_pem)
Generate a self-signed certificate authority (CA) keypair and cert.
Definition n_x509.c:171
int n_x509_mint_host_cert(const char *host, const N_STR *ca_cert_pem, const N_STR *ca_key_pem, int days, N_STR **leaf_cert_pem, N_STR **leaf_key_pem)
Mint a per-host leaf certificate signed by the given CA.
Definition n_x509.c:229
SSL * ssl
SSL handle.
Definition n_network.h:380
int netw_ssl_get_verify_result(NETWORK *netw, const char *expected_host, char *errbuf, size_t errsz)
evaluate the peer certificate of a completed TLS client connection
Definition n_network.c:1921
ssize_t send_ssl_data(void *netw, char *buf, uint32_t n)
send data onto the socket
Definition n_network.c:4409
int netw_ssl_set_verify(NETWORK *netw, int enable)
enable or disable SSL peer certificate verification
Definition n_network.c:1892
int netw_init_openssl(void)
Do not directly use, internal api.
Definition n_network.c:1333
ssize_t recv_ssl_data(void *netw, char *buf, uint32_t n)
recv data from the socket
Definition n_network.c:4504
int netw_make_listening(NETWORK **netw, char *addr, char *port, int nbpending, int ip_version)
Make a NETWORK be a Listening network.
Definition n_network.c:2885
int netw_ssl_do_handshake(NETWORK *netw, const char *sni_hostname)
Complete the SSL handshake on an already-connected NETWORK.
Definition n_network.c:2496
int netw_unload_openssl(void)
Do not directly use, internal api.
Definition n_network.c:1366
#define NETWORK_IPALL
Flag for auto detection by OS of ip version to use.
Definition n_network.h:48
int netw_ssl_connect_client_to(NETWORK **netw, char *host, char *port, int ip_version, int connect_timeout_ms)
Connect as an SSL client without providing a client certificate.
Definition n_network.c:2409
NETWORK * netw_accept_ssl_with_sni_cb(NETWORK *listen, netw_sni_pick_cb pick, void *user_data)
accept a TLS connection, selecting the server certificate per client SNI
Definition n_network.c:1846
int netw_close(NETWORK **netw)
Closing a specified Network, destroy queues, free the structure.
Definition n_network.c:2662
Structure of a NETWORK.
Definition n_network.h:309
Common headers and low-level functions & define.
Generic log system.
Network Engine.
N_STR and string function declaration.
X.509 helpers: self-signed CA generation and per-host leaf minting.