Spring Security入門demo案例
Spring Security是一個高度自定義的安全框架。利用Spring IoC/DI和AOP功能，為系統提供了聲明式安全訪問控制功能，減少了為系統安全而編寫大量重復代碼的工作。主要包含如下幾個重要的內容：
認證（Authentication），系統認為用戶是否能登錄。 授權（Authorization），系統判斷用戶是否有權限去做某些事情。二、入門案例首先引入必要的依賴：
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-security</artifactId></dependency><dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId></dependency>
然后創建一個controller：
@Slf4j@RestControllerpublic class SecurityController { @GetMapping({'/', '/index'}) public String getLogin() {log.info('進入index');return 'index'; }}
此時，我們的入門案例就完成了。啟動項目，Spring Security默認就開啟了，此時訪問localhost:8080/index就會被Spring Security攔截，跳轉到內置的登錄頁面要求登錄。
默認情況下，登錄的用戶名為user，密碼在啟動項目的時候，控制臺有打印出來：
Using generated security password: 0bfad04b-7a47-40fb-ae15-2a4a7c57099b
使用如上的賬密登錄后，再次訪問localhost:8080/index就可以正常返回預期的內容index了。
如果我們不希望使用默認的用戶密碼，可以在配置文件中指定一個，如此Spring Security就會使用我們指定的，而不會使用默認的了。
spring.security.user.name=zhangxunspring.security.user.password=123123三、自定義認證邏輯
當我們開啟自定義認證邏輯后，上面的默認用戶和配置文件中的用戶就不生效了，可以先行刪除。
我們新建一個MySecurityConfig類，并繼承WebSecurityConfigurerAdapter類，用于自定義認證邏輯。
@EnableWebSecuritypublic class MySecurityConfig extends WebSecurityConfigurerAdapter { @Override protected void configure(AuthenticationManagerBuilder auth) throws Exception {// 指定使用BCryptPasswordEncoder對前端傳過來的明文密碼進行encodePasswordEncoder encoder = new BCryptPasswordEncoder();// 用戶的真實密碼需要encode，security是比較兩個密文是否一致auth.inMemoryAuthentication().passwordEncoder(new BCryptPasswordEncoder()).withUser('root').password(encoder.encode('root123')).roles(); }}
需要注意的是，密碼必須使用如上的PasswordEncoder進行編碼，否則會拋出如下錯誤：
java.lang.IllegalArgumentException: There is no PasswordEncoder mapped for the id 'null'
此時，我們重啟應用，訪問localhost:8080/index進入內置的登錄頁面，輸入root/root123之后就能正常返回index內容了。
四、自定義授權邏輯一般權限管理都是基于RBAC模型的，即登錄的用戶肯定擁有某些角色，這些角色允許訪問某些資源。我們先來改造下認證的邏輯：
@Overrideprotected void configure(AuthenticationManagerBuilder auth) throws Exception { PasswordEncoder encoder = new BCryptPasswordEncoder(); auth.inMemoryAuthentication().passwordEncoder(new BCryptPasswordEncoder()).withUser('root').password(encoder.encode('root123')).roles('admin','manager').and().withUser('manager').password(encoder.encode('mm000')).roles('manager');}
使得root用戶擁有admin和manager兩個角色，zhang用戶擁有manager一個角色。
然后我們在該配置類中再增加自定義授權的邏輯：
@Overrideprotected void configure(HttpSecurity http) throws Exception { http.authorizeRequests()// 任何角色允許訪問.antMatchers('/', '/index').permitAll()// 僅admin角色可以訪問.antMatchers('/admin/**').hasRole('admin')// admin和manager兩個角色可以訪問.antMatchers('/manager/**').hasAnyRole('admin', 'manager'); // 沒有權限則進入內置的登錄頁面 http.formLogin();}
然后為了測試，我們還需要增加幾個資源：
@Slf4j@RestControllerpublic class SecurityController { @GetMapping({'/', '/index'}) public String getLogin() {log.info('進入index');return 'index'; } @GetMapping('admin/getHello') public String getAdminHello(){return 'hello admin!'; } @GetMapping('manager/getHello') public String getManagerHello(){return 'hello manager!'; } @GetMapping('guest/getHello') public String getGuestHello(){return 'hello guest!'; }}
此時，重啟項目，我們發現：
訪問/,/index,/guest/**的資源直接就能返回，不需要認證和授權。 訪問/admin/**資源的時候，由于沒有登錄，會跳轉到內置的登錄頁面；如果已經登錄，只有root用戶登錄后才可以訪問； 訪問/admin/**資源的時候，由于沒有登錄，會跳轉到內置的登錄頁面；如果已經登錄，那么root和zhang用戶都能訪問；我們還可以定制自己的登錄頁面，用于替換Spring Security內置的登錄頁面，這塊需要定制html頁面，本文不再詳述，比較簡單，可以參考formLogin的源碼注釋，里面講的比較清楚。
五、注銷登錄因為我們使用的是Spring Security內置的登錄頁面，各個資源返回的也是json字符串，并非頁面，所以如何實現注銷登錄是個問題。但可以通過閱讀HttpSecurity:logout中的源碼注釋，我們基本就能學會怎么操作了。
注銷登錄默認就開啟了，默認是訪問/logout，和/login一樣都是Spring Security自己實現的，我們調用即可； 注銷登錄會清除服務器端的session，清除remember me等設置；這個后面再詳細解說； 注銷登錄后默認會跳轉到/login頁面；還是如上的案例，我們在登錄后，直接調用http://localhost:8080/logout就可以實現上述的注銷登錄功能了。
但是在有些時候，我們會自定義登出的URL以及成功登出后應該跳轉到哪個URL，Spring Security也支持我們進行自定義。
@Override protected void configure(HttpSecurity http) throws Exception {http.authorizeRequests()// 任何角色允許訪問.antMatchers('/', '/index').permitAll()// 僅admin角色可以訪問.antMatchers('/admin/**').hasRole('admin')// admin和manager兩個角色可以訪問.antMatchers('/manager/**').hasAnyRole('admin', 'manager');// 沒有權限進入內置的登錄頁面http.formLogin();// 自定義登出邏輯http.logout().logoutUrl('/myLogOut').logoutSuccessUrl('/index'); }
當Post方式請求/myLogOut的時候就會觸發Spring Security的登出邏輯，并且登出后會跳轉到/index界面。
注意：在本案例中，是使用瀏覽器進行測試的，而且沒有html的頁面，所以使用瀏覽器發起post請求比較困難，那么使用get請求發起可以嗎？默認是不行的，因為Spring Security默認開啟了CSRF校驗，所有改變狀態的請求都必須以POST方式提交，為了能驗證我們這個例子，我們需要把CSRF校驗關掉，即在如上logout代碼后面加上如下的配置：
// 暫時關閉CSRF校驗，允許get請求登出http.csrf().disable();
此時再重啟應用，就可以驗證localhost:8080/myLogOut的登出邏輯了。
六、記住我功能當我們沒有開啟記住我功能的時候，登錄root用戶后，如果關掉瀏覽器，重新打開網址，會發現登錄已經退出了，這是因為登錄信息只在當前會話有效。
如果我們想要在某個時間段以內，一直使root用戶處于登錄狀態，那么就需要在瀏覽器端設置一個cookie，在有效期內，這個cookie所屬的用戶就一直是登錄的狀態。同樣的，只要在上面注銷登錄的代碼后面加上：
// 開啟remember me功能，有效期默認14天http.rememberMe();
此時內置的登錄頁面會出現記住我的選擇框，當我們選擇上登錄后，瀏覽器端就會有當前用戶的cookie信息了（名稱為remember-me），在它過期之前，登錄狀態就一直有效。
需要用戶主動退出登錄，也就是調用我們上面的/myLogOut才能將cookie清除并退出登錄。
如果是自定義的登錄頁面，可以在后面鏈式調用rememberMeParameter()方法，傳入自己的rememberme參數名稱即可。
以上是關于Spring Security的基本使用方法，使用數據庫及其它特性將會在后面的文章中予以說明。
七、會話管理在以上例子中，認證和授權都是Spring Security自動進行的。但是有的時候我們需要管理會話，比如從會話中獲取用戶姓名、用戶的權限信息；會話策略選擇以及會話超時設置等。
我們只需要增加如下的方法即可：
private String getName(){Authentication authentication = SecurityContextHolder.getContext().getAuthentication();Object principal = authentication.getPrincipal();if(principal == null){ return '游客';}if(principal instanceof UserDetails){ UserDetails userDetails = (UserDetails) principal; return userDetails.getUsername();} else{ return principal.toString();} }
該方法使用SecurityContextHolder獲取上下文信息，然后再獲取到其中的用戶名即可，當然其中還提供了可以獲取密碼、權限信息等方法。
Session的管理策略有以下幾種：
always，如果沒有Session就會創建一個； ifRequired，登錄時如果有需要，就創建一個； never，不會主動創建session，如果其它地方創建了session，就會使用它； stateless，不會創建也不會使用session;其中ifRequired是默認的模式，stateless是采用token機制時，session禁用的模式，設置方法如下：
@Override protected void configure(HttpSecurity http) throws Exception {http.sessionManagement().sessionCreationPolicy(SessionCreationPolicy.IF_REQUIRED); }
至于session的超時和安全可以在配置文件中設置：
# 超時時間設置server.servlet.session.timeout=3600s# 瀏覽器腳本將無法訪問cookieserver.servlet.session.cookie.http‐only=true# cookie將僅通過HTTPS連接發送server.servlet.session.cookie.secure=true
到此這篇關于Spring Security入門demo案例的文章就介紹到這了,更多相關Spring Security入門內容請搜索好吧啦網以前的文章或繼續瀏覽下面的相關文章希望大家以后多多支持好吧啦網！
相關文章：
網公網安備