Quick‑start
Already comfortable with SharePoint App Catalogs and Azure portal? These five steps usually take less than five minutes:
- Upload BlobBridge.sppkg to the Tenant App Catalog and deploy.
- Add the BlobBridge web‑part to any modern SharePoint page.
- Drop your licence file BlobBridge.lic in a library.
- Generate a Container SAS token with Read, Write, Create, List, Delete scopes.
- Open web‑part properties and paste Storage URL, Container, SAS token and full URL to licence file folder.
You’re done. The document library view now points at your blob container.
Full installation guide
1. Get the files
After checkout you receive an e‑mail with:
- BlobBridge.sppkg – the SharePoint package.
- BlobBridge.lic – tenant‑locked licence file.
2. Upload to App Catalog
Navigate to https://<tenant>.sharepoint.com/sites/apps (or your chosen App Catalog), choose Upload and select BlobBridge.sppkg. Confirm the Deploy dialog.
3. Add web‑part to a page
Edit a modern page → click + Add → search "BlobBridge" → select. Publish the page.
4. Upload licence file
The web‑part will look for BlobBridge.lic at runtime. Drop it into any library that all viewers can read (Site Assets works well). Note the folder path – you’ll reference it in properties.
Configuration options
| Property | Description | Example |
|---|---|---|
| Storage URL | Base URL of your storage account. | https://mystore.blob.core.windows.net |
| Container | Name of the blob container (case‑sensitive). | documents |
| SAS token | Shared Access Signature – grants scoped access. | ?sv=2024-06-... |
| Licence folder path | Full URL to the licence file folder. | https://<tenant>.sharepoint.com/SiteAssets/Licences |
Generate a SAS token
Open Azure portal → Storage Account → Containers → select your container → Generate SAS → Sign with User delegation key. Tick at minimum:
- Read
- Write
- Create
- List
- Delete (needed if users should delete files)
Set an expiry that matches your security policy (e.g. 12 months). Click Generate and copy the full query string starting with ?sv=.
Frequently asked questions
Does BlobBridge cache blobs inside SharePoint?
No. The web‑part streams files directly from Azure Blob Storage to the browser. Nothing is stored in SharePoint other than the web‑part and licence file.
Can I use multiple containers?
Add multiple instances of the web‑part to the same page – each can point to a different container or even a different storage account.
What happens when the SAS token expires?
Users will receive a “Forbidden” message. Generate a new SAS and paste it into web‑part properties; the page works instantly with no redeploy.
Troubleshooting
Check these common issues before raising a support ticket.
| Symptom | Likely cause | Fix |
|---|---|---|
| “Licence not found” banner | Licence folder path incorrect or file name mismatch. | Confirm path in properties and ensure file is BlobBridge.lic. |
| Upload stalls at 100 % | Block list committed but container lacks Create permission. | Regenerate SAS with Create & Write scopes. |
| Breadcrumb shows wrong folder | SAS token missing List capability. | Include List when generating SAS. |
| HTTP 403 on every request | Token expired or clock skew > 15 minutes. | Regenerate token and sync server clocks. |
| Large file downloads are slow | Azure egress distance or SharePoint throttling. | Place storage account in same region as majority of users and enable CDN if necessary. |
Still stuck? E‑mail [email protected] with your tenant ID, storage account region and detailed steps to reproduce.