From b60a5b93db07a50c0df21dc23878d4fcf00cfa78 Mon Sep 17 00:00:00 2001 From: Jan Malkiewicz Date: Fri, 18 Dec 2020 08:36:41 +0100 Subject: [PATCH] [CMPV2] Enhance documentation for CMPv2 cert provider Issue-ID: OOM-2560 Signed-off-by: Jan Malkiewicz Change-Id: I0a8a1979ca815a76b2e3318cc357da848fe52a9e --- docs/index.rst | 2 +- ...ternal-provider.rst => cmpv2-cert-provider.rst} | 24 ++++++++++++---------- 2 files changed, 14 insertions(+), 12 deletions(-) rename docs/sections/{external-provider.rst => cmpv2-cert-provider.rst} (87%) diff --git a/docs/index.rst b/docs/index.rst index 67d83c6e..d14bbfbe 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -12,7 +12,7 @@ OOM Certification Service sections/introduction.rst sections/architecture.rst - sections/external-provider.rst + sections/cmpv2-cert-provider.rst sections/build.rst sections/offeredapis.rst sections/usage.rst diff --git a/docs/sections/external-provider.rst b/docs/sections/cmpv2-cert-provider.rst similarity index 87% rename from docs/sections/external-provider.rst rename to docs/sections/cmpv2-cert-provider.rst index fe89762a..1aca0733 100644 --- a/docs/sections/external-provider.rst +++ b/docs/sections/cmpv2-cert-provider.rst @@ -2,13 +2,13 @@ .. http://creativecommons.org/licenses/by/4.0 .. Copyright 2020 NOKIA -K8s external provider +CMPv2 certificate provider ============================== General information ------------------------------ -Cert Service K8s external provider is a part of certificate distribution infrastructure in ONAP. +CMPv2 certificate provider is a part of certificate distribution infrastructure in ONAP. The main functionality of the provider is to forward Certificate Signing Requests (CSRs) created by cert-mananger (https://cert-manager.io) to CertServiceAPI. Additional information can be found on a dedicated page: https://wiki.onap.org/display/DW/CertService+and+K8s+Cert-Manager+integration. @@ -17,20 +17,20 @@ Additional information can be found on a dedicated page: https://wiki.onap.org/ CMPv2 Issuer ------------------------------ -In order to be able to request a certificate via K8s external provider a *CMPv2Issuer* CRD (Customer Resource Definition) instance has to be created. +In order to be able to request a certificate via CMPv2 provider a *CMPv2Issuer* CRD (Customer Resource Definition) instance has to be created. It is important to note that the attribute *kind* has to be set to **CMPv2Issuer**, all other attributes can be set as needed. -NOTE: a default instance of CMPv2Issuer is created when installing ONAP via OOM deployment (values can also be adjusted as needed) +**NOTE: a default instance of CMPv2Issuer is created when installing ONAP via OOM deployment.** -Here is an example of a *CMPv2Issuer*: +Here is a definition of a *CMPv2Issuer* provided with ONAP installation: .. code-block:: yaml apiVersion: certmanager.onap.org/v1 kind: CMPv2Issuer metadata: - name: cmpv2-issuer + name: cmpv2-issuer-onap namespace: onap spec: url: https://oom-cert-service:8443 @@ -49,11 +49,13 @@ Certificate enrolling In order to request a certificate a K8s *Certificate* CRD (Custom Resource Definition) has to be created. -It is important that in the section issuerRef following attributes have correct values: - - group: **certmanager.onap.org** - - kind: **CMPv2Issuer** +It is important that in the section issuerRef following attributes have those values: -After *Certificate* CRD has been placed cert manager will send a *CSR* (Certificate Sign Request) to CA (Certificate Authority) via K8s external provider. +- group: certmanager.onap.org + +- kind: CMPv2Issuer + +After *Certificate* CRD has been placed cert manager will send a *CSR* (Certificate Sign Request) to CA (Certificate Authority) via CMPv2 provider. Signed certificate as well as trust anchor (CA root certificate) will be stored in the K8s *secret* specified in *Certificate* CRD (see secretName attribute). By default certificates will be stored in PEM format. It is possible to get certificates also in JKS and P12 format - see example below - more information can be found on official cert manager page. @@ -99,7 +101,7 @@ Here is an example of a *Certificate*: issuerRef: group: certmanager.onap.org kind: CMPv2Issuer - name: cmpv2-issuer + name: cmpv2-issuer-onap # Section keystores is optional and defines in which format certificates will be stored # If this section is omitted than only PEM format will be present in the secret keystores: -- 2.16.6