All Insights

Multitenant software · Configuration management · Platform evaluation

How should shared configuration changes reach the right customers?

Define inheritance and local overrides, separate configuration selection from access control, and verify effective versions as changes propagate across tenants.

Define ownership and inheritance before implementation

Map the organizations the application serves and who may configure each one. Distinguish shared defaults, customer-specific values and locally delegated settings. For each setting, decide whether a local value overrides the default, remains pinned to an earlier version or must follow centrally managed changes.

Microsoft’s multitenant App Configuration guidance distinguishes shared and tenant-specific settings. It also explains that tenant prefixes and labels select configuration while access permissions operate at the store level. A naming convention alone therefore leaves the application’s authorization responsibilities unresolved.

Write a small set of expected outcomes for a shared change. Include a customer using the default, one with an override and one intentionally awaiting an update. Make conflicting settings an explicit product decision rather than leaving precedence to whichever value happens to load last.

Verify the effective configuration in each application

The Microsoft guidance notes that separately loaded tenant settings need separate caches and explicit refresh behavior. Inspect the configuration a running customer session actually uses. A successful update to central storage leaves a further question about when each application instance adopts it.

Show an effective configuration version and the origin of consequential settings to authorized operators. Exercise a tenant switch, a changed group membership and a delegated administrator’s update. Verify both the intended change and the neighboring customer settings that should remain unaffected.

Test the application’s supported administrative interfaces as well as its screens. Include new-customer provisioning, bulk changes, incomplete updates and removal of a local override. Keep access-boundary testing under the responsible security team; successful configuration propagation does not establish tenant isolation.

Roll out and reverse a complete configuration version

Azure App Configuration snapshots preserve selected key-values as an immutable set and support controlled rollout and rollback to an earlier configuration. This offers a useful versioning mechanism, provided the selected contents match the intended customer group and the application loads them correctly.

Rehearse a change with a small representative group, including customers with overrides. Compare the effective settings and resulting behavior before expanding. Then test rollback: confirm the earlier version is selected, caches refresh as intended and unresolved work created during the change remains visible.

Record the version each customer is meant to use and investigate divergence from that plan. Give exceptions an owner and a review date. This makes staged rollout, deliberate variation and accidental drift distinguishable when many customers share the same product.