From c09bd4988fca20f01f1565d279ac013cc501bc94 Mon Sep 17 00:00:00 2001 From: Tomasz Wrobel Date: Tue, 24 Nov 2020 12:17:43 +0100 Subject: [OOM CERT-SERVICE DOCS] Align release notes to template Issue-ID: OOM-2633 Signed-off-by: Tomasz Wrobel Change-Id: I891a0817f5e2b08e7420c3f007e85d096d3e3a96 --- docs/index.rst | 1 + docs/sections/change-log.rst | 262 ++++++++++++++++++++++++++++++++ docs/sections/release-notes.rst | 329 +++++++++------------------------------- 3 files changed, 334 insertions(+), 258 deletions(-) create mode 100644 docs/sections/change-log.rst diff --git a/docs/index.rst b/docs/index.rst index 97bfcac3..78d32ac7 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -18,6 +18,7 @@ OOM Certification Service sections/logging.rst sections/installation.rst sections/configuration.rst + sections/change-log.rst sections/release-notes.rst sections/troubleshooting.rst diff --git a/docs/sections/change-log.rst b/docs/sections/change-log.rst new file mode 100644 index 00000000..b2423a10 --- /dev/null +++ b/docs/sections/change-log.rst @@ -0,0 +1,262 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 +.. Copyright 2020 NOKIA + + +Change Log +============== + + +Version: 2.1.0 +-------------- + +:Release Date: + +**New Features** + +* Added module **oom-certservice-post-processor** with following functionality: + + * appending CMPv2 certificates to CertMan truststore + * replacing CertMan keystore with CMPv2 keystore + +**Bug Fixes** + + N/A + +**Known Issues** + + N/A + +**Security Notes** + + N/A + +*Fixed Security Issues* + + N/A + +*Known Security Issues* + + N/A + +*Known Vulnerabilities in Used Modules* + + N/A + +**Upgrade Notes** + +**Deprecation Notes** + +**Other** + +============== + +Version: 2.0.0 +-------------- + +:Release Date: + +**New Features** + + - The same functionality as in aaf-certservice 1.2.0 + +**Bug Fixes** + + N/A + +**Known Issues** + + N/A + +**Security Notes** + + N/A + +*Fixed Security Issues* + + N/A + +*Known Security Issues* + + N/A + +*Known Vulnerabilities in Used Modules* + + N/A + +**Upgrade Notes** + +**Deprecation Notes** + +**Other** + +=========== + +Version: 1.2.0 +-------------- + +:Release Date: + +**New Features** + + - Client creates subdirectories in given OUTPUT_PATH and place certificate into it. + +**Bug Fixes** + + N/A + +**Known Issues** + + N/A + +**Security Notes** + + N/A + +*Fixed Security Issues* + + N/A + +*Known Security Issues* + + N/A + +*Known Vulnerabilities in Used Modules* + + N/A + +**Upgrade Notes** + +**Deprecation Notes** + +**Other** + +=========== + +Version: 1.1.0 +-------------- + +:Release Date: 2020-06-29 + +**New Features** + + - Added property to CertService Client to allow selection of output certificates type (One of: PEM, JKS, P12). + +**Bug Fixes** + + - Resolved issue where created PKCS12 certificates had jks extension. + +**Known Issues** + + N/A + +**Security Notes** + + N/A + +*Fixed Security Issues* + + N/A + +*Known Security Issues* + + N/A + +*Known Vulnerabilities in Used Modules* + + N/A + +**Upgrade Notes** + +**Deprecation Notes** + +**Other** + +=========== + +Version: 1.0.1 +-------------- + +:Release Date: 2020-05-22 + +**New Features** + +The Frankfurt Release is the first release of the Certification Service. + + +**Bug Fixes** + + - `AAF-1132 `_ - CertService Client returns exit status 5 when TLS configuration fails + +**Known Issues** + + - PKCS12 certificates have jks extension + +**Security Notes** + + N/A + +*Fixed Security Issues* + + N/A + +*Known Security Issues* + + N/A + +*Known Vulnerabilities in Used Modules* + + N/A + +**Upgrade Notes** + +**Deprecation Notes** + +**Other** + +=========== + +Version: 1.0.0 +-------------- + +:Release Date: 2020-04-16 + +**New Features** + +The Frankfurt Release is the first release of the Certification Service. + +**Bug Fixes** + + - No new fixes were implemented for this release + +**Known Issues** + + - `AAF-1132 `_ - CertService Client returns exit status 5 when TLS configuration fails + + - PKCS12 certificates have jks extension + +**Security Notes** + + N/A + +*Fixed Security Issues* + + N/A + +*Known Security Issues* + + N/A + +*Known Vulnerabilities in Used Modules* + + N/A + +**Upgrade Notes** + +**Deprecation Notes** + +**Other** + +=========== + +End of Change Log diff --git a/docs/sections/release-notes.rst b/docs/sections/release-notes.rst index 65be849e..56dd8cc7 100644 --- a/docs/sections/release-notes.rst +++ b/docs/sections/release-notes.rst @@ -3,307 +3,120 @@ .. Copyright 2020 NOKIA .. _release_notes: -========================== -Cert Service Release Notes -========================== +*************************************** +OOM Certification Service Release Notes +*************************************** -============== +Abstract +======== -Version: 2.2.0 --------------- - -:Release Date: - -**New Features** - -* Added module **oom-certservice-k8s-external-provider** with following functionality: +This document provides the release notes for the Guilin release. - An external provider is a part of PKI infrastructure. It consumes CertificateRequest CRD from Cert-Manager and calls CertService API to enroll certificate from CMPv2 server. +Summary +======= - More information can be found on dedicated `wiki page `_ - -**Bug Fixes** - - N/A - -**Known Issues** +Certification Service provides certificates signed by external CMPv2 server - such certificates are further called operators certificates. Operators certificates are meant to secure external ONAP traffic - traffic between network functions (xNFs) and ONAP. - N/A +This project was moved from Application Authorization Framework (AAF), to check previous release notes see, `AAF CertService release notes `_ . -**Security Notes** - N/A +Release Data +============ -*Fixed Security Issues* ++--------------------------------------+--------------------------------------------------------------------------------+ +| **Project** | OOM | +| | | ++--------------------------------------+--------------------------------------------------------------------------------+ +| **Docker images** | * onap/org.onap.oom.platform.cert-service.oom-certservice-api:2.1.0 | +| | * onap/org.onap.oom.platform.cert-service.oom-certservice-client:2.1.0 | +| | * onap/org.onap.oom.platform.cert-service.oom-certservice-post-processor:2.1.0| +| | | ++--------------------------------------+--------------------------------------------------------------------------------+ +| **Release designation** | Guilin | +| | | ++--------------------------------------+--------------------------------------------------------------------------------+ - N/A -*Known Security Issues* +New features +------------ - N/A +- `AAF-1152 `_ Added to CertService's client parameter which controls output type of certificates (JKS, PKCS12, PEM) -*Known Vulnerabilities in Used Modules* - - N/A - -**Upgrade Notes** - -**Deprecation Notes** - -**Other** - -============== - -Version: 2.1.0 --------------- +- `DCAEGEN2-2252 `_ Added new not existing subfolders creation in output path (CMPv2 Integration). -:Release Date: +- `DCAEGEN2-2253 `_ Implemented CertServicePostprocessor, allows merging truststores and moving keystore files. -**New Features** +- `OOM-2526 `_ Moved project from AAF to OOM platform. -* Added module **oom-certservice-post-processor** with following functionality: +**Bug fixes** - * appending CMPv2 certificates to CertMan truststore - * replacing CertMan keystore with CMPv2 keystore - -**Bug Fixes** - - N/A +- `OOM-2524 `_ Fixed project makefile. **Known Issues** - N/A - -**Security Notes** - - N/A - -*Fixed Security Issues* - - N/A - -*Known Security Issues* - - N/A - -*Known Vulnerabilities in Used Modules* - - N/A - -**Upgrade Notes** - -**Deprecation Notes** - -**Other** - -============== +None -Version: 2.0.0 --------------- - -:Release Date: - -**New Features** - - - The same functionality as in aaf-certservice 1.2.0 - -**Bug Fixes** - - N/A - -**Known Issues** +Deliverables +------------ - N/A +Software Deliverables +~~~~~~~~~~~~~~~~~~~~~ +Docker images mentioned in Release Date section. -**Security Notes** +Documentation Deliverables +~~~~~~~~~~~~~~~~~~~~~~~~~~ +Documentation moved from AAF - `OOM Certification Service `_ . - N/A +Known Limitations, Issues and Workarounds +========================================= -*Fixed Security Issues* +System Limitations +------------------ - N/A +Any known system limitations. -*Known Security Issues* - N/A +Known Vulnerabilities +--------------------- -*Known Vulnerabilities in Used Modules* +Any known vulnerabilities. - N/A -**Upgrade Notes** +Workarounds +----------- -**Deprecation Notes** +Any known workarounds. -**Other** -=========== - -Version: 1.2.0 +Security Notes -------------- -:Release Date: - -**New Features** - - - Client creates subdirectories in given OUTPUT_PATH and place certificate into it. - -**Bug Fixes** - - N/A - -**Known Issues** - - N/A - -**Security Notes** - - N/A - -*Fixed Security Issues* - - N/A - -*Known Security Issues* - - N/A - -*Known Vulnerabilities in Used Modules* - - N/A - -**Upgrade Notes** - -**Deprecation Notes** - -**Other** - -=========== - -Version: 1.1.0 --------------- - -:Release Date: 2020-06-29 - -**New Features** - - - Added property to CertService Client to allow selection of output certificates type (One of: PEM, JKS, P12). - -**Bug Fixes** - - - Resolved issue where created PKCS12 certificates had jks extension. - -**Known Issues** - - N/A - -**Security Notes** - - N/A - -*Fixed Security Issues* - - N/A - -*Known Security Issues* - - N/A - -*Known Vulnerabilities in Used Modules* - - N/A - -**Upgrade Notes** - -**Deprecation Notes** - -**Other** - -=========== - -Version: 1.0.1 --------------- - -:Release Date: 2020-05-22 - -**New Features** - -The Frankfurt Release is the first release of the Certification Service. - - -**Bug Fixes** - - - `AAF-1132 `_ - CertService Client returns exit status 5 when TLS configuration fails - -**Known Issues** - - - PKCS12 certificates have jks extension - -**Security Notes** - - N/A - -*Fixed Security Issues* - - N/A - -*Known Security Issues* - - N/A - -*Known Vulnerabilities in Used Modules* - - N/A - -**Upgrade Notes** - -**Deprecation Notes** - -**Other** - -=========== - -Version: 1.0.0 --------------- - -:Release Date: 2020-04-16 - -**New Features** - -The Frankfurt Release is the first release of the Certification Service. - -**Bug Fixes** - - - No new fixes were implemented for this release - -**Known Issues** - - - `AAF-1132 `_ - CertService Client returns exit status 5 when TLS configuration fails - - - PKCS12 certificates have jks extension - -**Security Notes** - - N/A +**Fixed Security Issues** -*Fixed Security Issues* +None - N/A +**Known Security Issues** -*Known Security Issues* +None - N/A -*Known Vulnerabilities in Used Modules* +Test Results +============ +Not applicable - N/A -**Upgrade Notes** +References +========== -**Deprecation Notes** +For more information on the ONAP Guilin release, please see: -**Other** +#. `ONAP Home Page`_ +#. `ONAP Documentation`_ +#. `ONAP Release Downloads`_ +#. `ONAP Wiki Page`_ -=========== -End of Release Notes +.. _`ONAP Home Page`: https://www.onap.org +.. _`ONAP Wiki Page`: https://wiki.onap.org +.. _`ONAP Documentation`: https://docs.onap.org +.. _`ONAP Release Downloads`: https://git.onap.org -- cgit 1.2.3-korg