docs/sections/release-notes.rst

   1 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
   2 .. http://creativecommons.org/licenses/by/4.0
   3 .. Copyright © 2017 AT&T Intellectual Property. All rights reserved.
   4
   5 Release Notes
   6 =============
   7
   8 Version: 2.1.13 (Dublin, 4.0.0-ONAP)
   9 ---------------------------------------
  10
  11 :Release Date: 2019-06-06
  12
  13 **New Features**
  14
  15 Note: In general, Infrastructure must be accomplished in the release PRIOR to general usage.  This is the case for most of the features included here.
  16
  17         - AAF has built the required features to automatically generate all Certificates and Configurations real-time.  This will be utilized by ONAP MSs in El Alto
  18         - AAF has the ability to publish both Public and Internal Private K8s Service information (Locator)
  19         - Greatly Reduced size of Docker Images
  20         - Greatly enhanced startup procedures in K8s, to more cleanly start, with Certificate, Property Generation every time
  21         - Ability to run internally as non-root (fully setup K8s in El Alto)
  22         - Removal of unused classes in Batch
  23         - Large improvement in Batch and methodology, to be used in El Alto
  24
  25 **Bug Fixes**
  26         - `AAF-797 <https://jira.onap.org/browse/AAF-797>`_ Update IP address for aaf-onap-test.osaaf.org
  27         - `AAF-794 <https://jira.onap.org/browse/AAF-794>`_ Misleading error message in agent.sh
  28         - `AAF-773 <https://jira.onap.org/browse/AAF-773>`_ aaf-cass timing issues
  29         - `AAF-769 <https://jira.onap.org/browse/AAF-769>`_ AAF CSIT not working
  30         - `AAF-727 <https://jira.onap.org/browse/AAF-727>`_ Cert Subject Check confused by Email
  31         - `AAF-722 <https://jira.onap.org/browse/AAF-722>`_ aaf continues to be available to aai-resources even though aaf database appears to be down
  32         - `AAF-720 <https://jira.onap.org/browse/AAF-720>`_ Docker Images not passing Signal -1
  33         - `AAF-645 <https://jira.onap.org/browse/AAF-645>`_ Fix "Null" string for fetching path inside CADI API enforcement filter
  34         - `AAF-522 <https://jira.onap.org/browse/AAF-522>`_ rsa 4096 signing fails with TPM
  35         - `AAF-813 <https://jira.onap.org/browse/AAF-813>`_ Missing Role for dmaap-bc Identity
  36         - `AAF-514 <https://jira.onap.org/browse/AAF-514>`_ TPM Plugin: Remove global structure used for storing session data
  37         - `AAF-785 <https://jira.onap.org/browse/AAF-785>`_ non STAGING version on master
  38         - `AAF-822 <https://jira.onap.org/browse/AAF-822>`_ Startup issues with K8S, Certs
  39
  40 **Usage Notes**
  41         - AAF Core and SMS elements have consistently started from scratch. The one case where this didn't happen for SMS,
  42                 it was found that incompatible data was left in volume.  Removal of old data for SMS (See SMS notes) should resolve
  43         - On the same instance, one AAF Core component had a similar scenario.  A simple bounce of aaf-locator resolved.
  44         - Existing Cassandra
  45                 - For each release, AAF maintains the authz/auth/auth-cass/cass_init/init.cql which is used to setup Keyspaces from scratch
  46                 - Any changes are also done in small CQL files, you MIGHT need authz/auth/auth-cass/cass_init/init2_10.cql for Dublin
  47
  48
  49 Version: 2.1.8 (Casablanca, 3.0.0-ONAP, Casablanca Maintenance Release)
  50 --------------------------------------------------------------------------
  51
  52 Note: AAF did not create new artifacts for Casablanca Maintenance Release.
  53
  54
  55 :Release Date: 2018-11-30
  56
  57 **New Features**
  58
  59  - AAF created a local CA and CA Strategy to be utilized for ONAP Test Environments that can instantiated daily, yet have continuity over time and environments. (REAL ONAP instantiations should use their *own* CAs outside of initial tests.)
  60  - AAF has auto-creation of configurations and certificates.  This is expected to be done inside an "agent" container, and used by Apps.
  61  - AAF stores and creates "Bootstrap Data" for all users of AAF in ONAP.  This simplifies the efforts of ONAP components to organize their Authorizations, and so that various Test Environments can start with correct data every time.
  62  - Refactored all of AAF instantiations to use the above, and have consistency between the 5 ways to start AAF.
  63  - Ability for CADI Clients to map previous User/Password combinations to current credentials for migration purposes. This is applied to Shiro Plugin as well
  64  - CADI Coarse Grain Enforcement Point (Authorize API access).
  65  - Created Backward compatibility features, both for DB (Cassandra) and for API access.
  66
  67
  68 **Bug Fixes**
  69         - AAF in OOM was not stable coming out of Beijing.  AAF OOM was refactored using above Container based Configurations.
  70         - `AAF-617 <https://jira.onap.org/browse/AAF-617>`_ LOCATE Proxy DELETE not working
  71         - `AAF-605 <https://jira.onap.org/browse/AAF-605>`_ DB Stoppage not causing Reset of Connection
  72         - `AAF-601 <https://jira.onap.org/browse/AAF-601>`_ Agent "showpass" errors on optional "chal" file, when not exists
  73         - `AAF-600 <https://jira.onap.org/browse/AAF-600>`_ Bad Data for APPC in AAF Test Evironment
  74         - `AAF-598 <https://jira.onap.org/browse/AAF-598>`_ Inconsistent Startup with truly persistent Cass Data
  75         - `AAF-597 <https://jira.onap.org/browse/AAF-597>`_ Please change default appc@appc.onap.org permission
  76         - `AAF-592 <https://jira.onap.org/browse/AAF-592>`_ SDNC not able to authenticate with BAth username/password
  77         - `AAF-530 <https://jira.onap.org/browse/AAF-530>`_ AAF inside Kubernetes inaccessible for clients from outside
  78
  79 **Known Issues**
  80    N/A
  81
  82 **Other**
  83    - REAL ONAP versus ONAP Test Environment
  84      - CA used in ONAP Test Environment should (of course) NOT be used by individual companies in REAL deployments.
  85      - Cassandra Instance in Kubernetes ONAP Test environment is a single instance.  REAL deployments should follow global, multi-datacenter deployment strategies per Cassandra recommendations.
  86    - AAF team organized all the Identities, all the Credentials, etc, on behalf of ONAP Apps.
  87
  88 **Security Notes**
  89  - AAF has achieved clean scans for everything in authz.git repo
  90  - In the cadi.git (used for Adaptors), there is a Shiro adapter.  Shiro itself has security flags, *NOT* the adapter, so understand the security issues of Shiro before use.
  91
  92  - AAF 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 AAF open Critical security vulnerabilities and their risk assessment have been documented as part of the `project <https://wiki.onap.org/pages/viewpage.action?pageId=43386201>`_.
  93
  94 **Quick Links:**
  95         - `AAF project page <https://wiki.onap.org/display/DW/Application+Authorization+Framework+Project>`_
  96         - `CII Best Practices Silver Badge information for AAF <https://bestpractices.coreinfrastructure.org/en/projects/2303?criteria_level=1>`_
  97         - `CII Best Practices Passing Badge information for AAF <https://bestpractices.coreinfrastructure.org/en/projects/2303?criteria_level=0>`_
  98         - `Project Vulnerability Review Table for AAF <https://wiki.onap.org/pages/viewpage.action?pageId=43386201>`_
  99
 100 **Upgrade Notes**
 101   NA
 102
 103 **Deprecation Notes**
 104
 105 Version: 2.1.1 (Beijing, 2.0.0-ONAP)
 106 --------------------------------------
 107
 108 :Release Date: 2017-06-05
 109
 110
 111 **New Features:**
 112
 113  - Service (primary) – All the Authorization information (more on that in a bit)
 114  - Locate – how to find ANY OR ALL AAF instances across any geographic distribution
 115  - OAuth 2.0 – new component providing Tokens and Introspection (no time to discuss here)
 116  - GUI – Tool to view and manage Authorization Information, and create Credentials
 117  - Certman – Certificate Manger, create and renew X509 with Fine-Grained Identity
 118  - FS – File Server to provide access to distributable elements (like well known certs)
 119  - Hello - Test your client access (certs, OAuth 2.0, etc)
 120
 121 **Bug Fixes**
 122    - `AAF-290 <https://jira.onap.org/browse/AAF-290>`_ Fix aaf truststore
 123    - `AAF-270 <https://jira.onap.org/browse/AAF-270>`_ AAF fails health check on HEAT deployment
 124    - `AAF-286 <https://jira.onap.org/browse/AAF-286>`_ SMS fails health check on OOM deployment
 125    - `AAF-273 <https://jira.onap.org/browse/AAF-273>`_ Cassandra pod running over 8G heap - or 10% of ONAP ram (for 135 other pods on 256G 4 node cluster)
 126
 127
 128 **Known Issues**
 129    N/A
 130
 131 **Other**
 132    - REAL ONAP versus ONAP Test Environment
 133      - Cassandra Instance in Kubernetes ONAP Test environment is a single instance.  REAL deployments should follow global, multi-datacenter deployment strategies per Cassandra recommendations.
 134
 135
 136 **Quick Links:**
 137         - `AAF project page <https://wiki.onap.org/display/DW/Application+Authorization+Framework+Project>`_
 138         - `CII Best Practices Passing Badge information for AAF <https://bestpractices.coreinfrastructure.org/en/projects/2303?criteria_level=0>`_
 139         - `Project Vulnerability Review Table for AAF <https://wiki.onap.org/pages/viewpage.action?pageId=43385140>`_
 140
 141
 142