Blame doc/examples/ex-client-x509-3.1.c

Packit aea12f
/* This example code is placed in the public domain. */
Packit aea12f
Packit aea12f
#ifdef HAVE_CONFIG_H
Packit aea12f
#include <config.h>
Packit aea12f
#endif
Packit aea12f
Packit aea12f
#include <stdio.h>
Packit aea12f
#include <stdlib.h>
Packit aea12f
#include <string.h>
Packit aea12f
#include <assert.h>
Packit aea12f
#include <gnutls/gnutls.h>
Packit aea12f
#include <gnutls/x509.h>
Packit aea12f
#include "examples.h"
Packit aea12f
Packit aea12f
/* A very basic TLS client, with X.509 authentication and server certificate
Packit aea12f
 * verification utilizing the GnuTLS 3.1.x API. 
Packit aea12f
 * Note that error recovery is minimal for simplicity.
Packit aea12f
 */
Packit aea12f
Packit aea12f
#define CHECK(x) assert((x)>=0)
Packit aea12f
#define LOOP_CHECK(rval, cmd) \
Packit aea12f
        do { \
Packit aea12f
                rval = cmd; \
Packit aea12f
        } while(rval == GNUTLS_E_AGAIN || rval == GNUTLS_E_INTERRUPTED); \
Packit aea12f
        assert(rval >= 0)
Packit aea12f
Packit aea12f
#define MAX_BUF 1024
Packit aea12f
#define CAFILE "/etc/ssl/certs/ca-certificates.crt"
Packit aea12f
#define MSG "GET / HTTP/1.0\r\n\r\n"
Packit aea12f
Packit aea12f
extern int tcp_connect(void);
Packit aea12f
extern void tcp_close(int sd);
Packit aea12f
static int _verify_certificate_callback(gnutls_session_t session);
Packit aea12f
Packit aea12f
int main(void)
Packit aea12f
{
Packit aea12f
        int ret, sd, ii;
Packit aea12f
        gnutls_session_t session;
Packit aea12f
        char buffer[MAX_BUF + 1];
Packit aea12f
        gnutls_certificate_credentials_t xcred;
Packit aea12f
Packit aea12f
        if (gnutls_check_version("3.1.4") == NULL) {
Packit aea12f
                fprintf(stderr, "GnuTLS 3.1.4 or later is required for this example\n");
Packit aea12f
                exit(1);
Packit aea12f
        }
Packit aea12f
Packit aea12f
        CHECK(gnutls_global_init());
Packit aea12f
Packit aea12f
        /* X509 stuff */
Packit aea12f
        CHECK(gnutls_certificate_allocate_credentials(&xcred));
Packit aea12f
Packit aea12f
        /* sets the trusted cas file
Packit aea12f
         */
Packit aea12f
        CHECK(gnutls_certificate_set_x509_trust_file(xcred, CAFILE,
Packit aea12f
                                                     GNUTLS_X509_FMT_PEM));
Packit aea12f
        gnutls_certificate_set_verify_function(xcred,
Packit aea12f
                                               _verify_certificate_callback);
Packit aea12f
Packit aea12f
        /* If client holds a certificate it can be set using the following:
Packit aea12f
         *
Packit aea12f
         gnutls_certificate_set_x509_key_file (xcred, 
Packit aea12f
         "cert.pem", "key.pem", 
Packit aea12f
         GNUTLS_X509_FMT_PEM); 
Packit aea12f
         */
Packit aea12f
Packit aea12f
        /* Initialize TLS session 
Packit aea12f
         */
Packit aea12f
        CHECK(gnutls_init(&session, GNUTLS_CLIENT));
Packit aea12f
Packit aea12f
        gnutls_session_set_ptr(session, (void *) "www.example.com");
Packit aea12f
Packit aea12f
        gnutls_server_name_set(session, GNUTLS_NAME_DNS, "www.example.com",
Packit aea12f
                               strlen("www.example.com"));
Packit aea12f
Packit aea12f
        /* use default priorities */
Packit aea12f
        CHECK(gnutls_set_default_priority(session));
Packit aea12f
#if 0
Packit aea12f
	/* if more fine-graned control is required */
Packit aea12f
        ret = gnutls_priority_set_direct(session, 
Packit aea12f
                                         "NORMAL", &err;;
Packit aea12f
        if (ret < 0) {
Packit aea12f
                if (ret == GNUTLS_E_INVALID_REQUEST) {
Packit aea12f
                        fprintf(stderr, "Syntax error at: %s\n", err);
Packit aea12f
                }
Packit aea12f
                exit(1);
Packit aea12f
        }
Packit aea12f
#endif
Packit aea12f
Packit aea12f
        /* put the x509 credentials to the current session
Packit aea12f
         */
Packit aea12f
        CHECK(gnutls_credentials_set(session, GNUTLS_CRD_CERTIFICATE, xcred));
Packit aea12f
Packit aea12f
        /* connect to the peer
Packit aea12f
         */
Packit aea12f
        sd = tcp_connect();
Packit aea12f
Packit aea12f
        gnutls_transport_set_int(session, sd);
Packit aea12f
        gnutls_handshake_set_timeout(session,
Packit aea12f
                                     GNUTLS_DEFAULT_HANDSHAKE_TIMEOUT);
Packit aea12f
Packit aea12f
        /* Perform the TLS handshake
Packit aea12f
         */
Packit aea12f
        do {
Packit aea12f
                ret = gnutls_handshake(session);
Packit aea12f
        }
Packit aea12f
        while (ret < 0 && gnutls_error_is_fatal(ret) == 0);
Packit aea12f
Packit aea12f
        if (ret < 0) {
Packit aea12f
                fprintf(stderr, "*** Handshake failed\n");
Packit aea12f
                gnutls_perror(ret);
Packit aea12f
                goto end;
Packit aea12f
        } else {
Packit aea12f
                char *desc;
Packit aea12f
Packit aea12f
                desc = gnutls_session_get_desc(session);
Packit aea12f
                printf("- Session info: %s\n", desc);
Packit aea12f
                gnutls_free(desc);
Packit aea12f
        }
Packit aea12f
Packit aea12f
        LOOP_CHECK(ret, gnutls_record_send(session, MSG, strlen(MSG)));
Packit aea12f
Packit aea12f
        LOOP_CHECK(ret, gnutls_record_recv(session, buffer, MAX_BUF));
Packit aea12f
        if (ret == 0) {
Packit aea12f
                printf("- Peer has closed the TLS connection\n");
Packit aea12f
                goto end;
Packit aea12f
        } else if (ret < 0 && gnutls_error_is_fatal(ret) == 0) {
Packit aea12f
                fprintf(stderr, "*** Warning: %s\n", gnutls_strerror(ret));
Packit aea12f
        } else if (ret < 0) {
Packit aea12f
                fprintf(stderr, "*** Error: %s\n", gnutls_strerror(ret));
Packit aea12f
                goto end;
Packit aea12f
        }
Packit aea12f
Packit aea12f
        if (ret > 0) {
Packit aea12f
                printf("- Received %d bytes: ", ret);
Packit aea12f
                for (ii = 0; ii < ret; ii++) {
Packit aea12f
                        fputc(buffer[ii], stdout);
Packit aea12f
                }
Packit aea12f
                fputs("\n", stdout);
Packit aea12f
        }
Packit aea12f
Packit aea12f
        CHECK(gnutls_bye(session, GNUTLS_SHUT_RDWR));
Packit aea12f
Packit aea12f
      end:
Packit aea12f
Packit aea12f
        tcp_close(sd);
Packit aea12f
Packit aea12f
        gnutls_deinit(session);
Packit aea12f
Packit aea12f
        gnutls_certificate_free_credentials(xcred);
Packit aea12f
Packit aea12f
        gnutls_global_deinit();
Packit aea12f
Packit aea12f
        return 0;
Packit aea12f
}
Packit aea12f
Packit aea12f
/* This function will verify the peer's certificate, and check
Packit aea12f
 * if the hostname matches, as well as the activation, expiration dates.
Packit aea12f
 */
Packit aea12f
static int _verify_certificate_callback(gnutls_session_t session)
Packit aea12f
{
Packit aea12f
        unsigned int status;
Packit aea12f
        int type;
Packit aea12f
        const char *hostname;
Packit aea12f
        gnutls_datum_t out;
Packit aea12f
Packit aea12f
        /* read hostname */
Packit aea12f
        hostname = gnutls_session_get_ptr(session);
Packit aea12f
Packit aea12f
        /* This verification function uses the trusted CAs in the credentials
Packit aea12f
         * structure. So you must have installed one or more CA certificates.
Packit aea12f
         */
Packit aea12f
Packit aea12f
        CHECK(gnutls_certificate_verify_peers3(session, hostname,
Packit aea12f
					       &status));
Packit aea12f
Packit aea12f
        type = gnutls_certificate_type_get(session);
Packit aea12f
Packit aea12f
        CHECK(gnutls_certificate_verification_status_print(status, type,
Packit aea12f
                                                           &out, 0));
Packit aea12f
Packit aea12f
        printf("%s", out.data);
Packit aea12f
Packit aea12f
        gnutls_free(out.data);
Packit aea12f
Packit aea12f
        if (status != 0)        /* Certificate is not trusted */
Packit aea12f
                return GNUTLS_E_CERTIFICATE_ERROR;
Packit aea12f
Packit aea12f
        /* notify gnutls to continue handshake normally */
Packit aea12f
        return 0;
Packit aea12f
}