Table of Contents

1. Summary
   • Services
   • Features
2. Getting Started
   • Prerequisites
   • Installation
3. References

---

Summary

• api-gateway-service project established by combination of the following services and features

Services

 * api-gateway
 * payment-service
 * student-service
 * swagger-application
 * openai-service
 * service-registry

Features

 * Spring Cloud Gateway
 * SpringDoc Swagger
 * Event Driven Architecture with RabbitMQ
 * micrometer-tracing dependencies to track the logs
 * Postman collection to test by using Postman
 * Keycloak integration is completed under the payment-service
 * Feign Client secure call with Keycloak integration is completed under the student-service
 * MDC was added to improve logging between microservices
 * Google reCAPTCHA was added to secure endpoint calls
 * HCaptcha repo migration is completed under the student-service
 * openai-service repo migration is completed
 * Spring Cloud Eureka Server and Client integrations are completed with service-registry repo
 * KubernetesDeploymentGuide.md is added

---

Getting Started

• To get a local copy up and running please follow these steps

---

Prerequisites

• Followings should be installed and links for how to install them
  • Java 21 or higher How to install Java
    • Set JAVA_HOME to 21 -> export JAVA_HOME=$(/usr/libexec/java_home -v 21)
  • Maven How to install Maven
  • Docker How to install Docker
  • Postman can be installed (OPTIONAL), follow how to import postman collection to import files that are under the postman_collection folder
  • Create a new secret key via this url, copy the value, and add it as YOUR_API_KEY_HERE value in the .env
  • Google reCAPTCHA installation (OPTIONAL)
    • Log in to the https://www.google.com/recaptcha/admin/create
    • Fill the necessary fields.
      • This url can guide you
    • Copy SITE_KEY and SECRET_KEY and add them into related fields that are in the .env
  • HCaptcha integration was implemented in 4 different ways in HCaptchaController.java (OPTIONAL)

---

Installation

1. Clone the repo

    git clone https://github.com/musabbozkurt/api-gateway-service.git

2. Run all services

   • (OPTION 1)
     • Run docker-compose --profile start_application up -d --build command in the docker-compose.yml directory
   • (OPTION 2)
     1. Enable spring.docker.compose property and just run ApiGatewayApplication.java to install RabbitMQ, PostgreSQL and Keycloak
     2. Run mvn clean install or mvn clean package command under each service's directory
     3. Run mvn spring-boot:run command under each service's directory

3. Log in to http://localhost:9090/admin with username: admin and password: admin
   1. Create realm --> Import payment-service-realm-export.json
   2. Clients --> payment-service --> Credentials --> Regenerate copy the value and add it as PAYMENT_CLIENT_SECRET_ENV value in the .env
   3. Users --> Add user --> Username --> payment-service-user
   4. Users --> payment-service-user --> Credentials --> Set password to test and turn off Temporary toggle
   5. Users --> payment-service-user --> Role Mapping --> Assign role add admin role
   6. Restart student-service to fetch PAYMENT_CLIENT_SECRET

4. Additional information to access endpoints, swagger and actuator

   • Swagger: http://localhost:8080/swagger-ui.html
     • Open Swagger --> select Payment Service definition --> Click Authorize
       1. Enter the following credentials into the pop-up window
          1. username: payment-service-user
          2. password: test
          3. client_id: payment-service
          4. client_secret: PAYMENT_CLIENT_SECRET_ENV value in the .env
       2. 
       3. Click Authorize to get token
       4. Click Close and test the services
   • Actuator: http://localhost:8080/actuator
   • Eureka: http://localhost:8761/

5. Kubernetes Deployment Guide (OPTIONAL)

---

References

• References

---