aec java ios,AG-Gate 是一个基于spring cloud的用户资源授权、api管理授权的网关系统...

简介

AG-Gate 是一个基于spring cloud的用户资源授权、api管理授权的网关系统，以jwt交互的鉴权token来实施，支持基于Eureka注册中心下的服务鉴权和拦截，同时扩展Eureka下服务失效的通知扩展。

网关架构

功能列表

用户管理

角色管理

菜单、动作管理

操作日志

客户端注册

服务管理和授权

网关黑白名单和IP限制(待完善)

服务状态监控与提醒(待完善)

服务追踪(待完善)

快速运行

部署指南

运行ace-gate-way下db脚本

启动一个redis

修改ace-gate-way下的redis配置和数据库配置

jdk1.8

IDE插件一个，lombok插件，具体百度即可

启动指南

依次启动ace-gate-eureka、ace-gate-way

启动鉴权例子ace-gate-demo-provider、ace-gate-demo-client

关于服务失效提醒

可以根据需要扩展不同的消息通知，也可以做钩子结合实效后自动重启服务。

用户指南

AG-Gate主要是给服务之间做JWT鉴权和对外api的鉴权。我们平时无状态的api访问方式分为服务之间的互相调用和提供给外部系统的调用。

原则

需要被保护的服务才需要进行注册。

初始化jwt token认证

ace-gate-way下application.yml，会影响认证的相关信息。

内部服务之间的鉴权

注册保护服务的地址和访问方式

访问客户端的授权(申请clientId和secret，同时授权可访问服务)

内部鉴权建议助手

具体例子可以参考ace-gate-demo

服务提供端如何开启权限拦截

maven依赖，如果没有自行打包

com.github.wxiaoqi

ace-gate-agent

1.0-SNAPSHOT

配置引入

gate:

client:

# 地址为ace-gate-way所在ip端口

authHost: http://localhost:8765/api/authen

# 鉴权头部标志，与客户端一致

authHeader: access-token

配置启用

/**

* Created by ace on 2017/7/6.

*/

@Configuration

public class ApiWebAppConfig extends WebMvcConfigurerAdapter {

@Value("${gate.client.authHost}")

private String authHost;

@Override

public void addInterceptors(InterceptorRegistry registry) {

registry.addInterceptor(new ApiInterceptor(authHost)).addPathPatterns("/**");

super.addInterceptors(registry);

}

}

服务拦截启用，rest方法加上@ApiGateSecurity即可

@ApiGateSecurity

@RequestMapping(value = "/user/un/{username}/system", method = RequestMethod.GET)

@ResponseBody

public String getSystemsByUsername(@PathVariable("username") String username){

int userId = userBiz.getUserByUsername(username).getId();

return JSONObject.toJSONString(menuBiz.getUserAuthoritySystemByUserId(userId));

}

Feign客户端如何自动加上鉴权信息

maven依赖，如果没有自行打包

com.github.wxiaoqi

ace-gate-agent

1.0-SNAPSHOT

配置引入

gate:

client:

# 页面注册的客户信息

clientId: admin-ui

secret: test

# 与服务端authHeader保持一致

authHeader: access-token

authHost: http://localhost:8765/api/authen

# 与ace-gate-way gate.api.tokenHead保持一致

tokenHead: ApiGateToken

配置启用

@Configuration

public class FeignApiConfig {

@Value("${gate.client.clientId}")

private String clientId;

@Value("${gate.client.secret}")

private String secret;

@Value("${gate.client.authHeader}")

private String authHeader;

@Value("${gate.client.authHost}")

private String authHost;

@Value("${gate.client.tokenHead}")

private String tokenHead;

@Bean

public FeignInterceptor authenticationInterceptor() {

return new FeignInterceptor(clientId, secret, authHeader, authHost, tokenHead);

}

}

对外api鉴权

注册保护服务的地址和访问方式

访问客户端的授权(申请clientId和secret，同时授权可访问服务)

外部客户端访问token方式

凭借客户端和密钥申请有效token

请求json方式

{

"clientId":"gate-demo-client",

"secret":"test"

}

请求地址，ace-gate-way所释放的地址

http://[ace-gate-way部署服务器]:[配置端口]/api/authen/auth

凭借有效的token二次访问服务

请求头

以下配置信息来自ace-gate-way的application.yml

[${gate.api.header}]:[${gate.api.tokenHead}][空格][神奇的token]

如默认格式：

access-token:ApiGateToken eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJnYXRlLWRlbW8tY2xpZW50IiwiY3JlYXRlZCI6MTQ5OTk0NzAzNzE1NCwiZXhwIjoxNDk5OTU0MjM3fQ.eL3Ucd2Oh166PDcmHLsKK2A0uJZ6QPxLqRac6enQacBEgQwc2I0qJtkui1V0WjB70VWHpRbHgmzps_dM9jKg0A

外部访问IP黑白名单方式

带实现

欢迎交流