Download pdf - Alfa Install Guide

8/10/2019 Alfa Install Guide

1/16

ALFA Pluginfor Eclipse

Installation Guide


2/16

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 warrantiesof merchantability and tness 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.

Copyright 2013 by Axiomatics AB. All rights reserved.


3/16

1

ALFA Plugin for Eclipse

Installation Guide

2013 Axiomatics AB

www.axiomatics.com

Contents

Introduction 3

Conventions 3

Prerequisites 3

The ALFA update site 5

Testing the ALFA plugin 7

About Axiomatics 11


4/16

2


Installation Guide

2013 Axiomatics AB

www.axiomatics.com


5/16

3


Installation Guide

2013 Axiomatics AB

www.axiomatics.com

Introduction

The Axiomatics Language for Authorization (ALFA) is a domain-specic language for a high-level

description of XACML policies. It is designed for ease of use by developers. In addition, it presents

domain specic information such as attribute identiers 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 le 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

congurations specied in the table below.

Windows 7 Ubuntu 12.10 Mac OS X 10.7.5

Indigo SR2 Java forDevelopers 32 bit

Yes No No

Indigo SR2 Java for

Developers 64 bit

Yes Yes No

Indigo SR2 Java for

EE Developers 32 bit

Yes No No

Indigo SR2 Java for


Yes Yes Yes

Juno SR2 Java for

Developers 32 bit

Yes No No

Juno SR2 Java for

Developers 64 bit

Yes Yes No


6/16

4


Installation Guide

2013 Axiomatics AB

www.axiomatics.com

Windows 7 Ubuntu 12.10 Mac OS X 10.7.5

Juno SR2 Java for


Yes No No

Juno SR2 Java for


Yes Yes Yes

Kepler Java for

Developers 32 bit

Yes No No

Kepler Java for

Developers 64 bit

Yes Yes No

Kepler Java for EE

Developers 32 bit

Yes No No

Kepler Java for EE

Developers 64 bit

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 conguration:

http://download.eclipse.org/modeling/tmf/xtext/updates/composite/releases/

This is done in Eclipse on the menu Help -> Install New Software
http://download.eclipse.org/modeling/tmf/xtext/updates/composite/releases/http://download.eclipse.org/modeling/tmf/xtext/updates/composite/releases/


7/16


8/16

6


Installation Guide

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.


9/16

7


Installation Guide

2013 Axiomatics AB

www.axiomatics.com

Testing the ALFA plugin

The ALFA plugin for Eclipse is now installed. To try it out, create a new project in Eclipse and make a

folder called src. Then create a le with the extension alfa, for instance test.alfa, in the src folder.

Eclipse will ask you to add the Xtext nature to the project. Select yes.

Copy the le system.alfa from the ALFA distribution into the project. This le contains denitions for the

standard XACML functions. Next put the le called standard-attributes.alfa into the project. It contains

attribute ID denitions for the standard attributes from the XACML specication.

Enter the following text into the le test.alfa:


10/16

8


Installation Guide

2013 Axiomatics AB

www.axiomatics.com

namespacetest {

policytestpolicy {

target clauseAttributes.subjectId == alice

applypermitOverrides

rule{

permit

}

}

}

The compiler should have produced an XML le with an XACML policy in a folder called src-gen.


11/16

9


Installation Guide

2013 Axiomatics AB

www.axiomatics.com

The installation is complete.


12/16

10 About Axiomatics


Installation Guide

2013 Axiomatics AB

www.axiomatics.com


13/16

11About Axiomatics


Installation Guide

2013 Axiomatics AB

www.axiomatics.com

About AxiomaticsAxiomatics, located in Stockholm, Sweden, is the leading provider of ne-grained, attribute-based

authorization solutions based on the XACML standard. The company has a global customer base

spanning the health, government and nancal 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
http://www.axiomatics.com/http://www.axiomatics.com/


14/16

12 About Axiomatics


Installation Guide

2013 Axiomatics AB

www.axiomatics.com


15/16


16/16

AXIOMATICS AB

[email protected]

www.axiomatics.com