https://github.com/wso2/balana

https://github.com/wso2/balana

java wso2-balana xacml

Last synced: 3 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/wso2/balana
• Owner: wso2
• License: apache-2.0
• Created: 2014-02-26T09:17:19.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2024-10-08T06:55:18.000Z (about 1 month ago)
• Last Synced: 2024-11-08T14:45:00.741Z (10 days ago)
• Topics: java, wso2-balana, xacml
• Language: Java
• Size: 4.13 MB
• Stars: 122
• Watchers: 109
• Forks: 110
• Open Issues: 43
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
WSO2 Balana Implementation

==========================

---

|  Branch | Build Status |

| :------------ |:-------------

| master      | [![Build Status](https://wso2.org/jenkins/buildStatus/icon?job=forked-dependencies/balana)](https://wso2.org/jenkins/job/forked-dependencies/job/balana) |

---

## Welcome to WSO2 Balana

Balana is WSO2's open source implementation of the XACML specification building on [Sun's XACML Implementation](http://sunxacml.sourceforge.net/). As the name suggests Balana(the fortress) is a powerful entitlement engine to externalize authorization from your applications. With it's modular architecture you can easily develop a fully fledged entitlement solution in no time.

#### Specifications Supported by Balana

Balana supports the [XACML 3.0](http://docs.oasis-open.org/xacml/3.0/xacml-3.0-core-spec-os-en.html), [2.0](https://docs.oasis-open.org/xacml/2.0/access_control-xacml-2.0-core-spec-os.pdf), [1.1](https://d9db56472fd41226d193-1e5e0d4b7948acaf6080b0dce0b35ed5.ssl.cf1.rackcdn.com/committees/xacml/repository/cs-xacml-specification-1.1.pdf) and [1.0](https://www.oasis-open.org/committees/download.php/2406/oasis-xacml-1.0.pdf) specifications.

### Installation

Add the following dependency to your pom.

```xml

    org.wso2.balana

    org.wso2.balana

    1.1.12

 

```

### Getting Started

You can easily create a default instance of Balana with a file based policy repository as follows.

```java

private static Balana balana;

private static void initBalana() {

        try{

            // Using file based policy repository. so set the policy location as a system property

            String policyLocation = (new File(".")).getCanonicalPath() + File.separator + "resources";

            System.setProperty(FileBasedPolicyFinderModule.POLICY_DIR_PROPERTY, policyLocation);

        } catch (IOException e) {

            System.err.println("Can not locate policy repository");

        }

        // Create default instance of Balana

        balana = Balana.getInstance();

    }

```

### Running Samples

1) Install Java SE Development Kit 1.8

2) Install Apache Maven 3.x.x(https://maven.apache.org/download.cgi#)

3) Get a clone from https://github.com/wso2/balana.git or download the source

4) Run ``mvn clean install`` from balana directory

5) Move to balana/modules/balana-samples/``

6) Execute run script

Here are the samples included.

* [kmarket-trading-sample](modules/balana-samples/kmarket-trading-sample)

* [hierarchical-resource](modules/balana-samples/hierarchical-resource)

* [custom-combining-algo](modules/balana-samples/custom-combining-algo)

* [web-page-image-filtering](modules/balana-samples/web-page-image-filtering)

### License

License of Sun's XACML implementation can be found at [here](http://sunxacml.sourceforge.net/license.txt). But WSO2 Balana implementation is released under [Apache2 license](http://www.apache.org/licenses/LICENSE-2.0).