Docs
Reference

Azure Container Apps

Secrets on a container app. A write replaces the whole set, so a concurrent portal edit is lost. A revision holds its old value until you restart or redeploy, and a referenced secret is never pruned.

Secrets on a container app. A write replaces the whole set, so a concurrent portal edit is lost. A revision holds its old value until you restart or redeploy, and a referenced secret is never pruned.

The connection

WhatThis provider
VendorMicrosoft Azure
Keyazure-container-apps-secrets
Availabilityavailable. You can connect it today.
Credential penv holdsazure-service-principal
Values read backyes
Activationon-next-deploy

What it moves

DirectionWhat it does
importReads names and values out of the store into penv.
exportWrites names and values from penv into the store.

When a written value goes live

on-next-deploy. A new value waits there and arrives with your next deploy.

What happens to a name that exists

DirectionPolicies you can pick
importskip_existing, new_version, fail
exportcreate_only, overwrite, overwrite_and_prune

How syncs work says what each one does.

How you connect

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

FieldLabelKindRequiredWhat it is
tenantIdDirectory (tenant) IDsecret, masked here and sealedyes
clientIdApplication (client) IDsecret, masked here and sealedyes
clientSecretClient secretsecret, masked here and sealedyes

What the connection asks for

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

FieldLabelKindRequiredAdvancedWhat it is
subscriptionIdSubscription IDtextyesnoThe subscription the service principal has a role assignment on.
resourceGroupResource grouptextyesnoThe group the target resource sits in. One connection covers one group.

What a mapping asks for

Answered once per environment you map.

FieldLabelKindRequiredAdvancedWhat it is
containerAppNameContainer apptextyesnoThe container app whose secrets this environment maps onto.

Permissions it needs

penv probes for these when it verifies the connection.

PermissionDirectionsBlockingWithout it
Microsoft.App/containerApps/listSecrets/actionevery directionyesPreview cannot read the app's secrets.
Microsoft.App/containerApps/writeexportyesExport cannot write anything.
Microsoft.App/containerApps/readevery directionnoVerify cannot confirm the credential reaches this resource group.