Vapor 2.0 - 认证入门（Getting Started）

Vapor的Auth Provider软件使得实现认证和授权变得简单而安全。它支持常见的验证模式，如：

Token (bearer) authentication 令牌（承载）认证
Username + password (basic) authentication 用户名+密码（基本）认证
Permission-based authorization 基于权限的授权
Session-based persistance 基于会话的持久性
Auth的模块化，基于协议的性质也使其成为定制认证需求的良好基础。

提示
使用vapor new <name> --template=vapor/auth-template
创建一个新的带示例代码的AuthProvider项目模板。

包（Package）

要使用Auth，您需要将Auth Provider添加到您的项目中。这就像在` Package.swift文件中添加以下行一样简单。

.Package(url: "https://github.com/vapor/auth-provider.git", ...)

查看使用认证(Package) 部分了解更多信息。

示例（Example）

我们来看看我们如何使用Vapor和Auth实现一个简单的，基于令牌（token-based）的验证系统。

用户（User）

我们将首先创建一个模型来表示我们的用户。如果你已经有一个用户类，你可以跳过这个步骤。

import Vapor
import FluentProvider

final class ExampleUser: Model {
    let name: String

    ...
}

extension ExampleUser: Preparation { ... }

这里我们创建一个非常简单的用户，只有一个属性：一个名称（name）。

瞧一瞧
我们省略大部分Model和Preparation协议要求。有关这些协议的更多信息，请查看Fluent入门指南(Getting Started) 。

令牌（Token）

接下来，我们创建一个模型来表示我们的身份验证令牌。这些将存储在单独的数据库表或集合中，称为“令牌（tokens）”。

当用户登录时，我们将为它们创建一个新的令牌。然后，他们将在后续请求中使用此令牌，而不是其用户名和密码。

现在，这就是我们的简单的令牌模型。

import Vapor
import FluentProvider

final class ExampleToken: Model {
    let token: String
    let userId: Identifier

    var user: Parent<ExampleToken, ExampleUser> {
        return parent(id: userId)
    }

    ...
}

extension ExampleToken: Preparation { ... }

该令牌有两个属性：

令牌（token）：我们将在请求中发送的唯一的随机字符串
userId：此令牌所属的用户的标识符

瞧一瞧
我们在这里使用Fluent relations。查看关系(Relations) 部分了解更多信息。

令牌认证（Token Authenticatable）

现在我们有我们的示例用户和令牌，我们可以让我们的用户使用令牌进行认证。

这可能听起来很复杂，但实际上很简单：

import AuthProvider

extension ExampleUser: TokenAuthenticatable {
    // the token model that should be queried
    // to authenticate this user
    public typealias TokenType = ExampleToken
}

现在我们的示例用户是TokenAuthenticatable，我们可以继续下一步！

用户助手（User Helper）

让我们添加一个简单的便利方法来请求访问经过身份验证的用户。

extension Request {
    func user() throws -> ExampleUser {
        return try auth.assertAuthenticated()
    }
}

这是一个很好的捷径，将在几个步骤中派上用场。

中间件（Middleware）

要求认证，我们需要添加 TokenAuthenticationMiddleware。您可以将此中间件应用于单个路由或整个Droplet。为了简单起见，我们将其应用于Droplet。

import Vapor
import AuthProvider
import FluentProvider

let config = try Config()

config.preparations.append(ExampleUser.self)
config.preparations.append(ExampleToken.self)

let drop = try Droplet(config)


let tokenMiddleware = TokenAuthenticationMiddleware(ExampleUser.self)

/// use this route group for protected routes将此路由组用于受保护的路由
let authed = drop.grouped(tokenMiddleware)

由于我们的ExampleUser类是TokenAuthenticatable，我们可以将其传递给中间件的init方法。

** 瞧一瞧**
如果您只想要对某些路由进行身份验证，请查看
路由文档中的Route Group部分。

路由（Route）

现在我们有一个由我们的TokenMiddleware保护的路由组，我们添加一个路由来返回经过身份验证的用户名。

authed.get("me") { req in
    // return the authenticated user's name
    return try req.user().name
}

提示
我们正在使用.user()我们在Request这里添加的方便。这是一个捷径let user = try req.auth.assertAuthenticated(ExampleUser.self)

数据库（Database）

就是这样!我们现在有一个功能认证系统。让我们几个条目添加到数据库,并对其进行测试。

用户（Users）

id	name
1	Bob

令牌（Tokens）

id	token	user_id
1	foo	1

请求（Request）

现在我们可以向我们的Vapor应用程序发出请求。

GET /me HTTP/1.1
Authorization: Bearer foo

我们应该得到一个回应。

HTTP/1.1 200 OK
Content-Type: text/plain

Bob

坏令牌（Bad Token）

为了确保它的安全性，让我们使用不在我们的数据库中的令牌进行测试。

GET /me HTTP/1.1
Authorization: Bearer not-a-token