Definir una URI bien conocida: 5 reglas para no romper la web

Mark Nottingham, uno de los arquitectos del HTTP moderno, publicó una guía práctica para quienes quieren definir una URI "bien conocida" (well-known URI). El problema: cada vez más servicios abusan de este espacio sin considerar las consecuencias.

Por qué importa

Las URIs bien conocidas (bajo /.well-known/) son un estándar para que cualquier cliente descubra metadatos de un dominio: políticas de seguridad, claves públicas, etc. Pero si cada empresa define su propia ruta sin coordinación, se genera caos. Nottingham recuerda que el espacio es finito y que una mala definición puede afectar la interoperabilidad global.

Qué dice el contexto

• Nottingham propone 5 requisitos clave: 1) necesidad real (no solo conveniencia), 2) especificación pública, 3) registro en IANA, 4) compatibilidad con servidores existentes, 5) documentación de seguridad.
• El artículo surge de años de ver implementaciones defectuosas que rompen proxies, cortafuegos o clientes antiguos.
• Ejemplo concreto: Apple usó /.well-known/apple-app-site-association sin registro formal, causando conflictos con otros servicios.
• La guía enfatiza que una URI bien conocida no debe depender de una versión específica del protocolo subyacente.
• Nottingham advierte que definir una URI para un solo proveedor (vendor lock-in) va contra el espíritu de la web abierta.

Lo que puedes hacer

1. Antes de definir una URI, pregúntate si ya existe una estándar. Revisa el registro IANA de well-known URIs.