Replace connection strings with identity-based connections
Azure Functions binding extensions soportan identity-based connections, las cuales usan la function app’s manage identity para autenticar, en vez de requerir una connection string guardada en application settings.
Este approach elimina secretos del trigger y binding configuration. En vez de guardar una full connection string que contiene account keys o shared access signatures, configuras el binding con una named connection, que incluye solo el service endpoint o account name.
El runtime se encarga de la auth de manera transparente usando la assigned managed identity.
Para preparar una identity-based connection, activa un system-assigned managed identity para la function app, entonces asignar los Azure rules necesarios para el target resource.
La function app autentica usando la identidad y no tenemos secret values que aparezcan en el app settings.
Esto es particularmente util para AI backends que conectan a multiples Azure services, ya que cada conexion adicional en la config expande el surface area para ataques.
El identity-based connection mas comun es el runtime own storage dependency. Podemos reemplazar el AzureWebJobsStorage tradicional connection string con identity-based settings, configurando el storage account name y asignando roles
AzureWebJobsStorage__accountName = mystorageaccount
El runtime autentica con la function app’s managed identity. El rol minimo requerido es Storage Blob Data Owner. Si tu app usa blob triggers, tambien necesitas Storage Queue Data Contributor y Storage Account Contributor ya que blob triggers internamente usan storage queues para blob receipts. Para Service Bus y CosmosDB, usar solo Storage Blob Data Owner es suficiente.
Usar identity-based connections for trigger y output bindings
Identity-based connection config difiere de connection string configs en la manera de hacer setup del named connection prefix. Cada binding’s connection property en function_app.py referencia un named prefix (ejemplo connection="ServiceBusConnection"). Con connection strings, creas una single app setting con el prefix name, que contiene el full connection string. Con identity-based connections, creas settings usando el prefijo con property suffixes que especifican el service endpoint.
Ejemplos:
Service Bus trigger with identity-based connection
Remplaza la Service Bus connection string, con el fully qualified namespace.
Asigna Azure Service Bus Data Receiver role a la function app’s managed identity en el Service Bus namespace. Para output bindings, asigna Azure Service Bus Data Sender role instead.
ServiceBusConnection__fullyQualifiedNamespace = mynamespace.servicebus.windows.net
# Code fragment - focus on Service Bus trigger with identity-based connection
@app.service_bus_queue_trigger(
arg_name="msg",
queue_name="document-jobs",
connection="ServiceBusConnection"
)
def process_document(msg: func.ServiceBusMessage) -> None:
job = json.loads(msg.get_body().decode("utf-8"))
# Process the document...
CosmosDB output binding with identity-based connection
Reemplaza la CosmosDB connection string, con el account endpoints.
Asigna el rol Csomos DB Built-in Data Contributor a la function app’s managed identity.
CosmosDBConnection__accountEndpoint = https://mycosmosaccount.documents.azure.com:443/
Cada binding extension documenta su supported identity properties y required roles. El suffix pattern difiere por servicio
- storage bindings usan
__acountNameo service-specific URIs - CosmosDB usa
__accountEndpoint - Messaging services usan
__fullyQualifiedNamespace
Autenticar SDK clients con managed identity
Para Azure services sin dedicated binding support, creamos SDK clients directamente en function code. Estos clients se autenticar usando la misma managed identity que sirve el trigger y las binding connections.
DefaultAzureCredential provee de credential chain para entornos locales y cloud.
Inicializamos ambos el credential objhect y el service client fuera del function handler, al nivel del modulo. Esto asegura que el objeto persista entre invocaciones en la misma instancia, evitando tener que crearlo cada vez.
# Code fragment - focus on module-level client initialization
import os
from azure.identity import DefaultAzureCredential
from azure.ai.documentintelligence import DocumentIntelligenceClient
from azure.search.documents import SearchClient
credential = DefaultAzureCredential()
doc_client = DocumentIntelligenceClient(
endpoint=os.environ["DOCUMENT_INTELLIGENCE_ENDPOINT"],
credential=credential
)
search_client = SearchClient(
endpoint=os.environ["SEARCH_ENDPOINT"],
index_name=os.environ["SEARCH_INDEX"],
credential=credential
)
Secure HTTP endpoints con authorization keys
Las Azure Functions usan access keys para restringir acceso a HTTP-triggered function endpoints. Esto es especifico para Azure Functions y opera independiente de Entra ID para auth.
IMPORTANTE
Access keys son una barrera basica para evitar invokers no autorizados, pero no comprueban la caller identity ni ofrecen fine-grained acess control.
Tipos de keys
- Function keys Scoped a una single function. Cada function puede tener multiples named keys. Se incluyen en el header
x-functions-keyo el query paramcode, al llamar a la funcion - Host keys Scoped a todas las funciones en la function app. Una single host key da acceso a todas las HTTP-triggered functions. Usarlas para administrative tools o monitorizacion
- System keys Usadas por extensiones especificas o para auth de ops internas. La MCP extension usa
mcp_extensionsystem key para autenticar MCP client connections a la function app. Son managed por el runtime y no se deben compartir - Master key Acceso administrativo y hace override de todas las otras keys. Nunca jamas compartirla en apps
Se establece el auth level por HTTP trigger usando auth_level en @app.route()
Recordamos:
anonymousno requiere key (health check endpoints o funciones que manejan la auth de manera separada)functionerquiere function-specific key o host key (baseline for PROD)adminrequiere master key (administrative ops)
# Code fragment - focus on authorization levels
@app.route(route="classify", methods=["POST"], auth_level=func.AuthLevel.FUNCTION)
def classify_document(req: func.HttpRequest) -> func.HttpResponse:
# This function requires a function key or host key to invoke
pass
@app.route(route="health", methods=["GET"], auth_level=func.AuthLevel.ANONYMOUS)
def health_check(req: func.HttpRequest) -> func.HttpResponse:
return func.HttpResponse("OK", status_code=200)
Las access keys son una barrea basica pero no reemplazan la auth para PROD AI endpoints. Para paps que requieran verificar al caller, juntarlo con Azure API Management o App Service Authentication (Easy Auth) on top of access keys.
- API Management añade rate limiting, request validation y OAuth 2.0 token verification
- Easy Auth integra Entra ID directamente en la function app
/IMPORTANTE