Code Monkey home page Code Monkey logo

privatecollaborator's Introduction

Burp Suite - Private collaborator server

A script for installing private Burp Collaborator with Let's Encrypt SSL-certificate. Requires an Ubuntu virtual machine and public IP-address.

Works for example with Ubuntu 18.04/20.04/22.10 virtual machine and with following platforms:

  • Amazon AWS EC2 VM (with or without Elastic IP).
  • DigitalOcean VM (with or without Floating IP).

Please see the below blog post for usage instructions:

https://teamrot.fi/self-hosted-burp-collaborator-with-custom-domain/

TL;DR:

  1. Clone this repository.
  2. Install Burp to /usr/local/BurpSuitePro.
  3. Run sudo ./install.sh yourdomain.fi [email protected] (the email is for Let's Encrypt expiry notifications).
  4. You should now have Let's encrypt certificate for the domain and a private burp collaborator properly set up.
  5. Start the collaborator with sudo service burpcollaborator start.
  6. Configure your Burp Suite Professional to use it.
  7. ????
  8. Profit.

Important note:

As stated in the blog post, be sure to firewall the ports 9443 and 9090 properly to allow connections only from your own Burp Suite computer IP address. Otherwise everyone in the internet can use your collaborator server!

privatecollaborator's People

Contributors

dawid-czarnecki avatar merenon avatar putsi avatar sverrevh avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar

privatecollaborator's Issues

Debug ubuntu 21

The script fails on some cases with newest ubuntu due to dangling symlink and/or failure on the grep line.

Find out why and fix.

Challenge failed for domain

Trying to install privatecollaborator on AWS EC2 instance but getting following error when running your script:

$ sudo ./install.sh mmqbc.de
...
...
challenge failed for domain mmqbc.de
Challenge failed for domain mmqbc.de
dns-01 challenge for mmqbc.de
dns-01 challenge for mmqbc.de
Cleaning up challenges
Running manual-cleanup-hook command: ./cleanup.sh
Running manual-cleanup-hook command: ./cleanup.sh
manual-cleanup-hook command "./cleanup.sh" returned error code 1
Some challenges have failed.

IMPORTANT NOTES:
 - The following errors were reported by the server:

   Domain: mmqbc.de
   Type:   dns
   Detail: DNS problem: NXDOMAIN looking up TXT for
   _acme-challenge.mmqbc.de

   Domain: mmqbc.de
   Type:   dns
   Detail: DNS problem: NXDOMAIN looking up TXT for
   _acme-challenge.mmqbc.de
cp: cannot stat '/etc/letsencrypt/live/mmqbc.de/privkey.pem': No such file or directory
cp: cannot stat '/etc/letsencrypt/live/mmqbc.de/fullchain.pem': No such file or directory
cp: cannot stat '/etc/letsencrypt/live/mmqbc.de/cert.pem': No such file or directory

Setup:

Complete setup of goddady DNS management and EC2 was done according to the
https://teamrot.fi/2019/05/23/self-hosted-burp-collaborator-with-custom-domain/

Edit1:
More than 48 hours passed since setting up DNS in godaddy domain management console.

Extend collaborator

Add following functionalities to the collaborator:

  • Serving custom html-content (issue #11).
  • Catching connection attempts also to ports that are not listening.
  • Catching invalid HTTP-requests to HTTP-ports.
  • Dockerize the whole thing.
  • Create some kind of one-click-deploy to AWS.

Name resolution problem with AWS Ubuntu 18.04

Hi Putsi,

Thanks for this awesome script!

I tried running this on a fresh AWS Ubuntu 18.04. After running install.sh, name resolution stopped working. Commenting out these lines from install.sh seem to solve the issue:

systemctl disable systemd-resolved.service
systemctl stop systemd-resolved
rm -rf /etc/resolv.conf
echo "nameserver 1.1.1.1" > /etc/resolv.conf
echo "options edns0" >> /etc/resolv.conf
echo "search eu-north-1.compute.internal" >> /etc/resolv.conf

Make install.sh more user-friendly

  • Make the script non-interactive (apt and email).
  • Make the script handle errors properly. If the certbot fails, try to run it again atleast couple of times.

Failed to retrieve the interaction records

"We communicated with the collaborator, and appeared to successfully record events, however when we attempted to retrieve the interaction records the expected records weren't present."
Screenshot from 2021-12-19 15-32-35

Renew Certificates Script is Missing Copy

Based on the install.sh script, the Let's Encrypt certificates need to be copied to the desired collaborator directory. This is missing within the renewcert.sh script:

CERT_PATH=/etc/letsencrypt/live/$DOMAIN
mkdir -p /usr/local/collaborator/keys/
cp $CERT_PATH/privkey.pem /usr/local/collaborator/keys/
cp $CERT_PATH/fullchain.pem /usr/local/collaborator/keys/
cp $CERT_PATH/cert.pem /usr/local/collaborator/keys/

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.