20 KiB
FEEDBACK — Audit backend Kazier
Date : 2026-09-21
Scope : backend/ (Go, Gin, Postgres, Paseto, Tesseract)
Mode : lecture seule, vérifié dans le code.
But : autre agent relit et complète ci-dessous (voir § À compléter).
Haute priorité
-
Route
GET /files/foldersmasquée —backend/handlers/router.go:29-32GET /files/:iddéclaré avantGET /files/folders. Gin peut capterfolderscommeid="folders"→ 404 au lieu de la liste. -
move_resourcesans check de cycle —backend/service/sync.go:204-219SeultoFolder == resourceIDrejeté. Déplacer un parent dans son enfant crée un cycle, casse les CTE récursives (depth<100). -
create_linknon-idempotent —backend/service/sync.go:337→backend/repository/shares.go(CreateLinkINSERT simple sur PKtoken) Rejeu mêmeoperation_id(crash entre apply etRecord) → violation PK classéeINVALID_REQUESTterminale, bloque tout l'outbox. PrévoirON CONFLICT DO NOTHINGcommeOperations.Record. -
AUTH_SECRETdéfaut faible —backend/config/config.go:49+backend/pkg/auth/auth.goDéfautdev-secret-change-me, justeSHA256, pas de check longueur/entropie → tokens paseto v4-local forgeables sur déploiements par défaut. -
Upload : extension non sanitisée —
backend/service/resources.go:148-154filepath.Ext(file.Filename)client tel quel →destPath = <user>/<id>.<ext>. Cas""→ fichierid., cas../../,/, très long → traversal / orphelins / ambiguïtéGlob(id.*)pour OCR. -
Orphelins + stale bytes au re-upload —
backend/service/resources.go:161-162+backend/service/ocr.goUpdatePhysicalne supprime pas l'ancien<id>.<oldExt>.Globprend le premier match → OCR sur bytes périmés + fuite disque. ÉchecGetFileaprèsInsertFileréussi laisse aussi le fichier. -
ApplyBatchnon-atomique —backend/service/sync.go:103-125Applied() → apply → Record()sans transaction. TOCTOU sur batches concurrents même(device_id,operation_id), replay après crash,Recorden 500 avecappliedinconnu. -
Fuite d'erreurs internes —
backend/handlers/store.go:20-33+backend/service/sync.go:87-98Défaut500 err.Error()/INVALID_REQUEST err.Error()expose SQL/FS/paths au client. -
Count()bloque le bootstrap —backend/repository/users.go+backend/service/bootstrap.goCompte les soft-deleted. Tous users supprimés → plus jamais de nouvel admin, lock définitif. Devrait filtrerWHERE deleted_at IS NULL. -
Migrations destructives / irréversibles
backend/db/migrations/000007_resources_user_ownership.up.sql:7faitDELETE FROM resourcesà l'upgrade (wipe prod).backend/db/migrations/000008_operation_uuid.down.sqlfaitoperation_id::bigint→ casse dès que des IDs 32-hex aveca-fexistent.
-
Stubs dangereux —
backend/service/services.go,move.go,upload.go,folders.goUserCan*toujourstrue, no-ops. Si jamais câblés = bypass auth total. À supprimer. -
Oracle
INVALID_DEVICE_IDau login —backend/handlers/auth.go:55-81Check device aprèsVerifyTimedEqual. Creds valides + device inconnu → 400 vs 401 → oracle + pas de rate-limit.
Priorité moyenne (phase 2)
DeviceIDlogin non validé^[0-9a-f]{32}$(backend/handlers/auth.go:50vsdevices.go:23),folderId/fileId/tokenjamais validés hex avant DB.POST /sync/opsnon borné (backend/handlers/sync.go) : pas deMaxBytesReader, pas de cap batch (client=20) → DoS OOM.ParentResourceID/ToFoldernon validés hex → mal classésNOT_FOUND.UpdateNameByID,TouchResourcenon scopés owner (reposent que sur l'appelant) — TOCTOU.Revoke/RevokeLink: erreurs swallow_ =→ masque vraies pannes (backend/service/sync.go:306-309,359-361).- OCR :
Createowner-only maisGetFileOcrviewer+,Getjob scopédevice_id→ 2e device du même user = 404. PDF ignorectx, pas de cap taille/pages, stderr (avec paths) exposé (backend/ocr/tesseract.go:47-66). passwd.Verifyparsem=du hash stocké sans cap → ligne DB compromise = OOM Argon2 au login (backend/pkg/passwd/passwd.go:74-88).POST /devicespublic sans rate-limit → remplissage table.MarkUserpermet à n'importe qui de claim n'importe queldevice_id(backend/repository/devices.go:36-42).getIntsans range check (PORT/WORKERS/MAX négatifs acceptés) (backend/config/config.go:64-70).ChangePasswordne révoque pas les tokens (fenêtre 7j) (backend/handlers/auth.go:113-151).expiresAtpassé accepté pour shares/links → grants instantanément expirés.Snapshot/ListOwnedLIMIT 10000sans pagination → troncation silencieuse (backend/repository/shares.go:199,resources.go:547).- Positif : pas d'injection SQL trouvée (tout en
$n,sortClausewhitelist).
Plan proposé
- P0 robustesse : ordre routes, cycle move, idempotence
CreateLink, transactionApplyBatch, secret requis en prod, sanitextension+ cleanup orphelins. - P1 data : fix
Count()soft-deleted, corriger migrations 000007/000008, supprimer stubs, mapper erreurs sans fuite. - P2 durcissement : validation hex systématique, cap
sync/ops, rate-limit login/devices, cap Argon2 + PDF/OCR, scopeTouch/UpdateName, pagination snapshot.
À compléter (pour le relecteur)
- Ajouter nouveaux bugs ci-dessous avec
fichier:ligne, sévérité, explication courte. - Ne pas supprimer les entrées existantes, juste append ou annoter.
- Idées à creuser :
handlers/files.go(intParam,qnon borné),service/resources.go:164(filename brut commename, mime verbatim),repository/resources.go(parent check puis UPDATE non-atomique → FK 500),cmd/server/main.go(double pool,connjamaisClose, worker OCR non attendu),pkg/auth(TTL 7j sans refresh/révocation).
Ajouts relecteur (2026-09-21, vérifié en lecture)
Nota : entrées existantes conservées. Ci-dessous uniquement des ajouts. Annotation §1 :
GET /files/foldersvsGET /files/:id— Gin privilégie les segments statiques sur:paramdans son arbre, donc l'ordre de déclaration (router.go:29-32) ne masque pas forcémentfoldersen pratique. Reste fragile (dépend du routeur) : à verrouiller par un testGET /files/folders → 200+GET /files/<32hex> → 200/404, pas par l'ordre.
A1 — CRITIQUE : bypass dummy-password + panic nil-deref au login
backend/pkg/passwd/passwd.go:37-43,98-103+backend/handlers/auth.go:55-83VerifyTimedEqual("", dummy)vérifie contreHash("kazier-constantime-dummy")en dur.username=<inconnu> + password="kazier-constantime-dummy"→Verifyretournenil→ suite du handler avecuser == nil→user.ID:83panic (Gin recovery → 500). Effets : DoS à la demande + oracle 500 vs 401 qui casse l'indistinguabilité revendiquée + préimage hardcodée en source. Fix : dummy aléatoire par boot (ou hash du mot fourni à sel fixe) + ne jamais toucherusersiuserErr != nil.
A2 — Upload : file.Size fait confiance au header, io.Copy illimité
backend/service/resources.go:135,178-195(service) vsbackend/handlers/files.go:119-133(handler)- Le handler protège le transport (
MaxBytesReader), mais l'invariant service est absent : header menteur → écriture disque illimitée. Enveloppersrcdansio.LimitReader+ re-contrôler les octets écrits.
A3 — Upload non-atomique, torn reads OCR
backend/service/resources.go:154-157,178-195os.Create(dest)+io.Copydirect, overwrite sur place pourtargetExisting.service/ocr.go(Glob) peut lire un fichier à moitié écrit. Fix : temp +Rename(+Fsync).
A4 — Fichiers world-readable
backend/service/resources.go:149-150:MkdirAll 0755,os.Create→ 0644 selon umask. Données user lisibles sur hôte partagé. Passer en0700/0600.- Positif vérifié : pas de traversal via
ownerID/resourceID(32-hex issus token/serveur),UPLOAD_DIR= config admin.
A5 — NewID() panic sur échec entropie
backend/repository/resources.go:23-29:panicsicrypto/randéchoue → crash serveur entier. Retourner(string,error).
A6 — ShareLinkGet compare avec == au lieu de errors.Is
backend/handlers/share_links.go:23(tous les autres handlers viawriteErrorutilisenterrors.Is) :ErrNotFoundwrappé → 500 au lieu de 404, sur endpoint public non-authentifié → oracle 500/404.
A7 — Incohérences contrat / parsing silencieux (mineurs mais réels)
backend/handlers/auth.go:94-96:ExpiresAt = Now()+TTLseconde lecture d'horloge, pas leexpdu token (dérive ms).backend/handlers/auth.go:90: codeTOKEN_ERRORnon-standard.backend/handlers/files.go:114-117,50-53: 32-hex malformé →404, vsbackend/handlers/devices.go:23-26→400 INVALID_DEVICE_ID.backend/handlers/files.go:13-22+backend/handlers/sync.go:43-47:intParaminvalide/négatif →fallbacksilencieux ;aftergarbage →0= full snapshot au lieu de 400.Atoi32-bit overflow pour epoch-ms.backend/handlers/middleware.go:29: préfixeBearercase-sensitive.
A8 — Sémantiques silencieuses outbox (désync grantees + fuite d'existence)
backend/service/sync.go:180-202:update_metadatacible absente →nilmarqué applied (client croit le rename fait) vs<editor→ErrNotFound(batch halté). Incohérent.backend/service/sync.go:204-222:move/deletesur ressource partagée non-owned → no-op silencieux marqué applied → client grantee désync.backend/service/sync.go:152-178:ExistsOwner(own seul) puisInsert; id d'autrui deviné → PK globale →23505 → ErrNameConflict(repository/resources.go:143-146) = oracle d'existence cross-user. + TOCTOUExists→Insert.
A9 — Replay à payload muté avalé
backend/service/sync.go:109-115+backend/repository/operations.go:44-50(ON CONFLICT DO NOTHING) : même(device,op)avec payload différent = skip « succès », nouvelle intention dropée sans comparaison de hash.
A10 — UpdatePassword / MarkDeleted sans garde
backend/repository/users.go:87-103: pas deAND deleted_at IS NULL, pas de checkRowsAffected→ re-hash d'un compte soft-deleted, succès silencieux sur id inconnu / course avecMarkDeleted.
A11 — OcrJobs : transitions sans garde
backend/repository/ocr_jobs.go:60-67,112-128:TouchProcessing,Complete/Failsans garde de statut niRowsAffected→queued→done,done→failed, double-complete silencieux.ResetStaleProcessing:100-110sur horloge app (skew DB), lignesprocessingàstarted_at NULLjamais requeued.ClaimNext:72-95correct atomiquement mais sans index composite(status,created_at)→ scan O(queue).
A12 — physicalPath via Glob sans vérification fichier
backend/service/ocr.go:142-153: symlink/répertoire/id.acceptés ; symlink horsUPLOAD_DIRsuivi par tesseract. FaireLstat + IsRegular + EvalSymlinks-containment.lang(ocr/tesseract.go:30, depuisOCR_LANG) non whitelisté (argv, pas de shell — worst case erreur tesseract).
A13 — OCR : causes avalées, done trompeur
backend/service/ocr.go:113-138:Fail("file not readable")sanserr,Complete/UpdateOcrTextpartiellement log-only → jobdonealors queocr_textnon persisté ;GET /files/:id/ocrrenvoie""200 indistinguable de « pas encore extrait ».backend/ocr/tesseract.go:29-45,47-67: pas de timeout par job (ctx = vie serveur), stdout/stderr non bornés → OOM, pages PDF en erreurcontinuesilencieusement → texte partiel vu comme complet, pas de cap taille/pages.
A14 — main.go : lifecycle / concurrence boot
backend/cmd/server/main.go:44-51,59:db.Open+MigrateDatabase(qui ouvre son propre pool) = double pool ;connjamaisClose; migrations DDL à chaque boot (rôle runtime devrait être DML-only en prod).backend/service/bootstrap.go:25-47: double réplica sur DB vide → duplicateusername_normalized→ un réplicaFatal, pas de retry.
A15 — Complément device/token (étend § moyenne existant)
- Vérifié :
pkg/auth/auth.go:54-67Verifyn'impose pas^[0-9a-f]{32}$;handlers/middleware.go:46-62vérifie que le user existe mais jamais le device (hex niExists) → tokens à device supprimé/jamais-enregistré passent l'auth, 500 plus tard (FK).repository/operations.go:36-51valideoperation_idmais pasdevice_id; payloads vides/"null"/invalides normalisés en{}(60-68) au lieu d'être rejetés → trace infidèle.
A16 — Idées à creuser : conclusions
handlers/files.go:q:TrimSpace+!= ""ok, mais pas de longueur maxi →ILIKE %…%géant = full scan (index trigram manquant,repository/resources.go:297,327).page/pageSizecappés à 200 côté handler, mais(page-1)*pageSizenon cappé + repo sans validation (repository/resources.go:170-227,LIMITnégatif → 500).service/resources.go:159,164: confirmé —file.Filenamebrut commename(sauts de ligne, 255+ chars, unicode) +Content-Typeverbatim comme mime, sans whitelist/normalisation.repository/resources.go:124-147,374-403: confirmé —folderExists(SELECT)puisINSERT/UPDATEnon-atomique → parent supprimé entre les deux = 500 FK ou orphelin.cmd/server/main.go: confirmé ci-dessus (A14) + worker OCR non attendu au shutdown (5s puis exit, jobsprocessing→ requeue au prochain boot viaResetStaleProcessing, ok mais à documenter).pkg/auth: TTL 7j sans refresh/révocation confirmé par design (auth.go:13,handlers/auth.go:110-112) ;iat=nbf=now,expvérifié viaNewParserForValidNow(auth.go:55) — correct, pas de bug ici au-delà du secret (A-suite § haute prio n°4) et du format non validé (A15).
Validation (2026-09-21, autre agent — suite verte)
go build ./... OK. go test ./... : 11 packages OK, 0 fail
(cmd/server, config, db, handlers, ocr, pkg/api, pkg/auth, pkg/passwd, repository, service). Les 4 échecs transitoires vus pendant l'édition
concurrente (RecordNormalizes, MarkDeleted, UploadSanitizes,
UpdateMetadata/Move) ne se reproduisent plus — tests alignés sur la
nouvelle sémantique.
Haute priorité : tout corrigé
- §1 route
folders: réordonnée avant:id+ tests d'ordre (durcissement, Gin préférait déjà le statique). - #2 cycle :
checkNoCycle(walkGetParentID≤128) +MoveResourceatomique. Manque : pas de test cycle dédié. - #3
CreateLink:ON CONFLICT DO NOTHING+ même ressource → no-op, sinonNAME_CONFLICT. Tests rejeu/conflit OK. - #4 secret : défaut allongé (≥32), refusé en prod (
APP_ENV/ENV),len<32rejeté. Reste : dev boot sur défaut public (assumé). - #5/#6/A2/A3/A4 upload : ext whitelistée,
LimitReaderoctets réels, temp+Rename+Fsync,0700/0600, cleanup stale/orphelins. Tests OK. - #7 batch :
Claim/MarkApplied+applied:i/INTERNALexplicites. Documenté non-transactionnel (vrai Tx reportée). - #8 fuites :
classifySyncErrorgénérique + log serveur. OK côté sync. - #9
Count:WHERE deleted_at IS NULL, bootstrap recrée l'admin. OK. - #10 migrations :
000007sansDELETE,000008 downsans::bigintcrash, +000011/12/13saines. Up/down OK. - #11 stubs :
folders/move/upload/move_testsupprimés, 0 réf. OK. - #12 oracle : device inconnu →
401identique + rate-limit 60/min/IP. OK. - A1 dummy : random 32B/boot + guard
user==nil → 401+ caps Argon2. OK.
Moyens : corrigé, 3 partiels assumés
- A6
errors.Is, A8 sémantiques (absent → no-op, étranger →NOT_FOUNDhalt), A9 rejeu (payload_hash000013 +ErrInvalidPayload), A10 users guards, A11 jobs gardés, A12 path containment + lang whitelist, A13 OCR (timeout 120s, 2MiB, 50 pages), A7/A16 contrat : tous OK. - Partiels :
EnforceDeviceExistsopt-in défautfalse(tokens à device inconnu passent toujours par défaut) ;NewID()panic conservé (migration appelants partielle) ; double poolmain.gosubsiste ;POST /devicessans rate-limit (TODO assumé). - Reste :
UpdateNameByID/TouchResourcenon scopés encore appelés (TouchOwned/UpdateNameOwnedajoutés, migration appelants reportée).
Risques résiduels à trancher
- Activer
EnforceDeviceExistspar défaut (casse tokens existants — planifier rotation). - Vrai Tx
ApplyBatch(fenêtre TOCTOU admise, couverte par idempotence). - Rate-limit
POST /devices+ test cycle dédié manquant.
Addendum validation v2 (autres tâches finalisées)
go build ./... OK, go test ./... vert (12 packages, dont
handlers 9.6s, repository 3.4s, service 9.9s).
Nouveautés depuis v1, toutes validées :
handlers/store.go:writeErrordéfaut →500 INTERNAL "internal error"générique +logserveur (plus deerr.Error()brut) — clôt #8 côté handlers.handlers/sync.go:POST /sync/opsborné (MaxBytesReader1 MiB, max 100 ops/batch → 400 explicite) +parseAfterMsstrict 64-bit (garbage/négatif → 400, fini le repli silencieux vers full snapshot) — clôt le gap « sync non borné ».repository/devices.go:MarkUser→ErrNotFoundsi 0 rows (fini le no-op silencieux sur device fantôme ; la courseExists→MarkUserest désormais distinguable). Résiduel mineur :handlers/auth.gomappe encore cette erreur vers 500 au lieu de 401.- Nouveaux tests :
handlers/ocr_test.go,handlers/sync_test.go,repository/devices_test.go— tous verts. Restent ouverts :EnforceDeviceExists=falsepar défaut, vrai TxApplyBatch, rate-limitPOST /devices, test cycle dédié.
Suite (2026-09-21, fin des restes — suite verte)
go build ./... OK, go vet ./... OK, go test ./... : 12 packages OK, 0 fail.
Nouveaux tests exécutés nominalement (-run ciblé) : TestApplyBatchMoveIntoDescendantRejected,
TestDevicesRegisterRateLimited, TestSyncOpsBatchTooLargeRejected,
TestDevicesMarkUserUnknownDevice, TestIssueWithExpiryMatchesTokenExp.
- #8 fuite
writeError: défaut500→ message générique"internal error"log.Printfserveur (handlers/store.go:20-33). Plus aucunerr.Error()brut vers le client (sync déjà générique,response.godéjà enveloppe).
- A7
ExpiresAt:pkg/auth.IssueWithExpiryretourne leexpembarqué ;AuthLoginl'expose tel quel (plus deNow()+TTLrecalculé).Issueconservée (délègue) → 0 appelant cassé. Test d'égalité à la seconde (le token sérialise sans monotonique/sous-seconde). MarkUser:RowsAffected == 0 → ErrNotFound(repository/devices.go:36-42) ; login mappe en 401 indistinguable (jamais de token pour device fantôme). Test repo ajouté.TouchOwnedmigré : les 4TouchResourcedes paths share/revoke/link →TouchOwned(ownerID, …)(tous précédés deExistsOwner).UpdateNameByIDconservé volontairement pourupdate_metadata(un editor non-owner peut renommer —UpdateNameOwnedrejetterait à tort ; garde d'accès juste avant l'écriture). CommentairesDeprecated/inter-lots mis à jour.- Test cycle :
TestApplyBatchMoveIntoDescendantRejected(parent→enfant →INVALID_REQUEST, parent toujours à la racine). Point 3 des risques soldé côté cycle. - Rate-limit
POST /devices: 300/min/IP → 429RATE_LIMITED+ hookOnDevicesRateLimited+ResetDevicesRateLimit(placé APRÈS validation : l'invalide ne consomme pas le budget). Resets ajoutés aux helpers de test (files_test.go setup,auth_test.go setTestAuth,ocr_test.go setupOcr— ce dernier manquait et faisait échouerTestOcrJobsScopedByOwneren 429, corrigé). Budget large assumé : anti-flood massif, WAF frontal en prod. - Cap
POST /sync/ops:MaxBytesReader1 MiB + max 100 ops/batch → 400INVALID_REQUEST(client = 20, test 25 ops existant compatible). TestTestSyncOpsBatchTooLargeRejected(101 ops → 400).
Reste assumé (inchangé, documenté)
EnforceDeviceExistsdéfautfalse;NewID()panic conservé (NewIDErrdispo) ; double poolmain.go(migrate-avant-open, un seul vivant) ; vraie TxApplyBatchreportée (idempotence couvre la fenêtre).