> For the complete documentation index, see [llms.txt](https://cortex-docs.paloaltonetworks.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cortex-docs.paloaltonetworks.com/cortex-xdr-3.x/cortex-xdr-3.x-documentation/investigate-and-respond-to-incidents/investigate-alerts/alert-investigation-views/saas-causality-view.md).

# SaaS causality view

{% hint style="info" %}

### Notice

Requires a Cortex XDR Pro license.
{% endhint %}

The SaaS causality view provides a powerful way to analyze and investigate software-as-a-service (SaaS) related alerts for audit stories, such as Office 365 audit logs and normalized logs, by highlighting the most relevant events and alerts associated with a SaaS-related alert. To help you identify and investigate SaaS-specific data associated with SaaS-related alerts and SaaS audit logs, Cortex XDR displays a SaaS causality view, which enables you to swiftly investigate a SaaS alert by displaying the series of events and artifacts that are shared with the alert.

A SaaS causality view is only available when Cortex XDR is configured to collect SaaS audit logs and data. For example, this is possible by configuring an Office 365 data collector or Google Workspace data collector with the applicable SaaS audit logs. This enables you to investigate any Cortex XDR alerts generated from any IOC, BIOC, or correlation rules, including SaaS events. The SaaS causality view is available from the **Alerts** table, or from the **Query Results** after running a query on the SaaS related data. From both of these places, you can pivot (right-click) to the SaaS causality view from any row in the table and selecting Investigate Causality Chain → Open Card in new tab or Investigate Causality Chain → Open Card in same tab.

The scope of the SaaS causality view is the Causality Instance (CI) of an event to which this alert pertains. The SaaS causality view presents the event identity and /or IP address and the actions performed by the identity on the SaaS resource. On each node in the CI chain, Cortex XDR provides information to help you understand what happened around the event.

The SaaS causality view contains the following sections:

<details>

<summary>Information Overview</summary>

Summarizes information about the alert you are analyzing, including the type of SaaS provider, project, and region on which the event occurred. Select **View Raw Log** to view the raw log as provided by the SaaS provider in JSON format.

</details>

<details>

<summary>SaaS causality instance chain</summary>

Includes the graphical representation of the SaaS Causality Instance (CI) along with other information and capabilities to enable you to conduct your analysis.

The SaaS causality view presents a single event CI chain. The CI chain is built from Identity and Resource nodes. The Identity node represents for example keys, service accounts, and users, while the Resource node represents for example network interfaces, storage buckets, or disks. When available, the chain can also include an IP address and alerts that were triggered on the Identity and SaaS resource.

The SaaS causality view provides an interactive way to view the CI chain for an alert. You can move it, extend it, and modify it. To adjust the appearance of the CI chain, you can enlarge/shrink the chain for easy viewing using the size controls on the right. You can also move the chain around by selecting and dragging it. To return the chain to its original position and size, click ![causality-view-reset-icon.png](/files/05qBcBjuokF4fncecOep) in the lower-right of the CI graph.

* **Identity node:** Displays the name of the identity, generated alert information, and if available the associated IP address.

  To further investigate the user:

  1. Hover over an Identity node to display, if available, the identity **Analytics Profiles**.
  2. Select the Identity node to display in the Entity Data section additional information about the Identity entity.
  3. Select the Alert icon to display in the Entity Data section additional information about the alert.
* **IP address node:** Displays the IP address associated with the Identity.
* **Resource node:** Displays the referenced resource on which the operation was performed. Cortex XDR displays information on the following resources.

  To further investigate the resource:

  1. Hover over a Resource node to display, if available, the resource **Analytics Profiles** and **Resource Editors** statistics.
  2. Select the Resource node to display in the Entity Data section additional information about the Resource entity.

Types of resource

| Icon                                                | Type of resource                        |
| --------------------------------------------------- | --------------------------------------- |
| ![saas-resource-1.png](/files/w8fIAH3JBVRkAxoj9De3) | Google Workspace Admin Console          |
| ![saas-resource-2.png](/files/9FG734DNrVC2QiuVQ2er) | Google Workspace for Google Drive       |
| ![saas-resource-3.png](/files/A3R4sZvsjLyOOlzcYUAJ) | Microsoft Office 365 Exchange Online    |
| ![saas-resource-4.png](/files/8svhirZ5XeTcQu6MW69H) | Microsoft 365 Office Groups             |
| ![saas-resource-5.png](/files/jeiyfRAHFMW5aWJ2XWJC) | Microsoft Office 365 OneDrive           |
| ![saas-resource-6.png](/files/XYbuUVR1kUfOt2arCVLu) | Microsoft Office 365 SharePoint Online  |
| ![saas-resource-7.png](/files/LGtvfq3LhlMosPQfgrNz) | Microsoft Office 365 Skype for Business |
| ![saas-resource-8.png](/files/QWcDOxUzFk7dqfCWF9e9) | Microsoft Office 365 Teams              |

</details>

<details>

<summary>All Events table</summary>

Displays up to 100,000 related events and up to 1,000 related alerts. In the **All Events** table, Cortex XDR displays detailed information about each of the related events. To simplify your investigation, Cortex XDR scans your Cortex XDR data aggregating the events that have the same Identity or Resource and displays the entry with an ![cloud-causality-aggregated-events.png](/files/vqytHLF4Qx9UU8TWHGBP) aggregated icon. Right-click and select **Show Grouped Events** to view the aggregated entries.

Entries highlighted in red indicate that the specific event triggered an alert. To continue the investigation, right-click to **View in XQL**.

To continue the investigation, in the **Alerts** table, right-click an alert to see the available actions.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://cortex-docs.paloaltonetworks.com/cortex-xdr-3.x/cortex-xdr-3.x-documentation/investigate-and-respond-to-incidents/investigate-alerts/alert-investigation-views/saas-causality-view.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
