Vert.x Auth Common
基本术语
- 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接口。