FastGateway
้ ็ฝฎ่ฆๆฑ
- JDK 21
- Maven 3.8+
- Docker
- Redis
๐ ้กน็ฎไป็ป
FastGateway ๆฏไธไธช่ฝป้็บงใ้ซๆง่ฝ็ API ็ฝๅ ณๆๅก๏ผๅบไบ Spring Boot 3.x ๅ Spring Cloud ๆๅปบใๅฎๆไพไบไธฐๅฏ็ๅ่ฝ้๏ผๅ ๆฌ้ซๆง่ฝ็่ฏทๆฑ่ทฏ็ฑใๆบ่ฝ่ด่ฝฝๅ่กกใ็ตๆดป็้ๆต็ญ็ฅใๆๅกๅ็ฐใๅฎๅ จๆงๅถ็ญ๏ผๆฏๆๅปบ็ฐไปฃๅๅพฎๆๅกๆถๆ็็ๆณ้ๆฉใ
็ณป็ปๆถๆ
โโโโโโโโโโโโโโโ
โ Client โ
โโโโโโโโฌโโโโโโโ
โ
โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Mo Gateway โ
โ โ
โ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โ
โ โ ่ทฏ็ฑๆจกๅ โ โ ่ฎค่ฏ้ดๆ โ โ ้ๆตๆจกๅ โ โ ่ด่ฝฝๅ่กกๆจกๅ โ โ
โ โ โ โ ๆจกๅ โ โ โ โ โ โ
โ โ โข ่ฏทๆฑ่ทฏ็ฑ โ โ โข JWT่ฎค่ฏ โ โ โข ไปค็ๆกถ โ โ โข ่ฝฎ่ฏข็ฎๆณ โ โ
โ โ โข ่ทฏๅพๅน้
โ โ โข API Key โ โ โข ๆปๅจ็ชๅฃ โ โ โข ๅ ๆ่ฝฎ่ฏข โ โ
โ โ โข ๅ่ฎฎ่ฝฌๆข โ โ โข SPIๆไปถ โ โ โข ๅๅธๅผ โ โ โข ๆๅฐ่ฟๆฅ โ โ
โ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โ
โ โ
โ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โ
โ โ ็ๆงๆจกๅ โ โ ๆๅกๅ็ฐ โ โ ้
็ฝฎ็ฎก็ โ โ ็ผๅญๆจกๅ โ โ
โ โ โ โ ๆจกๅ โ โ ๆจกๅ โ โ โ โ
โ โ โข Prometheusโ โ โข K8sๅ็ฐ โ โ โข ๅจๆ้
็ฝฎ โ โ โข Redis็ผๅญ โ โ
โ โ โข ๅฅๅบทๆฃๆฅ โ โ โข ๅฅๅบทๆฃๆฅ โ โ โข ็ญ้่ฝฝ โ โ โข ่ฎค่ฏ็ผๅญ โ โ
โ โ โข ๆง่ฝๆๆ โ โ โข ๆๅกๆณจๅ โ โ โข ็ฏๅขๅ้ โ โ โข ้ๆต็ถๆ โ โ
โ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ
โผ
โโโโโโโโโโโโโโโ
โ Services โ
โ โ
โ โข Service A โ
โ โข Service B โ
โ โข Service C โ
โโโโโโโโโโโโโโโ
๐ ๆ ธๅฟ็นๆง
1. ้ซๆง่ฝ่ฏทๆฑๅค็
- ้็จ Spring WebFlux ๅๅบๅผ็ผ็จๆจกๅ๏ผๆไพๅ่ถ็ๆง่ฝ่กจ็ฐ
- ๆฏๆ HTTP/2 ๅ่ฎฎ๏ผๅฎ็ฐๆด้ซๆ็็ฝ็ปไผ ่พ
- ๅผๆญฅ้้ปๅก I/O ๅค็๏ผๆ้ซ็ณป็ปๅๅ้
- ๆบ่ฝ็่ฏทๆฑๅ็ผฉๅ็ผๅญ็ญ็ฅ๏ผไผๅๅๅบๆถ้ด
2. ๆบ่ฝ่ด่ฝฝๅ่กก
- ๆไพๅค็ง่ด่ฝฝๅ่กก็ฎๆณ๏ผๆปก่ถณไธๅๅบๆฏ้ๆฑ
- ่ฝฎ่ฏข็ฎๆณ๏ผ้็จไบๆๅกๅฎไพๆง่ฝ็ธ่ฟ็ๅบๆฏ
- ๅ ๆ่ฝฎ่ฏข๏ผๆฏๆๆๅกๅฎไพๅทฎๅผๅ้ ็ฝฎ
- ๆๅฐ่ฟๆฅ๏ผ้็จไบ้ฟ่ฟๆฅๅบๆฏ
- ๅๅบๆถ้ดๅ ๆ๏ผๆ นๆฎๆๅกๅๅบๆถ้ดๅจๆ่ฐๆด
- ่ชๅจๆๅกๅฅๅบทๆฃๆฅ๏ผๅๆถๅ้คๅผๅธธๅฎไพ
- ๆฏๆๅจๆ่ฐๆดๆๅกๆ้๏ผๅฎ็ฐๆด็ฒพ็ป็ๆต้ๆงๅถ
3. ็ตๆดป็้ๆต็ญ็ฅ
- ๅบไบ Redis ็ๅๅธๅผ้ๆต๏ผๆฏๆ้็พค้จ็ฝฒ
- ๅค็ง้ๆต็ฎๆณๆฏๆ๏ผ้ๅบไธๅไธๅกๅบๆฏ
- ไปค็ๆกถ๏ผ้ๅ็ชๅๆต้ๅบๆฏ
- ๆผๆกถ๏ผ้ๅๅนณๆปๆต้ๅบๆฏ
- ๆปๅจ็ชๅฃ๏ผ้ๅ็ฒพ็กฎๆงๅถๅบๆฏ
- ๆฏๆๆๅก็บงๅซใๆฅๅฃ็บงๅซ็้ๆต้ ็ฝฎ
- ๆไพ้ๆต้็บง็ญ็ฅ๏ผไฟ่ฏ็ณป็ปๅฏ็จๆง
4. ๆๅกๅ็ฐไธๆณจๅ
- ๅ็ๆฏๆ Kubernetes ๆๅกๅ็ฐ
- ๆไพ่ชๅฎไนๆๅกๆณจๅๆบๅถ
- ๆฏๆๅจๆๆๅกไธไธ็บฟ
- ๆๅกๅ ๆฐๆฎ็ฎก็๏ผๆฏๆๆๅกๆ ็ญพๅๅฑๆง้ ็ฝฎ
5. ๆไปถๅ่ฎค่ฏ้ดๆ็ณป็ป
- SPI ๆไปถๆถๆ๏ผๅบไบ Java SPI ๆบๅถ็ๅฏๆฉๅฑ่ฎค่ฏ็ณป็ป
- ๅค้่ฎค่ฏ็ญ็ฅ๏ผๆฏๆ JWTใAPI Key ็ญๅค็ง่ฎค่ฏๆนๅผ
- ็ญๆๆๆฏๆ๏ผ่ฎค่ฏๆไปถๅฏๅจๆๅ ่ฝฝๅๅธ่ฝฝ
- ่ฎค่ฏ้พๅผๅค็๏ผๅคไธช่ฎค่ฏๆไพ่ ๆไผๅ ็บง้กบๅบๆง่ก
- ็ผๅญๆบๅถ๏ผRedis ็ผๅญ่ฎค่ฏ็ปๆ๏ผๆๅๆง่ฝ
- ๅฎๆด็ SSL/TLS ๅ ๅฏๆฏๆ
- ๅฏ้ ็ฝฎ็ CORS ็ญ็ฅ
่ฎค่ฏ้ดๆๆถๆๅพ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ่ฎค่ฏ้ดๆๅค็ๆต็จ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๅฎขๆท็ซฏ โโโโโโ ็ฝๅ
ณๅ
ฅๅฃ โ
โ ่ฏทๆฑ โ โ (GatewayController) โ
โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ
โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ่ฎค่ฏๆๅก โ
โ (AuthenticationService) โ
โโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ
โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๆไปถ็ฎก็ๅจ โ
โ (AuthPluginManager) โ
โ โ
โ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ JWT ๆไปถ โ โ API Key ๆไปถ โ โ
โ โ โ โ โ โ
โ โ โโโโโโโโโโโ โ โ โโโโโโโโโโโโโโโโโโโโโโโ โ โ
โ โ โJWT่งฃๆ โ โ โ โ API Key ้ช่ฏ โ โ โ
โ โ โToken โ โ โ โ โ โ โ
โ โ โ้ช่ฏ โ โ โ โ ๆ้ๆฃๆฅ โ โ โ
โ โ โ่ง่ฒๆๅ โ โ โ โ โ โ โ
โ โ โโโโโโโโโโโ โ โ โโโโโโโโโโโโโโโโโโโโโโโ โ โ
โ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ
โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ่ฎค่ฏไธไธๆ โ
โ (AuthenticationContext) โ
โ โ
โ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ ็ผๅญ็ฎก็ โ โ ้
็ฝฎ็ฎก็ โ โ
โ โ โ โ โ โ
โ โ โโโโโโโโโโโ โ โ โโโโโโโโโโโโโโโโโโโโโโโ โ โ
โ โ โRedis โ โ โ โ ๅจๆ้
็ฝฎ โ โ โ
โ โ โ็ผๅญ โ โ โ โ โ โ โ
โ โ โ่ฎค่ฏ็ปๆ โ โ โ โ ็ฏๅขๅ้ โ โ โ
โ โ โโโโโโโโโโโ โ โ โ โ โ โ
โ โโโโโโโโโโโโโโโ โ โ ๅฑๆงๆไปถ โ โ โ
โ โ โโโโโโโโโโโโโโโโโโโโโโโ โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ
โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ่ฎค่ฏ็ปๆ โ
โ (AuthenticationResult) โ
โ โ
โ ๆๅ: ็จๆทไฟกๆฏ + ่ง่ฒ + ๆ้ + ๅ
ๆฐๆฎ โ
โ ๅคฑ่ดฅ: ้่ฏฏไฟกๆฏ + ้่ฏฏ็ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
SPI ๆไปถๅ่ฎค่ฏๆไพ่
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ SPI ่ฎค่ฏๆไปถๆถๆ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
META-INF/services/com.mo.gateway.spi.auth.AuthenticationProvider
โโโ com.mo.gateway.plugin.auth.jwt.JwtAuthenticationProvider
โโโ com.mo.gateway.plugin.auth.apikey.ApiKeyAuthenticationProvider
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ AuthenticationProvider SPI ๆฅๅฃ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ + getProviderName() : String โ
โ + getVersion() : String โ
โ + supports(request) : boolean โ
โ + authenticate(request, context) : AuthenticationResult โ
โ + initialize(config) : void โ
โ + destroy() : void โ
โ + health() : HealthStatus โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โฒ
โ
โโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโโ
โ JWT ่ฎค่ฏๆไพ่
โ โ API Key ่ฎค่ฏๆไพ่
โ
โ โ โ โ
โ โข Token ่งฃๆ โ โ โข Key ้ช่ฏ โ
โ โข ็ญพๅ้ช่ฏ โ โ โข ๆ้ๆฃๆฅ โ
โ โข ่ฟๆๆฃๆฅ โ โ โข ็ผๅญๆฏๆ โ
โ โข ่ง่ฒๆๅ โ โ โข ้ข็้ๅถ โ
โ โข ๆ้ๆๅ โ โ โ
โโโโโโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโโ
6. ็ๆงไธๅฏ่งๆตๆง
- ้ๆ Prometheus ็ๆง็ณป็ป
- ่ฏฆ็ป็่ฏทๆฑ่ฟฝ่ธช
- ไธฐๅฏ็ๆง่ฝๆๆ
- ๅฎๅ็ๅฅๅบทๆฃๆฅๆบๅถ
- ็ปๆๅ็ๆฅๅฟ่ฎฐๅฝ
๐ ๅฟซ้ๅผๅง
็ฏๅข่ฆๆฑ
- JDK 21
- Maven 3.8+
- Docker ๅ Docker Compose
- Redis 7.x
- Kubernetes๏ผๅฏ้๏ผ็จไบ็ไบง็ฏๅข๏ผ
ๆฌๅฐๅผๅ็ฏๅขๆญๅปบ
- ๅ ้้กน็ฎไปฃ็
- ๅฏๅจไพ่ตๆๅก๏ผRedis็ญ๏ผ
- ๆๅปบๅนถ่ฟ่ก้กน็ฎ
- ้ช่ฏๆๅกๆฏๅฆๆญฃๅธธ่ฟ่ก
โ๏ธ ้ ็ฝฎ่ฏดๆ
ๅบ็ก้ ็ฝฎ
็ฝๅ ณๆๅกๆฏๆไธฐๅฏ็้ ็ฝฎ้้กน๏ผๅ ๆฌ๏ผ
- ๆๅก็ซฏๅฃ้ ็ฝฎ
- SSL/TLS ้ ็ฝฎ
- HTTP/2 ๆฏๆ
- ่ฎค่ฏ้ดๆ้ ็ฝฎ
- ้ๆตๅๆฐ้ ็ฝฎ
- ่ด่ฝฝๅ่กก็ญ็ฅ
- ๆๅกๅ็ฐ้ ็ฝฎ
่ฎค่ฏ้ดๆ้ ็ฝฎ
JWT ่ฎค่ฏ้ ็ฝฎ
gateway:
auth:
enabled: true
plugin-directory: plugins
enabled-providers:
- jwt
- apikey
provider-configs:
jwt:
secret: ${JWT_SECRET:your-secret-key}
issuer: ${JWT_ISSUER:mo-gateway}
expiration-minutes: ${JWT_EXPIRATION_MINUTES:60}
API Key ่ฎค่ฏ้ ็ฝฎ
gateway:
auth:
provider-configs:
apikey:
cache-enabled: ${APIKEY_CACHE_ENABLED:true}
cache-expiration-minutes: ${APIKEY_CACHE_EXPIRATION_MINUTES:30}
่ฎค่ฏๆไปถๆฉๅฑ
ๆทปๅ ่ชๅฎไน่ฎค่ฏๆไปถๅช้๏ผ
- ๅฎ็ฐ
AuthenticationProviderๆฅๅฃ - ๅจ
META-INF/services/com.mo.gateway.spi.auth.AuthenticationProviderๆไปถไธญๆณจๅ - ๅฐๆไปถ JAR ๅ
ๆพๅ
ฅ
plugins็ฎๅฝ
่ฏฆ็ป้ ็ฝฎ่ฏดๆ่ฏทๅ่ ้ ็ฝฎๆๅ
็ฏๅขๅ้
ๆฏๆ้่ฟ็ฏๅขๅ้่ฆ็้ป่ฎค้ ็ฝฎ๏ผไธป่ฆ้ ็ฝฎ้กนๅ ๆฌ๏ผ
- ๆๅกๅ็ฐ็ฑปๅ
- Redis ่ฟๆฅไฟกๆฏ
- ้ๆตๅๆฐ
- ๆฅๅฟ็บงๅซ
- ็ๆง้ ็ฝฎ
๐ ไธๅกๆๅกๆฅๅ ฅๆๅ
ๆๅกๆฅๅ ฅๆต็จ
- ๆๅกๆณจๅ
- Kubernetes ็ฏๅข้ ็ฝฎ
- ้ Kubernetes ็ฏๅข้ ็ฝฎ
- ่ฎค่ฏ้ดๆ้ ็ฝฎ
- ้ๆต้ ็ฝฎ
- ่ด่ฝฝๅ่กก้ ็ฝฎ
- ็ๆง้ๆ
่ฎค่ฏ้ดๆไฝฟ็จ็คบไพ
JWT ่ฎค่ฏ่ฏทๆฑ็คบไพ
# ไฝฟ็จ JWT Token ่ฎฟ้ฎๅไฟๆค็API
curl -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
-X GET "http://gateway:8080/api/v1/protected-resource"
API Key ่ฎค่ฏ่ฏทๆฑ็คบไพ
# ไฝฟ็จ API Key ่ฎฟ้ฎๅไฟๆค็API
curl -H "X-API-Key: your-api-key-here" \
-X GET "http://gateway:8080/api/v1/protected-resource"
่ฎค่ฏๅคฑ่ดฅๅๅบ็คบไพ
{
"timestamp": "2024-01-20T10:30:00Z",
"status": 401,
"error": "AUTHENTICATION_FAILED",
"message": "Invalid JWT token",
"path": "/api/v1/protected-resource"
}
่ฏฆ็ปๆฅๅ ฅ่ฏดๆ่ฏทๅ่ ๆๅกๆฅๅ ฅๆๅ
๐ณ ้จ็ฝฒๆๅ
้จ็ฝฒๆนๅผ
- Docker ้จ็ฝฒ
- ๅๆบ้จ็ฝฒ
- ้็พค้จ็ฝฒ
- Kubernetes ้จ็ฝฒ
- ๅบ็ก้จ็ฝฒ
- ้ซๅฏ็จ้จ็ฝฒ
่ฏฆ็ป้จ็ฝฒ่ฏดๆ่ฏทๅ่ ้จ็ฝฒๆๅ
๐ ็ๆงไธ่ฟ็ปด
็ๆงๆๆ
- ๆๅกๅฅๅบท็ถๆ
- ๆง่ฝๆๆ
- ้ๆต็ป่ฎก
- ็ณป็ป่ตๆบไฝฟ็จๆ ๅต
ๆฅๅฟ็ฎก็
- ็ปๆๅๆฅๅฟ
- ๆฅๅฟๆถ้
- ๆฅๅฟๅๆ
่ฏฆ็ป่ฟ็ปด่ฏดๆ่ฏทๅ่ ่ฟ็ปดๆๅ
๐ค ่ดก็ฎๆๅ
ๆฌข่ฟ่ดก็ฎไปฃ็ ๏ผๆไบค Issue ๆ Pull Requestใ่ฏท็กฎไฟ๏ผ
- ้ตๅพชไปฃ็ ่ง่
- ๆทปๅ ๅฟ ่ฆ็ๆต่ฏ
- ๆดๆฐ็ธๅ ณๆๆกฃ
่ฏฆ็ป่ดก็ฎๆๅ่ฏทๅ่ ่ดก็ฎๆๅ
๐ ่ฎธๅฏ่ฏ
ๆฌ้กน็ฎ้็จ MIT ่ฎธๅฏ่ฏ
๐ ่็ณปๆนๅผ
- ้กน็ฎ็ปดๆค่ ๏ผ[Mo]
- ้ฎ็ฎฑ๏ผ[[email protected]]
- ้กน็ฎ้พๆฅ๏ผ[https://github.com/xmopher/gateway.git]