API doc (for dev)

GET /api/render-live-template

API: render_live_tpl :param name: the client name if any. You can also use the GET parameter ‘name’ to achieve the same thing :returns: HTML that should be included directly into the page

GET /api/running-clients.json

GET method provided by the webservice.

The JSON returned is:

{
    "results": [ ]
}

The output is filtered by the burpui.misc.acl module so that you only see stats about the clients you are authorized to.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
  • client (str) – Ask a specific client in order to know if it is running a backup
Returns:

The JSON described above.

GET /api/clients-report.json

GET method provided by the webservice.

The JSON returned is:

{
  "results": [
    {
      "backups": [
        {
          "name": "client1",
          "number": 15
        },
        {
          "name": "client2",
          "number": 1
        }
      ],
      "clients": [
        {
          "name": "client1",
          "stats": {
            "total": 296377,
            "totsize": 57055793698,
            "windows": "false"
          }
        },
        {
          "name": "client2",
          "stats": {
            "total": 3117,
            "totsize": 5345361,
            "windows": "true"
          }
        }
      ]
    }
  ]
}

The output is filtered by the burpui.misc.acl module so that you only see stats about the clients you are authorized to.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
Returns:

The JSON described above

GET /api/server-config

GET method provided by the webservice.

The JSON returned is:

{
  "boolean": [
    "daemon",
    "fork",
    "..."
  ],
  "defaults": {
    "address": "",
    "autoupgrade_dir": "",
    "ca_burp_ca": "",
    "ca_conf": "",
    "ca_name": "",
    "ca_server_name": "",
    "client_can_delete": true,
    "...": "..."
  },
  "integer": [
    "port",
    "status_port",
    "..."
  ],
  "multi": [
    "keep",
    "restore_client",
    "..."
  ],
  "placeholders": {
    "autoupgrade_dir": "path",
    "ca_burp_ca": "path",
    "ca_conf": "path",
    "ca_name": "name",
    "ca_server_name": "name",
    "client_can_delete": "0|1",
    "...": "..."
  },
  "results": {
    "boolean": [
      {
        "name": "hardlinked_archive",
        "value": false
      },
      {
        "name": "syslog",
        "value": true
      },
      { "...": "..." }
    ],
    "clients": [
      {
        "name": "testclient",
        "value": "/etc/burp/clientconfdir/testclient"
      }
    ],
    "common": [
      {
        "name": "mode",
        "value": "server"
      },
      {
        "name": "directory",
        "value": "/var/spool/burp"
      },
      { "...": "..." }
    ],
    "includes": [],
    "includes_ext": [],
    "integer": [
      {
        "name": "port",
        "value": 4971
      },
      {
        "name": "status_port",
        "value": 4972
      },
      { "...": "..." }
    ],
    "multi": [
      {
        "name": "keep",
        "value": [
          "7",
          "4"
        ]
      },
      { "...": "..." }
    ]
  },
  "server_doc": {
    "address": "Defines the main TCP address that the server listens on. The default is either '::' or '0.0.0.0', dependent upon compile time options.",
    "...": "..."
  },
  "string": [
    "mode",
    "address",
    "..."
  ],
  "suggest": {
    "compression": [
      "gzip1",
      "gzip2",
      "gzip3",
      "gzip4",
      "gzip5",
      "gzip6",
      "gzip7",
      "gzip8",
      "gzip9"
    ],
    "mode": [
      "client",
      "server"
    ],
    "...": []
  }
}
Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
Returns:

The JSON described above.

GET /api/running.json

GET method provided by the webservice.

The JSON returned is:

{
    "results": false
}

The output is filtered by the burpui.misc.acl module so that you only see stats about the clients you are authorized to.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
Returns:

The JSON described above.

GET /api/clients.json

GET method provided by the webservice.

The JSON returned is:

{
  "results": [
    {
      "last": "2015-05-17 11:40:02",
      "name": "client1",
      "state": "idle"
    },
    {
      "last": "never",
      "name": "client2",
      "state": "idle"
    }
  ]
}

The output is filtered by the burpui.misc.acl module so that you only see stats about the clients you are authorized to.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
Returns:

The JSON described above

GET /api/servers.json

The burpui.api.servers.ServersStats resource allows you to retrieve statistics about servers/agents.

This resource is part of the burpui.api.servers module.

GET /api/live.json

API: live :returns: the live status of the server

GET /clients-report

Global report

GET /live-monitor

Live status monitor view

GET /client

Specific client overview

GET /

Home page

GET /api/(server)/client-tree.json/(name)/(int: backup)

GET method provided by the webservice.

The JSON returned is:

{
  "results": [
    {
      "date": "2015-05-21 14:54:49",
      "gid": "0",
      "inodes": "173",
      "mode": "drwxr-xr-x",
      "name": "/",
      "parent": "",
      "size": "12.0KiB",
      "type": "d",
      "uid": "0"
    }
  ]
}

The output is filtered by the burpui.misc.acl module so that you only see stats about the clients you are authorized to.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
  • name (str) – The client we are working on
  • backup (int) – The backup we are working on
Returns:

The JSON described above.

GET /api/(server)/client-stat.json/(name)/(int: backup)

GET method provided by the webservice.

The JSON returned is:

{
  "results": {
    "dir": {
      "changed": 0,
      "deleted": 0,
      "new": 394,
      "scanned": 394,
      "total": 394,
      "unchanged": 0
    },
    "duration": 5,
    "efs": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "encrypted": true,
    "end": 1422189124,
    "files": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "files_enc": {
      "changed": 0,
      "deleted": 0,
      "new": 1421,
      "scanned": 1421,
      "total": 1421,
      "unchanged": 0
    },
    "hardlink": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "meta": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "meta_enc": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "number": 1,
    "received": 1679304,
    "softlink": {
      "changed": 0,
      "deleted": 0,
      "new": 1302,
      "scanned": 1302,
      "total": 1302,
      "unchanged": 0
    },
    "special": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "start": 1422189119,
    "total": {
      "changed": 0,
      "deleted": 0,
      "new": 3117,
      "scanned": 3117,
      "total": 3117,
      "unchanged": 0
    },
    "totsize": 5345361,
    "vssfooter": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "vssfooter_enc": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "vssheader": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "vssheader_enc": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "windows": "false"
  }
}

The output is filtered by the burpui.misc.acl module so that you only see stats about the clients you are authorized to.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
  • name (str) – The client we are working on
  • backup (int) – The backup we are working on
Returns:

The JSON described above.

POST /api/(server)/restore/(name)/(int: backup)

POST method provided by the webservice. This method returns a flask.Response object.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
  • name (str) – The client we are working on
  • backup (int) – The backup we are working on
Returns:

A flask.Response object representing an archive of the restored files

GET /(server)/client-browse/(name)/(int: backup)/(int: encrypted)

Browse a specific backup of a specific client

GET /client-browse/(name)/(int: backup)/(int: encrypted)

Browse a specific backup of a specific client

GET /api/client-tree.json/(name)/(int: backup)

GET method provided by the webservice.

The JSON returned is:

{
  "results": [
    {
      "date": "2015-05-21 14:54:49",
      "gid": "0",
      "inodes": "173",
      "mode": "drwxr-xr-x",
      "name": "/",
      "parent": "",
      "size": "12.0KiB",
      "type": "d",
      "uid": "0"
    }
  ]
}

The output is filtered by the burpui.misc.acl module so that you only see stats about the clients you are authorized to.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
  • name (str) – The client we are working on
  • backup (int) – The backup we are working on
Returns:

The JSON described above.

GET /api/client-stat.json/(name)/(int: backup)

GET method provided by the webservice.

The JSON returned is:

{
  "results": {
    "dir": {
      "changed": 0,
      "deleted": 0,
      "new": 394,
      "scanned": 394,
      "total": 394,
      "unchanged": 0
    },
    "duration": 5,
    "efs": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "encrypted": true,
    "end": 1422189124,
    "files": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "files_enc": {
      "changed": 0,
      "deleted": 0,
      "new": 1421,
      "scanned": 1421,
      "total": 1421,
      "unchanged": 0
    },
    "hardlink": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "meta": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "meta_enc": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "number": 1,
    "received": 1679304,
    "softlink": {
      "changed": 0,
      "deleted": 0,
      "new": 1302,
      "scanned": 1302,
      "total": 1302,
      "unchanged": 0
    },
    "special": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "start": 1422189119,
    "total": {
      "changed": 0,
      "deleted": 0,
      "new": 3117,
      "scanned": 3117,
      "total": 3117,
      "unchanged": 0
    },
    "totsize": 5345361,
    "vssfooter": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "vssfooter_enc": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "vssheader": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "vssheader_enc": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "windows": "false"
  }
}

The output is filtered by the burpui.misc.acl module so that you only see stats about the clients you are authorized to.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
  • name (str) – The client we are working on
  • backup (int) – The backup we are working on
Returns:

The JSON described above.

POST /api/restore/(name)/(int: backup)

POST method provided by the webservice. This method returns a flask.Response object.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
  • name (str) – The client we are working on
  • backup (int) – The backup we are working on
Returns:

A flask.Response object representing an archive of the restored files

GET /api/(server)/render-live-template/(name)

API: render_live_tpl :param name: the client name if any. You can also use the GET parameter ‘name’ to achieve the same thing :returns: HTML that should be included directly into the page

GET /api/(server)/running-clients.json/(client)

GET method provided by the webservice.

The JSON returned is:

{
    "results": [ ]
}

The output is filtered by the burpui.misc.acl module so that you only see stats about the clients you are authorized to.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
  • client (str) – Ask a specific client in order to know if it is running a backup
Returns:

The JSON described above.

GET /api/(server)/client-stat.json/(name)

GET method provided by the webservice.

The JSON returned is:

{
  "results": {
    "dir": {
      "changed": 0,
      "deleted": 0,
      "new": 394,
      "scanned": 394,
      "total": 394,
      "unchanged": 0
    },
    "duration": 5,
    "efs": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "encrypted": true,
    "end": 1422189124,
    "files": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "files_enc": {
      "changed": 0,
      "deleted": 0,
      "new": 1421,
      "scanned": 1421,
      "total": 1421,
      "unchanged": 0
    },
    "hardlink": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "meta": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "meta_enc": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "number": 1,
    "received": 1679304,
    "softlink": {
      "changed": 0,
      "deleted": 0,
      "new": 1302,
      "scanned": 1302,
      "total": 1302,
      "unchanged": 0
    },
    "special": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "start": 1422189119,
    "total": {
      "changed": 0,
      "deleted": 0,
      "new": 3117,
      "scanned": 3117,
      "total": 3117,
      "unchanged": 0
    },
    "totsize": 5345361,
    "vssfooter": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "vssfooter_enc": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "vssheader": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "vssheader_enc": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "windows": "false"
  }
}

The output is filtered by the burpui.misc.acl module so that you only see stats about the clients you are authorized to.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
  • name (str) – The client we are working on
  • backup (int) – The backup we are working on
Returns:

The JSON described above.

GET /api/(server)/server-config/(path: conf)

GET method provided by the webservice.

The JSON returned is:

{
  "boolean": [
    "daemon",
    "fork",
    "..."
  ],
  "defaults": {
    "address": "",
    "autoupgrade_dir": "",
    "ca_burp_ca": "",
    "ca_conf": "",
    "ca_name": "",
    "ca_server_name": "",
    "client_can_delete": true,
    "...": "..."
  },
  "integer": [
    "port",
    "status_port",
    "..."
  ],
  "multi": [
    "keep",
    "restore_client",
    "..."
  ],
  "placeholders": {
    "autoupgrade_dir": "path",
    "ca_burp_ca": "path",
    "ca_conf": "path",
    "ca_name": "name",
    "ca_server_name": "name",
    "client_can_delete": "0|1",
    "...": "..."
  },
  "results": {
    "boolean": [
      {
        "name": "hardlinked_archive",
        "value": false
      },
      {
        "name": "syslog",
        "value": true
      },
      { "...": "..." }
    ],
    "clients": [
      {
        "name": "testclient",
        "value": "/etc/burp/clientconfdir/testclient"
      }
    ],
    "common": [
      {
        "name": "mode",
        "value": "server"
      },
      {
        "name": "directory",
        "value": "/var/spool/burp"
      },
      { "...": "..." }
    ],
    "includes": [],
    "includes_ext": [],
    "integer": [
      {
        "name": "port",
        "value": 4971
      },
      {
        "name": "status_port",
        "value": 4972
      },
      { "...": "..." }
    ],
    "multi": [
      {
        "name": "keep",
        "value": [
          "7",
          "4"
        ]
      },
      { "...": "..." }
    ]
  },
  "server_doc": {
    "address": "Defines the main TCP address that the server listens on. The default is either '::' or '0.0.0.0', dependent upon compile time options.",
    "...": "..."
  },
  "string": [
    "mode",
    "address",
    "..."
  ],
  "suggest": {
    "compression": [
      "gzip1",
      "gzip2",
      "gzip3",
      "gzip4",
      "gzip5",
      "gzip6",
      "gzip7",
      "gzip8",
      "gzip9"
    ],
    "mode": [
      "client",
      "server"
    ],
    "...": []
  }
}
Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
Returns:

The JSON described above.

GET /api/(server)/client.json/(name)

GET method provided by the webservice.

The JSON returned is:

{
  "results": [
    {
      "date": "2015-01-25 13:32:00",
      "deletable": true,
      "encrypted": true,
      "number": "1"
    }
  ]
}

The output is filtered by the burpui.misc.acl module so that you only see stats about the clients you are authorized to.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
  • name (str) – The client we are working on
Returns:

The JSON described above.

GET /(server)/client-browse/(name)/(int: backup)

Browse a specific backup of a specific client

GET /(server)/backup-report/(name)/(int: backup)

Backup specific report

GET /client-browse/(name)/(int: backup)

Browse a specific backup of a specific client

GET /backup-report/(name)/(int: backup)

Backup specific report

GET /api/render-live-template/(name)

API: render_live_tpl :param name: the client name if any. You can also use the GET parameter ‘name’ to achieve the same thing :returns: HTML that should be included directly into the page

GET /api/running-clients.json/(client)

GET method provided by the webservice.

The JSON returned is:

{
    "results": [ ]
}

The output is filtered by the burpui.misc.acl module so that you only see stats about the clients you are authorized to.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
  • client (str) – Ask a specific client in order to know if it is running a backup
Returns:

The JSON described above.

GET /api/client-stat.json/(name)

GET method provided by the webservice.

The JSON returned is:

{
  "results": {
    "dir": {
      "changed": 0,
      "deleted": 0,
      "new": 394,
      "scanned": 394,
      "total": 394,
      "unchanged": 0
    },
    "duration": 5,
    "efs": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "encrypted": true,
    "end": 1422189124,
    "files": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "files_enc": {
      "changed": 0,
      "deleted": 0,
      "new": 1421,
      "scanned": 1421,
      "total": 1421,
      "unchanged": 0
    },
    "hardlink": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "meta": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "meta_enc": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "number": 1,
    "received": 1679304,
    "softlink": {
      "changed": 0,
      "deleted": 0,
      "new": 1302,
      "scanned": 1302,
      "total": 1302,
      "unchanged": 0
    },
    "special": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "start": 1422189119,
    "total": {
      "changed": 0,
      "deleted": 0,
      "new": 3117,
      "scanned": 3117,
      "total": 3117,
      "unchanged": 0
    },
    "totsize": 5345361,
    "vssfooter": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "vssfooter_enc": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "vssheader": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "vssheader_enc": {
      "changed": 0,
      "deleted": 0,
      "new": 0,
      "scanned": 0,
      "total": 0,
      "unchanged": 0
    },
    "windows": "false"
  }
}

The output is filtered by the burpui.misc.acl module so that you only see stats about the clients you are authorized to.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
  • name (str) – The client we are working on
  • backup (int) – The backup we are working on
Returns:

The JSON described above.

GET /api/server-config/(path: conf)

GET method provided by the webservice.

The JSON returned is:

{
  "boolean": [
    "daemon",
    "fork",
    "..."
  ],
  "defaults": {
    "address": "",
    "autoupgrade_dir": "",
    "ca_burp_ca": "",
    "ca_conf": "",
    "ca_name": "",
    "ca_server_name": "",
    "client_can_delete": true,
    "...": "..."
  },
  "integer": [
    "port",
    "status_port",
    "..."
  ],
  "multi": [
    "keep",
    "restore_client",
    "..."
  ],
  "placeholders": {
    "autoupgrade_dir": "path",
    "ca_burp_ca": "path",
    "ca_conf": "path",
    "ca_name": "name",
    "ca_server_name": "name",
    "client_can_delete": "0|1",
    "...": "..."
  },
  "results": {
    "boolean": [
      {
        "name": "hardlinked_archive",
        "value": false
      },
      {
        "name": "syslog",
        "value": true
      },
      { "...": "..." }
    ],
    "clients": [
      {
        "name": "testclient",
        "value": "/etc/burp/clientconfdir/testclient"
      }
    ],
    "common": [
      {
        "name": "mode",
        "value": "server"
      },
      {
        "name": "directory",
        "value": "/var/spool/burp"
      },
      { "...": "..." }
    ],
    "includes": [],
    "includes_ext": [],
    "integer": [
      {
        "name": "port",
        "value": 4971
      },
      {
        "name": "status_port",
        "value": 4972
      },
      { "...": "..." }
    ],
    "multi": [
      {
        "name": "keep",
        "value": [
          "7",
          "4"
        ]
      },
      { "...": "..." }
    ]
  },
  "server_doc": {
    "address": "Defines the main TCP address that the server listens on. The default is either '::' or '0.0.0.0', dependent upon compile time options.",
    "...": "..."
  },
  "string": [
    "mode",
    "address",
    "..."
  ],
  "suggest": {
    "compression": [
      "gzip1",
      "gzip2",
      "gzip3",
      "gzip4",
      "gzip5",
      "gzip6",
      "gzip7",
      "gzip8",
      "gzip9"
    ],
    "mode": [
      "client",
      "server"
    ],
    "...": []
  }
}
Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
Returns:

The JSON described above.

GET /api/client.json/(name)

GET method provided by the webservice.

The JSON returned is:

{
  "results": [
    {
      "date": "2015-01-25 13:32:00",
      "deletable": true,
      "encrypted": true,
      "number": "1"
    }
  ]
}

The output is filtered by the burpui.misc.acl module so that you only see stats about the clients you are authorized to.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
  • name (str) – The client we are working on
Returns:

The JSON described above.

GET /api/(server)/render-live-template

API: render_live_tpl :param name: the client name if any. You can also use the GET parameter ‘name’ to achieve the same thing :returns: HTML that should be included directly into the page

GET /api/(server)/running-clients.json

GET method provided by the webservice.

The JSON returned is:

{
    "results": [ ]
}

The output is filtered by the burpui.misc.acl module so that you only see stats about the clients you are authorized to.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
  • client (str) – Ask a specific client in order to know if it is running a backup
Returns:

The JSON described above.

GET /api/(server)/clients-report.json

GET method provided by the webservice.

The JSON returned is:

{
  "results": [
    {
      "backups": [
        {
          "name": "client1",
          "number": 15
        },
        {
          "name": "client2",
          "number": 1
        }
      ],
      "clients": [
        {
          "name": "client1",
          "stats": {
            "total": 296377,
            "totsize": 57055793698,
            "windows": "false"
          }
        },
        {
          "name": "client2",
          "stats": {
            "total": 3117,
            "totsize": 5345361,
            "windows": "true"
          }
        }
      ]
    }
  ]
}

The output is filtered by the burpui.misc.acl module so that you only see stats about the clients you are authorized to.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
Returns:

The JSON described above

GET /api/(server)/server-config

GET method provided by the webservice.

The JSON returned is:

{
  "boolean": [
    "daemon",
    "fork",
    "..."
  ],
  "defaults": {
    "address": "",
    "autoupgrade_dir": "",
    "ca_burp_ca": "",
    "ca_conf": "",
    "ca_name": "",
    "ca_server_name": "",
    "client_can_delete": true,
    "...": "..."
  },
  "integer": [
    "port",
    "status_port",
    "..."
  ],
  "multi": [
    "keep",
    "restore_client",
    "..."
  ],
  "placeholders": {
    "autoupgrade_dir": "path",
    "ca_burp_ca": "path",
    "ca_conf": "path",
    "ca_name": "name",
    "ca_server_name": "name",
    "client_can_delete": "0|1",
    "...": "..."
  },
  "results": {
    "boolean": [
      {
        "name": "hardlinked_archive",
        "value": false
      },
      {
        "name": "syslog",
        "value": true
      },
      { "...": "..." }
    ],
    "clients": [
      {
        "name": "testclient",
        "value": "/etc/burp/clientconfdir/testclient"
      }
    ],
    "common": [
      {
        "name": "mode",
        "value": "server"
      },
      {
        "name": "directory",
        "value": "/var/spool/burp"
      },
      { "...": "..." }
    ],
    "includes": [],
    "includes_ext": [],
    "integer": [
      {
        "name": "port",
        "value": 4971
      },
      {
        "name": "status_port",
        "value": 4972
      },
      { "...": "..." }
    ],
    "multi": [
      {
        "name": "keep",
        "value": [
          "7",
          "4"
        ]
      },
      { "...": "..." }
    ]
  },
  "server_doc": {
    "address": "Defines the main TCP address that the server listens on. The default is either '::' or '0.0.0.0', dependent upon compile time options.",
    "...": "..."
  },
  "string": [
    "mode",
    "address",
    "..."
  ],
  "suggest": {
    "compression": [
      "gzip1",
      "gzip2",
      "gzip3",
      "gzip4",
      "gzip5",
      "gzip6",
      "gzip7",
      "gzip8",
      "gzip9"
    ],
    "mode": [
      "client",
      "server"
    ],
    "...": []
  }
}
Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
Returns:

The JSON described above.

GET /api/(server)/running.json

GET method provided by the webservice.

The JSON returned is:

{
    "results": false
}

The output is filtered by the burpui.misc.acl module so that you only see stats about the clients you are authorized to.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
Returns:

The JSON described above.

GET /api/(server)/clients.json

GET method provided by the webservice.

The JSON returned is:

{
  "results": [
    {
      "last": "2015-05-17 11:40:02",
      "name": "client1",
      "state": "idle"
    },
    {
      "last": "never",
      "name": "client2",
      "state": "idle"
    }
  ]
}

The output is filtered by the burpui.misc.acl module so that you only see stats about the clients you are authorized to.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
Returns:

The JSON described above

GET /api/(server)/live.json

API: live :returns: the live status of the server

GET /(server)/client-browse/(name)

Browse a specific backup of a specific client

GET /(server)/client-report/(name)

Specific client report

GET /(server)/backup-report/(name)

Backup specific report

GET /(server)/live-monitor/(name)

Live status monitor view

GET /(server)/client/(name)

Specific client overview

GET /client-browse/(name)

Browse a specific backup of a specific client

GET /client-report/(name)

Specific client report

GET /backup-report/(name)

Backup specific report

GET /live-monitor/(name)

Live status monitor view

GET /client/(name)

Specific client overview

GET /static/(path: filename)

Function used internally to send static files from the static folder to the browser.

New in version 0.5.

GET /(server)/clients-report

Global report

GET /(server)/live-monitor

Live status monitor view

GET /(server)/client

Specific client overview