Repository files navigation

Unfortunately the HUD is no longer under active development due to the fact no one is focusing on it.

The HUD is a unique and innovative interface that we know some people love.But it also needs a non trivial amount of maintenance and we just don’t have enough volunteers to maintain it right now.

If you would like to get involved please get in touch via theZAP HUD Group.

In order to keep maintaining the HUD we do not actually need anyone with Java experience - we have that covered.We need someone with good Java Script experience and the confidence to dive into non trivial browser issues.

The HUD is a very unconventional project, and does unusual things in order to get around browser security features.Browser changes often break the HUD in strange ways.

We know that the HUD no longer loads reliably all of the time in Firefox and Chrome, and the integration tests we have for it have been broken for some time.

If you are up for a challenge thenlet us know!

The HUD is an interface that provides the functionality of ZAPdirectly in the browser.

Learn more:

• Blog:Hacking with a Heads Up Display
• Video:The ZAP HUD - Usable Security Tooling
• Wiki:Inside the HUD

You can try out ZAP enabled with the HUD via any of:

• Download and run the latestZAP Release

or

• Run it from this repo using:

  git clone https://github.com/zaproxy/zap-hud.gitcd zap-hud./gradlew runZap

In all cases you will need Java 11+ installed.

You'll see the HUD Radar icon in the toolbar. When the icon is selected the HUD will be added to your browser.

1. Quick Start: Select eitherFirefox orChrome on theQuick Start tab and click on theLaunch Browser button.

2. Manually: You can also configure Firefox or Chrome to proxy via ZAP manually, but you will need to import the ZAP Root CA Certificate (and may require other setting changes in up-to-date browsers).

The first time the HUD is launched you'll be prompted with the HUD Tutorial. We recommend that you follow the tutorial even if you have read the above blog post and watched the video.

ZAP is a community project and so we are always very keen to hear from anyone who'd like to contribute, just post to theZAP HUD Group

We'd also love to hear some feedback, which you can also give via that group.

This is still early days and there are some known issues and limitations with the current release. Development on the HUD is active and we recommend you check in often for new features and improvements. :)

You shouldNOT use it on sites you do not trust!However itis in scope for the ZAP bug bounty onBugCrowd

Limitations while running:

• Only a limited amount of ZAP functionality is available
• Firefox has been tested more than Chrome, but both should work
• The code to support the HUD in multiple browser tabs isvery new so might be buggy
  • In particular don't close the first tab on Firefox or the HUDwill stop working (weird, we know. See#199 for details)
• Using the HUD with browser dev tools open can significantly affect performance
• Behaviour using the browser back button is currently undefined

Issues and todos in code:

• We're using Vue.js in dev mode, which prevents us from using a suitably strong CSP
• JavaScript code still needs to be formatted and linted
• Documentation could, of course, be better
• Async functions are handled as via Promises as opposed to using 'await' pattern

These lists aren't exhaustive, but do highlight some of the larger restrictions.