Skip to main content

Tree

Certificate authority hierarchy

Certificate authority hierarchyA self-signed root CA signs issuing intermediate CAs, which issue the leaf certificate types: server, client, code signing and S/MIME.ROOTRoot CAself-signed · offlineISSUINGIntermediate CAissuing · signed by rootISSUINGIntermediate CAissuing · signed by rootServer (TLS)ServerAuthClient (mTLS)ClientAuthCode signingCodeSigningS/MIMEEmailProtectionLEGENDTrust anchorIssuing CALeaf certificate · EKUSigns

An offline root signs issuing intermediates, which issue the leaf certificate types.

Applies to:
DuoKey Cockpit v2Root / Intermediate / External CAsVault-backed signing keys

CA types​

A certificate authority is created inside the platform. When you select a vault, its signing key is generated and held in that vault — software vault, HSM, cloud KMS or MPC cluster — and is never exported; every certificate, CRL and OCSP response is signed there. Without a vault, a classical CA uses a software key stored by the platform. See CA Key Protection for the supported back-ends per algorithm and for migrating existing CAs.

TypeHow it is createdTypical role
Root CASelf-signedOffline trust anchor at the top of the hierarchy
Intermediate / issuing CASigned by a parent root or intermediateThe CA that issues day-to-day certificates
External CAImported from an existing PKITrack and manage a CA operated elsewhere
PQC / hybrid chains

When creating an intermediate under a post-quantum or hybrid parent, the platform enforces parent-algorithm compatibility so the chain remains verifiable. PQC and hybrid CAs are vault-signed; classical CAs are vault-signed when created with a vault.

CA subject and constraints​

Each CA is configured with its subject (CN, O, OU, C, ST, L), a configurable path-length constraint, the signing hash algorithm, the key type / size, and the distribution URLs published into issued certificates:

SettingPurpose
Path-length constraintHow many sub-CAs may sit below this CA
AIA OCSP URLAuthority Information Access — where relying parties fetch OCSP
CRL distribution URLWhere relying parties fetch the CRL
Signing keyA key generated and held in the selected vault (HSM, cloud KMS, MPC), or a software key stored by the platform

Building a hierarchy​

1

Create the root CA

Create a self-signed root with a long validity and a restrictive path-length constraint. Keep it for signing intermediates only.

2

Create an issuing intermediate

Create an intermediate signed by the root. Day-to-day certificates are issued from the intermediate, so the root can stay offline.

3

Publish distribution points

Set the AIA OCSP and CRL distribution URLs so issued certificates carry working revocation endpoints.

4

Issue

Issue certificates under the intermediate — directly, via the request workflow, or through the enrollment protocols.

CA lifecycle​

Every CA supports a complete, audited lifecycle. Each action is gated by fine-grained role-based permissions, and revocation, archive and CA changes can additionally require M-of-N quorum approval.

ActionEffectRFC 5280
SuspendTemporarily hold the CAcertificateHold
ReactivateLift a suspensionremoveFromCRL (reason 8)
Revoke (simple)Permanently revoke this CA—
Revoke (cascade)Revoke this CA and all sub-CAs and issued certificates—
Archive / UnarchiveHide a non-issuing CA from lists and pickers—
Preview the blast radius first

Before any cascading action, request a lifecycle-impact preview — a read-only report of exactly which sub-CAs and certificates a cascade would affect. Archive is only allowed once a CA has stopped issuing.

Chain, CRL and OCSP​

Each CA can publish its full certificate chain, generate and serve a CRL, and expose an OCSP responder for real-time status. See Revocation (OCSP & CRL) for details.

API reference​

Every CA action — create a root or intermediate, retrieve the chain, preview lifecycle impact, suspend, reactivate, revoke, cascade revoke, archive and generate a CRL — is also available programmatically through the platform API.