包含在AuthProvider包中的RedirectMiddleware
类和InverseRedirectMiddleware
类将帮助您将未经身份验证的请求重定向到给定的路径。这对于将用户从安全页面重定向到登录页面特别有用,反之亦然。
重定向中间件(Redirect Middleware)
我们来看看如何添加RedirectMiddleware
到你的应用程序。
现有认证(Existing Auth)
由于我们只希望将此中间件应用于安全页面,因此我们将使用路由组进行应用。
您应该已经在应用程序中使用其中一个验证中间件了一个保护区。
import Vapor
import AuthProvider
let drop = try Droplet()
drop.get("login") { req in
return // some login form
}
let auth = TokenAuthenticationMiddleware(User.self)
let protected = drop.grouped([auth])
protected.get("secure") { req in
let user = try req.auth.assertAuthenticated(User.self)
return "Welcome to the secure page, \(user.name)"
}
上述代码片段可以通过使用TokenAuthenticationMiddleware
保护对GET /secure
的页面的访问。
由于我们已经申请TokenAuthenticationMiddleware
,任何未经身份验证的人都无法访问该页面。虽然这是非常安全的,但我们应该为未经身份验证的用户提供更好的体验。我们可以将它们重定向到登录页面,而不是向他们显示一条错误消息。
添加重定向(Add Redirect)
创建重定向中间件非常简单。我们将使用其中一个预设来重定向用户到/login
。
let redirect = RedirectMiddleware.login()
现在我们只需要将这个重定向中间件添加到我们protected
之前提到的路由组中。
let protected = drop.grouped([redirect, auth])
警告
确保重定向中间件在 auth中间件之前。
完整示例(Complete Example)
现在每当一个未经身份验证的用户尝试访问GET /secure
时,它们将被重定向到GET /login
。
import Vapor
import AuthProvider
let drop = try Droplet()
let redirect = RedirectMiddleware.login()
let auth = TokenAuthenticationMiddleware(TestUser.self)
let protected = drop.grouped([redirect, auth])
protected.get { req in
let user = try req.auth.assertAuthenticated(TestUser.self)
return "Welcome to the dashboard, \(user.name)"
}
自定义路由(Custom Route)
如果您的登录页面不是/login
,或者您希望重定向中间件重定向到其他类型的页面,那么只需使用完整的初始化程序。
let redirect = RedirectMiddleware(path: "/foo")
逆重定向中间件(Inverse Redirect Middleware)
补充的RedirectMiddleware
是InverseRedirectMiddleware
。就像您想将未经身份验证的用户重定向到安全网页,您也可能希望将身份验证的用户重定向到特定页面。
例如,如果用户已经通过身份验证,并且访问了登录页面,则可能会被困惑,并尝试重新登录。
示例(Example)
以下是InverseRedirectMiddleware
用于将身份验证User
的重定向重定向到登录页面的示例。
我们正在使用预设的.home()
便利方法,将用户重定向到GET /
。
import Vapor
import AuthProvider
let drop = try Droplet()
let redirect = InverseRedirectMiddleware.home(User.self)
let group = drop.grouped([redirect])
group.get("login") { req in
return "Please login"
}
自定义路由(Custom Rout)
如果您所需的页面不是/
,或者您希望反向重定向中间件重定向到其他类型的页面,只需使用完整的初始化程序。
let redirect = InverseRedirectMiddleware(User.self, path: "/foo")