Authentication and Authorisation - Auth Common

优质

小牛编辑

144浏览

2023-12-01

引用：http://vertx.io/docs/vertx-auth-common/java/

基本术语

Authentication：认证
Authorisation：授权
Authority：权限
Permission：许可
Role：角色
User：用户
Token：令牌
Principal：凭证
Handler：处理器

Vert.X Auth项目提供了处理认证和授权的功能，它可以被vertx-web项目使用，若要在自己的项目中运用它，则需要在构建描述信息的dependencies节点中添加如下信息：

Maven（在pom.xml文件中）

  <dependency>
      <groupId>io.vertx</groupId>
      <artifactId>vertx-auth-common</artifactId>
      <version>3.2.1</version>
  </dependency>

Gradle（在build.gradle文件中）

  compile io.vertx:vertx-auth-common:3.2.1

基本概念

认证Authentication：用于验证用户的标识和身份。

授权Authorisation：用于验证用户是否拥有访问系统的许可。

权限Authority：它取决于一些特定的系统实现但对特定的模型不做任何要求；比如：许可/角色permissions/roles模型，可以使事情变得灵活。在一些实现中一个权限可以用来表述一个许可，如：有权限访问所有打印机、或特定打印机。在另外一些实现中则必须支持角色信息，通常使用一些角色信息对权限进行前缀role:命名/标识，如：role:admin。还有一些实现也许会包含更加复杂以及不同的模型来表述权限信息。

如果要了解期望的特定认证提供者Auth Provider，则可以按照文档中的内容实施。

认证

如果要对用户进行认证可使用Provider中的authenticate方法。

这个方法的第一个参数是一个JSON对象，它包含了认证用的信息，实际上这些信息取决于特定的实现；对于简单基于用户名/密码username/password的认证包含了如下信息：

{
    “username": "tim",
    "password": "mypassword"
}

对于一些基于JWT Token或OAuth Bearer Token的实现还会在认证信息中包含令牌Token信息。Vert.X中的认证是异步执行，在调用过程中，认证结果被传给结果处理器中的用户User对象里，异步调用结果包含了一个用户User的实例，这个实例表述了已经认证过的用户信息，并且包含了这些用户允许执行的合法操作。

这里是一个简单的基于用户名/密码username/password认证用户的代码实现：

JsonObject authInfo = new JsonObject().put("username", "tim").put("password", "mypassword");
    authProvider.authenticate(authInfo, res -> {
        if (res.succeeded()) {
            User user = res.result();
            System.out.println("User " + user.principal() + " is now authenticated");
        } else {
            res.cause().printStackTrace();
        }
});

授权

一旦你拥有了一个用户User的实例过后，你就可以调用它的方法对这个用户进行授权。

检查一个用户是否拥有特定权限需要使用它的isAuhorised方法。

上边所有操作的结果都是通过处理器Handler异步调用提供的。

这里是一个对用户授权的例子：

user.isAuthorised("printers:printer1234", res -> {
    if (res.succeeded()) {
        boolean hasAuthority = res.result();
        if (hasAuthority) {
            System.out.println("User has the authority");
        } else {
            System.out.println("User does not have the authority");
        }
    } else {
        res.cause().printStackTrace();
    }
});

另外一个例子对基于角色模型的用户进行授权就是使用role:前缀，请注意，就像上边讨论的一样，权限字符串如何被解释完全取决于底层实现，这里Vert.X不对解释细节提供假设。

权限缓存

用户对象可以缓存任何权限，之后的调用会检查是否拥有同样的权限执行其操作，这个结果实际上调用了底层提供者Provider的方法。

为了清空内部缓存，则你可以使用clearCache方法。

用户凭证

对于已经认证过的用户，你可以调用principal方法获取用户的凭证信息，获取凭证信息的内容同样取决于底层实现。

创建自己的认证实现

如果你希望创建自己的认证提供者Auth Provider则需要创建一个类实现AuthProvider接口。

Vert.X提供了用户对象的抽象实现AbstractUser，你可以创建这个类的子类对自己的用户User对象提供自定义实现。这个抽象实现中包含了缓存逻辑，所以你在实现的时候不需要考虑自己处理缓存问题。

如果你希望在集群环境中使用你的User对象，则需要保证这个用户对象实现了ClusterSerializable接口。