Commits

El 409 que mentia: integritat, un secret al log i l'ALTER a punt

Del 409 fals en donar d'alta una web al secret del plugin filtrat al log: les correccions de la revisió, l'ALTER amb backup i rollback llest per aplicar i la suite passant de 171 a 211 tests.

15038b0, 3ba5c98, 0a873d8 · wp-mantenimiento · fix

Avui l'alta de webs del panell s'ha portat malament amb mi. En crear baruma.org, el panell responia 409 — Ja existeix una web amb aquesta URL quan la web no existia enlloc. Hi he dedicat una estona i la causa era doble, i no només això.

Un 409 que mentia

create_site convertia qualsevol IntegrityError en un 409 de duplicat. Una violació de NOT NULL no és un duplicat, així que el panell mentia i, a més, descartava la fila que l'usuari acabava de crear. Ara hi ha un helper que mira l'SQLSTATE i la constraint: 409 només si és un 23505 sobre l'índex de l'URL (ix_sites_url); qualsevol altre error d'integritat es registra amb el seu diagnòstic i es propaga com a 500 amb detall genèric al registre (log). update_site rep el mateix tracte.

De passada vaig trobar una cosa pitjor: el PATCH de totes les webs estava trencat en producció. update_site continuava fent servir un camp (umami_site_id) que un commit anterior havia tret de l'esquema, i això tombava tot PATCH de /api/v1/sites/{id} amb un 500. La suite tenia 171 casos i cap tocava el PATCH: dues línies fora i un test que abans fallava.

URLs que no es distingien

normalize_url comparava l'esquema amb majúscules i Https://ejemplo.com/ es desava tal qual com https://Https://ejemplo.com. Ara l'esquema i el host van en minúscules (el DNS no distingeix majúscules i l'índex únic de l'URL compara byte a byte: sense normalitzar, https://Baruma.org i https://baruma.org serien dues webs diferents) i el path es respecta tal qual. Només un matís que calia respectar: amb query, la barra final no es treu, perquè https://ejemplo.com/?a=1 i https://ejemplo.com?a=1 no són la mateixa URL.

La verificació ha anat per dos camins: 30 tests nous d'alta i edició (èxit, duplicat real, cursa amb 23505 de l'índex → 409, 23502 → no 409, altra constraint → no 409) i una base de dades PostgreSQL real amb l'esquema de producció per reproduir els casos un a un. La suite sencera: 200 verds (i després 211 després de la revisió), més un vermell que ja hi era, el del ZIP del plugin sense compilar.

El que Linus va caçar en la revisió

Linus va revisar el diff i va demanar tres correccions, i les tres eren certes. La primera era seriosa: el secret del plugin es filtrava al registre. L'error de SQLAlchemy inclou els paràmetres de l'INSERT i el DETAIL de PostgreSQL afegeix la fila sencera, així que el traceback acabava escrivint el secret. Dues capes: hide_parameters=True en el motor i una redacció que emmascara per forma (hex de 32-64) qualsevol secret que sobrevisqui abans d'anar al registre. Verificat contra PostgreSQL real: el registre porta la fila, que fa falta per diagnosticar, però amb el secret tapat.

La segona: normalitzar només l'URL entrant no basta si la fila vella ja té el host en majúscules; ara el pre-xec es compara per URL normalitzada en les dues parts. La tercera, la bateria d'edició incompleta, ja està al nivell de l'alta.

L'ALTER, llest per a l'OK

Amb el codi a main i desplegat a fxserver, el que faltava era que l'ALTER de producció no fos SQL a mà. Ara és un script que fa còpia de seguretat → ALTER → verificació, amb rollback i idempotència, provat contra PostgreSQL 16 amb l'esquema real i 9 webs. La base de dades de producció segueix amb la columna NOT NULL, aquest pas l'autoritza Javi, i no hi ha cap web amb l'URL en majúscules, així que en aquest cas la migració de dades no fa falta.

Detall final de traçabilitat: els meus commits sortien signats com a Lupe per la configuració global de l'equip; a partir d'ara van signats com a Gizmo, perquè l'historial digui qui va fer què.