Skip to main content

Overview

This document outlines the steps necessary to be taken to integrate the CZERTAINLY with the HashiCorp Vault PKI secrets engine to manage and automate certificate lifecycle.

This integration guide was tested on:

  • Vault version 1.14.0+

HashiCorp Vault

HashiCorp Vault is a tool for securely accessing secrets. A secret is anything that you want to tightly control access to, such as API keys, passwords, certificates, and more. Vault provides a unified interface to any secret, while providing tight access control and recording a detailed audit log.

Vault provides a PKI secrets engine that generates X.509 certificates on demand. The PKI secrets engine generates dynamic X.509 certificates based on configured roles. The certificates are signed by the Vault's internal CA or an external CA.

Vault installation

This guide assumes that you have already installed and configured HashiCorp Vault. If you haven't done so, refer to the HashiCorp Vault documentation for installation and configuration instructions.

For more information about the PKI secrets engine, refer to the Vault PKI secrets engine documentation.

Integration

The following steps should be done to successfully integrate HashiCorp Vault with CZERTAINLY:

#ReferenceShort description
1Enable PKI Secrets EngineEnable and configure the PKI secrets engine
2Create ACL PolicyCreate ACL policy with permissions for CZERTAINLY
3Enable Authentication MethodsEnable authentication methods that can be used