Skip to main content

Databricks Excel Add-in architecture and security

Preview

This feature is in Public Preview.

This page describes how the Databricks Excel Add-in connects to your Databricks workspace and which network security features apply to its traffic.

Network traffic and architecture​

The Databricks Excel Add-in runs in Excel on the user's computer. Requests from the add-in to your workspace come from that computer's IP address, the same as when a user opens the workspace in a browser. The add-in therefore works with the existing security features of your Databricks workspace, such as IP access lists and front-end Private Service Connect.

When users connect to your workspace through front-end Private Service Connect, traffic between the add-in and your workspace uses your private network. This includes workspace sign-in, browsing data, running queries, returning query results to Excel, and writing data back to Databricks.

When front-end Private Service Connect is enabled and public access to the workspace is disabled, users must connect to your corporate network or VPN to use the add-in. If a user isn't connected, the workspace blocks their requests, including sign-in.

The following diagram shows how the add-in communicates with your workspace:

Architecture diagram of the Excel Add-in. The add-in runs as a JavaScript iframe in Excel on the user's desktop and sends requests through the Databricks API proxy to the UI service for login and static UI assets, and to Databricks APIs.

  1. The user signs in to the Databricks workspace.
  2. The workspace serves the add-in's UI to Excel, where it runs in an iframe.
  3. The add-in calls the Databricks APIs it needs.

Scheduled refresh​

Scheduled refresh runs within Databricks as a job, not in Excel. To update the workbook, Databricks makes an outbound call to the public Microsoft Graph API endpoint (graph.microsoft.com).