SpecsModelExplore
Overview
Actors
External Systems
IoT Platform
Edge
Ingestion
Stream Processing
Device Management
User-Facing Apps
Platform
Observability
Secrets Manager
CA ServiceSecret Store
SpecsModelExplore
Secrets Manager
OverviewGuideSecrets & CA APILinks and Communications
IDproduct.platform.secrets_manager
DescriptionIssues and rotates device certificates and service secrets.
Keysecrets_manager
Typemicroservice:service
TeamPlatform Engineering
Ownerplatform@iotgateway.example
Statusactive
TechnologiesGo, HashiCorp Vault, PKI/x509
Attributescipher: AES-256-GCM, rotation: 90d
Tags
Table of contents
Guide
Secrets Manager
Internal structure
Components
API surface
Provisioning uses cert issuance
Secrets & CA API

Guide

Secrets Manager

The Secrets Manager is the platform’s trust anchor. It signs device certificates, stores and leases service secrets, and rotates both on a schedule — all behind a single API so no service ever ships a private key in its config.

Responsibility in one sentence

Be the only place credentials are minted, stored and rotated — and expose that as a narrow, auditable API.

Internal structure

Could not build diagram for model "example-iot".

Components

CA Service

Signs device X.509 certificates from a CSR.

Secret Store

Versioned, encrypted storage for service secrets and leases.

API surface

  • POST /sign — turn a CSR into a signed certificate.
  • GET /ca/crl — fetch the current revocation list.

The full contract is embedded on the Overview tab.

Provisioning uses cert issuance

When a new device is provisioned, Device Management calls POST /sign to turn the device’s CSR into a signed certificate. That step lives inside the broader provisioning flow:

Secrets and certificates rotate every 90d by default. Rotation is non-breaking: the previous version stays valid until consumers have fetched the new one.

Secrets & CA API