Una conexión requiere de:
- host (server FQDN
<server-name>.postgres.database.azure.com) - puerto (
5432conexiones directas;6432PgBouncer) - database name
- username (
username@servernamepara Entra auth) - pwd (static o Entra token)
Auth methods
Azure Database for PostgreSQL soporta dos tipos de autenticación:
- Microsoft Entra (OAuth 2.0 tokens)
- PostgreSQL native auth (user & pwd)
Microsoft Entra
Para conectar las Entra identities necesitamos obtener un token de https://ossrdbms-aad.database.windows.net
El proceso es:
- La app pide un token de Entra ID
- Entra valida la identidad y devuelve un token
- La app se conecta a PostgreSQL usando el token como pwd
- PostgreSQL valida el token contra el Entra administrator configurado
en python se usa azure-identity library para obtener tokens. DefaultAzureCredential prueba automáticamente multiples auth methods en orden (Entra ID, Azure CLI credentials, etc)
from azure.identity import DefaultAzureCredential
credential = DefaultAzureCredential()
token = credential.get_token("https://ossrdbms-aad.database.windows.net/.default")
# Use token.token as the password in your connection string
TLS/SSL config
PostgreSQL clients usa sslmode param para controlar la encriptación y validar certificados. Tiene los siguientes modos:
- disable: Azure rechaza conexiones con este modo
- allow: Encripta si el server lo requiere, pero no valida certificados
- prefer: Encripta si el server lo soporta, pero no valida certificados
- require: Fuerza la encriptación, pero no valida certificados
- verify-ca: Fuerza la encriptación y valida el server certificate
- verify-full: Fuerza la encriptación, valida el ser certificate, y confirma que el certificate hostname hace match con el server
Para PROD usar
verify-fullpara verificar que el server es genuino y real
Connection pooling con PgBouncer
PgBouncer solo está disponible para General Purpose y Memory optimized compute tiers. PgBouncer usa el puerto 6432
PgBouncer es una herramienta con un pool de conexión que reduce el overhead de crear conexiones constantemente, manteniendo una pool de conexiones reusables a través de las cuales enruta a los clientes. Esto reduce el overhead para apps que usan short-lived connections
activar pgBouncer
az postgres flexible-server parameter set \
--resource-group myResourceGroup \
--server-name myserver \
--name pgbounder.enabled \
--value true
tras activarlo, debemos usar el puerto 6432
postgresql://user@myserver.postgres.database.azure.com:6432/mydb?sslmode=require
Network access considerations
IMPORTANTE
Azure Database for PostgreSQL soporta dos modelos de networking:
- public access (firewall rules): el server tiene una IP pública y las firewall rules controlan que clientes se pueden conectar
- private access (VNet integration): el server solo tiene una IP privada dentro de una red virtual de Azure. Solo te puedes conectar desde recursos dentreo de la misma red, peered networks, o a través de VPN/ExpressRoute. Se usa para PROD envs.
/IMPORTANTE
Connection string examples
# Basic connection with SSL required
postgresql://myuser:mypassword@myserver.postgres.database.azure.com/mydb?sslmode=require
# Connection with certificate verification
postgresql://myuser:mypassword@myserver.postgres.database.azure.com/mydb?sslmode=verify-full&sslrootcert=/etc/ssl/certs/ca-certificates.crt
# Connection through PgBouncer (note port 6432)
postgresql://myuser:mypassword@myserver.postgres.database.azure.com:6432/mydb?sslmode=require