Improved Markdown.

This commit is contained in:
Achim D. Brucker 2018-05-13 10:46:46 +02:00
parent a17acb75b6
commit 3c3e98fbc0
1 changed files with 30 additions and 9 deletions

View File

@ -1,4 +1,5 @@
# SecureBPMN # SecureBPMN
[SecureBPMN](https://www.brucker.ch/projects/securebpmn/index.en.html) [SecureBPMN](https://www.brucker.ch/projects/securebpmn/index.en.html)
is a domain-specific modeling language that allows to model security is a domain-specific modeling language that allows to model security
aspects (e.g., access control, separation of duty, aspects (e.g., access control, separation of duty,
@ -13,15 +14,19 @@ on the level of SecureBPMN models as well as refinement properties between
the model and the actual implementation. the model and the actual implementation.
## Installation ## Installation
### SecureBPMN Designer ### SecureBPMN Designer
#### Prerequisites #### Prerequisites
* Eclipse Helios * Eclipse Helios
* SATMC (http://www.ai-lab.it/satmc/), version 3.3.x * SATMC (http://www.ai-lab.it/satmc/), version 3.3.x
(for the formal analysis of secure business processes) (for the formal analysis of secure business processes)
#### Preparing the Eclipse environment #### Preparing the Eclipse environment
* First, install the GenericBreakGlass-XACML into your local
maven repository: First, install the GenericBreakGlass-XACML into your local
maven repository:
``` ```
cd GenericBreakGlass-XACML/src/eu.aniketos.securebpmn.xacml.parent cd GenericBreakGlass-XACML/src/eu.aniketos.securebpmn.xacml.parent
mvn clean eclipse:clean mvn clean eclipse:clean
@ -29,17 +34,20 @@ mvn eclipse:eclipse
mvn install mvn install
cd .. cd ..
``` ```
* To initialize the Eclipse project structure, please do
To initialize the Eclipse project structure, please do
``` ```
cd designer/src//org.activiti.designer.parent cd designer/src//org.activiti.designer.parent
mvn clean eclipse:clean mvn clean eclipse:clean
mvn eclipse:eclipse mvn eclipse:eclipse
cd .. cd ..
``` ```
* After this, all projects can be imported into a fresh Eclipse
workspace using `File -> Import -> Existing Projects into Workspace`. After this, all projects can be imported into a fresh Eclipse
workspace using `File -> Import -> Existing Projects into Workspace`.
#### Generate Model Classes #### Generate Model Classes
1. Open the folder `model` in the project `org.activiti.designer.model` 1. Open the folder `model` in the project `org.activiti.designer.model`
2. Open `BPMN20.genmodel` 2. Open `BPMN20.genmodel`
3. Select the top level node (`bpmn2`) 3. Select the top level node (`bpmn2`)
@ -50,11 +58,14 @@ cd ..
6. Select `Generator -> Generate all` from the top-level menu 6. Select `Generator -> Generate all` from the top-level menu
#### Start Eclipse Application #### Start Eclipse Application
Select the project `org.activiti.designer.eclipse` and select `Run as Select the project `org.activiti.designer.eclipse` and select `Run as
-> Eclipse application` in the context menu (right click). -> Eclipse application` in the context menu (right click).
### SecureBPMN Runtime ### SecureBPMN Runtime
#### Prerequisites #### Prerequisites
Java 6 must be installed and executable: Java 6 must be installed and executable:
``` ```
export JAVA_HOME=<install directory of java 6> export JAVA_HOME=<install directory of java 6>
@ -65,10 +76,12 @@ Moreover, the xalan libraries must be installed:
cd runtime/src/userguide cd runtime/src/userguide
ant install.xalan.libs ant install.xalan.libs
``` ```
### Building the SecureBPMN Runtime ### Building the SecureBPMN Runtime
* If you did not install GenericBreakGlass-XACML into your local
maven repository as part of the installation of the SecureBPMN If you did not install GenericBreakGlass-XACML into your local
Designer: maven repository as part of the installation of the SecureBPMN
Designer:
``` ```
cd GenericBreakGlass-XACML/src/eu.aniketos.securebpmn.xacml.parent cd GenericBreakGlass-XACML/src/eu.aniketos.securebpmn.xacml.parent
mvn clean eclipse:clean mvn clean eclipse:clean
@ -76,37 +89,45 @@ mvn eclipse:eclipse
mvn install mvn install
cd .. cd ..
``` ```
* Compile the SecureBPMN runtime:
Compile the SecureBPMN runtime:
``` ```
cd runtime/src/distro cd runtime/src/distro
ant clean distro ant clean distro
``` ```
If ``ant `clean distro``` is not able to download tomcat, please If ``ant `clean distro``` is not able to download tomcat, please
download `apache-tomcat-6.0.32.zip` and copy it into download `apache-tomcat-6.0.32.zip` and copy it into
`runtime/src/distro/target`. `runtime/src/distro/target`.
### Executing the SecureBPMN Runtime ### Executing the SecureBPMN Runtime
``` ```
cd runtime/src/distro/target/activiti-5.8/setup/ cd runtime/src/distro/target/activiti-5.8/setup/
ant demo.start ant demo.start
``` ```
And open `http://localhost:8080/activiti-explorer` in a web browser. And open `http://localhost:8080/activiti-explorer` in a web browser.
Note that `and demo.stop` will stop the demo and `ant demo.clean` will Note that `and demo.stop` will stop the demo and `ant demo.clean` will
reset the demo setup. reset the demo setup.
## Team ## Team
Main developer: [Achim D. Brucker](http://www.brucker.ch/) Main developer: [Achim D. Brucker](http://www.brucker.ch/)
### Contributors ### Contributors
* Jan Alexander * Jan Alexander
* Matthias Klink * Matthias Klink
* Helmut Petritsch * Helmut Petritsch
* Raj Ruparel * Raj Ruparel
## Publications ## Publications
Related publications are listed on the [SecureBPMN Related publications are listed on the [SecureBPMN
website](https://www.brucker.ch/projects/securebpmn/index.en.html). website](https://www.brucker.ch/projects/securebpmn/index.en.html).
The core publications are: The core publications are:
* Achim D. Brucker. [Integrating Security Aspects into Business Process * Achim D. Brucker. [Integrating Security Aspects into Business Process
Models](http://www.brucker.ch/bibliography/download/2013/brucker-securebpmn-2013.pdf). Models](http://www.brucker.ch/bibliography/download/2013/brucker-securebpmn-2013.pdf).
In it - Information Technology, 55 (6), pages 239-246, 2013. In it - Information Technology, 55 (6), pages 239-246, 2013.