Manage secrets and configurations (Azure Functions)

Use application settings for configuration

Los application settings son pares clave-valor que se configuran a través de:

  • Azure portal
  • Azure CLI
  • infrastructure-as-code

El runtime de las Azure Functions exponen estas settings a tu funcion como environment variables.

Azure encripta application settings at rest y lo desencripta solo cuando se inyecta en la app’s process memory, para que no se guarden en plaintext en el disco.

En python se accede a las app settings usando

  • os.environ para required settings
  • os.getenv para settings con fallback defaults

Este patron ayuda a mantener las functions environment-agnostic, ya que el mismo codigo lee config de local.settings.json en development y de las app settings en PROD.

# Code fragment - focus on reading application settings
import os

ai_endpoint = os.environ["AI_SERVICE_ENDPOINT"]
model_id = os.environ["MODEL_ID"]
confidence_threshold = float(os.getenv("CONFIDENCE_THRESHOLD", "0.85"))
max_batch_size = int(os.getenv("MAX_BATCH_SIZE", "10"))

Ignorar siempre local.settings.json del .gitignore

Reference secrets de Azure Key Vault

Las referencias a Key Vault permiten guardar valores sensibles directamente en Azure Key Vault y referenciarlos desde las app settings.

El runtime resuelve la referencia en app startup time, obtiene el secreto de la key vault y lo inyecta como environment variable, por lo que es transparente para la app.

Reference syntaxes

URI syntax - points to specific secret version (or latest)

@Microsoft.KeyVault(SecretUri=https://myvault.vault.azure.net/secrets/AiServiceKey/)

Named syntax - uses vault name and secret name

@Microsoft.KeyVault(VaultName=myvault;SecretName=AiServiceKey)

Ambos tipos requieren que la Function App tenga una managed identity (system-assigned o user-assigned) con el rol Key Vault Secrets User en el target vault. Sin este rol, el runtime no puede obtener el secreto para la app.

Las Key Vault references se resuelven en app startup time. Al cambiar un secreto la nueva versión se usa dentro de las primeras 24 horas. Cualqueir cambio a la configuración de la app causa inmediatamente un refetch de los secretos.

Para AI backends que usen rotacion la recomendacion es usar versionless URIs para que el runtime pille la rotación automáticamente.

Los beneficioes de usar Key Vault son seguridad, centralizacion de secret management a través de multiple Function Apps y services, audir logging, separate secret ownership from app deployment. Un equipo de seguridad puede hacer management y rotar secretos sin tener que acceder a la config de la aplicacion.

Integrate with Azure App Configuration

IMPORTANTE

Azure App Configuration provee un store centralizado para non-secret configuration values y feature flags.

  • Application settings funciona bien para individual function apps.
  • App Configuration es util cuando multiples function apps o micros comparten valores comunes de config, como model endpoint URLs o feature toggles. Cambiar un setting una unica vez en App Configuration propaga este cambio a todas las apps conectadas.

/IMPORTANTE

En python se conecta a App Configuration usando una libreria a través de azure-appconfiguration-provider. Esto carga los config values en memoria y los pone disponibles para que la app los lea.

Soporta label-based filtering. Te permite cargar diferentes sets de valores para diferentes entornos.

# Code fragment - focus on loading configuration from App Configuration
from azure.appconfiguration.provider import load
from azure.identity import DefaultAzureCredential
import os

config = load(
    endpoint=os.environ["APP_CONFIG_ENDPOINT"],
    credential=DefaultAzureCredential(),
    selects=[{"key_filter": "AIBackend/*"}]
)

model_endpoint = config["AIBackend/ModelEndpoint"]
inference_timeout = int(config["AIBackend/InferenceTimeout"])

Una arquitectura comun es combinar App Configuration para nonsecret-values y Key Vault para secretos.

App Configuration soporta Key Vault references. Esto crea una configuration surface unificada para poder obtener todos los valores a través del mismo proveedor

Handle configuration in the local development workflow

Para desarrollo local necesitamos reproducir la misma config structure que corre en Azure, pero apuntando a local services y emuladores en vez de cloud resources.

El local.settings.json file hace mirror de las settings que ofrece el Azure portal.

Puedes hacer pull de current app settings de una deployed function app, a tu config local, usando Azure Functions Core Tools command. Este comando descarga todos los settings y los escribe a local.settings.json, lo cual es util para replicar PROD de manera rapida.

func azure functionapp fetch-app-settings <function-app-name>

Ya que este local.settings.json puede contener conn strings sensibles, podemos encriptar el fichero con Core Tools para proteger los secretos at rest en tu maquina. El local Functions runtime puede leer los valores, pero estos no son visibles si abres el fichero.

func settings encrypt

Para el dia a dia apuntar AzureWebJobsStorage a UseDevelopmentStorage=true para usar Azurite.