Skip to content
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
57 commits
Select commit Hold shift + click to select a range
fbfb672
Update opencanary
alaudazzi May 27, 2025
2202cdf
Update ping_federate
alaudazzi May 27, 2025
d1568af
Update pps
alaudazzi May 28, 2025
b4fa015
Update prisma_access
alaudazzi May 30, 2025
bc352c0
Update prisma_cloud
alaudazzi May 30, 2025
6665e84
Update proofpoint-itm
alaudazzi Jun 2, 2025
92fd7c6
Update proofpoint_on_demand
alaudazzi Jun 2, 2025
76121e1
Update qualys_vmdr
alaudazzi Jun 2, 2025
2ccf02f
Update qualys and sentinel_one_cloud_funnel
alaudazzi Jun 2, 2025
e50178f
Update servicenow
alaudazzi Jun 2, 2025
bf50f10
Update splunk
alaudazzi Jun 4, 2025
579ab1e
Update spycloud
alaudazzi Jun 4, 2025
305e92c
Update sublime_security
alaudazzi Jun 4, 2025
6f94f0f
Update symantec_endpoint_security
alaudazzi Jun 4, 2025
6436f88
Update teleport
alaudazzi Jun 4, 2025
7800852
Update tenable_io
alaudazzi Jun 4, 2025
ab8c72c
Update ti_crowdstrike
alaudazzi Jun 4, 2025
a8613aa
Update ti_eset
alaudazzi Jun 4, 2025
d865667
Update ti_rapid7_threat_command
alaudazzi Jun 4, 2025
ec144cf
Update ti_threatconnect
alaudazzi Jun 5, 2025
70d6366
Update ti_threatq
alaudazzi Jun 5, 2025
0f96e9d
Update trellix_edr_cloud
alaudazzi Jun 5, 2025
d71a6a1
Update trendmicro
alaudazzi Jun 5, 2025
b0008ad
Update wiz
alaudazzi Jun 5, 2025
2463cfd
Update zscaler_zia
alaudazzi Jun 5, 2025
ab749df
Merge branch 'main' into remove-duplicated-install-instruct
alaudazzi Jun 5, 2025
2a8084d
Update zscaler_zia
alaudazzi Jun 5, 2025
8a0bd56
Merge branch 'remove-duplicated-install-instruct' of github.com:elast…
alaudazzi Jun 5, 2025
b6da6aa
Update manifest and changelog
alaudazzi Jun 5, 2025
8ada671
Update packages/zscaler_zia/_dev/build/docs/README.md
alaudazzi Jun 16, 2025
aa48b6d
Update packages/opencanary/_dev/build/docs/README.md
alaudazzi Jun 16, 2025
bf4b3ff
Update packages/qualys_vmdr/_dev/build/docs/README.md
alaudazzi Jun 16, 2025
136cb21
Update packages/ti_threatconnect/_dev/build/docs/README.md
alaudazzi Jun 16, 2025
14c207a
Update packages/wiz/_dev/build/docs/README.md
alaudazzi Jun 16, 2025
a33fbd0
Update packages/splunk/_dev/build/docs/README.md
alaudazzi Jun 16, 2025
e44579b
Update packages/opencanary/docs/README.md
alaudazzi Jun 16, 2025
83540ef
Update packages/ti_threatq/_dev/build/docs/README.md
alaudazzi Jun 16, 2025
4e2526d
Update packages/opencanary/changelog.yml
alaudazzi Jun 16, 2025
aa40dde
Update packages/tenable_io/_dev/build/docs/README.md
alaudazzi Jun 16, 2025
c1fff96
Integrate reviewer comments
alaudazzi Jun 16, 2025
89f946d
Integrate reviewer comments
alaudazzi Jun 16, 2025
d79a561
Integrate reviewer comments
alaudazzi Jun 16, 2025
5220bb1
Merge branch 'main' into remove-duplicated-install-instruct
alaudazzi Jun 16, 2025
e4987c8
Remove dead URL
alaudazzi Jun 16, 2025
f842043
Update manifest for ping_federate
alaudazzi Jun 18, 2025
338e660
Update manifest for qualys_vmdr
alaudazzi Jun 18, 2025
b0dfd15
Update manifest for teleport
alaudazzi Jun 18, 2025
9f9413d
Update manifest for tenable_io
alaudazzi Jun 18, 2025
246bb8c
Merge branch 'master' into remove-duplicated-install-instruct
efd6 Jun 18, 2025
5ef3f12
Update README
shmsr Jun 18, 2025
e32561b
ti_threatconnect: update transform
efd6 Jun 18, 2025
6c0cce8
Merge branch 'main' into remove-duplicated-install-instruct
alaudazzi Jun 18, 2025
2178a88
Update manifest for sentinel_one_cloud_funnel
alaudazzi Jun 18, 2025
28b5e6a
Update packages/prisma_cloud/_dev/build/docs/README.md
alaudazzi Jun 18, 2025
7cfde08
Update packages/proofpoint_itm/_dev/build/docs/README.md
alaudazzi Jun 18, 2025
6d3f25f
run elastic-package for prisma_cloud
alaudazzi Jun 18, 2025
d412438
Run elastic-package for proofpoint_itm
alaudazzi Jun 18, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Update wiz
  • Loading branch information
alaudazzi committed Jun 5, 2025
commit b0008add6b7409a85181a7d645540006586b793d
72 changes: 26 additions & 46 deletions packages/wiz/_dev/build/docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

[Wiz](https://www.wiz.io/) continuously prioritizes critical risks based on a deep cloud analysis across misconfigurations, network exposure, secrets, vulnerabilities, malware, and identities to build a single prioritized view of risk for your cloud.

This Wiz integration enables you to consume and analyze Wiz data within Elastic Security including issues, audit events, [misconfigurations](https://ela.st/cspm) [vulnerabilities](https://ela.st/cnvm) and defend which provides real-time threat detection based on runtime signals and cloud activity—giving you visibility and context for your cloud environments within Elastic Security.
The Wiz integration enables you to consume and analyze Wiz data within Elastic Security including issues, audit events, [misconfigurations](https://ela.st/cspm) [vulnerabilities](https://ela.st/cnvm) and defend which provides real-time threat detection based on runtime signals and cloud activity—giving you visibility and context for your cloud environments within Elastic Security.

## Data streams

Expand All @@ -24,55 +24,36 @@ This integration supports using Elastic Agent or agentless ingestion of data.

## Elastic Agent

Elastic Agent must be installed. For more information, refer to the link [here](https://www.elastic.co/guide/en/fleet/current/elastic-agent-installation.html).

### Installing and managing an Elastic Agent:

You have a few options for installing and managing an Elastic Agent:

### Install a Fleet-managed Elastic Agent (recommended):

With this approach, you install Elastic Agent and use Fleet in Kibana to define, configure, and manage your agents in a central location. We recommend using Fleet management because it makes the management and upgrade of your agents considerably easier.

### Install Elastic Agent in standalone mode (advanced users):

With this approach, you install Elastic Agent and manually configure the agent locally on the system where it’s installed. You are responsible for managing and upgrading the agents. This approach is reserved for advanced users only.

### Install Elastic Agent in a containerized environment:

You can run Elastic Agent inside a container, either with Fleet Server or standalone. Docker images for all versions of Elastic Agent are available from the Elastic Docker registry, and we provide deployment manifests for running on Kubernetes.

There are some minimum requirements for running Elastic Agent and for more information, refer to the link [here](https://www.elastic.co/guide/en/fleet/current/elastic-agent-installation.html).
Elastic Agent must be installed. For more details, check the Elastic Agent [installation instructions](docs-content://reference/fleet/install-elastic-agents.md).

The minimum **kibana.version** required is **8.10.1**.
This module has been tested against the **Wiz API Version v1**.

## Agentless Enabled Integration
## Agentless enabled integration
Comment thread
alaudazzi marked this conversation as resolved.
Resolved

Agentless integrations allow you to collect data without having to manage Elastic Agent in your cloud. They make manual agent deployment unnecessary, so you can focus on your data instead of the agent that collects it. For more information, refer to [Agentless integrations](https://www.elastic.co/guide/en/serverless/current/security-agentless-integrations.html) and the [Agentless integrations FAQ](https://www.elastic.co/guide/en/serverless/current/agentless-integration-troubleshooting.html).

Agentless deployments are only supported in Elastic Serverless and Elastic Cloud environments. This functionality is in beta and is subject to change. Beta features are not subject to the support SLA of official GA features.
Agentless deployments are only supported in Elastic Serverless and Elastic Cloud environments. This functionality is in beta and is subject to change. Beta features are not subject to the support SLA of official GA features.

## Setup

### To collect logs (Audit, Issue, Vulnerability, Cloud Configuration Findings) via GraphQL API:
### Collect logs (Audit, Issue, Vulnerability, Cloud Configuration Findings) via GraphQL API

### Get the Wiz API URL:
### Get the Wiz API URL

1. Go to your user profile.
2. Copy the **API Endpoint URL**.

### Steps to get the Client ID and Client Secret:
### Get the Client ID and Client Secret

1. In the Wiz dashboard Navigate to Settings > Service Accounts.
2. Click Add Service Account.
3. Name the new service account, for example: Elastic Integration.
4. If you desire, narrow the scope of this service account to specific projects.
5. Select the permission read:resources and click Add Service Account.
6. Copy the Client Secret. Note that you won't be able to copy it after this stage.
7. Copy the Client ID, which is displayed under the Service Accounts page.
1. In the Wiz dashboard Navigate to **Settings** > **Service Accounts**.
2. Click **Add Service Account**.
3. Name the new service account, for example: Elastic Integration You can narrow the scope of this service account to specific projects.
4. Select the permission read:resources and click **Add Service Account**.
5. Copy the Client Secret. You won't be able to copy it after this stage.
6. Copy the Client ID, which is displayed under the **Service Accounts** page.

### Required scopes:
### Required scopes

| Data Stream | Scope |
| ------------- | ------------- |
Expand All @@ -82,7 +63,7 @@ Agentless deployments are only supported in Elastic Serverless and Elastic Cloud
| Cloud Configuration Finding | read:cloud_configuration |
| Cloud Configuration Finding Full Posture | read:cloud_configuration |

### To collect logs (Defend) via HTTP Endpoint:
### Collect logs (Defend) via HTTP Endpoint

1. Obtain the webhook URL
- Generate a webhook URL for the third-party product.
Expand All @@ -104,21 +85,20 @@ Agentless deployments are only supported in Elastic Serverless and Elastic Cloud
- Click Add Integration.
- For more details, go to this [link](https://docs.wiz.io/docs/webhook-integration).

### Enabling the integration in Elastic:
### Enable the integration in Elastic

1. In Kibana go to Management > Integrations
2. In "Search for integrations" search bar, type Wiz
3. Click on the "Wiz" integration from the search results.
4. Click on the "Add Wiz" button to add the integration.
5. Enable the input type corresponding to the log source you wish to collect from.
6. Configure all the required integration parameters, including the listen address, listen port, and authentication method along with its corresponding required fields for the HTTP Endpoint input type. For the CEL input type, ensure you provide the Client ID, Client Secret, URL, and Token URL to successfully retrieve logs.
7. Save the integration.
1. In Kibana navigate to **Management** > **Integrations**.
2. In the search top bar, type **Wiz**.
3. Select the **Wiz** integration and add it.
4. Enable the input type corresponding to the log source you wish to collect from.
5. Configure all the required integration parameters, including the listen address, listen port, and authentication method along with its corresponding required fields for the HTTP Endpoint input type. For the CEL input type, ensure you provide the Client ID, Client Secret, URL, and Token URL to successfully retrieve logs.
6. Save the integration.

**Note:**
- Vulnerability data is fetched for the previous day.
- Custom headers are not supported in this integration. Only the standard Authorization header (e.g., Bearer token) is used for API requests.
- Custom headers are not supported in this integration. Only the standard Authorization header (for example, Bearer token) is used for API requests.

## Logs Reference
## Logs reference

### Audit

Expand All @@ -130,7 +110,7 @@ This is the `Audit` dataset.

{{fields "audit"}}

### Cloud Configuration Finding
### Cloud configuration finding

This is the `Cloud Configuration Finding` dataset.

Expand All @@ -140,7 +120,7 @@ This is the `Cloud Configuration Finding` dataset.

{{fields "cloud_configuration_finding"}}

### Cloud Configuration Finding Full Posture
### Cloud configuration finding full posture

This is the `Cloud Configuration Finding Full Posture` dataset.

Expand Down
72 changes: 26 additions & 46 deletions packages/wiz/docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

[Wiz](https://www.wiz.io/) continuously prioritizes critical risks based on a deep cloud analysis across misconfigurations, network exposure, secrets, vulnerabilities, malware, and identities to build a single prioritized view of risk for your cloud.

This Wiz integration enables you to consume and analyze Wiz data within Elastic Security including issues, audit events, [misconfigurations](https://ela.st/cspm) [vulnerabilities](https://ela.st/cnvm) and defend which provides real-time threat detection based on runtime signals and cloud activity—giving you visibility and context for your cloud environments within Elastic Security.
The Wiz integration enables you to consume and analyze Wiz data within Elastic Security including issues, audit events, [misconfigurations](https://ela.st/cspm) [vulnerabilities](https://ela.st/cnvm) and defend which provides real-time threat detection based on runtime signals and cloud activity—giving you visibility and context for your cloud environments within Elastic Security.

## Data streams

Expand All @@ -24,55 +24,36 @@ This integration supports using Elastic Agent or agentless ingestion of data.

## Elastic Agent

Elastic Agent must be installed. For more information, refer to the link [here](https://www.elastic.co/guide/en/fleet/current/elastic-agent-installation.html).

### Installing and managing an Elastic Agent:

You have a few options for installing and managing an Elastic Agent:

### Install a Fleet-managed Elastic Agent (recommended):

With this approach, you install Elastic Agent and use Fleet in Kibana to define, configure, and manage your agents in a central location. We recommend using Fleet management because it makes the management and upgrade of your agents considerably easier.

### Install Elastic Agent in standalone mode (advanced users):

With this approach, you install Elastic Agent and manually configure the agent locally on the system where it’s installed. You are responsible for managing and upgrading the agents. This approach is reserved for advanced users only.

### Install Elastic Agent in a containerized environment:

You can run Elastic Agent inside a container, either with Fleet Server or standalone. Docker images for all versions of Elastic Agent are available from the Elastic Docker registry, and we provide deployment manifests for running on Kubernetes.

There are some minimum requirements for running Elastic Agent and for more information, refer to the link [here](https://www.elastic.co/guide/en/fleet/current/elastic-agent-installation.html).
Elastic Agent must be installed. For more details, check the Elastic Agent [installation instructions](docs-content://reference/fleet/install-elastic-agents.md).

The minimum **kibana.version** required is **8.10.1**.
This module has been tested against the **Wiz API Version v1**.

## Agentless Enabled Integration
## Agentless enabled integration

Agentless integrations allow you to collect data without having to manage Elastic Agent in your cloud. They make manual agent deployment unnecessary, so you can focus on your data instead of the agent that collects it. For more information, refer to [Agentless integrations](https://www.elastic.co/guide/en/serverless/current/security-agentless-integrations.html) and the [Agentless integrations FAQ](https://www.elastic.co/guide/en/serverless/current/agentless-integration-troubleshooting.html).

Agentless deployments are only supported in Elastic Serverless and Elastic Cloud environments. This functionality is in beta and is subject to change. Beta features are not subject to the support SLA of official GA features.
Agentless deployments are only supported in Elastic Serverless and Elastic Cloud environments. This functionality is in beta and is subject to change. Beta features are not subject to the support SLA of official GA features.

## Setup

### To collect logs (Audit, Issue, Vulnerability, Cloud Configuration Findings) via GraphQL API:
### Collect logs (Audit, Issue, Vulnerability, Cloud Configuration Findings) via GraphQL API

### Get the Wiz API URL:
### Get the Wiz API URL

1. Go to your user profile.
2. Copy the **API Endpoint URL**.

### Steps to get the Client ID and Client Secret:
### Get the Client ID and Client Secret

1. In the Wiz dashboard Navigate to Settings > Service Accounts.
2. Click Add Service Account.
3. Name the new service account, for example: Elastic Integration.
4. If you desire, narrow the scope of this service account to specific projects.
5. Select the permission read:resources and click Add Service Account.
6. Copy the Client Secret. Note that you won't be able to copy it after this stage.
7. Copy the Client ID, which is displayed under the Service Accounts page.
1. In the Wiz dashboard Navigate to **Settings** > **Service Accounts**.
2. Click **Add Service Account**.
3. Name the new service account, for example: Elastic Integration You can narrow the scope of this service account to specific projects.
4. Select the permission read:resources and click **Add Service Account**.
5. Copy the Client Secret. You won't be able to copy it after this stage.
6. Copy the Client ID, which is displayed under the **Service Accounts** page.

### Required scopes:
### Required scopes

| Data Stream | Scope |
| ------------- | ------------- |
Expand All @@ -82,7 +63,7 @@ Agentless deployments are only supported in Elastic Serverless and Elastic Cloud
| Cloud Configuration Finding | read:cloud_configuration |
| Cloud Configuration Finding Full Posture | read:cloud_configuration |

### To collect logs (Defend) via HTTP Endpoint:
### Collect logs (Defend) via HTTP Endpoint

1. Obtain the webhook URL
- Generate a webhook URL for the third-party product.
Expand All @@ -104,21 +85,20 @@ Agentless deployments are only supported in Elastic Serverless and Elastic Cloud
- Click Add Integration.
- For more details, go to this [link](https://docs.wiz.io/docs/webhook-integration).

### Enabling the integration in Elastic:
### Enable the integration in Elastic

1. In Kibana go to Management > Integrations
2. In "Search for integrations" search bar, type Wiz
3. Click on the "Wiz" integration from the search results.
4. Click on the "Add Wiz" button to add the integration.
5. Enable the input type corresponding to the log source you wish to collect from.
6. Configure all the required integration parameters, including the listen address, listen port, and authentication method along with its corresponding required fields for the HTTP Endpoint input type. For the CEL input type, ensure you provide the Client ID, Client Secret, URL, and Token URL to successfully retrieve logs.
7. Save the integration.
1. In Kibana navigate to **Management** > **Integrations**.
2. In the search top bar, type **Wiz**.
3. Select the **Wiz** integration and add it.
4. Enable the input type corresponding to the log source you wish to collect from.
5. Configure all the required integration parameters, including the listen address, listen port, and authentication method along with its corresponding required fields for the HTTP Endpoint input type. For the CEL input type, ensure you provide the Client ID, Client Secret, URL, and Token URL to successfully retrieve logs.
6. Save the integration.

**Note:**
- Vulnerability data is fetched for the previous day.
- Custom headers are not supported in this integration. Only the standard Authorization header (e.g., Bearer token) is used for API requests.
- Custom headers are not supported in this integration. Only the standard Authorization header (for example, Bearer token) is used for API requests.

## Logs Reference
## Logs reference

### Audit

Expand Down Expand Up @@ -256,7 +236,7 @@ An example event for `audit` looks as following:
| wiz.audit.user_agent | | keyword |


### Cloud Configuration Finding
### Cloud configuration finding

This is the `Cloud Configuration Finding` dataset.

Expand Down Expand Up @@ -424,7 +404,7 @@ An example event for `cloud_configuration_finding` looks as following:
| wiz.cloud_configuration_finding.rule.short_id | | keyword |


### Cloud Configuration Finding Full Posture
### Cloud configuration finding full posture

This is the `Cloud Configuration Finding Full Posture` dataset.

Expand Down