> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kikimora.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Creating a web application

> Work through the four-step setup wizard, including target scope, scan configuration, inline auth record creation, and every field validation message.

A web application must exist before you can run a web security scan against it. The setup wizard at `/web-applications/new` takes four steps.

Completed steps stay clickable in the progress bar at the top, so you can jump back to an earlier step without losing what you have entered.

## Step 1: General information

1. Go to `/web-applications` and click **Add new**.
2. Fill in the fields:

| Field                 | Required | Notes                                                                                                   |
| :-------------------- | :------- | :------------------------------------------------------------------------------------------------------ |
| **Name**              | Yes      | Unique display name for the target. Empty submit returns `Name is required`.                            |
| **Asset**             | No       | Associated infrastructure asset or host grouping.                                                       |
| **Risk Owner**        | Yes      | Person accountable for this application's security risk. Empty submit returns `Risk Owner is required`. |
| **Remediation Owner** | No       | Person assigned to remediate findings.                                                                  |

<img src="https://mintcdn.com/kikimora/QAjwfNrYFC-wb2oj/images/web-applications/create-app--01--general-information.png?fit=max&auto=format&n=QAjwfNrYFC-wb2oj&q=85&s=f97f0b48e62778c31694c4d85fddbf6c" alt="Step 1 of the web application wizard with name, asset, risk owner, and remediation owner fields" width="1920" height="1080" data-path="images/web-applications/create-app--01--general-information.png" />

## Step 2: Target details

Click **Next**, then configure how the scanner reaches and crawls the application:

| Field           | Required | Notes                                                                                                                                                                                  |
| :-------------- | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Start URL**   | Yes      | The scanner's entry point. Must start with `http://` or `https://`. Empty submit returns `Start URL is required`; a malformed value returns `URL must start with http:// or https://`. |
| **Crawl Scope** | Yes      | How far the scanner follows links — for example *Limited at or below URL hostname*. Empty submit returns `Crawl Scope is required`.                                                    |
| **Sitemap**     | Yes      | Whether to upload or parse `sitemap.xml`. Empty submit returns `Sitemap is required`.                                                                                                  |

If the start URL points at an unverified domain, a domain verification dialog prompts you to prove ownership before continuing.

<img src="https://mintcdn.com/kikimora/QAjwfNrYFC-wb2oj/images/web-applications/create-app--02--target-details.png?fit=max&auto=format&n=QAjwfNrYFC-wb2oj&q=85&s=9be9bb8a93c871fa3fd3d16ac195a97c" alt="Step 2 of the wizard showing start URL, crawl scope, and sitemap configuration" width="1920" height="1080" data-path="images/web-applications/create-app--02--target-details.png" />

## Step 3: Scan configuration

Click **Next** to reach scan configuration:

| Field                      | Required | Notes                                                                                                                       |
| :------------------------- | :------- | :-------------------------------------------------------------------------------------------------------------------------- |
| **Authentication Records** | No       | Select existing credentials, or click **Create** to define new ones inline.                                                 |
| **Robots.txt**             | Yes      | Whether the scanner respects or ignores the site's `robots.txt` rules. Empty submit returns `Robot.txt option is required`. |

<img src="https://mintcdn.com/kikimora/QAjwfNrYFC-wb2oj/images/web-applications/create-app--04--scan-configuration.png?fit=max&auto=format&n=QAjwfNrYFC-wb2oj&q=85&s=df45f7c48991035832b5c505602dc944" alt="Step 3 scan configuration with the authentication records selector and robots.txt option" width="1920" height="1080" data-path="images/web-applications/create-app--04--scan-configuration.png" />

### Creating an auth record inline

Clicking **Create** in the Authentication Records section opens the **Add New Authentication Record** dialog:

* **Name** *(required)* — identifies the credential set. Empty submit returns `Name is required`.
* **Type** *(required)* — the authentication method, such as *Standard*, *Selenium Script*, or *Header Authentication*. Empty submit returns `Type is required`.
* **Username** and **Password** — required when *Standard* is selected.

Click **Save**. The record is created and attached to the web application you are setting up.

<img src="https://mintcdn.com/kikimora/QAjwfNrYFC-wb2oj/images/web-applications/create-app--03--add-auth-record-modal.png?fit=max&auto=format&n=QAjwfNrYFC-wb2oj&q=85&s=d480916d077ada1cafdd01b842c694ac" alt="Add New Authentication Record dialog with name, type, username, password, and comments fields" width="1920" height="1080" data-path="images/web-applications/create-app--03--add-auth-record-modal.png" />

## Step 4: Review

Check the summary across General Information, Target Details, and Scan Configuration, then click **Finish** to save and provision the web application.

<img src="https://mintcdn.com/kikimora/QAjwfNrYFC-wb2oj/images/web-applications/create-app--05--review.png?fit=max&auto=format&n=QAjwfNrYFC-wb2oj&q=85&s=3a91d7909cd73795b2078d83e5b98ad9" alt="Review step summarizing the configured general information, target details, and scan configuration" width="1920" height="1080" data-path="images/web-applications/create-app--05--review.png" />
