JEECG 單點集成文檔 === kisso 采用的是加密會話 cookie 機制實現單點登錄 SSO 服務，具備“無狀態”、“分散驗 證” 等特性。 1、session 存放在服務器端，cookie 存放在客戶端，存在 2 種狀態：“ 第一種：持久 cookie 具有時效性，以文件的形式存放在客戶機硬盤中， 時間一到生命周期結束自動被刪除。第二種：臨時 cookie 又叫會話 cookie 放在瀏覽器 內存中，瀏覽器關閉生命周期結束自動失效 ”。 2、單純不做任何改變而言 session 更安全，如果 cookie 采取各種安全保護措施，此時的 cookie 一樣安全。 3、cookie 輕松實現分布式服務部署，單點登錄跨域訪問等問題，換成 session 需要處理 session 復制及各種問題實現困難。 ## 一、服務端集成 ### 1. maven依賴jar ``` <!-- kisso begin --> <dependency> <groupId>com.baomidou</groupId> <artifactId>kisso</artifactId> <version>3.6.11</version> </dependency> <dependency> <groupId>com.alibaba</groupId> <artifactId>fastjson</artifactId> <version>1.2.15</version> </dependency> <!-- kisso end --> ``` ### 2. 項目配置文件 (1)spring配置文件 ``` <!-- 單點登錄 kisso 注入初始化，也支持使用 web.xml 初始化 --> <bean id="kissoInit" class="com.baomidou.kisso.web.WebKissoConfigurer" init-method="initKisso"> <property name="ssoPropPath" value="sso.properties" /> <!-- 不同環境配置選擇設置 ,dev_mode/開發模式 ,test_mode/測試模式 ,online_mode/生產模式--> <property name="runMode" value="test_mode" /> </bean> ``` (2)sso.properties文件配置 ``` # 單點登錄信息加密密鑰 sso.secretkey=Kisso4springMvc80mAS # cookie名稱 sso.cookie.name=uid # cookie單點服務器登錄域名（本地測試需要host配置域名，不能使用ip） sso.cookie.domain=.test.com ``` ## 二、客戶端集成 ### 1.Maven依賴jar ``` <!-- kisso begin --> <dependency> <groupId>com.baomidou</groupId> <artifactId>kisso</artifactId> <version>3.6.11</version> </dependency> <dependency> <groupId>com.alibaba</groupId> <artifactId>fastjson</artifactId> <version>1.2.15</version> </dependency> <!-- kisso end --> ``` ### 2.客戶端配置文件 (1)spring配置文件 ``` <!-- kisso 注入初始化，也支持使用 web.xml 初始化 --> <bean id="kissoInit" class="com.baomidou.kisso.web.WebKissoConfigurer" init-method="initKisso"> <property name="ssoPropPath" value="sso.properties" /> <!-- 不同環境配置選擇設置 dev_mode 開發模式 test_mode 測試模式 online_mode 生產模式 --> <property name="runMode" value="test_mode" /> </bean> <mvc:interceptors> <!-- SSO 登錄驗證攔截器 path 對所有的請求攔截使用/**，對某個模塊下的請求攔截使用：/myPath/* --> <mvc:interceptor> <mvc:mapping path="/**" /> <bean class="com.baomidou.kisso.web.interceptor.SSOSpringInterceptor" /> </mvc:interceptor> <!-- SSO 系統權限攔截器 TODO 需要自己實現攔截器來控制權限處理（菜單權限，功能權限控制） --> </mvc:interceptors> ``` (2)sso.properties文件配置 ``` # 單點登錄信息加密密鑰 sso.secretkey=Kisso4springMvc80mAS # cookie名稱 sso.cookie.name=uid # cookie單點服務器登錄域名（本地測試需要host配置域名，不能使用ip） sso.cookie.domain=.test.com # 服務端登錄地址 sso.login.url=http://sso.test.com:8080/jeecg/loginController.do?login ```