|
| 1 | +# ZAProxy Automated Security Tests Collection |
| 2 | +This repository contains a collection of scripts to automate ZAP Security Tests. |
| 3 | + |
| 4 | +## Getting Started |
| 5 | + |
| 6 | +To get started simply clone this repository, then browse each sub-directory for details on how to use each automation tool. |
| 7 | + |
| 8 | +Tools on the project root are usable directly. |
| 9 | + |
| 10 | +You can use this repo in conjunction with the Vagrant Kali-Linux base-box you'll find here: |
| 11 | + |
| 12 | +[https://app.vagrantup.com/zfpsystems/boxes/kali-base-x86_64] |
| 13 | + |
| 14 | +to have a full automated build environment and deploy of your testing VM. |
| 15 | + |
| 16 | +### Prerequisites |
| 17 | + |
| 18 | +You need git to clone this repository, obviously. You can get git from |
| 19 | +[http://git-scm.com/](http://git-scm.com/). |
| 20 | + |
| 21 | +Scripts are mostly Python scripts so you'll need a Python interpreter installed and fully working. |
| 22 | + |
| 23 | +You'll need ZAProxy installed, you can find the latest release here: |
| 24 | +[https://github.com/zaproxy/zaproxy] |
| 25 | + |
| 26 | +You'll need Java VM installed. |
| 27 | + |
| 28 | +### Install |
| 29 | +To install the automation tools just clone this repo inside your Kali Linux (or the system you want to use to run ZAProxy): |
| 30 | +``` |
| 31 | +git clone https://github.com/zfpsystems/zap-automation |
| 32 | +``` |
| 33 | + |
| 34 | +I usually test these tools from /opt/zfpsystems/zap-automaion , but you can use whatever path you prefer. |
| 35 | + |
| 36 | +Tools come with different licenses so please check sub-directory for licenses. |
| 37 | + |
| 38 | +### Reccommendations (yeah read them!) |
| 39 | +- DO NOT USE ZAProxy or this ZAProxy automation tools collection to hack web sites and web applications you don't own or you don't have a written permission to pen-test. |
| 40 | + |
| 41 | +- I do not assume any responsabilities for your actions, nor for the content of this repository. |
| 42 | + |
| 43 | +- This automation tools collection sole purpose is to help people (especially the ones who can't afford expensive security solutions) to test security of their web applications and web sites to improve the quality and security of this world and not to make it worst! |
| 44 | + |
| 45 | +### How to help this project |
| 46 | +If you have ZAProxy automation scripts you want to include in this collection please feel free, here is how to: |
| 47 | + |
| 48 | +- Create a public github.com repository of your tool, for example JohnWayne-zap-automation |
| 49 | +- Add your tool, required dependencies and everything is needed to make it work fine in the repository you have created |
| 50 | +- Add a README.md file with instructions on how to install and use your automation tool and your name |
| 51 | +- Let me know the URL to your repo and I will add it to the autobuild that generates this collection daily. If your automation tool pass the basic working tests then it will be published on this public repository |
| 52 | +- Please note: This is a public and open source repository, so do not add copyrighted stuff that won't allow me to publish your automation tools. |
| 53 | + |
| 54 | +Thanks! |
| 55 | + |
| 56 | + |
| 57 | + |
| 58 | + |
0 commit comments