Connect to PostgreSQL

Una conexión requiere de:

  • host (server FQDN <server-name>.postgres.database.azure.com)
  • puerto (5432 conexiones directas; 6432 PgBouncer)
  • database name
  • username (username@servername para 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-full para 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