Azure App Service app settings

App Service and Functions read these as environment variables. A write replaces the whole set, so a portal edit made at the same time is lost.

Connection

What	This provider
Vendor	Microsoft Azure
Key	`azure-app-service-settings`
Availability	`available`. You can connect it today.
Credential we hold	`azure-service-principal`
Values read back	yes
Activation	`restart-on-write`

Direction	What it does
`import`	We read names and values out of the store into your environment.
`export`	We write names and values from your environment into the store.

restart-on-write. When we write a value, the workload restarts.

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.

Paste a credential from the vendor. We seal it and never show it again.

Field	Label	Kind	Required
`tenantId`	Directory (tenant) ID	secret; we mask it here and seal it	yes
`clientId`	Application (client) ID	secret; we mask it here and seal it	yes
`clientSecret`	Client secret	secret; we mask it here and seal it	yes

You set these when you connect. Every mapping on the connection shares them.

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.

You answer these once per environment you map.

Field	Label	Kind	Required	Advanced	What it is
`siteName`	App	text	yes	no	The app whose settings this environment maps onto. A function app is one of these too.
`slot`	Deployment slot	text	no	yes	Leave empty to write the production slot. A slot keeps its own settings.

We probe for these when we verify the connection.

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