Knowledge BaseRelease NotesRequest Demo

Wiz API

Panther supports pulling logs directly from Wiz API

Overview

Panther can fetch Wiz Audit, Issues, and Vulnerability finding logs by querying the Wiz API.

To ingest different types of Wiz logs, you can additionally or instead use the Wiz Webhook integration. Note that the Wiz.Issues events available through this integration and the Wiz.IssuesWebhook events available through the Wiz API integration differ slightly.

How to onboard Wiz logs to Panther

Prerequisite

  • The user setting up this integration must have access to a Wiz tenant and have a Wiz role with permissions to create service accounts (such as a Global Admin).

Step 1: Retrieve your Wiz API endpoint URL

The Wiz GraphQL API has a single endpoint (https://api.<TENANT_DATA_CENTER>.app.wiz.io/graphql), where <TENANT_DATA_CENTER> is the Wiz regional data center in which your tenant resides, e.g., us1, us2, eu1 or eu2. The endpoint is the same regardless of which operation you're performing.

To retrieve your GraphQL endpoint:

  1. In the upper-right corner of your Wiz console, click the user icon > User settings (or this direct link).

  2. On the left side, click Tenant (or this direct link).

  3. Copy your API Endpoint URL and store it in a secure location, as you will need it in a following step.

Step 2: Create a service account in Wiz

  1. In the Wiz dashboard, navigate to Settings > Access Management > Service Accounts.

  2. Click Add Service Account.

  3. In the New Service Account form, fill in the fields:

    • Name: Provide a descriptive name for the service account, e.g., Panther Integration.

    • Type: Select Custom Integration (GraphQL API).

    • Projects (Optional): Select one or more projects this service account will have access to.

      • Note that selecting one or more projects disallows you from querying Audit logs.

    • API Scopes:

      • Select read:resources.

      • Select the scope(s) listed in the Required API scopes for service account table below for the Wiz log type(s) you plan to ingest into Panther.

  4. Click Add Service Account.

  5. Copy the Client Secret, and store it in a secure location, as you will need it in a following step. You will not be able to view this value after this step.

  6. Copy the Client ID, and store it in a secure location, as you will need it in a following step.

Required API scopes for service account

Log type
Scope required for querying
Notes

Audit

admin:audit

This permission is only visible if you have not chosen one or more Projects for the service account

Issues

read:issues

VulnerabilityFinding

read:vulnerabilities

Step 3: Create a new Wiz log source in Panther

  1. In the left-hand navigation bar of your Panther Console, click Configure > Log Sources.

  2. Click Create New.

  3. Search for "Wiz," then click its tile.

  4. In the upper-right corner of the slide-out panel, click Start Setup.\

    A page in the Panther console with the trail Configure > Log Sources > Add New Source is shown, with a slide-out panel expanded with the title Wiz. An arrow is drawn to a "Start Setup" button.

  5. On the Configure screen, fill in the form:

    • Name: Enter a descriptive name for the source e.g. My Wiz logs.

    • Project Ids (Optional): Enter the IDs of the projects you'd like to pull logs for. If this field is left blank, Panther will pull logs for all projects. To find the ID for a given project in the Wiz console:

      1. Click Settings > Projects.

      2. On the right-hand side of the row of the project, click the three dots icon > Project Id. The ID will be copied to your clipboard.

    • Select the log types you want to monitor: All Wiz log types will be pre-populated.

  6. Click Setup.

  7. On the Set Credentials page, fill in the form:

    • Token URL: Enter your Wiz API Token URL. This value depends on your Wiz account's identity provider:

      • Amazon Cognito: Enter https://auth.app.wiz.io/oauth/token.

      • Auth0: Enter https://auth.wiz.io/oauth/token.

        • Note that Wiz ended support for Auth0 as an identity provider in December 2022.

    • API Endpoint: Enter the API Endpoint URL you retrieved from Wiz.

    • Client ID: Enter the Client ID you generated in Wiz.

    • Client Secret: Enter the Client Secret you generated in Wiz.

  8. Click Setup. You will be directed to a success screen:\

    The success screen reads, "Everything looks good! Panther will now automatically pull & process logs from your account"

    • You can optionally enable one or more Detection Packs.

    • The Trigger an alert when no events are processed setting defaults to YES. We recommend leaving this enabled, as you will be alerted if data stops flowing from the log source after a certain period. The timeframe is configurable, with a default of 24 hours.\

      The "Trigger an alert when no events are processed" toggle is set to YES. The "How long should Panther wait before it sends you an alert that no events have been processed" setting is set to 1 Day

Panther-managed detections

See Panther-managed rules for Wiz in the panther-analysis GitHub repository.

Supported log types

Wiz.Audit

The Audit log records key events in Wiz, such as log ins, log outs, and user updates. The Audit log is primarily used to investigate potentially suspicious activity or diagnose and troubleshoot errors.

Reference: https://win.wiz.io/reference/audit-log

Wiz.Issues

The Issues log records key events in Wiz related to issues, such as vulnerability findings and security incidents. It is used to track, manage, and remediate security vulnerabilities and incidents.

Reference: https://win.wiz.io/reference/issues-query

Wiz.VulnerabilityFinding

The Vulnerability Finding log records information about security vulnerabilities detected in Wiz, including details about the vulnerabilities, affected assets, and remediation steps.

Reference: https://win.wiz.io/reference/vulnerability-finding

PreviousWiz LogsNextWiz Webhook (Beta)

Last updated

Was this helpful?