---
title: "Bring your own scanner"
description: "Bring your own scanner If your scanner generates json - we support it Requirements Json report as an example for us to parse it Docker image with scanner…"
url: https://whitespots.io/docs/whitespots-wiki/appsec-portal/features/bring-your-own-scanner
slug: whitespots-wiki/appsec-portal/features/bring-your-own-scanner
publish_date: 2025-12-27T16:25:29.000Z
last_modified: 2025-12-27T16:25:29.000Z
---

# Bring your own scanner

# 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="https://whitespots.io/api/image/45e57660c33fd57eb9ff209c62fef5a1.png" 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="https://whitespots.io/api/image/847734380b0fc1ab1261039e31b911fb.png" alt="" width="375"><figcaption></figcaption></figure>



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

<figure><img src="https://whitespots.io/api/image/f517b29158194375e10b074e7ede5717.png" 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="https://whitespots.io/api/image/bcb326ab42dcb702329c11353a809104.png" alt="" width="375"><figcaption></figcaption></figure>

3. Go inside this scanner to configure the parse logic

<figure><img src="https://whitespots.io/api/image/d1927473ab8b03f6da729907823bd012.png" 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](https://whitespots.io/docs/whitespots-wiki/appsec-portal/features/deduplicator) service.





---

## Navigation

- Location: [Docs](https://whitespots.io/docs) > [Whitespots Wiki](https://whitespots.io/docs/whitespots-wiki) > [AppSec Portal](https://whitespots.io/docs/whitespots-wiki/appsec-portal) > [🎯 Features](https://whitespots.io/docs/whitespots-wiki/appsec-portal/features)
- Previous: [Rules view](https://whitespots.io/docs/whitespots-wiki/appsec-portal/features/auto-validator/rules-view)
- Next: [Custom Reports](https://whitespots.io/docs/whitespots-wiki/appsec-portal/features/custom-reports)