# ABAC Auth Provider

We provide an implementation of `AuthorizationProvider` that uses a simple Attribute Based Access Control. The provider is backed by a Policy object which contains matches of attributes against the given user, and on match, the listed authorizations will be granted to the user.

Once the provider returns the authorizations for the user, the mechanism for verification is the same as any other `AuthorizationProvider`.

To use this project, add the following dependency to the dependencies section of your build descriptor:

- Maven (in your `pom.xml`):

    <dependency>
    <groupId>io.vertx</groupId>
    <artifactId>vertx-auth-abac</artifactId>
    <version>5.0.5</version>
    </dependency>

- Gradle (in your `build.gradle` file):

    compile 'io.vertx:vertx-auth-abac:5.0.5'

To create an instance you first need a policy object.

For example:

    {
      "name" : "Only MFA users have DELETE rights",
      "attributes" : {
        "/principal/amr": {
          "eq": "mfa"
        }
      },
      "authorizations" : [ {
        "type" : "wildcard",
        "permission" : "web:DELETE"
      } ]
    }

Once you’ve got one of these you can create a `PolicyBasedAuthorizationProvider` instance as follows:

    Policy policy = new Policy(
      new JsonObject()
        .put("name", "Only MFA users have DELETE rights")
        .put("attributes", new JsonObject()
          .put("/principal/amr", "mfa"))
        .put("authorizations", new JsonArray()
          .add(new JsonObject()
            .put("type", "wildcard")
            .put("permission", "web:DELETE"))));

    PolicyBasedAuthorizationProvider.create()
        .addPolicy(policy);

You can load a single policy from a file, or by code, and load multiple policies to the provider. When multiple policies are loaded, all policies are matched against the user, and all authorizations are returned.

Policies make use of attributes, Vert.x only provides a simple attribute implementation for equality, negation or value in a collection match. Although this is not a limitation, as you can implement your own attribute using composition and register it with the policy.

    Attribute.create(user -> {
      // get the current origin
      return "localhost".equals(user.get("origin"));
    });