Skip to content

Commit 803d52c

Browse files
authored
Add guide for connecting Excel to local lakeFS server
This guide explains how to connect a modern Excel add-in to a local lakeFS server, addressing common security issues encountered during the process.
1 parent 8148360 commit 803d52c

File tree

1 file changed

+16
-0
lines changed

1 file changed

+16
-0
lines changed
Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
---
2+
layout: post
3+
title: Connecting Excel to a Local lakeFS Server: A Clearer Guide
4+
---
5+
6+
This guide solves a common but tricky problem: connecting a modern Excel add-in (like xlwings Lite) to a lakeFS server running on your own computer (`localhost`). When you try this, you'll likely run into security errors from your web browser.
7+
8+
Here, we'll break down why this happens and provide a clear, step-by-step solution using a simple tool called NGINX.
9+
10+
### The Core Problem: Modern Browser Security
11+
12+
When your Excel add-in tries to talk to your local lakeFS server, it's blocked by two modern browser security rules designed to protect you:
13+
14+
1. **CORS (Cross-Origin Resource Sharing):** Think of this like a bouncer at a club. Your add-in is from one web address (the "origin"), and your lakeFS server is at another (`localhost`). Because your add-in is sending login details (an `Authorization` header), the bouncer (your browser) is extra strict. It requires the lakeFS server to explicitly say, "Yes, I trust the add-in from that specific address." The default lakeFS setup doesn't do this, so the request is blocked.
15+
2. **PNA (Private Network Access):** This is a newer rule. It's like a doorman asking for extra credentials before letting someone from a public place (the internet, where your add-in technically lives) into a private building (your computer, or `localhost`). The browser sends a special "preflight" question to the server first. The lakeFS server (in version v1.60.0, at least) doesn't know how to answer this question correctly, so it returns an error, and the browser cancels the connection.
16+

0 commit comments

Comments
 (0)