Vapor 2.0 - 重定向中间件(Redirect Middlewares)

前往 Vapor 2.0 - 文档目录

包含在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)

补充的RedirectMiddlewareInverseRedirectMiddleware。就像您想将未经身份验证的用户重定向到安全网页,您也可能希望将身份验证的用户重定向到特定页面。

例如,如果用户已经通过身份验证,并且访问了登录页面,则可能会被困惑,并尝试重新登录。

示例(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")

你可能感兴趣的:(Vapor 2.0 - 重定向中间件(Redirect Middlewares))