iot-dc3/dc3-gateway

DC3 Gateway

Overview

dc3-gateway is the API Gateway of the IoT DC3 platform, built on Spring Cloud Gateway (WebFlux). It serves as the single ingress point for all external HTTP traffic, providing rate limiting, authentication verification, service routing, and reverse proxying.

Module Information

• Group ID: io.github.pnoker
• Artifact ID: dc3-gateway
• Version: 2026.5.17
• Package: io.github.pnoker.gateway

Service Ports

Protocol	Port
HTTP	8000

Key Responsibilities

• Request Routing: Routes /api/v3/{service}/** requests to the corresponding center service via StripPrefix=2
• Authentication Filter: Authentic filter validates Bearer tokens with the Auth Center before forwarding protected routes
• Load Balancing: Uses Nacos or static addresses (dev mode) for backend service discovery
• gRPC Client: Connects to dc3-center-auth (port 9300) for token validation

Routing Rules

Path Pattern	Backend Service	Auth Required
/api/v3/auth/token/**	dc3-center-auth	No
/api/v3/auth/**	dc3-center-auth	Yes
/api/v3/manager/**	dc3-center-manager	Yes
/api/v3/data/**	dc3-center-data	Yes
/api/v3/ekuiper/**	dc3-center-ekuiper	Yes

Dependencies

Business logic is shared via dc3-common-gateway:

<dependency>
    <groupId>io.github.pnoker</groupId>
    <artifactId>dc3-common-gateway</artifactId>
</dependency>

Configuration

• application.yml — base port and profile config
• application-dev.yml — dev env: static gRPC address for auth (dc3-center-auth:9300)
• application-pre.yml — pre-release: Nacos discovery, gateway route definitions
• application-pro.yml — production: Nacos discovery

Running Locally

1. Start Infrastructure

podman compose -f dc3/docker-compose-db.yml up -d

2. Build

mvn -s .mvn/settings.xml clean package

3. Run (start first before any center service)

java -jar dc3-gateway/target/dc3-gateway.jar

Related Modules

• dc3-common-gateway — Authentic filter implementation and gateway utilities
• dc3-api-auth — gRPC API contracts for token validation
• dc3-center-auth — Token validation backend

License

Copyright 2016-present the IoT DC3 original author or authors.

Licensed under the GNU Affero General Public License v3.0 (AGPL 3.0)