brillientaKnowledge base

Knowledge base / Intranet Builder / Automated installation

Automated mode

1 min read · Intranet Builder 2.4.0

The same engine, run as queued jobs in your own Azure subscription. Setup Center submits jobs to an Entra ID protected API; a PowerShell worker performs them with its managed identity. The API never calls SharePoint. Details: docs/AUTOMATED-MODE.md and docs/PROVISIONING-API.md.

How a job flows

  1. Setup Center calls POST /api/jobs with an Entra token (user_impersonation scope + Intranet.Provision role).
  2. The API validates the token and configuration, authorizes the target site against the approved site patterns, stores the job (Table + Blob) and queues it.
  3. The worker claims the job with a lease and runs it with the engine under its managed identity (Sites.Selected, granted sites only), writing progress and checkpoints as it goes.
  4. Jobs can be listed, inspected, cancelled and resumed from Setup Center. No secrets or keys exist anywhere: Storage refuses shared keys and Application Insights accepts only Entra ID telemetry.

Setup (after the first administrator-run sites)

  1. Deploy infra/main.bicep (two Function Apps, identities, Storage, App Insights) with tenantId, sharePointHostName and approvedSitePatterns.
  2. Zip-deploy provisioning-api.zip and provisioning-worker.zip (npm run build:api).
  3. Register-ProvisioningApi.ps1 -FunctionAppName -AssignTo creates the Entra registration and role assignments.
  4. Grant-WorkerPermissions.ps1 -WorkerPrincipalId grants Graph access (Sites.Selected by default); Grant-IntranetSiteAccess.ps1 -SiteUrl -WorkerAppId grants per-site access (intranet FullControl, admin Write, catalog Read).
  5. Approve the Administration package's user_impersonation request, then switch Setup Center to Automated mode and test the connection.
LimitsInstall cannot deploy packages, register hubs or create sites unless allowSiteCreation (needs Sites.FullControl.All). One changing job per site (IB1009). Plan/Test are read-only.
This article is about Brillienta Intranet Builder.See the productView plansBook a demo
Still need help?Our team answers product questions by email, and we can walk you through it on a call.
Open in the full guideContact support