Interaction of services by REST when one protected by certificate

Prerequisites

• Maven 3
• JDK 17

Overview

• Article Service with REST endpoints protected by certificate
• Facade Service with REST endpoints. Make calls to Article Service

How to build

mvn clean install

How to run

Run both services

Use

scripts in articles-service and facade-service folders

Run both services (Facade Service will make UNSECURE calls to Articles Service)

Use

script in articles-service folder and

run_via_maven-unsecure_calls.bat

script in facade-service folder

Run both services in Docker containers

docker-compose up

Run both services in Docker containers with rebuild of service images

docker-compose up --build --force-recreate --no-deps

Stop and cleanup started containers

docker-compose down

Swagger documentation

Articles service Swagger page

Facade service Swagger page

How to make calls

Make call to protected Article Service in case of run via .bat scripts

curl -v \
  --cacert _cert/issued-for-localhost/andd3dfx.crt \
  --key _cert/issued-for-localhost/andd3dfx.key \
  https://localhost:9082/api/v1/articles

If you got

error - you need to generate new certificate instead of expired one.

Make call to protected Article Service in case of run via Docker Compose

curl -v --connect-to articles-service:9082:localhost:9082 \
  --cacert _cert/issued-for-articles-service/andd3dfx.crt \
  --key _cert/issued-for-articles-service/andd3dfx.key \
  https://articles-service:9082/api/v1/articles

Used

flag of curl to satisfy cert condition

CN=article-service

If you got

error - you need to generate new certificate instead of expired one.

Make call to Facade Service

curl http://localhost:9081/api/v1/articles

Appendix

Generating a Keystore (PKCS12 format) with self-signed certificate

Based on https://www.baeldung.com/spring-boot-https-self-signed-certificate

keytool -genkeypair -alias andd3dfx -keyalg RSA -keysize 2048 -storetype PKCS12 -keystore andd3dfx.p12 -validity 1825

Dialog during certificate generation:

Enter keystore password: andreika
Re-enter new password: andreika
What is your first and last name?
[Unknown]:  localhost
What is the name of your organizational unit?
[Unknown]:  
What is the name of your organization?
[Unknown]:  andrei-company
What is the name of your City or Locality?
[Unknown]:  Minsk
What is the name of your State or Province?
[Unknown]:  Minsk
What is the two-letter country code for this unit?
[Unknown]:  BY
Is CN=localhost, OU=andrei-dev, O=andrei-dev, L=Minsk, ST=Minsk, C=BY correct?
[no]:  yes

Extract private key from a .P12 file and write it to .PEM file

openssl pkcs12 -in andd3dfx.p12 -nocerts -out andd3dfx.key

(used

as a password for all steps)

Extract the certificate file (the signed public key) from the .P12 file

openssl pkcs12 -in andd3dfx.p12 -clcerts -nokeys -out andd3dfx.crt

(used

as a password for all steps)