NATS Logo by Example

Mutual TLS in Embedded

This examples demonstrates a basic embedded server and client connection setup utilizing mTLS.

This example relies on the mkcert tool using the commands below to generate the necessary server and client certs. The CA is installed in the default location and symlinked for this example.

mkcert \
  -key-file key.pem \
  -cert-file cert.pem \
  localhost

mkcert \
  -client \
  -key-file client-key.pem \
  -cert-file client-cert.pem \
  localhost

ln -s /root/.local/share/mkcert/rootCA.pem ca.pem
CLI Go Python JavaScript Rust C# .NET V2 Java Ruby Elixir Crystal C
Jump to the output or the recording
$ nbe run embedded/mtls/go
View the source code or learn how to run this example yourself

Code

package main


import (
	"flag"
	"fmt"
	"log"
	"time"


	"github.com/nats-io/nats-server/v2/server"
	"github.com/nats-io/nats.go"
)


func main() {
	var (
		host           string
		port           int
		certFile       string
		keyFile        string
		clientCertFile string
		clientKeyFile  string
		caFile         string
	)


	flag.StringVar(&host, "host", "localhost", "Client connection host/IP.")
	flag.IntVar(&port, "port", 4222, "Client connection port.")
	flag.StringVar(&certFile, "tls.cert.server", "cert.pem", "TLS cert file.")
	flag.StringVar(&keyFile, "tls.key.server", "key.pem", "TLS key file.")
	flag.StringVar(&caFile, "tls.ca", "ca.pem", "TLS CA file.")
	flag.StringVar(&clientCertFile, "tls.cert.client", "client-cert.pem", "TLS cert file.")
	flag.StringVar(&clientKeyFile, "tls.key.client", "client-key.pem", "TLS key file.")


	flag.Parse()


	serverTlsConfig, err := server.GenTLSConfig(&server.TLSConfigOpts{
		CertFile: certFile,
		KeyFile:  keyFile,
		CaFile:   caFile,
		Verify:   true,
		Timeout:  2,
	})
	if err != nil {
		log.Fatalf("tls config: %v", err)
	}

Setup the embedded server options.

	opts := server.Options{
		Host:      host,
		Port:      port,
		TLSConfig: serverTlsConfig,
	}

Initialize a new server with the options.

	ns, err := server.NewServer(&opts)
	if err != nil {
		log.Fatalf("server init: %v", err)
	}

Start the server.

	go ns.Start()
	defer ns.Shutdown()


	time.Sleep(time.Second)

Create a client connection.

	nc, err := nats.Connect(
		fmt.Sprintf("tls://%s:%d", host, port),
		nats.RootCAs(caFile),
		nats.ClientCert(clientCertFile, clientKeyFile),
	)
	if err != nil {
		log.Fatalf("client connect: %v", err)
	}
	defer nc.Drain()

Setup a basic subscription, publish, and print it.

	sub, _ := nc.SubscribeSync("hello")
	defer sub.Drain()


	nc.Publish("hello", []byte("world"))


	msg, _ := sub.NextMsg(time.Second)
	fmt.Println(string(msg.Data))
}

Output

world

Recording

Note, playback is half speed to make it a bit easier to follow.