Skip to content

Commit 9a4167d

Browse files
feat(docs): add Prowler Cloud docs to Openstack getting started (#10100)
Co-authored-by: Andoni A. <14891798+andoniaf@users.noreply.github.com>
1 parent 43792f3 commit 9a4167d

File tree

5 files changed

+39
-10
lines changed

5 files changed

+39
-10
lines changed

docs/user-guide/providers/openstack/getting-started-openstack.mdx

Lines changed: 39 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -4,13 +4,11 @@ title: 'Getting Started With OpenStack'
44

55
import { VersionBadge } from "/snippets/version-badge.mdx"
66

7-
<VersionBadge version="5.18.0" />
8-
9-
Prowler for OpenStack allows you to audit your OpenStack cloud infrastructure for security misconfigurations, including compute instances, networking, identity and access management, storage, and more.
7+
Prowler supports OpenStack both from the CLI and from Prowler Cloud. This guide walks you through the requirements, how to connect the provider in the UI, and how to run scans from the command line.
108

11-
<Warning>
9+
<Note>
1210
Prowler currently supports **public cloud OpenStack providers** (OVH, Infomaniak, Vexxhost, etc.). Support for self-deployed OpenStack environments is not yet available, if you are interested in this feature, please [open an issue](https://github.com/prowler-cloud/prowler/issues/new) or [contact us](https://prowler.com/contact).
13-
</Warning>
11+
</Note>
1412

1513
## Prerequisites
1614

@@ -22,16 +20,47 @@ Before running Prowler with the OpenStack provider, ensure you have:
2220
4. Access to Prowler CLI (see [Installation](/getting-started/installation/prowler-cli)) or an account created in [Prowler Cloud](https://cloud.prowler.com)
2321

2422
<CardGroup cols={2}>
25-
<Card title="Prowler CLI" icon="terminal" href="#prowler-cli">
26-
Run OpenStack security audits with Prowler CLI
23+
<Card title="Prowler Cloud" icon="cloud" href="#prowler-cloud">
24+
Onboard OpenStack using Prowler Cloud
2725
</Card>
28-
<Card title="Authentication Methods" icon="key" href="/user-guide/providers/openstack/authentication">
29-
Learn about OpenStack authentication options
26+
<Card title="Prowler CLI" icon="terminal" href="#prowler-cli">
27+
Onboard OpenStack using Prowler CLI
3028
</Card>
3129
</CardGroup>
3230

31+
## Prowler Cloud
32+
33+
<VersionBadge version="5.19.0" />
34+
35+
### Step 1: Add the Provider
36+
37+
1. Navigate to "Cloud Providers" and click "Add Cloud Provider".
38+
![Providers List](./images/select-provider.png)
39+
2. Select "OpenStack" from the provider list.
40+
3. Enter the "Project ID" from the OpenStack provider.
41+
![Add project ID form](./images/add-provider-id.png)
42+
4. (Optional) Add a friendly alias to identify this project in dashboards.
43+
44+
### Step 2: Provide Credentials
45+
46+
1. Click "Next" to open the credentials form.
47+
2. Paste the full content of the `clouds.yaml` file into the "Clouds YAML Content" field. This file is available in the OpenStack provider's Horizon dashboard (see the [Authentication guide](/user-guide/providers/openstack/authentication) for detailed instructions).
48+
3. Enter the "Cloud Name" — this is the key that identifies the cloud entry inside the `clouds.yaml` file (e.g., `mycloud`).
49+
![Credentials form](./images/add-credentials.png)
50+
51+
### Step 3: Test the Connection and Start Scanning
52+
53+
1. Click "Test connection" to ensure Prowler Cloud can reach the OpenStack API.
54+
![Test connection](./images/test-connection.png)
55+
2. The provider will appear in the list with its current connection status.
56+
3. Launch a scan from the provider row or from the "Scans" page.
57+
58+
---
59+
3360
## Prowler CLI
3461

62+
<VersionBadge version="5.18.0" />
63+
3564
### Step 1: Set Up Authentication
3665

3766
Download the `clouds.yaml` file from your OpenStack provider (see [Authentication guide](/user-guide/providers/openstack/authentication) for detailed instructions) and save it to `~/.config/openstack/clouds.yaml`:
@@ -98,7 +127,7 @@ Run a baseline scan of your OpenStack cloud:
98127
prowler openstack --clouds-yaml-cloud openstack
99128
```
100129

101-
Replace `openstack` with your cloud name if you customized it in the `clouds.yaml` file (e.g., `ovh-production`).
130+
Replace `openstack` with the custom cloud name defined in the `clouds.yaml` file (e.g., `ovh-production`).
102131

103132
Prowler will automatically discover and audit all supported OpenStack services in your project.
104133

135 KB
Loading
99.4 KB
Loading
241 KB
Loading
102 KB
Loading

0 commit comments

Comments
 (0)