El esquema como superficie expuesta

Una API de rutas se inventaría recorriendo rutas: cada una tiene su método, sus parámetros y su respuesta, y el control de acceso se suele colgar de la ruta. Con GraphQL eso se mueve de sitio. El cliente envía su petición siempre a la misma dirección y describe dentro qué campos quiere; el servidor arma la respuesta recorriendo el esquema campo por campo. Quien audita ya no tiene una lista de rutas que revisar: tiene un grafo de tipos y relaciones.

Eso cambia tres cosas de la revisión. La primera, que el inventario de la superficie es el esquema, no la documentación ni las pantallas. La segunda, que un campo existe aunque ninguna pantalla lo pida: basta con que el esquema lo declare para que se pueda pedir. Y la tercera, que las comprobaciones de quién puede ver qué tienen que vivir donde se resuelve cada campo, porque no hay una ruta de la que colgarlas.

Abre el laboratorio. En esquema.graphql está lo que el servidor sabe resolver; en inventario-campos.txt, la clasificación que hizo el equipo de datos y la pantalla donde se muestra cada campo. Busca en el tipo que describe a una persona el campo clasificado como personal al que no le corresponde ninguna pantalla.

Las consultas raíz son las puertas por las que se entra al grafo, y conviene leerlas de una en una preguntándose a quién describen sus argumentos. Hay dos que devuelven el mismo tipo de datos personales: una no recibe argumentos y la otra sí. Mira cuál de las dos deja elegir de quién son los datos.

El portal de desarrolladores de Carretel lo mantiene a mano el equipo de alianzas; el esquema lo genera una herramienta a partir de los modelos de datos. Cuando dos inventarios se mantienen por caminos distintos, acaban diciendo cosas distintas, y el que manda es el que el servidor obedece. Cruza documentacion-publica.txt con las mutaciones del esquema.

El equipo pregunta por dónde empezar. Hay tres respuestas posibles y solo una ataca la causa de que aparezcan campos que nadie decidió exponer: que el esquema se genere solo, a partir de los modelos de datos, sin que nadie decida qué sale y qué no. Mientras eso siga así, cada columna nueva en la base de datos es un campo nuevo en la API.