Why a checklist matters
BlobBridge touches Azure Storage, Azure AD and SharePoint—three platforms with their own governance expectations. Teams that follow a deliberate checklist avoid rework, unblock security reviews faster and land the deployment with confidence. The steps below are ordered so that dependencies (like RBAC and container design) are validated before you publish the SPFx package to production.
1. Confirm prerequisites
- Microsoft 365 tenant with a SharePoint App Catalog (tenant or site collection).
- An Azure subscription where the storage account already exists or can be provisioned.
- BlobBridge licence file (trial or full) and the
blob-bridgeSPFx package downloaded from the customer portal. - Admin personas: Azure subscription owner (or with Storage Account Contributor), SharePoint tenant admin, and someone who can assign Azure AD roles.
Tip: capture the Microsoft 365 Tenant ID and Azure subscription ID in the change ticket so every team is working from the same source of truth.
2. Harden and configure the storage account
BlobBridge reads and writes directly to the Azure Storage account you provide. Before you worry about SharePoint, guarantee the storage layer is in the right shape:
- Use a General-purpose v2 account with hierarchical namespaces disabled (BlobBridge works with block blob containers).
- Enable secure transfer required and restrict public network access according to your policy. Private endpoints work—just ensure the SharePoint tenant can resolve the FQDN.
- Under Configuration, confirm that Storage account key access is enabled. BlobBridge uses SAS or user delegation keys, but key access must not be blocked at the account level.
- Decide whether hot/cool tiers or lifecycle policies will be applied to the target containers and document the defaults.
If the platform team manages storage accounts centrally, request the configuration in writing so it can be traced during the go-live review.
3. Assign the right Azure roles
BlobBridge relies on Azure RBAC to govern SAS creation and container operations. The easiest way to unblock administrators is to map roles deliberately:
- Grant the deployment engineer the Storage Blob Data Owner role on the storage account scope so they can manage ACLs, generate SAS tokens and validate permissions.
- If you are separating duties, provide the operations team the Storage Blob Data Owner role and the SharePoint team Storage Blob Data Reader for audit visibility.
- Document who can rotate the SAS, who can create additional containers and who is accountable for cost alerts.
Do not rely on the classic account-key model—RBAC + SAS keeps the deployment aligned with Azure security baselines.
4. Create containers and scope SAS correctly
Most production tenants want predictable SAS scope from day one. Follow this sequence:
- Create blob containers using naming conventions that match your SharePoint audiences (for example
hr-shared,projects-emea). - For static SAS, generate tokens limited to the required operations (CRUD) and set expiries that align with your rotation policy (typically 30–90 days).
- If you plan to use user delegation SAS, configure an Azure AD application and document the token issuance flow before go-live.
- Record the storage endpoint URLs and SAS strings in your secure vault—never paste them into emails or change tickets.
Need a walkthrough? See the docs section on “Container creation & SAS setup” after you complete this checklist; it mirrors the steps above with screenshots.
5. Prepare the BlobBridge artefacts
BlobBridge ships as an SPFx package plus a licence file.
- Virus-scan the
.sppkgand licence before uploading to your tenant. - Capture the package version and SHA-256 hash (provided in the release notes) in the deployment ticket.
- Store the licence file in a SharePoint document library that the web part can reach—usually a locked-down “Apps” library at the tenant level.
6. Publish to SharePoint
This is the moment the SharePoint admin steps in:
- Upload the
blob-bridge.sppkgpackage to the App Catalog. Approve deployment tenant-wide. - Add the “BlobBridge” web part to a pilot communication site and configure it with your first SAS token.
- Reference the licence file location in the web part properties and confirm the licence status shows as Valid.
- Test uploads, renames and deletes to ensure storage permissions align with the SAS scopes you defined.
7. Validate security and compliance
Before you open the floodgates, prove that controls are in place:
- Review Azure Storage diagnostic logging and ensure it is being shipped to Log Analytics or your SIEM.
- Confirm data residency and retention policies are noted in the deployment record (BlobBridge keeps files inside Azure, not SharePoint).
- Share your SAS rotation cadence with the security team and note who will execute it.
- Document the process for revoking a SAS immediately if a container is compromised.
8. Plan go-live and ongoing operations
With technical tasks complete, keep the momentum rolling:
- Create a communication pack for end users explaining how BlobBridge mirrors the SharePoint document library experience.
- Schedule a post-implementation review two weeks after launch to capture feedback and confirm telemetry (cost, latency, error rates).
- Automate alerts for storage capacity thresholds and SAS renewals.
- Back up the configuration: licence file path, SAS values, container list and custom CSS if you applied any branding.
Deployment summary
| Area | Owner | Proof of completion |
|---|---|---|
| Storage account configuration | Azure platform | Screenshot of settings + change ticket ID |
| RBAC assignments | Azure AD / Identity | Access review exported as CSV |
| Container & SAS setup | BlobBridge deployment engineer | Record in secrets vault with expiry dates |
| SPFx package deployment | SharePoint admin | App Catalog confirmation + pilot site test plan |
| Licence validation | BlobBridge admin | Screenshot of licence status in web part properties |
| Monitoring & alerts | Operations | Alert rule IDs and runbook links |
Run through the table as part of your go-live meeting and capture any outstanding actions—closing the loop early keeps BlobBridge deployments repeatable.
Next steps
- Walk through the BlobBridge documentation for detailed screenshots and script snippets.
- Share the one-pager with stakeholders who need the value proposition without the technical deep dive.
- Schedule the first SAS rotation and document where renewal tasks will be tracked (ServiceNow, Azure DevOps, etc.).