Add mTLS certificates generation documentation

Signed-off-by: Adam Wudzinski <Adam.Wudzinski@nokia.com>
Issue-ID: AAF-1091
Change-Id: I69199e98a50c2e18be7b45bf6097842459247d6e
1 file changed
tree: 14d0cab493801b584bfe62ec0fd1d87bc00786da
  1. certs/
  2. certService/
  3. certServiceClient/
  4. compose-resources/
  5. docs/
  6. releases/
  7. .gitignore
  8. .gitreview
  9. .readthedocs.yaml
  10. checkstyle-suppressions.xml
  11. docker-compose.yml
  12. INFO.yaml
  13. Makefile
  14. pom.xml
  15. README.md
  16. version.properties
README.md

Cert service

General description

More information about the project and all its functionalities you can find under the wiki page: https://wiki.onap.org/display/DW/AAF+Certification+Service

Project consists of two submodules:

  1. aaf-certservice-api
  2. aaf-certservice-client

Detailed information about submodules can be found in README.md in their directories.

Project building

mvn clean package

Install the packages into the local repository

mvn clean install

Building Docker images and install packages into local repository

mvn clean install -P docker
or
make build

Generating certificates

There are example certificates already generated in certs/ directory. In order to generate new certificates, first remove existing ones. Then execute following command from certs(!) directory:

 make

Running Docker containers from docker-compose with EJBCA

Docker-compose uses a local image of certservice-api and make run-client uses a local image of certservice-client Build docker images locally before running docker compose command.

1. Build local images
make build
2. Start Cert Service with configured EJBCA
make start-backend
3. Run Cert Service Client
make run-client
4. Stop Cert Service and EJBCA
make stop-backend

AAF CertService CSITs

CSIT repository

https://gerrit.onap.org/r/admin/repos/integration/csit

####How to run tests locally

  1. Checkout CSIT repository
  2. Configure CSIT local environment
  3. Inside CSIT directory execute
sudo ./run-csit.sh plans/aaf/certservice

####Jenkins build https://jenkins.onap.org/view/CSIT/job/aaf-master-csit-certservice/

Sonar results

https://sonarcloud.io/dashboard?id=onap_aaf-certservice

Maven artifacts

All maven artifacts are deployed under nexus uri:

https://nexus.onap.org/content/repositories/snapshots/org/onap/aaf/certservice/

Docker artifacts

All docker images are hosted under nexus3 uri:

https://nexus3.onap.org/repository/docker.snapshot/v2/onap/org.onap.aaf.certservice.aaf-certservice-api/

How to release containers

https://github.com/lfit/releng-global-jjb/blob/master/docs/jjb/lf-release-jobs.rst