Alfa Install Guide
Alfa Install Guide
for Eclipse
Installation Guide
Disclaimer
Axiomatics AB strives to ensure all documentation is accurate and up to date. However, no warranty
of any kind is made with regard to this material, including, but not limited to, the implied warranties
of merchantability and fitness for a particular purpose. Axiomatics AB shall not be liable for errors
contained herein or for incidental or consequential damages in connection with the furnishing,
performance or use of this material.
Note: The information in this document is subject to change without notice.
Trademarks
All brand names and product names used in this book are the trademarks, registered trademarks, or
trade names of their respective holders.
Title: ALFA Plugin for Eclipse Installation Guide
Document number: 1.0.2-01
Note: New versions of this document may be published on the Axiomatics Customer Support site
without further notice. Visit https://support.axiomatics.com and check the documentation download
area for later versions of this document.
Contents
Introduction
Conventions
Prerequisites
About Axiomatics
11
2013 Axiomatics AB
www.axiomatics.com
2013 Axiomatics AB
www.axiomatics.com
Introduction
The Axiomatics Language for Authorization (ALFA) is a domain-specific language for a high-level
description of XACML policies. It is designed for ease of use by developers. In addition, it presents
domain specific information such as attribute identifiers in compact form and it can be compiled into
XACML 3.0.
This document explains how to install it.
Conventions
On Microsoft Windows, the actual path separator is the backslash character (\) and on Linux the forward
slash (/).
Throughout this guide, the forward slash is used to denote a file system path separator although the actual
separator may be different on the target platform.
Prerequisites
An editor and compiler for ALFA are delivered as an Eclipse plugin. ALFA has been tested with the
configurations specified in the table below.
Windows 7
Ubuntu 12.10
Mac OS X 10.7.5
Yes
No
No
Yes
Yes
No
Yes
No
No
Yes
Yes
Yes
Yes
No
No
Yes
Yes
No
2013 Axiomatics AB
www.axiomatics.com
Windows 7
Ubuntu 12.10
Mac OS X 10.7.5
Yes
No
No
Yes
Yes
Yes
Yes
No
No
Yes
Yes
No
Yes
No
No
Yes
Yes
No
ALFA may work with other architectures but it has only been tested with those listed above.
Note: The following step is needed only for Eclipse Indigo. Later versions do not require it.
The ALFA Plugin for Eclipse has a dependency on the Xtext library, so the following update site must be
enabled in your eclipse configuration:
http://download.eclipse.org/modeling/tmf/xtext/updates/composite/releases/
This is done in Eclipse on the menu Help -> Install New Software
2013 Axiomatics AB
www.axiomatics.com
Press OK and proceed without selecting any of the software available at the Xtext update site.
2013 Axiomatics AB
www.axiomatics.com
Select ALFA Plugin for Eclipse and install it by clicking on Next until you have accepted the license
agreements for ALFA and Xtext.
If you see the above dialog, press OK to proceed with the installation.
You may be asked to restart Eclipse for the changes to take effect.
2013 Axiomatics AB
www.axiomatics.com
Copy the file system.alfa from the ALFA distribution into the project. This file contains definitions for the
standard XACML functions. Next put the file called standard-attributes.alfa into the project. It contains
attribute ID definitions for the standard attributes from the XACML specification.
Enter the following text into the file test.alfa:
2013 Axiomatics AB
www.axiomatics.com
namespace test {
policy testpolicy {
target clause Attributes.subjectId == alice
apply permitOverrides
rule {
permit
}
}
}
The compiler should have produced an XML file with an XACML policy in a folder called src-gen.
2013 Axiomatics AB
www.axiomatics.com
2013 Axiomatics AB
www.axiomatics.com
10
2013 Axiomatics AB
www.axiomatics.com
About Axiomatics
11
About Axiomatics
About Axiomatics
Axiomatics, located in Stockholm, Sweden, is the leading provider of fine-grained, attribute-based
authorization solutions based on the XACML standard. The company has a global customer base
spanning the health, government and financal sectors.
The Axiomatics Policy Server (APS) protects systems against unauthorized use while enabling secure
sharing of information within and across enterprise borders. Axiomatics actively contributes to the
development of the XACML standard and has editorial responsibilities on the OASIS Technical Committee.
http://www.axiomatics.com
2013 Axiomatics AB
www.axiomatics.com
12
2013 Axiomatics AB
www.axiomatics.com
About Axiomatics
AXIOMATICS AB
info@axiomatics.com
www.axiomatics.com