【JEECG技术文档】JEECG 接口权限开发及配置使用说明
1.功能介紹
通過接口配置實現(xiàn),對接口的訪問權限控制和數(shù)據(jù)權限控制,接口時REST接口,接口權限認證機制使用Json web token (JWT)
接口權限調(diào)用流程:
? ? (1)通過接口用戶的用戶名密碼,調(diào)用鑒權token接口獲取接口用戶的token
? ? ? ? ? ? ?該token,2個小時內(nèi)有效
? ? (2)把獲取的token作為參數(shù),調(diào)用接口的時候,會根據(jù)token去鑒權
? ? (3)鑒權通過,接口會根據(jù)接口定義的編碼,檢驗是否有訪問權限
? ? ? ? ? ? 有則可以繼續(xù)訪問,無則提示訪問受限
? ? (4)有訪問權限,則獲取接口的數(shù)據(jù)權限規(guī)則,根據(jù)授權的數(shù)據(jù)權限規(guī)則返回需要的數(shù)據(jù)
?????實現(xiàn)一個新的接口,無需關注token的鑒權機制,需要實現(xiàn)以下步驟:
? ? (1)開發(fā)一個rest接口
? ? (2)枚舉類InterfaceEnum中定義接口編碼
? ?(3)調(diào)用InterfaceUtil工具類getInterfaceRuleDto獲取接口權限,驗證是否有訪問權限,并獲取數(shù)據(jù)權限
? ?(4)根據(jù)獲取的數(shù)據(jù)權限,組裝查詢條件返回接口數(shù)據(jù)
2.?權限接口定義
開發(fā)一個接口rest接口,
public?enum?InterfaceEnum ??類中定義接口編碼
blacklist_list("blacklist_list", "黑名單分頁查詢", "/rest/tsBlackListController", "GET", 1) blacklist_list 為接口編碼
3.?接口管理
3.1 ?配置接口權限,
? ? 接口權限管理--接口權限錄入,
??
? 接口添加:
說明:
- ? ? 接口權限編碼:該編碼比較重要,每個接口一個編碼,不能重復。該編碼由開發(fā)者制定(見接口權限開發(fā),接口編碼定義)
- ? ? 接口權限名稱:定義名稱
- ? ? 接口權限等級:一級權限,下級權限區(qū)分
- ? ? 父級接口:上下級關系維護(父子關系)
- ? ? 接口權限地址:接口請求地址
- ?請求方式:GET、POST、PUT、DELETE
- ? ? 接口權限排序:樹形列表展示的順序
? ? 以上信息:接口權限編碼字段比較重要,其他的字段與權限控制無關,只做說明使用
3.2 增加數(shù)據(jù)規(guī)則權限
????
?
4.?創(chuàng)建接口角色
4.1 創(chuàng)建接口角色,進行角色授權,然后分配角色給接口用戶
? ? ??接口權限---接口角色管理 ??創(chuàng)建接口角色
?
5.?接口開發(fā)實現(xiàn)
接口中增加業(yè)務邏輯:
5.1 校驗接口訪問權限
InterfaceRuleDto interfaceRuleDto = InterfaceUtil.getInterfaceRuleDto(request, InterfaceEnum.blacklist_list);if(interfaceRuleDto==null){return Result.error("您沒有該接口的權限!");}
5.2 接口權限規(guī)則注入
?????方案一:
?????查詢器處理
? ? 方案二:
? ? Sql和hql 處理
String qlStr = InterfaceUtil.getQL(interfaceRuleDto, InterfaceEnum.blacklist_list);
? 把組裝的qlStr 追加到查詢語句中
6.?接口測試
//獲取token public static String getToken(String userName,String password){String url = "http://localhost:8888/jeecg-bpm/rest/tokens?username="+userName+"&password="+password;String token= JwtHttpUtil.httpRequest(url, "POST", null);return token;}//獲取黑名單列表public static JSONObject getBlackList(String token){String url = "http://localhost:8888/jeecg-bpm/rest/tsBlackListController";JSONObject resp= JwtHttpUtil.httpRequest(url, "GET", null,token);return resp;}public static void main(String[] args) {//接口角色授權的用戶賬號密碼String token = getToken("interfaceuser","123456");//獲取黑名單列表System.out.println("======獲取黑名單列表======="+getBlackList(token));}
總結
以上是生活随笔為你收集整理的【JEECG技术文档】JEECG 接口权限开发及配置使用说明的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: hdu 1024(滚动数组优化)
- 下一篇: 如何删除mysql-bin.0000X