> For the complete documentation index, see [llms.txt](https://docs.whitespots.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.whitespots.io/appsec-portal/features/bring-your-own-scanner.md).

# Bring your own scanner

> **If your scanner generates json - we support it**

## Requirements

1. Json report as an example for us to parse it
2. Docker image with scanner

## Add job to auditor

1. Navigate to Auditor->Jobs
2. Find a button on the right to create a new job

<figure><img src="/files/w9vT2UeMiqcWaijArFSn" alt="" width="375"><figcaption></figcaption></figure>

There are a lot of settings for jobs. If you find that hard to understand - take a look at any of our existing jobs

<figure><img src="/files/thOAV6KCK0Uov3thTRIq" alt="" width="375"><figcaption></figcaption></figure>

Ok, you put the image address, now it's time to describe how it works

<figure><img src="/files/CZ8t0aDgr8x2LOjzNS9V" alt="" width="375"><figcaption></figcaption></figure>

## Add a new importer

1. Navigate to Settings->Scanners
2. Create a new importer with preferable name

<figure><img src="/files/2tcNd5UbaatNZO2R9789" alt="" width="375"><figcaption></figcaption></figure>

3. Go inside this scanner to configure the parse logic

<figure><img src="/files/dhqRQhTaHJquTN4FxWpK" alt="" width="375"><figcaption></figcaption></figure>

4. Carefully follow the instructions (watch the video for more details)

{% embed url="<https://www.youtube.com/watch?v=PCnAHVXimn4>" %}

> <mark style="color:$danger;">**Important information**</mark>
>
> Not all scanners have CWE, some of them don't provide recommendations (as in example), only a few have proper severity table. That's normal for them. You may tweak it with portal. That's why we eat our bread :smile:

:tada: That's it. Now you can get back to auditor and set a new SCAN\_TYPE variable.&#x20;

Put your job in a sequence and enjoy new checks.

PS. don't forget to create a rule in [deduplicator](/appsec-portal/features/deduplicator.md) service.
