---
title: "Execution of a Horizon3AI penetration test using ZPE Cloud"
slug: "execution-of-a-horizon3ai-penetration-test-using-zpe-cloud"
updated: 2023-04-13T12:33:20Z
published: 2023-04-13T12:33:20Z
canonical: "docs.zpesystems.com/execution-of-a-horizon3ai-penetration-test-using-zpe-cloud"
---

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

# Execution of a Horizon3AI penetration test using ZPE Cloud

ZPE Cloud's automation and orchastration capabilties provide an simple method to deploy Horizon3.ai agent to each Nodegrid appliance and to start regular pentests.

## Requirements

- Horizon3.ai account
- ZPECloud.com or ZPEcloud.eu account
- Nodegrid appliances which are managed by ZPE Cloud
- Virtulisation license

> For the installation of the Horizon3 agents follow the manual installation process. [Installation and Execution of a Penetration Test with Horizon3](/guides/docs/execution-of-a-penetration-test-with-horizon3)

### ZPE Cloud account setup

The installation process requires that one new configuration profile need to be uploaded to the customers ZPE Cloud account.

Download the following configuration profile:

[horizon3_run_pentest.py](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/horizon3_run_pentest.py)

### Upload of Horizon3 profiles

- login to the customers ZPE Cloud account via
  - https://zpecloud.com or https://zpecloud.eu
- Navigate to Profiles  

![Horizon3ai - Profiles - Before](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/Horizon3ai%20-%20Profiles%20-%20Before.png)
- Click on **ADD FROM FILE** to upload the `horizon3_run_pentest.py` profile and provide the follwing details

| Setting | Value | Comment |
| --- | --- | --- |
| Name | Horizon3AI Run Pentest |  |
| Description | Starts a Horizon3AI Pentest |  |
| Type | Script |  |
| IMPORT FROM FILE | select the file `horizon3_run_pentest.py` |  |
| Custom Command | Enabled |  |
| Button Name | Run Horizon3 Pentest |  |

![Horizon3ai - add profile run](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/Horizon3ai%20-%20add%20profile%20run.png)

### Define Penetration Template to be used

> When this step is skipped with the Horizon3.ai execute the default scan template

- Navigate to Profiles
- search for 'Horizon3AI Run Pentest'

![Horizon3ai - search profile](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/Horizon3ai%20-%20search%20profile.png)

- select the Profile and click on **EDIT**
- in the line template, provide a Horzion3AI scan profile. If no template is provide the default scan profile will be executed.

![Horizon3ai - add profile run](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/Horizon3ai%20-%20add%20profile%20run.png)

### Run a Penetration Test

- Navigate to Devices
- Click on **Menu**
- Select the Nodegrid appliance which will run the Pentest
- Click on **RUN HORIZON3 PENTEST**

![Horizon3ai - Run Pentest](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/Horizon3ai%20-%20Run%20Pentest.png)

### Schedule a Penetration Test

- Navigate to Devices
- Select the device which will run the pentration test by Schedule
- Click on **APPLY CONFIGURATION**
- Profide the following details

| Setting | Value | Comment |
| --- | --- | --- |
| Configuration | Horizon3AI Run Pentest |  |
| Apply | Schedule |  |
| Select start date |  | Default is now, adjust to a desired start day and time |
| Recurrent | Enabled |  |
| Frequecy | Weekly | Set to to desired frequencey, like daily or weekly |

![Horizon3ai - Schedule](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/Horizon3ai%20-%20Schedule.png)

- Click on **SAVE** to schedule the task