From c3980e4f27880d9f3ac43fec10692c7a4d516055 Mon Sep 17 00:00:00 2001
From: Toni de la Fuente
Date: Mon, 19 Dec 2022 18:29:26 +0100
Subject: [PATCH] docs: General changes (#1552)
Co-authored-by: Sergio Garcia
---
README.md | 51 +++++++++++++-----
.../ProwlerPro-3Dashboards-1-1024x1024.png | Bin 306765 -> 0 bytes
docs/img/extended-display.png | Bin 176439 -> 167206 bytes
docs/img/html-output.png | Bin 0 -> 868051 bytes
docs/img/prowlerpro-2-pages.png | Bin 282139 -> 0 bytes
docs/img/short-display.png | Bin 100681 -> 92546 bytes
docs/index.md | 23 ++++----
docs/tutorials/aws/securityhub.md | 2 +-
docs/tutorials/compliance.md | 3 +-
mkdocs.yml | 2 +-
10 files changed, 56 insertions(+), 25 deletions(-)
delete mode 100644 docs/img/ProwlerPro-3Dashboards-1-1024x1024.png
create mode 100644 docs/img/html-output.png
delete mode 100644 docs/img/prowlerpro-2-pages.png
diff --git a/README.md b/README.md
index 0688f2c9..a16f901a 100644
--- a/README.md
+++ b/README.md
@@ -26,6 +26,7 @@
+
# Description
@@ -34,26 +35,48 @@
It contains hundreds of controls covering CIS, PCI-DSS, ISO27001, GDPR, HIPAA, FFIEC, SOC2, AWS FTR, ENS and custom security frameworks.
+## Looking for Prowler v2 documentation?
+For Prowler v2 Documentation, please go to https://github.com/prowler-cloud/prowler/tree/2.12.1.
# ⚙️ Install
+## Pip package
+Prowler is available as a project in [PyPI](https://pypi.org/project/prowler-cloud/), thus can be installed using pip with Python >= 3.9:
+
```console
pip install prowler-cloud
prowler -v
```
-## Prowler container versions
+## Containers
The available versions of Prowler are the following:
-- latest: in sync with master branch (bear in mind that it is not a stable version)
-- (release): you can find the releases [here](https://github.com/prowler-cloud/prowler/releases), those are stable releases.
-- stable: this tag always point to the latest release.
+- `latest`: in sync with master branch (bear in mind that it is not a stable version)
+- `` (release): you can find the releases [here](https://github.com/prowler-cloud/prowler/releases), those are stable releases.
+- `stable`: this tag always point to the latest release.
The container images are available here:
- [DockerHub](https://hub.docker.com/r/toniblyx/prowler/tags)
- [AWS Public ECR](https://gallery.ecr.aws/o4g1s5r6/prowler)
+## From Github
+
+Python >= 3.9 is required with pip and pipenv:
+
+```
+git clone https://github.com/prowler-cloud/prowler
+cd prowler
+pipenv shell
+pipenv install
+python prowler.py -v
+```
+
+# 📖 Documentation
+
+The full documentation now can be found at [https://docs.prowler.cloud](https://docs.prowler.cloud)
+
+
# 📐✏️ High level architecture
You can run Prowler from your workstation, an EC2 instance, Fargate or any other container, Codebuild, CloudShell and Cloud9.
@@ -102,12 +125,16 @@ prowler
> Running the `prowler` command without options will use your environment variable credentials.
-By default, prowler will generate a CSV and a JSON report, however you could generate an HTML or an JSON-ASFF report with `-M` or `--output-modes`:
+By default, prowler will generate a CSV, a JSON and a HTML report, however you can generate JSON-ASFF (only for AWS Security Hub) report with `-M` or `--output-modes`:
```console
prowler -M csv json json-asff html
```
+The html report will be located in the `output` directory as the other files and it will look like:
+
+
+
You can use `-l`/`--list-checks` or `--list-services` to list all available checks or services within the provider.
```console
@@ -115,7 +142,7 @@ prowler --list-checks
prowler --list-services
```
-For executing specific checks or services you can use options `-c`/`checks` or `-s`/`services`:
+For executing specific checks or services you can use options `-c`/`--checks` or `-s`/`--services`:
```console
prowler aws --checks s3_bucket_public_access
@@ -158,17 +185,15 @@ With Azure you need to specify which auth method is going to be used:
```console
prowler azure [--sp-env-auth, --az-cli-auth, --browser-auth, --managed-identity-auth]
```
-> By default, `prowler` will scan all Azure subscriptions.
+> By default, `prowler` will scan all Azure subscriptions.
# 🎉 New Features
-- Multi-cloud support!
+- Python: we got rid of all bash and it is now all in Python.
+- Faster: huge performance improvements (same account from 2.5 hours to 4 minutes).
+- Developers and community: we have made it easier to contribute with new checks and new compliance frameworks. We also included unit tests.
+- Multi-cloud: in addition to AWS, we have added Azure, we plan to include GCP and OCI soon, let us know if you want to contribute!
-# 📖 Documentation
-
-The full documentation can be found here:
-
-[https://docs.prowler.cloud](https://docs.prowler.cloud)
# 📃 License
Prowler is licensed as Apache License 2.0 as specified in each file. You may obtain a copy of the License at
diff --git a/docs/img/ProwlerPro-3Dashboards-1-1024x1024.png b/docs/img/ProwlerPro-3Dashboards-1-1024x1024.png
deleted file mode 100644
index 54bc22be193b5d2dbd6e29395b154a121ed9e65b..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001
literal 306765
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 |