Spring Security 是 Spring 家族中的一個安全管理框架，實際上，在 Spring Boot 出現之前，Spring Security 就已經發展了多年了，但是使用的並不多，安全管理這個領域，一直是 Shiro 的天下。
相對於 Shiro，在 SSM/SSH 中整合 Spring Security 都是比較麻煩的操作，所以，Spring Security 雖然功能比 Shiro 強大，但是使用反而沒有 Shiro 多（Shiro 雖然功能沒有 Spring Security 多，但是對於大部分專案而言，Shiro 也夠用了）。
自從有了 Spring Boot 之後，Spring Boot 對於 Spring Security 提供了 自動化配置方案，可以零配置使用 Spring Security。
因此，一般來說，常見的安全管理技術棧的組合是這樣的：
- SSM + Shiro
- Spring Boot/Spring Cloud + Spring Security
注意，這只是一個推薦的組合而已，如果單純從技術上來說，無論怎麼組合，都是可以執行的。
我們來看下具體使用。
1.專案建立
在 Spring Boot 中使用 Spring Security 非常容易，引入依賴即可：
pom.xml 中的 Spring Security 依賴：
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-security</artifactId>
</dependency>只要加入依賴，專案的所有介面都會被自動保護起來。
2.初次體驗
我們建立一個 HelloController:
@RestController
public class HelloController {
@GetMapping("/hello")
public String hello() {
return "hello";
}
}訪問 /hello ，需要登入之後才能訪問。
當使用者從瀏覽器傳送請求訪問 /hello 介面時，服務端會返回 302 響應碼，讓客戶端重定向到 /login 頁面，使用者在 /login 頁面登入，登陸成功之後，就會自動跳轉到 /hello 介面。
另外，也可以使用 POSTMAN 來傳送請求，使用 POSTMAN 傳送請求時，可以將使用者資訊放在請求頭中（這樣可以避免重定向到登入頁面）：
通過以上兩種不同的登入方式，可以看出，Spring Security 支援兩種不同的認證方式：
- 可以通過 form 表單來認證
- 可以通過 HttpBasic 來認證
3.使用者名稱配置
預設情況下，登入的使用者名稱是 user ，密碼則是專案啟動時隨機生成的字串，可以從啟動的控制檯日誌中看到預設密碼：
這個隨機生成的密碼，每次啟動時都會變。對登入的使用者名稱/密碼進行配置，有三種不同的方式：
- 在 application.properties 中進行配置
- 通過 Java 程式碼配置在記憶體中
- 通過 Java 從資料庫中載入
前兩種比較簡單，第三種程式碼量略大，本文就先來看看前兩種，第三種後面再單獨寫文章介紹，也可以參考我的微人事專案。
3.1 配置檔案配置使用者名稱/密碼
可以直接在 application.properties 檔案中配置使用者的基本資訊：
spring.security.user.name=javaboy
spring.security.user.password=123配置完成後，重啟專案，就可以使用這裡配置的使用者名稱/密碼登入了。
3.2 Java 配置使用者名稱/密碼
也可以在 Java 程式碼中配置使用者名稱密碼，首先需要我們建立一個 Spring Security 的配置類，整合自 WebSecurityConfigurerAdapter 類，如下：
@Configuration
public class SecurityConfig extends WebSecurityConfigurerAdapter {
@Override
protected void configure(AuthenticationManagerBuilder auth) throws Exception {
//下面這兩行配置表示在記憶體中配置了兩個使用者
auth.inMemoryAuthentication()
.withUser("javaboy").roles("admin").password("$2a$10$OR3VSksVAmCzc.7WeaRPR.t0wyCsIj24k0Bne8iKWV1o.V9wsP8Xe")
.and()
.withUser("lisi").roles("user").password("$2a$10$p1H8iWa8I4.CA.7Z8bwLjes91ZpY.rYREGHQEInNtAp4NzL6PLKxi");
}
@Bean
PasswordEncoder passwordEncoder() {
return new BCryptPasswordEncoder();
}
}這裡我們在 configure 方法中配置了兩個使用者，使用者的密碼都是加密之後的字串(明文是 123)，從 Spring5 開始，強制要求密碼要加密，如果非不想加密，可以使用一個過期的 PasswordEncoder 的例項 NoOpPasswordEncoder，但是不建議這麼做，畢竟不安全。
Spring Security 中提供了 BCryptPasswordEncoder 密碼編碼工具，可以非常方便的實現密碼的加密加鹽，相同明文加密出來的結果總是不同，這樣就不需要使用者去額外儲存鹽的欄位了，這一點比 Shiro 要方便很多。
4.登入配置
對於登入介面，登入成功後的響應，登入失敗後的響應，我們都可以在 WebSecurityConfigurerAdapter 的實現類中進行配置。例如下面這樣：
@Configuration
public class SecurityConfig extends WebSecurityConfigurerAdapter {
@Autowired
VerifyCodeFilter verifyCodeFilter;
@Override
protected void configure(HttpSecurity http) throws Exception {
http.addFilterBefore(verifyCodeFilter, UsernamePasswordAuthenticationFilter.class);
http
.authorizeRequests()//開啟登入配置
.antMatchers("/hello").hasRole("admin")//表示訪問 /hello 這個介面，需要具備 admin 這個角色
.anyRequest().authenticated()//表示剩餘的其他介面，登入之後就能訪問
.and()
.formLogin()
//定義登入頁面，未登入時，訪問一個需要登入之後才能訪問的介面，會自動跳轉到該頁面
.loginPage("/login_p")
//登入處理介面
.loginProcessingUrl("/doLogin")
//定義登入時，使用者名稱的 key，預設為 username
.usernameParameter("uname")
//定義登入時，使用者密碼的 key，預設為 password
.passwordParameter("passwd")
//登入成功的處理器
.successHandler(new AuthenticationSuccessHandler() {
@Override
public void onAuthenticationSuccess(HttpServletRequest req, HttpServletResponse resp, Authentication authentication) throws IOException, ServletException {
resp.setContentType("application/json;charset=utf-8");
PrintWriter out = resp.getWriter();
out.write("success");
out.flush();
}
})
.failureHandler(new AuthenticationFailureHandler() {
@Override
public void onAuthenticationFailure(HttpServletRequest req, HttpServletResponse resp, AuthenticationException exception) throws IOException, ServletException {
resp.setContentType("application/json;charset=utf-8");
PrintWriter out = resp.getWriter();
out.write("fail");
out.flush();
}
})
.permitAll()//和表單登入相關的介面統統都直接通過
.and()
.logout()
.logoutUrl("/logout")
.logoutSuccessHandler(new LogoutSuccessHandler() {
@Override
public void onLogoutSuccess(HttpServletRequest req, HttpServletResponse resp, Authentication authentication) throws IOException, ServletException {
resp.setContentType("application/json;charset=utf-8");
PrintWriter out = resp.getWriter();
out.write("logout success");
out.flush();
}
})
.permitAll()
.and()
.httpBasic()
.and()
.csrf().disable();
}
}我們可以在 successHandler 方法中，配置登入成功的回撥，如果是前後端分離開發的話，登入成功後返回 JSON 即可，同理，failureHandler 方法中配置登入失敗的回撥，logoutSuccessHandler 中則配置登出成功的回撥。
5.忽略攔截
如果某一個請求地址不需要攔截的話，有兩種方式實現：
- 設定該地址匿名訪問
- 直接過濾掉該地址，即該地址不走 Spring Security 過濾器鏈
推薦使用第二種方案，配置如下：
@Configuration
public class SecurityConfig extends WebSecurityConfigurerAdapter {
@Override
public void configure(WebSecurity web) throws Exception {
web.ignoring().antMatchers("/vercode");
}
}Spring Security 另外一個強大之處就是它可以結合 OAuth2 ，玩出更多的花樣出來，這些我們在後面的文章中再和大家細細介紹。
本文就先說到這裡，有問題歡迎留言討論。
關注公眾號【江南一點雨】，專注於 Spring Boot+微服務以及前後端分離等全棧技術，定期視訊教程分享，關注後回覆 Java ，領取鬆哥為你精心準備的 Java 乾貨！
