> 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-xsiam/configure-cortex-xsiam/cortex-xsiam-data-sources/vendor-specific-data-sources-and-connectors/microsoft/microsoft-power-bi.md).

# Microsoft Power BI

Use Microsoft Power BI data with Cortex XSIAM.

The capabilities and sub-capabilities listed for this connector are available with any active Cortex XSIAM or Cortex Cloud Posture Security license.

This connector includes the following capabilities and sub-capabilities (if applicable):

* **SaaS Posture Configuration Monitoring:** Detect, monitor and alert on settings of your SaaS application.
  * **saas-posture-config-remediation:** Help remediate the misconfigured security settings of your SaaS application.

### How to configure the Microsoft Power BI connector

Cortex XSIAM supports Microsoft Power BI tenants with Global Admin or Power BI Admin privileges.

To access Microsoft Power BI, Cortex XSIAM requires the following information, which you will specify during the connection process.

* **Client ID:** The Application (client) ID generated when you register an app in the Microsoft Entra Admin Center. Cortex XSIAM uses this value to identify your integration.
* **Tenant ID:** The Directory (tenant) ID for your Microsoft Entra instance. Cortex XSIAM uses this value to scope authentication to your organization.
* **Client Secret:** A secret key generated within your registered application. Cortex XSIAM uses the Client ID, Tenant ID, and Client Secret to authenticate to the Power BI API using the Client Credentials flow.

Perform the following procedures in the order that they appear below.

#### Task 1: Register a Power BI App in Microsoft Entra

1. Navigate to the [Microsoft Entra Admin Center](https://entra.microsoft.com) and log in.
2. In the left panel, select **App registrations**.
3. Click **New registration**.
4. Enter an **App Name** (for example, `Cortex_BI_Integration`).
5. Under **Supported account types**, select **Accounts in this organizational directory only (Single tenant)**.
6. Click **Register**.

#### Task 2: Retrieve Your Client ID and Tenant ID

1. On the **Overview** page of your new app, locate and copy the **Application (client) ID**.
2. Locate and copy the **Directory (tenant) ID**.
3. Store both values securely in a text file.

   > Do not continue to the next step unless you have copied both values. You must provide them to Cortex XSIAM during the onboarding process.

#### Task 3: Generate a Client Secret

1. In the left panel of your app, click **Certificates & secrets**.
2. Click **New client secret**.
3. Enter a description (for example, `Cortex Integration Secret`) and set an expiration duration.
4. Click **Add**.
5. Copy the **Value** immediately and store it securely.

   > The secret value is shown only once. It will be masked after you navigate away from this page. You must provide this value to Cortex XSIAM during the onboarding process.

#### Task 4: Configure Access in the Fabric Admin Portal

1. Navigate to the [Fabric Admin Portal](https://app.fabric.microsoft.com/admin-portal).
2. Ensure your Service Principal is added to the security groups for the following settings:
   * **Service principals can access read-only admin APIs**
   * **Service principals can use Fabric APIs**

#### Task 5: Connect Microsoft Power BI to Cortex XSIAM

1. In Cortex XSIAM, navigate to **Settings** → **Data Sources & Integrations**.
2. Click **+ Add new**.
3. In the **Add Data Source** page, search for Microsoft Power BI.
4. Under **Recommended**, hover over the new Microsoft Power BI integration and click **Add Instance** to launch the configuration wizard.
5. Under the **Capabilities** tab, enter a name for your application.
6. Select **Security Posture** under **Default Capabilities**. Click **Next**.
7. Under the **Connection** tab, enter the **Client ID**, **Tenant ID**, and **Client Secret** details.
8. Under the **Configuration** tab, select a **Sync Interval**. Choose a meaningful **Tag** to distinguish between various applications in different environments.
9. A confirmation message shows that Microsoft Power BI is successfully connected. Confirm the **Summary** details and click **Save instance**.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://cortex-docs.paloaltonetworks.com/cortex-xsiam/configure-cortex-xsiam/cortex-xsiam-data-sources/vendor-specific-data-sources-and-connectors/microsoft/microsoft-power-bi.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
