...

• Follow Google Java Style Guide
  • https://google.github.io/styleguide/javaguide.html
  • https://plugins.jetbrains.com/plugin/8527-google-java-format
• Follow SONAR rules
  • SONAR is available at https://sonarcloud.io/dashboard?id=onap_aaf-certservice
  • Code Coverage MUST be at >= 80% level
  • No new violation in the NEW code
• New libraries
  • Before you add a new JAVA library contact with Specificator and Commiter to get confirmation that library can be used in the project!
• Remember to update README.md file (https://gerrit.onap.org/r/gitweb?p=aaf/certservice.git;a=blob;f=certService/README.md;h=db96fa98661586015935c05ac222ef83ca779ff5;hb=HEAD)

Licenses

assertj-core

3.15.0

mockito-core

3.2.4

spring-core

5.2.3.RELEASE

spring-boot-starter

2.2.4.RELEASE

maven-javadoc-plugin

3.1.1

maven-surefire-plugin

3.0.0-M4

spring-boot-starter-actuator

2.2.4.RELEASE

spring-boot-starter-log4j2

2.1.5.RELEASE

spring-cloud-starter-config

springdoc-openapi-ui

1.2.30

bouncycastle

1.60

docker-maven-plugin

0.33.0

spring-cloud-starter-config

Tips & Tricks

...

How to run Jenkins Builds

• Development Procedures and Policies#MagicWords

How to create a new project in ONAP

1. Create a repository in gerrit
   1. Create a ticket at https://jira.linuxfoundation.org/servicedesk/customer/portal/2/create/102?q=create%20repository&q_time=1581674068823
2. Configure pom.xml in project
   1.  An example: https://gerrit.onap.org/r/gitweb?p=aaf/certservice.git;a=blob;f=certService/pom.xml;h=3f17f3904b45f48007c7cf10cb54b2b814447226;hb=HEAD
3. Configure Jenkins Jobs
   
   1. https://gerrit.onap.org/r/c/ci-management/ /101668
   2. Contact person:
      1. jwagantall@linuxfoundation.org
4. Documentation
   1. An example:  https://gerrit.onap.org/r/#/c/cli/ /101293/
   2. Contact person:
      1. sofia.wallin@est.tech
      2. jwagantall@linuxfoundation.org

Records

• CertService with TLS installation Poc <Polish> 

How to

...

As standalone docker:

Simple docker run with environment file

AAFCERT_CLIENT_IMAGE=nexus3.onap.org:10001/onap/org.onap.aaf.certservice.aaf-certservice-client:latest
DOCKER_ENV_FILE= <path to envfile>

docker run --env-file $DOCKER_ENV_FILE $AAFCERT_CLIENT_IMAGE

Enviroment file example:

#Client envs
REQUEST_TIMEOUT=1000
OUTPUT_PATH=/var/log
CA_NAME=Client
#Csr config envs
COMMON_NAME=onap.org
ORGANIZATION=Linux-Foundation
ORGANIZATION_UNIT=ONAP
LOCATION=San-Francisco
STATE=California
COUNTRY=US
SANS=example.com:example2.com

As init container for K8s:

Client's exiting codes:

...

Success

...

create CSR and PK for certificate endpoint

1. Create CSR and PK using openssl;

   1. create configuration file : 

      Code Block
      title csr.config
      [ req ] default_bits = 2048 distinguished_name = req_distinguished_name req_extensions = req_ext [ req_distinguished_name ] countryName = Country Name (2 letter code) countryName_default = US stateOrProvinceName = State or Province Name (full name) stateOrProvinceName_default = California localityName = Locality Name (eg, city) localityName_default = San-Francisco organizationName = Organization Name (eg, company) organizationName_default = Linux-Foundation organizationalUnitName = Organizational Unit Name (eg, section) organizationalUnitName_default = ONAP commonName = Common Name (e.g. server FQDN or YOUR name) commonName_default = onap.org emailAddress = Email Address emailAddress_default = tester@onap.org [ req_ext ] subjectAltName = @alt_names [ alt_names ] DNS.1 = onap.org DNS.2 = test.onap.org

      
      

   2. run openssl command that will generate CSR (onap.csr) and private key (onap.key), using csr.config :

      Code Block
      language bash
      openssl req -out onap.csr -newkey rsa:2048 -nodes -keyout onap.key -config csr.config

      
      

2. Encode CSR and private key in Base64. You can use this  java code to create onap.csr.b64 and onap.key.b64 :

   Code Block
   language java
   private static void encodeCsrAndPkInBase64() throws IOException { String csr = Files.readString(Paths.get(PATH_TO_CSR)); String pk = Files.readString(Paths.get(PATH_TO_PK)); String encodedCsr = new String(Base64.getEncoder().encode(csr.getBytes())); String encodedPk = new String(Base64.getEncoder().encode(pk.getBytes())); Files.writeString(Paths.get(PATH_TO_CSR ".b64"), encodedCsr); Files.writeString(Paths.get(PATH_TO_PK ".b64"), encodedPk); }

   
   

3. Paste  onap.csr.b64 content in to CSR header, and onap.key.b64 content in to PK header in certifcate request

How to run CertService Client

All necessary information could be find in official documentation, see Read The Docs.

Client's exiting codes:

Exiting codes could be find in official documentation, see Read The Docs