Apache Shiro Remember Me服务

r囧r小猫 2022-03-19 05:20 194阅读 0赞

Shiro提供Remember服务，AuthenticationToken需要实现org.apache.shiro.authc.RememberMeAuthenticationToken接口，此接口提供了一个方法：

<table> 
 <tbody> 
  <tr> 
   <td> <p>boolean&nbsp;isRememberMe();</p> </td> 
  </tr> 
 </tbody> 
</table>

如果该方法返回true，则Shiro 将会在整个会话中记住终端用户的身份ID。

注：经常使用的UsernamePasswordToken 已经实现了RememberMeAuthenticationToken 接口，并支持rememberMe 登录。

**编程方式**

编程方式支持RememberMe服务，你可以通过类的接口将其值设为true。比如：

<table> 
 <tbody> 
  <tr> 
   <td> <p>UsernamePasswordToken&nbsp;token&nbsp;=&nbsp;new&nbsp;UsernamePasswordToken(username,&nbsp;password);</p> <p>token.setRememberMe(true);</p> <p>SecurityUtils.getSubject().login(token);</p> <p>…</p> </td> 
  </tr> 
 </tbody> 
</table>

**表单提交方式**

在Web应用中，默认的认证过滤器是FormAuthenticationFilter。它读取一个名为‘rememberMe’表单值来支持 Remember Me 服务，此值是布尔型。比如在你的页面里有一个名为‘rememberMe’的checkbox：

<table> 
 <tbody> 
  <tr> 
   <td> <p>&lt;form&nbsp;...&gt;</p> <p></p> <p>&nbsp;&nbsp;&nbsp;Username:&nbsp;&lt;input&nbsp;type="text"&nbsp;name="username"/&gt;&nbsp;&lt;br/&gt;</p> <p>&nbsp;&nbsp;&nbsp;Password:&nbsp;&lt;input&nbsp;type="password"&nbsp;name="password"/&gt;</p> <p>&nbsp;&nbsp;&nbsp;...</p> <p>&nbsp;&nbsp;&nbsp;&lt;input&nbsp;type="checkbox"&nbsp;name="rememberMe"&nbsp;value="true"/&gt;Remember&nbsp;Me?&nbsp;</p> <p>&nbsp;&nbsp;&nbsp;...</p> <p>&lt;/form&gt;</p> </td> 
  </tr> 
 </tbody> 
</table>

默认的FormAuthenticationFilter会寻找请求参数名为username，password和rememberMe的值。如果你的参数名与这些默认值不同，你可以在FormAuthenticationFilter中进行配置，比如：

<table> 
 <tbody> 
  <tr> 
   <td> <p>[main]</p> <p>...</p> <p>authc.loginUrl&nbsp;=&nbsp;/whatever.jsp</p> <p>authc.usernameParam&nbsp;=&nbsp;somethingOtherThanUsername</p> <p>authc.passwordParam&nbsp;=&nbsp;somethingOtherThanPassword</p> <p>authc.rememberMeParam&nbsp;=&nbsp;somethingOtherThanRememberMe</p> <p>...</p> </td> 
  </tr> 
 </tbody> 
</table>

**Cookie方式**

你可以通过设定\{ \{RememberMeManager\}\}的各个cookie 属性来配置rememberMe。例如：

<table> 
 <tbody> 
  <tr> 
   <td> <p>[main]</p> <p>…</p> <p>securityManager.rememberMeManager.cookie.name&nbsp;=&nbsp;foo</p> <p>securityManager.rememberMeManager.cookie.maxAge&nbsp;=&nbsp;blah</p> <p>...</p> </td> 
  </tr> 
 </tbody> 
</table>

请参见CookieRememberMeManager 及SimpleCookie 的JavaDoc 支持来获取更多的配置属性。

**自定义方式**

应该注意到，默认基于cookie 的RememberMeManager 实现如果不符合你的需求，你可以插入任何你喜欢的插件到 securityManager 当中，就像你配置任何其他对象的引用一样：

<table> 
 <tbody> 
  <tr> 
   <td> <p>[main]</p> <p>...</p> <p>rememberMeManager&nbsp;=&nbsp;com.my.impl.RememberMeManager</p> <p>securityManager.rememberMeManager&nbsp;=&nbsp;$rememberMeManager</p> </td> 
  </tr> 
 </tbody> 
</table>