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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.whitespots.io/appsec-portal/features/bring-your-own-scanner.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.