Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 6 Next »

1. Introduction

The ONAP Security Best Practices is a list of Best Practices recommended by the ONAP sub-committee.  These best practices have the following states:

  • Draft: It is still under discussion in the ONAP security sub-committee
  • Recommended: It is recommended by the security sub-committee but not yet approved by the TSC
  • Approved: It is approved by the TSC.


 2. CII Badging Program.

Status: Approved 

Best Practice:

It is recommended that the ONAP projects are certified as part of the CII badging program.  A gold badge is recommended, however the basic passing badge is the starting point.

This is currently being introduced slowly with 2 projects undergoing certification.

•Basic introduction can be found here: https://github.com/coreinfrastructure/best-practices-badge/blob/master/doc/criteria.md
•Silver/Gold criteria can be found here: https://github.com/coreinfrastructure/best-practices-badge/blob/master/doc/other.md


As additional information, the CLAMP project has been applying the CII badging programe procedures.  Their experience is captured here: https://wiki.onap.org/display/DW/ONAP+security+Recomendation+Developement?src=contextnavpagetreemode 


3. Credential Protection and Management

Status: Draft

Best Practice:


ONAP requires two components to improve the security of credentials used in orchestration.

  1. a secrets vault to store credentials used by ONAP
  2. a process to instantiate credentials

Component 1: Secrets Vault - A service that can be integrated with ONAP that provides secure storage of the credentials used by ONAP to authenticate to VNFs.

Components

1) Vault for secret storage: storage of passwords, secrets, certificates or anything else that  might be used in order to access or authenticate to some system

2) Key Management Server: used to generate/manage crypro keys that are used by other   parts of the system (for example Vault) and perform crypto operations (in case we don’t

   want keys to leave the server)


High high level architecture approach for both components

1) External interface – for consumption by the system

2) Internal implementation interface/plugin system – to enable integration with pre-existing solutions

3) “Naïve” Native implementation – does  all the stuff that required in order for system to be fully operational and secure out of box without any external systems To be used during testing/demoes or by people without hardware solutions

      at place.


Use cases

Use case: provisioning SD-[W,L]AN service over already instantiated Juniper VNFs (or PNFs)

using IPsec tunnel


1)      ONAP got request to service provisioning. Information includes IDs of VNFs that

service should be provisioned over

2)      MSO/SA forwards request to SDN-C

3)      SDN-C sends request to Secrets Vault to retrieve credentials to abovementioned VNFs by their ID

4)      Secrets Vault sends back to SDN-C credentials

5)      SDN-C generates pre-shared key for IPsec tunnel provisioning

6)      SDN-C sends to Secrets Vault request to store pre-shared key

7)      SDN-C using retrieved credentials connects via SSH to VNFs and configures

IPsec tunnel using PSK


Use case extension: at later timeframe SD-[W,L]an service is extended to new branch where VNF needs

to be instantiated


1)      ONAP got request to service provisioning.

2)      MSO instantiates new VNF and passes it to APP-C for initial configuration

3)      APP-C generates random user name and password (aka credentials)

4)      APP-C sends request to Secrets Vault to store credentials by VNF  ID

5)      APP-C configures new VNF to use new credentials

6)      APP-C notifies MSO that it finished

7)      MSO/SA forwards request to SDN-C

8)      SDN-C sends request to Secrets Vault to retrieve credentials to abovementioned VNF by his ID

9)      Secrets Vault sends back to SDN-C credentials

10)   SDN-C sends request to Secrets Vault to retrieve pre shared IPsec key for IPsec tunnel

11)   Secrets Vault sends back IPsec key

12)   SDN-C using retrieved credentials connects via SSH to VNFs and configures IPsec tunnel using retrieved PSK

13)   Everybody happy and everything is secured




  • OpenStack’s Barbican: specific to OpenStack, not a mature service
  • Various commercial services such as LastPass

Recommendation: ONAP should provide a reference implementation of a secrets vault service as an ONAP project.

Next Steps:

  • Find a project lead for a reference implementation.

Component 2: A process to provision ONAP instances with credentials. These credentials may be used for interprocess communication (e.g., APPC calling A&AI) or for ONAP configuring VNFs.

Automatic provisioning of certificates and credentials to ONAP components: AAF can provision certificates. ECOMP DCAE is currently using AAF to provision certificates.

Next steps:

  • Work with the AAF team to include this functionality in Release 2. It is important to understand that the AAF solution depends on the CA supporting the SCEP protocol.
  • Enhance AAF to provision userIDs & passwords to ONAP instances and VNFs. Most VNFs only support userID/password authentication today. ETSI NFV SEC may issue a spec in the future on a more comprehensive approach to using PKI for NFV which can be visited by ONAP SEC when released. Steve is working on this right now but doesn’t know when he’ll be done.

4. Static Code Scans

Status: Draft

Best Practice:

Tools that have been assessed: Coverity Scan (LF evaluation), HP Fortify (AT&T evaluation), Checkmarx (AT&T evaluation), Bandit (AT&T evaluation)

Prelimary Decision: Coverity Scan https://scan.coverity.com/

Description: Coverity Scan is a service by which Synopsys provides the results of analysis on open source coding projects to open source code developers that have registered their products with Coverity Scan. Coverity Scan is powered by Coverity® Quality Advisor. Coverity Quality Advisor surfaces defects identified by the Coverity Static Analysis Verification Engine (Coverity SAVE®). Synopsys offers the results of the analysis completed by Coverity Quality Advisor on registered projects at no charge to registered open source developers.

Current Activity: In conversations with Coverity to understand the definition of “project” – does it refer to ONAP or the projects under an ONAP release to ensure that the limitation on free scans does not lead to bottlenecks in submissions and commits.

Open Source use: 4000+ open source projects use Coverity Scan

Frequency of builds:

Up to 28 builds per week, with a maximum of 4 builds per day, for projects with fewer than 100K lines of code

Up to 21 builds per week, with a maximum of 3 builds per day, for projects with 100K to 500K lines of code

Up to 14 builds per week, with a maximum of 2 build per day, for projects with 500K to 1 million lines of code

Up to 7 builds per week, with a maximum of 1 build per day, for projects with more than 1 million lines of code

Once a project reaches the maximum builds per week, additional build requests will be rejected. You will be able to re-submit the build request the following week.

Languages supported: C/C++, C#, Java, Javascript, Python, Ruby


  • No labels