View on GitHub

Attack Graphs Plugin for

An Attack Graphs Extension for

Computed Attributes Functions

This plugin allows to specify a computed attributes function for any shape in the diagram. The user can access the computed attributes function of a cell by clicking the handle displayed on the right-hand side of the cell.

image of cell handles

Computed attributes functions take attributes of the current cell and return the resulting computed attribute to the cell. There can be a default computed attribute function, which will be used by default by new cells. A default computed attribute function can be defined by naming a function default in the global computed attribute function dialog. If no default function was specified, cells will use the None function and will not calculate computed attributes.

When clicking on the eye-icon displayed on the lower right-hand side of the cell, the cell can be disabled and re-enabled. If the cell is disabled (slashed eye), its values are not considered by parent cells, effectively disconnecting it from its parents.

The computed attributes function dialog allows to specify a custom computed attributes function or to select a global computed attributes function by reference.


Expected return value

Computed attributes functions must return a dictionary (KeyValuePairs) containing a value for the computed attribute. If desired, the function can further return color information to improve the presentation of batches.

The following dictionary is expected to be returned by computed attributes functions:

  "value": string, // Value to display in the batch (e.g. "S")
  "fillColor": string, // optional, hex color for the batch (e.g. "#ffdd00")
  "fontColor:" string // optional, hex color for the font (e.g. "#000000")

Please note that the fillColor and fontColor are optional keys. If they are not set, they default to #f00 and #fff respectively.

For backwards compatability, newer plugin version are able to handle the return value of computed attributes functions using the old API. The return value is treated as the value to be displayed in the batch. The colors are set according to their respective default value.

Relevant data types

type KeyValuePairs = { [k: string]: string }
type GlobalAttributeDict = { [name: string]: GlobalAttribute}

type GlobalAttribute = {
  name: string,
  value: string,
  min: string,
  max: string,

type CellDataCollection = {
  globalAttributes: GlobalAttributeDict,
  cellAttributes: KeyValuePairs,

Example of a computed attributes function accessing the value of a cell attribute

    return {"value": parseInt(collection.cellAttributes["A"]) + 5};

Example of a computed attributes function accessing a global attribute’s maximum value

    return {"value": collection.globalAttributes["Knowledge"].max};

Testing functions

To write working js functions more easily, you can use the provided Testbench.js file. It provides example data structured in the way aggregation functions and computed attributes functions will receive the data in an AttackGraph.

It is recommended to copy the code into the debugger of your choice, or an online tool like JSFiddle for better debugging functionality.