---
title: "Direct use of Auditor"
description: "Direct use of Auditor If you are using Auditor without the AppSec Portal, directly:  Preconfigure Auditor if you are using your own images for job…"
url: https://whitespots.io/docs/whitespots-wiki/auditor/features/run-audit/direct-use-of-auditor
slug: whitespots-wiki/auditor/features/run-audit/direct-use-of-auditor
publish_date: 2025-12-03T22:20:02.000Z
last_modified: 2025-12-03T22:20:02.000Z
---

# Direct use of Auditor

# Direct use of Auditor

If you are using Auditor **without** the AppSec Portal, **directly**: 

1. **Preconfigure Auditor**

if you are using your own images for job (scanners), [**preconfigure**](https://whitespots.io/docs/whitespots-wiki/auditor/features/settings/direct-use-of-the-auditor/docker-credentials) Auditor 

2. **Create pipeline**

On the dashboard page click on <img src="https://whitespots.io/api/image/f633e2d93f9cb8c0e84f5556da6d5afe.png" alt="" data-size="line"> button

<figure><img src="https://whitespots.io/api/image/58ffe50ae30707e7ed022d259063e214.png" alt=""><figcaption></figcaption></figure>

3. **Add Jobs**

Click on the **Jobs** field and create a sequence of jobs (scanners) by selecting the required jobs from the drop-down list&#x20;

Scanning will be performed sequentially based on the selected set of jobs

<figure><img src="https://whitespots.io/api/image/c83a8416933bfcfabb74c8adaeef280c.png" alt=""><figcaption></figcaption></figure>

4. **Add environment variables**

The variables **require** you to specify information about your product and its location&#x20;

| Name                                                 | Description                                                                                                                        |
| ---------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| <mark style="color:blue;">`PRODUCT_NAME`</mark>      | name of your product                                                                                                               |
| <mark style="color:blue;">`PORTAL_IMPORT_URL`</mark> | address where reports will be sent (delivery point)                                                                                |
| <mark style="color:blue;">`PORTAL_TOKEN`</mark>      | credentials for delvery point                                                                                                      |
| <mark style="color:blue;">`REPOSITORY`</mark>        | URL of the cloned repository to be scanned, where the **code** will be checked in                                                  |
| <mark style="color:blue;">`DOCKER_IMAGE`</mark>      | reference to a list of your docker **images**, e.g. _registry.gitlab.com/whitespots-public/appsec-portal/back/appsecportal:latest_ |
| <mark style="color:blue;">`DOMAIN`</mark>            | domain of your **web** product                                                                                                     |
| <mark style="color:blue;">`HOST`</mark>              | IP address of your **web** product                                                                                                 |

Optionally you can specify other variables that you need to set

<figure><img src="https://whitespots.io/api/image/3efb6430e171d3f3a04696366622a02d.png" alt=""><figcaption></figcaption></figure>

5. **Run pipline**

Click Run pipeline

The scanning of your product will commence.\
After all the jobs in your pipeline have finished their work, the status of the Pipeline will change from     **`In progress`** to **`Finished`**

<figure><img src="https://whitespots.io/api/image/b58821148811433bb8a8d6e4bbc409f0.png" alt=""><figcaption></figcaption></figure>

6. **Get Results**

At the location specified by the environment variable (PORTAL\_URL), retrieve reports from each scanner in your pipeline



Clicking on a pipeline provides information about the Jobs in it, as well as Logs for each of them

<figure><img src="https://whitespots.io/api/image/c9f4bc43f2a3d4eb08e268b37dbefb91.png" alt=""><figcaption></figcaption></figure>

You can bulk delete all pipelines by clicking on the button <img src="https://whitespots.io/api/image/5689cd9e8850dbbecac6d0ebf6998736.png" alt="" data-size="line">

<figure><img src="https://whitespots.io/api/image/b2a547566c4f7bc7a26982238a55d2e9.png" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
When scanning a code with Auditor, if the code is not loaded by the technical scanner, the pipelines are automatically killed.
{% endhint %}

You can also filter the available pipelines by clicking on the filter button in the right panel. \
You can filter your results by Job name and/or status

<figure><img src="https://whitespots.io/api/image/14b8ca9a9ee9f0cc4e63c54c82b8a2e3.png" alt=""><figcaption></figcaption></figure>


---

## Navigation

- Location: [Docs](https://whitespots.io/docs) > [Whitespots Wiki](https://whitespots.io/docs/whitespots-wiki) > [Auditor](https://whitespots.io/docs/whitespots-wiki/auditor) > [🎯 Features](https://whitespots.io/docs/whitespots-wiki/auditor/features) > [🚀 Run Audit](https://whitespots.io/docs/whitespots-wiki/auditor/features/run-audit)
- Previous: [AppSec Portal cooperation](https://whitespots.io/docs/whitespots-wiki/auditor/features/run-audit/appsec-portal-cooperation)
- Next: [⚙️ Settings](https://whitespots.io/docs/whitespots-wiki/auditor/features/settings)