Skip to content
GuidesDocs 1.3.x

Transport Security

TLS encrypts the connection and authenticates the server. Mutual TLS additionally authenticates the client certificate. Neither replaces application-level identity and authorization when a request crosses a user or gateway trust boundary.

Choose the task

NeedCanonical guide
Load a server key/certificate, use environment paths, or test TLS locallyTLS configuration
Require and validate client certificates for service-to-service trafficMutual TLS
Decide between HTTP/1.1, h2c, and TLS/ALPN transportsTransport matrix
Add JWT, session, gateway, or per-method policyAuth and authz
Find exact server TLS fieldsCreateServerOptions
typescript
const server = createServer({
  services: [routes],
  tls: { dirPath: './keys' },
});

Production certificates should be issued and rotated by the platform rather than baked into an image. Keep private keys out of source control, validate the full chain, and do not disable peer verification as a production workaround. The mTLS page owns client-certificate policy; the TLS page owns certificate loading and server transport setup.