XSRF

XSRF 是一个 Tango 的 XSRF 中间件.

可以起到防止跨站请求伪造和表单重复提交的作用。

安装

  1. go get github.com/tango-contrib/xsrf

示例

  1. type Action struct {
  2.     render.Render
  3.     xsrf.Checker
  4. }
  6. func (a *Action) Get() error {
  7.     return a.Render("test.html", render.T{
  8.         "XsrfFormHtml": a.XsrfFormHtml(),
  9.     })
  10. }
  12. func (a *Action) Post() {
  13.     //中间件会自动检查XSRF，如果校验失败会输出默认的错误信息
  14. }
  16. func main() {
  17.     t := tango.Classic()
  18.     t.Use(xsrf.New(expireTime))  //expireTime为XSRF值的刷新时间
  19.     t.Run()
  20. }

如果希望某个Action不进行校验XSRF，可以在Action结构体中使用xsrf.NoCheck：

  1. type Action struct {
  2.     xsrf.NoCheck
  3. }

如果希望某个Action不自动校验XSRF，改为自己校验XSRF后输出自定义的XSRF错误信息，则需要实现中间件的AutoCheck()方法：

  1. type Action struct {
  2.     xsrf.Checker
  3. }
  5. func (a *Action) AutoCheck() bool {
  6.     return false
  7. }
  9. func (a *Action) Post() {
  10.     if a.IsValid() == false {
  11.         //这里写XSRF校验失败的代码
  12.     }
  13. }

还可以在XSRF校验之后执行 Renew() 方法来生成新的XSRF值，起到防止表单刷新的作用：

  1. type Action struct {
  2.     xsrf.Checker
  3. }
  5. func (a *Action) AutoCheck() bool {
  6.     return false
  7. }
  9. func (a *Action) Post() {
  10.     if a.IsValid() == false {
  11.         //这里写XSRF校验失败的代码
  12.     }
  13.     a.Renew()  //重新生成新的XSRF值，刷新表单时XSRF会校验失败
  14. }