Respetar los límites del cliente

Puede obtener las raíces y leer las capacidades, pero el verdadero trabajo consiste en honoring respetarlas. Un servidor confiable se mantiene dentro de los límites que el host estableció para él. 🚧

Antes de tocar cualquier archivo, confirme que su ruta se encuentra within una de las raíces del cliente. Si no es así, rechace la operación en lugar de salir del área permitida.

Una ruta engañosa como ../../etc puede escapar de una raíz. Siempre resolve la ruta a una ruta absoluta y normalizada antes de compararla con las carpetas permitidas.

Compruebe que la ruta resuelta sea relative a una raíz. El helper de pathlib genera una excepción si la ruta escapa, lo que le proporciona una respuesta clara de sí o no sobre si debe continuar.

Si el cliente nunca declaró una capacidad, no la llame. Respetar los límites significa confiar en la negotiation, no intentar usar funciones que nunca se ofrecieron.

Cuando las raíces estén vacías o no sean compatibles, no haga suposiciones sobre el sistema de archivos. Narrow lo que hace su herramienta y explique al usuario el motivo, en lugar de acceder a rutas arbitrarias.

Las raíces establecen un límite exterior, pero usted puede ser más restrictivo. Solicite solo lo que la tarea realmente necesita, siguiendo el principio de least privilege, y no toque el resto.

El respeto va más allá de las rutas. Respete también el ritmo y los límites del host, para no saturarlo nunca con llamadas ni ignorar una cancellation solicitada por el usuario.

Cuando llegue una notificación roots list_changed, re-check las rutas almacenadas en caché. Una carpeta permitida hace un minuto puede estar ahora fuera del ámbito actual del usuario.

Si una solicitud apunta fuera de las raíces, devuelva un error claro que el modelo pueda leer. Una negativa cortés es mejor que hacer silenciosamente algo que el usuario nunca autorizó.

Los servidores que respetan los límites son los que los usuarios mantienen instalados. Un buen scoping convierte una herramienta potente en una herramienta segura a la que las personas están dispuestas a conceder acceso. 💛

Una solicitud apunta a una ruta que está fuera de todas las raíces declaradas. ¿Qué debería hacer su servidor?

Resuelve las rutas, confirma que se encuentren dentro de una root, omite las funciones no declaradas, degrada la funcionalidad con elegancia y rechaza el trabajo fuera del ámbito. Eso es lo que hace confiable a un servidor. ✅