Burp Collaborator Server Ansible Role

This role installs Burp Collaborator Server on a Ubuntu 16.04 Linux machine.

Requirements

• A Debian-based Linux system
• Ansible 2.2 installed on a Unix/Linux machine with openssl
• Burp Suite Professional jar file (available at PortSwigger)

Role Variables

Here are the variables you can set:

burp_http_port: 80
burp_https_port: 443
burp_dns_port: 53
burp_metrics_path: metricated
burp_whitelist: '["127.0.0.1"]'
burp_key: burp.pk8
burp_cert: burp.crt
burp_ca_bundle: intermediate.crt
burp_server_domain: collaborator.example.com
burp_local_address: <internal IP address>
burp_public_address: <public IP address> # This might be the same as above

If you want Ansible to create a self-signed certificate for you to use with Collaborator, set the following to true. If you don’t want a self-signed certificate, set generate_self_signed_certs to false.

generate_self_signed_certs: true
country: GB
state: London
locality: London
organisation: 4ARMED
organisational_unit: Training

Dependencies

• 4ARMED.java

Example Playbook

Here’s a simple playbook you can use to set this up:

---
- hosts: all
  become: yes
  gather_facts: False
  vars:
    - burp_server_domain: collaborator.example.com
    - burp_local_address: 138.68.191.190
    - burp_public_address: 138.68.191.190
  pre_tasks:
    - name: Burp | Install Python 2
      raw: test -e /usr/bin/python || (apt -y update && apt install -y python-minimal)

  roles:
    - { role: 4ARMED.burp-collaborator }

License

MIT/BSD

Author Information

This was created by @marcwickenden at 4ARMED.