Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
api
 
 
 
 
src
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

DITAS - PrivacySecurityEvaluator

The PSE is a service used in the blueprint selection phase of DITAS. It's responsible for filtering and ranking the security and privacy properties of a blueprint.

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

Prerequisites

  • Java JDK 8 or later
  • Maven 3 or later

Installing

For installation you have two options, building and running it on your local machine or using the docker approach.

For local testing and building for that you can follow the following steps:

install dependencies (only needs to be done once):

mvn clean install

compile

mvn build

to run locally:

mvn spring-boot:run

Alternatively you can build the provided docker image:

docker build -t ditas/privacy-security-evaluator -f Dockerfile.artifact .

and run it:

docker run -p 8080:8080 ditas/privacy-security-evaluator

Running the tests

For testing you can use:

 mvn test

Configuration

We implemented three different Strategies to rank the incoming blueprints:

  • real - ranks the bluprints on how good they fit the requirements
  • hashBased - ranks the blueprints based on their hash value
  • random - ranks the blueprints randomly

The default strategy is real but for development you can change the profile in the resources/application.properties file.

Api Documentation

Api Documentation

Version: 1.0

License: Apache 2.0

/filter

POST

Summary:

legacy-filter

Description:

evaluates a given blueprint request

Parameters
Name Located in Description Required Schema
input body input No Request
Responses
Code Description Schema
200 ranked blueprint metrics BlueprintRanking
400 Request input did not match expected format or could not be ranked

/v1/filter

POST

Summary:

filter

Description:

evaluates a given blueprint request

Parameters
Name Located in Description Required Schema
input body input Yes Request
Responses
Code Description Schema
200 ranked blueprint metrics BlueprintRanking
400 Request input did not match expected format or could not be ranked

Models

BlueprintRanking

Name Type Description Required
blueprint Feature No
score double No

Feature

Name Type Description Required
description string No
id string No
properties object No
type string No

Property

Name Type Description Required
unit string No
value object No

Request

Name Type Description Required
blueprintAttributes [ Feature ] No
requirement Feature No

Built With

  • Apache Maven 3
  • jre 8
  • Tomcat 8
  • SpringBoot

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

License

This project is licensed under the Apache 2.0 - see the LICENSE.md file for details.

Acknowledgments

This is being developed for the DITAS Project.