Improve security release notes for El Alto
[sdnc/oam.git] / docs / release-notes.rst
1 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
2
3 Release Notes
4 =============
5
6 Version 1.7.3
7 -------------
8 :Release Date: 2019-09-30
9
10 El Alto release
11
12 **Artifact Versions**
13
14
15 The following table lists the SDNC docker containers and their versions.
16
17 +--------------------------------+---------------------------------------------+-----------+
18 | Image name                     |  Description                                | Version(s)|
19 +================================+=============================================+===========+
20 | onap/network-discovery         | POMBA : network discovery microservice      | 1.7.3     |
21 +--------------------------------+---------------------------------------------+-----------+
22 | onap/service-decomposition     | POMBA : service decomposition microservice  | 1.7.3     |
23 +--------------------------------+---------------------------------------------+-----------+
24 | onap/sdnc-ansible-server-image | Ansible server                              | 1.7.3     |
25 +--------------------------------+---------------------------------------------+-----------+
26 | onap/sdnc-aaf-image            | SDNC controller image, with AAF integration | 1.7.3     |
27 +--------------------------------+---------------------------------------------+-----------+
28 | onap/sdnc-image                | SDNC controller image, standalone (no AAF)  | 1.7.3     |
29 +--------------------------------+---------------------------------------------+-----------+
30 | onap/sdnc-ueb-listener-image   | SDC listener                                | 1.7.3     |
31 +--------------------------------+---------------------------------------------+-----------+
32 | onap/sdcn-dmaap-listener-image | DMAAP listener                              | 1.7.3     |
33 +--------------------------------+---------------------------------------------+-----------+
34
35
36 **New Features**
37
38 The full list of El Alto epics and user stories for SDNC may be found at <https://jira.onap.org/issues/?filter=12044>.
39
40 The following list summarizes some of the most significant epics:
41
42 +------------+-------------------------------------------------------------------------------------+
43 | Jira #     | Abstract                                                                            |
44 +============+=====================================================================================+
45 | [SDNC-825] | OpenDaylight Neon upgrade                                                           |
46 +------------+-------------------------------------------------------------------------------------+
47 | [SDNC-858] | Tune OpenDaylight Java settings for NETCONF                                         |
48 +------------+-------------------------------------------------------------------------------------+
49 | [SDNC-822] | Add aggregate-route-policy in GR-API and async changes                              |
50 +------------+-------------------------------------------------------------------------------------+
51 | [SDNC-431] | Implement config DB and REST API                                                    |
52 +------------+-------------------------------------------------------------------------------------+
53 | [SDNC-433] | Receive netconf notification from RAN, update config DB and publish change on DMAAP |
54 +------------+-------------------------------------------------------------------------------------+
55
56
57
58 **Bug Fixes**
59 The full list of bug fixes in the SDNC El Alto release may be found at <https://jira.onap.org/issues/?filter=12045>
60
61 **Known Issues**
62 The full list of known issues in SDNC may be found in the ONAP Jira at <https://jira.onap.org/issues/?filter=11119>
63
64 One item of note is that the SDNC admin portal was determined to have a number of security vulnerabilities,
65 under Known Security Issues.  As a temporary remediation, the admin portal was disabled in
66 Dublin.  These issues have been resolved in El Alto.
67
68 **Security Notes**
69
70 *Fixed Security Issues*
71
72 - CVE-2019-12132 `OJSI-41 <https://jira.onap.org/browse/OJSI-41>`_ SDNC service allows for arbitrary code execution in sla/dgUpload form
73   Fixed temporarily by disabling admportal.
74 - CVE-2019-12123 `OJSI-42 <https://jira.onap.org/browse/OJSI-42>`_ SDNC service allows for arbitrary code execution in sla/printAsXml form
75   Fixed temporarily by disabling admportal.
76 - CVE-2019-12113 `OJSI-43 <https://jira.onap.org/browse/OJSI-43>`_ SDNC service allows for arbitrary code execution in sla/printAsGv form
77   Fixed by removing this API endpoint.
78 - `OJSI-91 <https://jira.onap.org/browse/OJSI-91>`_ SDNC exposes unprotected API for user creation
79   Fixed temporarily by disabling admportal.
80 - `OJSI-98 <https://jira.onap.org/browse/OJSI-98>`_ In default deployment SDNC (sdnc-portal) exposes HTTP port 30201 outside of cluster.
81   Port 30201 now uses HTTPS protocol.
82 - CVE-2019-12112 `OJSI-199 <https://jira.onap.org/browse/OJSI-199>`_ SDNC service allows for arbitrary code execution in sla/upload form
83   Fixed temporarily by disabling admportal.
84 - `OJSI-34 <https://jira.onap.org/browse/OJSI-34>`_ Multiple SQL Injection issues in SDNC
85 - `OJSI-99 <https://jira.onap.org/browse/OJSI-99>`_ In default deployment SDNC (sdnc) exposes HTTP port 30202 outside of cluster.
86   Port 30202 is no longer used.
87 - `OJSI-100 <https://jira.onap.org/browse/OJSI-100>`_ In default deployment SDNC (sdnc-dgbuilder) exposes HTTP port 30203 outside of cluster.
88   Port 30203 now uses HTTPS protocol.
89 - `OJSI-179 <https://jira.onap.org/browse/OJSI-179>`_ dev-sdnc-sdnc exposes JDWP on port 1830 which allows for arbitrary code execution
90   Ticket has been closed as no one was able to reproduce the issue.
91 - `OJSI-183 <https://jira.onap.org/browse/OJSI-183>`_ SDNC exposes ssh service on port 30208
92   Port 30202 is no longer used.
93
94 *Known Security Issues*
95
96 For CVE-2019-12132, CVE-2019-12123 and CVE-2019-12112 only temporary fix has been applied.
97 This fix simply prevents admportal from being started and exposed.
98 If admportal is to be used in your deployment, please be very cautious and remember to fix those vulnerabilities on your own.
99
100 *Known Vulnerabilities in Used Modules*
101
102 Quick Links:
103
104 - `SDNC project page <https://wiki.onap.org/display/DW/Software+Defined+Network+Controller+Project>`_
105 - `Passing Badge information for SDNC <https://bestpractices.coreinfrastructure.org/en/projects/1703>`_
106 - `Project Vulnerability Review Table for Casablanca Release <https://wiki.onap.org/pages/viewpage.action?pageId=45307811>`_
107
108
109 Version 1.5.4
110 -------------
111 :Release Date: 2019-06-13
112
113
114 **New Features**
115
116 The full list of Dublin epics and user stories for SDNC maybe be found at <https://jira.onap.org/issues/?filter=11803>.
117
118 The following list summarizes some of the most significant epics:
119
120 +------------+----------------------------------------------------------------------------+
121 | Jira #     | Abstract                                                                   |
122 +============+============================================================================+
123 | [SDNC-551] | OpenDaylight Fluorine Support                                              |
124 +------------+----------------------------------------------------------------------------+
125 | [SDNC-564] | 5G Use Case                                                                |
126 +------------+----------------------------------------------------------------------------+
127 | [SDNC-565] | CCVPN Use Case Extension                                                   |
128 +------------+----------------------------------------------------------------------------+
129 | [SDNC-570] | SDN-R: Server side component                                               |
130 +------------+----------------------------------------------------------------------------+
131 | [SDNC-579] | SDN-R : UX-Client                                                          |
132 +------------+----------------------------------------------------------------------------+
133 | [SDNC-631] | SDNC support for the PNF Use Case Network Assign for Plug and Play feature |
134 +------------+----------------------------------------------------------------------------+
135
136
137 **Bug Fixes**
138 The full list of bug fixes in the SDNC Dublin release may be found at <https://jira.onap.org/issues/?filter=11805>
139
140 **Known Issues**
141 The full list of known issues in SDNC may be found in the ONAP Jira at <https://jira.onap.org/issues/?filter=11119>
142
143 One item of note is that the SDNC admin portal was determined to have a number of security vulnerabilities,
144 under Known Security Issues.  As a temporary remediation, the admin portal is disabled in
145 Dublin.  It will be re-enabled in El Alto once the security issues are addressed.
146
147 **Security Notes**
148
149 *Fixed Security Issues*
150
151 - CVE-2019-12132 `OJSI-41 <https://jira.onap.org/browse/OJSI-41>`_ SDNC service allows for arbitrary code execution in sla/dgUpload form
152   Fixed temporarily by disabling admportal
153 - CVE-2019-12123 `OJSI-42 <https://jira.onap.org/browse/OJSI-42>`_ SDNC service allows for arbitrary code execution in sla/printAsXml form
154   Fixed temporarily by disabling admportal
155 - CVE-2019-12113 `OJSI-43 <https://jira.onap.org/browse/OJSI-43>`_ SDNC service allows for arbitrary code execution in sla/printAsGv form
156   Fixed temporarily by disabling admportal
157 - `OJSI-91 <https://jira.onap.org/browse/OJSI-91>`_ SDNC exposes unprotected API for user creation
158   Fixed temporarily by disabling admportal
159 - `OJSI-98 <https://jira.onap.org/browse/OJSI-98>`_ In default deployment SDNC (sdnc-portal) exposes HTTP port 30201 outside of cluster.
160   Fixed temporarily by disabling admportal
161 - CVE-2019-12112 `OJSI-199 <https://jira.onap.org/browse/OJSI-199>`_ SDNC service allows for arbitrary code execution in sla/upload form
162   Fixed temporarily by disabling admportal
163
164 *Known Security Issues*
165
166 - `OJSI-34 <https://jira.onap.org/browse/OJSI-34>`_ Multiple SQL Injection issues in SDNC
167 - `OJSI-99 <https://jira.onap.org/browse/OJSI-99>`_ In default deployment SDNC (sdnc) exposes HTTP port 30202 outside of cluster.
168 - `OJSI-100 <https://jira.onap.org/browse/OJSI-100>`_ In default deployment SDNC (sdnc-dgbuilder) exposes HTTP port 30203 outside of cluster.
169 - `OJSI-179 <https://jira.onap.org/browse/OJSI-179>`_ dev-sdnc-sdnc exposes JDWP on port 1830 which allows for arbitrary code execution
170 - `OJSI-183 <https://jira.onap.org/browse/OJSI-183>`_ SDNC exposes ssh service on port 30208
171
172 *Known Vulnerabilities in Used Modules*
173
174 Quick Links:
175
176 - `SDNC project page <https://wiki.onap.org/display/DW/Software+Defined+Network+Controller+Project>`_
177 - `Passing Badge information for SDNC <https://bestpractices.coreinfrastructure.org/en/projects/1703>`_
178 - `Project Vulnerability Review Table for Casablanca Release <https://wiki.onap.org/pages/viewpage.action?pageId=45307811>`_
179
180 Version: 1.4.4
181 --------------
182
183 **Bugs Fixes**
184
185 The following bugs are fixed in the SDNC Casablanca January 2019 maintenance release:
186
187 +------------+------------------------------------------------------------------------------------------+
188 | Jira #     | Abstract                                                                                 |
189 +============+==========================================================================================+
190 | [SDNC-405] | SDNC API documentation is missing on ReadTheDocs                                         |
191 +------------+------------------------------------------------------------------------------------------+
192 | [SDNC-523] | vnf-information.vnf-id validation check should not be mandatory in validate-vnf-input DG |
193 +------------+------------------------------------------------------------------------------------------+
194 | [SDNC-532] | oof query failed due to hostname change, returning unknown host                          |
195 +------------+------------------------------------------------------------------------------------------+
196 | [SDNC-534] | wrong "input" field in DMaaP message template                                            |
197 +------------+------------------------------------------------------------------------------------------+
198 | [SDNC-536] | Upgrade zjsonpatch version to remediate vulnerabilities                                  |
199 +------------+------------------------------------------------------------------------------------------+
200 | [SDNC-537] | Update to spring-boot 2.1.0-RELEASE                                                      |
201 +------------+------------------------------------------------------------------------------------------+
202 | [SDNC-540] | CCVPN closed loop testing failed.                                                        |
203 +------------+------------------------------------------------------------------------------------------+
204 | [SDNC-542] | [PORT] Network Discovery microservice does not log                                       |
205 +------------+------------------------------------------------------------------------------------------+
206 | [SDNC-546] | CCVPN bugs fix for manual free integration test                                          |
207 +------------+------------------------------------------------------------------------------------------+
208 | [SDNC-549] | Retain MD-SAL data on pod recreate                                                       |
209 +------------+------------------------------------------------------------------------------------------+
210
211
212
213 Version: 1.4.3
214 --------------
215
216
217 :Release Date: 2018-11-30
218
219 **New Features**
220
221 The Casablanca release of SDNC introduces the following new features:
222
223         - Network Discovery, in support of POMBA
224         - Support for CCVPN use case
225         - Change Management enhancements
226
227 **Bug Fixes**
228
229 The list of bugs fixed in the SDNC Casablanca release may be found in the ONAP Jira at <https://jira.onap.org/issues/?filter=11544>
230
231
232 **Known Issues**
233
234 The list of known issues in the SDNC project may be found in the ONAP Jira at <https://jira.onap.org/issues/?filter=11119>
235
236
237 **Security Notes**
238
239 SDNC code has been formally scanned during build time using NexusIQ and all Critical vulnerabilities have been addressed, items that remain open have been assessed for risk and determined to be false positive. The SDNC open Critical security vulnerabilities and their risk assessment have been documented as part of the `project <https://wiki.onap.org/pages/viewpage.action?pageId=45307811>`_.
240
241 Quick Links:
242
243 - `SDNC project page <https://wiki.onap.org/display/DW/Software+Defined+Network+Controller+Project>`_
244 - `Passing Badge information for SDNC <https://bestpractices.coreinfrastructure.org/en/projects/1703>`_
245 - `Project Vulnerability Review Table for Casablanca Release <https://wiki.onap.org/pages/viewpage.action?pageId=45307811>`_
246
247 **Upgrade Notes**
248    NA
249
250 **Deprecation Notes**
251    NA
252
253 **Other**
254    NA
255
256 Version: 1.3.4
257 --------------
258
259
260 :Release Date: 2018-07-06
261
262 **New Features**
263
264 The full list of SDNC Beijing Epics and user stories can be found in the ONAP Jira at <https://jira.onap.org/issues/?filter=10791>.  The
265 following table lists the major features included in the Beijing release.
266
267 +------------+-------------------------------------------------------------------------------------------------------------+
268 | Jira #     | Abstract                                                                                                    |
269 +============+=============================================================================================================+
270 | [SDNC-278] | Change management in-place software upgrade execution using Ansible <https://jira.onap.org/browse/SDNC-278> |
271 +------------+-------------------------------------------------------------------------------------------------------------+
272 | [SDNC-163] | Deploy a SDN-C high availability environment - Kubernetes <https://jira.onap.org/browse/SDNC-163>           |
273 +------------+-------------------------------------------------------------------------------------------------------------+
274
275
276 **Bug Fixes**
277
278 The list of bugs fixed in the SDNC Beijing release may be found in the ONAP Jira at <https://jira.onap.org/issues/?filter=11118>
279
280
281 **Known Issues**
282
283 +------------+----------------------------------------------------------------------------------------------------------------------------------+
284 | Jira #     | Abstract                                                                                                                         |
285 +============+==================================================================================================================================+
286 | [SDNC-324] | IPV4_ADDRESS_POOL is empty <https://jira.onap.org/browse/SDNC-324>                                                               |
287 +------------+----------------------------------------------------------------------------------------------------------------------------------+
288 | [SDNC-321] | dgbuilder won't save DG <https://jira.onap.org/browse/SDNC-321>                                                                  |
289 +------------+----------------------------------------------------------------------------------------------------------------------------------+
290 | [SDNC-304] | SDNC OOM intermittent Healthcheck failure - JSONDecodeError - on different startup order <https://jira.onap.org/browse/SDNC-304> |
291 +------------+----------------------------------------------------------------------------------------------------------------------------------+
292 | [SDNC-115] | VNFAPI DGs contain plugin references to software not part of ONAP <https://jira.onap.org/browse/SDNC-115>                        |
293 +------------+----------------------------------------------------------------------------------------------------------------------------------+
294 | [SDNC-114] | Generic API DGs contain plugin references to software not part of ONAP <https://jira.onap.org/browse/SDNC-114>                   |
295 +------------+----------------------------------------------------------------------------------------------------------------------------------+
296 | [SDNC-106] | VNFAPI DGs contain old openecomp and com.att based plugin references <https://jira.onap.org/browse/SDNC-106>                     |
297 +------------+----------------------------------------------------------------------------------------------------------------------------------+
298 | [SDNC-64]  | SDNC is not setting FromApp identifier in logging MDC <https://jira.onap.org/browse/SDNC-64>                                     |
299 +------------+----------------------------------------------------------------------------------------------------------------------------------+
300
301
302 **Security Notes**
303
304 SDNC code has been formally scanned during build time using NexusIQ and all Critical vulnerabilities have been addressed, items that remain open have been assessed for risk and determined to be false positive. The SDNC open Critical security vulnerabilities and their risk assessment have been documented as part of the `project <https://wiki.onap.org/pages/viewpage.action?pageId=28379582>`_.
305
306 Quick Links:
307
308 - `SDNC project page <https://wiki.onap.org/display/DW/Software+Defined+Network+Controller+Project>`_
309 - `Passing Badge information for SDNC <https://bestpractices.coreinfrastructure.org/en/projects/1703>`_
310 - `Project Vulnerability Review Table for SDNC <https://wiki.onap.org/pages/viewpage.action?pageId=28379582>`_
311
312 **Upgrade Notes**
313         NA
314
315 **Deprecation Notes**
316         NA
317
318 **Other**
319         NA
320
321 Version: 1.2.1
322 --------------
323
324 :Release Date: 2018-01-18
325
326 **Bug Fixes**
327
328 - `SDNC-145 <https://jira.onap.org/browse/SDNC-145>`_ Error message refers to wrong parameters
329 - `SDNC-195 <https://jira.onap.org/browse/SDNC-195>`_ UEB listener doesn't insert correct parameters for allotted resources in DB table ALLOTTED_RESOURCE_MODEL
330 - `SDNC-198 <https://jira.onap.org/browse/SDNC-198>`_ CSIT job fails
331 - `SDNC-201 <https://jira.onap.org/browse/SDNC-201>`_ Fix DG bugs from integration tests
332 - `SDNC-202 <https://jira.onap.org/browse/SDNC-202>`_ Search for service -data null match, set vGW LAN IP via Heat
333 - `SDNC-211 <https://jira.onap.org/browse/SDNC-211>`_ Update SDNC Amsterdam branch to use maintenance release versions
334 - `SDNC-212 <https://jira.onap.org/browse/SDNC-212>`_ Duplicate file name
335
336 Version: 1.2.0
337 --------------
338
339 :Release Date: 2017-11-16
340
341 **New Features**
342
343 The ONAP Amsterdam release introduces the following changes to SDNC from
344 the original openECOMP seed code:
345    - Refactored / moved common platform code to new CCSDK project
346    - Refactored code to rename openecomp to onap
347    - Introduced new GENERIC-RESOURCE-API api, used by vCPE and VoLTE use cases
348    - Introduced new docker containers for SDC and DMAAP interfaces
349
350 **Bug Fixes**
351         NA
352 **Known Issues**
353 The following known high priority issues are being worked and are expected to be delivered
354 in release 1.2.1:
355 - `SDNC-179 <https://jira.onap.org/browse/SDNC-179>`_ Failed to make HTTPS connection in restapicall node
356 - `SDNC-181 <https://jira.onap.org/browse/SDNC-181>`_ Change call to brg-wan-ip-address vbrg-wan-ip brg topo activate DG
357 - `SDNC-182 <https://jira.onap.org/browse/SDNC-182>`_ Fix VNI Consistency: Add vG vxlan tunnel setup and bridge domain setup to brg-topo-activate DG
358
359 **Security Issues**
360         NA
361
362 **Upgrade Notes**
363         NA
364
365 **Deprecation Notes**
366         NA
367
368 **Other**
369         NA