Saltar al contenido principal

PKI y certificados

El grupo de comandos pki gestiona la Autoridad de Certificación (CA) interna de Suricatavel para autenticar comunicaciones con sensores, agentes e integraciones mediante TLS mutuo (mTLS).


AcciónDescripción
statusMuestra el estado de la Autoridad de Certificación, huella digital y fechas de validez.
initInicializa una CA raíz interna autofirmada.
importImporta el certificado y clave privada de una CA corporativa externa.

Ventana de terminal
suricatavel pki status

Muestra si la CA está inicializada, su huella digital SHA-256, el subject DN y la fecha de expiración.


Para generar una nueva CA raíz interna:

Ventana de terminal
suricatavel pki init --cn="Suricatavel Root CA" --org="SecOps" --days=3650
  • --cn: Common Name del certificado CA (por defecto: Suricatavel Root CA).
  • --org: Nombre de la organización (por defecto: Suricatavel).
  • --days: Días de validez del certificado (por defecto: 3650 - 10 años).

Las claves privadas se cifran automáticamente en reposo mediante Ansible Vault o claves de aplicación.


Para utilizar una PKI corporativa existente:

Ventana de terminal
suricatavel pki import --cert=/path/to/ca.crt --key=/path/to/ca.key --passphrase="secret"
  • --cert (requerido): Ruta al archivo de certificado CA en formato PEM.
  • --key (requerido): Ruta al archivo de clave privada en formato PEM.
  • --passphrase: Contraseña para descifrar la clave privada si está protegida.