Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Legacy AAF CertMan which uses SCEP protocol or own internal Certificate Authority - mostly used by AT&T and integrated with several ONAP components
  • New CertService which uses CMPv2 to enroll certificates - integrated with ONAP bordering components to protect external traffic
  • K8s Cert-Manager which is OOM way forward to enroll certificates for ONAP components and de-facto industry standard for K8s based clouds

It is time to unify them and use forward just one of them.

...

Underneath, out of Certificate CRD, Cert-Manager creates CertificateRequest CRD which is more suitable for M2M processing as it contains Certificate Singing Signing Request (CSR). CertificateRequest CRD is further on consumed by Issuer which processes CSR stored there and in return puts signed certificate and trusted certs in CertificateRequest's status and marks CertificateReqeust CertificateRequest as Ready. Cert-Manager notices such state change and from CertificateRequest marked as Ready creates K8s secret originally requested in Certificate CRD. Such K8s secret is ready to be mounted to K8s workload as any other secret.

...

CertService was implemented some time back. It provides basic certificate enrollment functionality using CMPv2 over HTTP. Cause in ONAP we have a lot of components which issue certificates, it is wise to harmonize them and use forward just one of them. As a way forward, CertService should be a backend proxy service for K8s Cert-Manager. The same functionality which is currently implemented in CertService client should be implemented in Cert-Manager's external issuer, except parts which are already implemented in Cert-Manager and are generic for all providers issuers (e.g. input parameters validation, conversion to different format, etc). If possible the same input parameters which nowadays are used by CertService client should also be used by Certificate CRD. Following diagram presents new setup.

Gliffy Diagram
size600
namecert_manager_cert_service_integration
pagePin9


Gliffy Diagram
macroId16e29a87-76c2-48e2-b64a-eefa78b442008


As a consequence, all existing usages should be adjusted to use new way and create Certificate CRD instead of calling CertService client as init container.

...

In helm templates the way forward is simple. Certificate CRD must be added and K8s workload must be enhanced to mount secret created out of Certificate CRD.

DCAE blueprints

The same functionality in DCAE is more complicated cause K8s Cloudify plugin code must be extended to create Certificate CRD instead of adding init container. Following diagram presents flow for DCAE microservice deployment when CMPv2 and Cert-Manager integration is enabled.

Gliffy Diagram
size600
namedcae_cmpv2_certmanager_flow
pagePin

...

5

Limitations

After detailed check found out that K8s Cert-Manager doesn't correctly handle issuer's response which contains multiple trusted certificates, aka root CAs. For that following community bugs were reported:

  1. Add multiple trustedCertEntries to truststores
  2. JKS and PKCS12 Keystores are inconsistent


Future

CertService API enhancements

...