> 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-cloud-posture-management/cortex-cloud-data-sources-and-connectors/vendor-specific-data-sources/databricks/how-to-onboard-databricks.md).

# How to onboard Databricks

You can add the Databricks platform as a third-party data source in Cortex Cloud Data Security.

**Prerequisites**

* In order to use Databricks, you must be registered.
* Make sure you have the following account permissions to onboard:
  * `Account Admin`: For information about this role, see [Set up users, groups, and roles](/cortex-cloud-posture-management/onboard-and-configure/deployment-steps-and-checklist/set-up-users-and-roles.md).
  * `Metastore Admin`: Databricks admin that can only be assigned by an `Account Admin`. Databricks recommends assigning this role to a group rather than an individual user in order to facilitate management and ensure continuity in case an individual leaves the organization.
* Make sure you have the following ID numbers at hand:
  * **Account ID:** Refers to the unique identifier of the user account.

    How to find the Account ID

    1. Log in to the account console.
    2. In the account console, your user name should appear in the upper right corner of the page.
    3. Click the icon of your user name.
    4. Your account ID appears in the list.
  * **Application ID:** Refers to the unique identifier for a service principal in Databricks.

    How to find the Application ID

    1. Log in to the account console.
    2. Click User Management and navigate to the Service Principals tab.
    3. Click the name of the service principal for which you need the Application ID. The service principal must also be the account admin.
    4. On the service principal settings page, navigate to the Configuration tab.
    5. The Application ID appears in the list.

#### **Add the Databricks data source**

To add the Databricks platform as a data source, you need to add configuration details, establish a connection, and then verify the connection.

Add configuration details

1. Navigate to Settings → Data Sources & Integrations.
2. On the Data Sources & Integrations page, click + Add New.
3. On the Add Data Sources or Integrations page, search for Databricks, then hover over it and click Add.
4. On the Databricks integration instance settings page, for the Configuration step do the following:
   1. Enter the display name for your Databricks integration instance.
   2. Enter your Databricks Account ID.
   3. Enter your Application ID.
   4. Select a cloud platform.
   5. (Optional) Turn on the toggle for My Databricks account protected by network policies and select a region.

      If you turn on this feature, both the cloud and region will be used for scanning, possibly incurring cost and requiring adherence to certain compliance policies.
   6. Click Next.
5. Click Next.

Establish a connection

1. For the Establish Connection step, you are now instructed to open your Databricks console in a new browser tab.
2. On the Establish Connection tab, click the arrow to open the Generated script code block. Do one or both of the following:
   * Click the cloud icon to download the .sh script file.
   * Click the copy icon to copy the script to your clipboard.
3. Run the script in your Databricks CLI.
4. Click Verify Connection.

Verify the connection

1. For the Verify Connection step, if the connection is verified, a confirmation message is displayed.
2. Click Close.

Databricks now appears in the list of data sources on the Data Sources & Integrations page.

#### **Verify the Cortex Gateway connection**

At the end of the onboarding process, a pending request for Databricks approval is automatically created and displayed on the Cortex Gateway screen. In order to complete the onboarding process, approve the pending request. If you do not have permissions, contact your Cortex Cloud administrator.

For more information, see [Egress configurations](/gateway-guide/egress-configurations.md).


---

# 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-cloud-posture-management/cortex-cloud-data-sources-and-connectors/vendor-specific-data-sources/databricks/how-to-onboard-databricks.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.