# Zap Hud | The OWASP ZAP Heads Up Display (HUD)

**URL:** <https://onehack.st/t/zap-hud-the-owasp-zap-heads-up-display-hud/198847>\
**Category:** Tools & Scripts\
**Tags:** tools, hacking\
**Created:** [August 22, 2021, 8:53pm UTC](https://onehack.st/t/zap-hud-the-owasp-zap-heads-up-display-hud/198847 "2021-08-22T20:53:24Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![TheStrength](https://onehack.st/user_avatar/onehack.st/thestrength/32/46753_2.png) [@TheStrength](https://onehack.st/u/TheStrength)\
**Post date:** [August 22, 2021, 8:53pm UTC](https://onehack.st/t/zap-hud-the-owasp-zap-heads-up-display-hud/198847/1 "2021-08-22T20:53:24Z")

</div>

![image](https://onehack.st/uploads/default/original/3X/a/f/af8f0ceb81175cec75a1b978f03546ed009512c3.png)

# OWASP ZAP Heads Up Display

[![Release: Beta](https://camo.githubusercontent.com/27804cedd2e76f0608308edac4566980573331c66c64c2af6990d61cc9d34281/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f72656c656173652d626574612d627269676874677265656e2e737667)](https://camo.githubusercontent.com/27804cedd2e76f0608308edac4566980573331c66c64c2af6990d61cc9d34281/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f72656c656173652d626574612d627269676874677265656e2e737667) [![Known Vulnerabilities](https://camo.githubusercontent.com/0032beab1b0057bd33825f30e7206978997302348604150fda2fe9785f71d61e/68747470733a2f2f736e796b2e696f2f746573742f6769746875622f7a6170726f78792f7a61702d6875642f62616467652e7376673f74617267657446696c653d7061636b6167652e6a736f6e)](https://snyk.io/test/github/zaproxy/zap-hud?targetFile=package.json) [![Total alerts](https://camo.githubusercontent.com/eaf0e153560a26426080ce72ae18c9bf12816dc428cbf1d5409e29e0ec4ebd8a/68747470733a2f2f696d672e736869656c64732e696f2f6c67746d2f616c657274732f672f7a6170726f78792f7a61702d6875642e7376673f6c6f676f3d6c67746d266c6f676f57696474683d3138)](https://lgtm.com/projects/g/zaproxy/zap-hud/alerts/) [![Language grade: JavaScript](https://camo.githubusercontent.com/fbe8719976266282550ab53fc5adccec48f2b20a7cd416dd96ebf6d0bde1b807/68747470733a2f2f696d672e736869656c64732e696f2f6c67746d2f67726164652f6a6176617363726970742f672f7a6170726f78792f7a61702d6875642e7376673f6c6f676f3d6c67746d266c6f676f57696474683d3138)](https://lgtm.com/projects/g/zaproxy/zap-hud/context:javascript)

 ![image](https://onehack.st/uploads/default/original/3X/a/8/a804877e0386d293c5f8d71c7289fd60ecb4d1ed.png)

The HUD is an interface that provides the functionality of ZAP **directly in the browser**.

Learn more:

- Blog: [Hacking with a Heads Up Display](https://segment.com/blog/hacking-with-a-heads-up-display/)
- Video: [The OWASP ZAP HUD - Usable Security Tooling](https://youtu.be/ztfgip-UhWw)
- Wiki: [Inside the HUD](https://github.com/zaproxy/zap-hud/wiki)

[![](https://raw.githubusercontent.com/zaproxy/zap-hud/main/assets/images/hud-break.gif)](https://raw.githubusercontent.com/zaproxy/zap-hud/main/assets/images/hud-break.gif)

## Using the HUD

### Downloading

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

- Download and run the latest [ZAP Release](https://www.zaproxy.org/download/)

or

- Run it from this repo using:

```auto
git clone https://github.com/zaproxy/zap-hud.git
cd zap-hud
./gradlew runZap

```

In all cases you will need Java 8+ installed.

You’ll see the HUD Radar icon [![Radar Icon](https://raw.githubusercontent.com/zaproxy/zap-hud/main/src/main/resources/org/zaproxy/zap/extension/hud/resources/radar.png)](https://raw.githubusercontent.com/zaproxy/zap-hud/main/src/main/resources/org/zaproxy/zap/extension/hud/resources/radar.png) in the toolbar. When the icon is selected the HUD will be added to your browser.

[![Toolbar with Radar](https://raw.githubusercontent.com/zaproxy/zap-hud/main/assets/images/toolbar_radar.png)](https://raw.githubusercontent.com/zaproxy/zap-hud/main/assets/images/toolbar_radar.png)

### Starting the HUD

1. Quick Start: Select either `Firefox` or `Chrome` on the `Quick Start` tab and click on the `Launch Browser` button.

[![](https://raw.githubusercontent.com/zaproxy/zap-hud/main/assets/images/ZAP-Launch-browser.png)](https://raw.githubusercontent.com/zaproxy/zap-hud/main/assets/images/ZAP-Launch-browser.png)

1. 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.

## Getting Involved

ZAP is a community project and so we are always very keen to hear from anyone who’d like to contribute, just post to the [ZAP HUD Group](https://groups.google.com/group/zaproxy-hud)

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

## Limitations

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 should **NOT** use it on sites you do not trust! However it **is** in scope for the ZAP bug bounty on [BugCrowd](https://bugcrowd.com/owaspzap)

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 is _very_ new so might be buggy
  - In particular don’t close the first tab on Firefox or the HUD _will_ stop working (weird, we know. See [#199](https://github.com/zaproxy/zap-hud/issues/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.

## GitHub:

> **[GitHub - zaproxy/zap-hud: The ZAP Heads Up Display (HUD)](https://github.com/zaproxy/zap-hud)**
>
> The ZAP Heads Up Display (HUD)
