Topic

Private PKI

Many organisations run their own CA for internal servers, users, devices and services. Its certificates are trusted only by machines you configure to trust its root.

This hub covers a two-tier design with an offline root, guarding CA keys with HSMs and key ceremonies, distributing your root safely, mutual TLS and identities for machines.

Understand it: handbook chapters

Plain words first, then the real mechanism, what it looks like at work and why it matters.

Chapter 22

A CA of your own: private two-tier PKI

A private CA lets you issue certificates for internal systems under your own rules, built safely as an offline root plus an online issuing CA with clear policies and templates.

  • Expert
  • IT ops
  • Developer

Chapter 21

Guarding the keys: HSMs and key ceremonies

A CA is only as trustworthy as its private keys, so they live in certified hardware, are created in witnessed ceremonies and are used only under multi-person control.

  • Expert
  • IT ops
  • Leader

Chapter 23

Both sides show ID: mutual TLS

In mutual TLS the client also proves who it is, with a certificate and a signature from its private key, so both ends are authenticated before any data flows.

  • IT ops
  • Developer
  • Expert

Chapter 25

Machines with passports: device identity

A device certificate, installed at the factory with its private key locked in secure hardware, lets a machine prove what it is and who made it, for its whole life.

  • IT ops
  • Developer
  • Expert

Do it: how-to guides

Step-by-step, with real commands and a way to check it worked.

How to trust a private root CA on Linux

Your Linux server, desktop or container image trusts your organisation's private root CA system-wide, and you know which programs keep their own list.

  • Linux
  • Docker

How to set up mutual TLS (nginx and curl)

You will have an nginx endpoint that accepts only clients holding a certificate from your own client CA, lets in only the clients you name, and is tested with curl.

  • nginx
  • Linux
  • Windows

Fix it: error pages

The exact messages tools and browsers print, with likely causes and safe fixes.

Check yours: browser tools

They run in your browser. Nothing you paste is sent anywhere.

Tool

Chain checker

Paste a chain and see which link is missing, expired or out of order.

Tool

CSR decoder

Check a certificate signing request before you send it to a CA.

The big picture: crash course

Short lessons of about nine minutes each, with check questions.

Look it up: glossary terms

Every term in plain words, linked to its full entry.