Azure Static Web Apps settings

The backend API of a static site reads these. A write replaces the whole set, so a portal edit made at the same time is lost.

The connection

What	This provider
Vendor	Microsoft Azure
Key	`azure-static-web-apps-settings`
Availability	`available`. You can connect it today.
Credential penv holds	`azure-service-principal`
Values read back	yes
Activation	`immediate`

Direction	What it does
`import`	Reads names and values out of the store into penv.
`export`	Writes names and values from penv into the store.

immediate. The running app sees a new value at once.

Direction	Policies you can pick
`import`	`skip_existing`, `new_version`, `fail`
`export`	`create_only`, `overwrite`, `overwrite_and_prune`

How syncs work says what each one does.

You paste a credential you already hold. penv seals it and never shows it again.

Field	Label	Kind	Required
`tenantId`	Directory (tenant) ID	secret, masked here and sealed	yes
`clientId`	Application (client) ID	secret, masked here and sealed	yes
`clientSecret`	Client secret	secret, masked here and sealed	yes

Fixed when you connect, and shared by every mapping on it.

Field	Label	Kind	Required	Advanced	What it is
`subscriptionId`	Subscription ID	text	yes	no	The subscription the service principal has a role assignment on.
`resourceGroup`	Resource group	text	yes	no	The group the target resource sits in. One connection covers one group.

Answered once per environment you map.

Field	Label	Kind	Required	Advanced	What it is
`siteName`	Static site	text	yes	no	The site whose backend API reads these settings.
`environmentName`	Environment	text	no	yes	Leave empty for production. Azure copies these settings to staging too.

penv probes for these when it verifies the connection.

Permission	Directions	Blocking	Without it
`Microsoft.Web/staticSites/listAppSettings/action`	every direction	yes	Preview cannot read the site's settings.
`Microsoft.Web/staticSites/config/write`	`export`	yes	Export cannot write anything.
`Microsoft.Web/staticSites/Read`	every direction	no	Verify cannot confirm the credential reaches this resource group.