@puca/puca-core 14.11.1 → 14.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (32) hide show
  1. package/dist/core/services/crud-base.controller.d.ts +2 -1
  2. package/dist/core/services/crud-base.controller.js +16 -0
  3. package/dist/core/services/crud-base.controller.js.map +1 -1
  4. package/dist/core/services/install.service.js +25 -0
  5. package/dist/core/services/install.service.js.map +1 -1
  6. package/dist/core/services/report.service.d.ts +8 -0
  7. package/dist/core/services/report.service.js +81 -16
  8. package/dist/core/services/report.service.js.map +1 -1
  9. package/dist/core/services/table-permission.service.js +3 -1
  10. package/dist/core/services/table-permission.service.js.map +1 -1
  11. package/dist/models/crud-controller-especification-environment.d.ts +4 -1
  12. package/dist/models/crud-controller-especification.d.ts +4 -0
  13. package/dist/models/crud-controller-especification.js.map +1 -1
  14. package/dist/models/table-dictionary.d.ts +6 -0
  15. package/dist/orm/services/sql/column-security.helper.d.ts +22 -0
  16. package/dist/orm/services/sql/column-security.helper.js +108 -0
  17. package/dist/orm/services/sql/column-security.helper.js.map +1 -0
  18. package/dist/orm/services/sql/sql-security-layer.service.d.ts +4 -0
  19. package/dist/orm/services/sql/sql-security-layer.service.js +137 -9
  20. package/dist/orm/services/sql/sql-security-layer.service.js.map +1 -1
  21. package/dist/orm/services/sql/table-permission.helper.d.ts +2 -0
  22. package/dist/orm/services/sql/table-permission.helper.js +113 -1
  23. package/dist/orm/services/sql/table-permission.helper.js.map +1 -1
  24. package/dist/tsconfig.tsbuildinfo +1 -1
  25. package/docs/column-level-security/column-level-security-analysis.md +156 -0
  26. package/docs/column-level-security/column-level-security-by-rule-analysis.md +201 -0
  27. package/docs/column-level-security/dictionary-admin-permission-plan.md +164 -0
  28. package/docs/column-level-security/pending-flow-runtime-function-columns.md +39 -0
  29. package/docs/column-level-security/pending-javascript-source-columns.md +19 -0
  30. package/docs/column-level-security/puca-flow-dictionary-admin-exception-plan.md +164 -0
  31. package/package.json +1 -1
  32. package/sqli-pesquisa-consolidada.md +368 -0
@@ -0,0 +1,164 @@
1
+ # Plano: exceção de dicionário no puca-flow (admin do flow)
2
+
3
+ **Status:** plano (não implementado)
4
+ **Data:** 2026-07-27
5
+ **Escopo:** `puca-flow` (api + front) + contrato com `puca-crud-api`
6
+ **Depende de:** [dictionary-admin-permission-plan.md](./dictionary-admin-permission-plan.md)
7
+
8
+ ## Veredito
9
+
10
+ Com `dictionary-admin` no backend do crud, o fluxo atual de personalização de formulário do card (`PucaFormLayoutCustomization` → `POST/DELETE /puca-crud-api/field_dictionary*`) **quebra** para admin do flow que **não** tem `dictionary-admin`.
11
+
12
+ Solução: o **puca-flow** passa a mediar a escrita de dicionário **somente** para tabelas do próprio flow, após `userIsAdmin`, sem exigir `dictionary-admin`.
13
+
14
+ ---
15
+
16
+ ## Contexto atual
17
+
18
+ ### Como o flow edita dicionário hoje
19
+
20
+ - UI: `PucaFormLayoutCustomization.vue` (aberta a partir do card / kanban para admin).
21
+ - Chamadas **diretas** ao crud, com o token do usuário:
22
+ - `POST /puca-crud-api/field_dictionary`
23
+ - `POST /puca-crud-api/field_dictionary/edit/:table/:field`
24
+ - `DELETE /puca-crud-api/field_dictionary/:table/:field`
25
+ - `connection-entity/*` (referências)
26
+ - eventualmente layout / table-headers
27
+ - Admin do flow: `FlowService.userIsAdmin` via multiselect `flow_admin_rules` (interseção com `user.rules`).
28
+ - Setup interno já eleva com `puca-user` + `disablePermissionSystem` (ex.: create view + table-headers no generate de view do flow).
29
+
30
+ ### Por que precisa de exceção
31
+
32
+ `dictionary-admin` é permissão **global** de estrutura. Admin de um flow precisa só alterar o schema da **entidade daquele flow** (`user_flow_*` / `user_view_flow_*`), não de todo o tenant.
33
+
34
+ ---
35
+
36
+ ## Objetivo
37
+
38
+ 1. Admin do flow continua podendo criar/editar/remover campos (e conexões) da tabela/view do flow **sem** `dictionary-admin`.
39
+ 2. Sem ser admin do flow **e** sem `dictionary-admin` → negado.
40
+ 3. Escopo estrito: só entidades ligadas ao `flowPid` informado (não qualquer `user_*`).
41
+ 4. Não reabrir bypass global no `puca-crud` (não aceitar “sou admin de algum flow” no crud sem validação no flow).
42
+
43
+ ---
44
+
45
+ ## Estratégia recomendada
46
+
47
+ ### Opção A (preferida): endpoints no `puca-flow-api` que fazem proxy elevado
48
+
49
+ Novos endpoints sob algo como:
50
+
51
+ ```
52
+ POST /puca-flow-api/flow/:flowPid/dictionary/fields
53
+ POST /puca-flow-api/flow/:flowPid/dictionary/fields/:fieldName/edit
54
+ DELETE /puca-flow-api/flow/:flowPid/dictionary/fields/:fieldName
55
+ POST /puca-flow-api/flow/:flowPid/dictionary/connection-entity/...
56
+ POST /puca-flow-api/flow/:flowPid/dictionary/table-headers (se necessário)
57
+ POST /puca-flow-api/flow/:flowPid/dictionary/editor/layout (se necessário)
58
+ ```
59
+
60
+ Fluxo de cada write:
61
+
62
+ ```mermaid
63
+ sequenceDiagram
64
+ participant UI as PucaFormLayoutCustomization
65
+ participant Flow as puca-flow-api
66
+ participant Crud as puca-crud-api
67
+
68
+ UI->>Flow: write dictionary (token user + flowPid)
69
+ Flow->>Flow: userIsAdmin(flowPid, user)
70
+ Flow->>Flow: resolve entityName do flow e assert body.entity === entity
71
+ Flow->>Crud: call interno (puca-user ou device=internal + disablePermissionSystem)
72
+ Crud-->>Flow: ok
73
+ Flow-->>UI: ok
74
+ ```
75
+
76
+ ### Opção B (alternativa): query/header no crud com callback ao flow
77
+
78
+ `puca-crud` aceitaria `?flowPid=` e chamaria o flow para validar admin. Acoplamento circular e mais frágil — **evitar**.
79
+
80
+ ### Por que A
81
+
82
+ - Validação de admin fica onde já existe (`userIsAdmin`).
83
+ - Crud continua com gate único `dictionary-admin` para tráfego “de usuário”.
84
+ - Elevação só em path interno já usado pelo flow (mesmo padrão do generate de view).
85
+
86
+ ---
87
+
88
+ ## Regras de escopo (obrigatórias)
89
+
90
+ Antes de elevar a chamada:
91
+
92
+ 1. `await flowService.userIsAdmin({ flow: flowPid, user })` — senão 403.
93
+ 2. Resolver a entidade permitida a partir do flow (ex.: `flow.table_name` / `flow.view_name` / convenção `user_flow_*` + `user_view_flow_*` já usada no serviço).
94
+ 3. Payload deve referenciar **apenas** essa entidade:
95
+ - `field_dictionary.entity` / `tableName` path param
96
+ - `connection-entity.sourceTable` / `targetTable` (pelo menos o lado “dono” do flow)
97
+ 4. Rejeitar nomes fora do prefixo do flow (ex.: não permitir `user_cliente` só porque é `user_*`).
98
+ 5. **Não** permitir alterar `rules` / `use_access_control*` de tabelas que não sejam do flow; e mesmo no flow, preferir só campos/layout, não ACL global — se table-headers for exposto, limitar campos permitidos (label, edit_field, layout; não ACL de módulo).
99
+
100
+ ---
101
+
102
+ ## Mudanças no front (`puca-flow`)
103
+
104
+ Em `PucaFormLayoutCustomization.vue` (e qualquer outro caller):
105
+
106
+ - Trocar URLs `/puca-crud-api/field_dictionary...` e `connection-entity...` por `/puca-flow-api/flow/${flowPid}/dictionary/...`.
107
+ - Garantir `flowPid` sempre disponível (já é prop no componente / contexto do card).
108
+ - Manter UI de admin (`isAdmin`) como está; o backend do flow é a fonte da verdade.
109
+
110
+ Opcional: se o usuário tiver `dictionary-admin`, o Dictionary global do crud continua independente; o flow não precisa saber disso.
111
+
112
+ ---
113
+
114
+ ## Mudanças na API (`puca-flow`)
115
+
116
+ 1. Controller fino + service que:
117
+ - valida admin
118
+ - valida escopo da entidade
119
+ - chama `comunicationService` / HTTP interno para `puca-crud-api` com `puca-user` (ou device internal), **repassando o body sanitizado**
120
+ 2. Reusar DTOs já existentes do crud (mesmo shape de field / edit / connection) para minimizar front churn.
121
+ 3. Logs: registrar `flowPid`, `user`, `entity`, operação (auditoria de schema).
122
+
123
+ ---
124
+
125
+ ## Contrato com `dictionary-admin`
126
+
127
+ | Ator | Pode escrever dicionário global (`Dictionary.vue`, qualquer `user_*`) | Pode escrever dicionário do **seu** flow |
128
+ | --- | --- | --- |
129
+ | Sem `dictionary-admin`, não admin do flow | Não | Não |
130
+ | Admin do flow, sem `dictionary-admin` | Não | **Sim** (só entidade do flow, via flow-api) |
131
+ | Com `dictionary-admin` | Sim (via crud) | Sim (via crud ou flow) |
132
+ | `puca-user` / internal | Sim (paths internos) | Sim |
133
+
134
+ Ordem de rollout: **implementar `dictionary-admin` no crud + endpoints de exceção no flow na mesma release** (ou feature-flag no assert até o proxy do flow estar live).
135
+
136
+ ---
137
+
138
+ ## Test plan
139
+
140
+ - [ ] Admin do flow **sem** `dictionary-admin`: cria/edita/remove campo na entidade do flow via UI de layout → sucesso.
141
+ - [ ] Mesmo user: tenta `POST /puca-crud-api/field_dictionary` direto → negado.
142
+ - [ ] Mesmo user: chama flow-api com `entity` de **outra** tabela → 403.
143
+ - [ ] Não-admin do flow, sem `dictionary-admin`: flow-api → 403.
144
+ - [ ] User com `dictionary-admin`: Dictionary global continua funcionando.
145
+ - [ ] Generate/setup de view do flow (já com `puca-user`) não regride.
146
+
147
+ ---
148
+
149
+ ## Ordem de implementação sugerida
150
+
151
+ 1. Definir mapa `flowPid → entityName(s)` no `FlowService` (single source).
152
+ 2. Endpoints proxy no flow + testes de escopo/admin.
153
+ 3. Trocar front `PucaFormLayoutCustomization` para o proxy.
154
+ 4. Ativar `assertDictionaryAdmin` no crud (plano irmão).
155
+ 5. Feature-flag / checklist de release conjunta.
156
+
157
+ ---
158
+
159
+ ## Riscos
160
+
161
+ - Esquecer algum caller direto ao crud no front do flow (grep `puca-crud-api/field_dictionary` e `connection-entity`).
162
+ - View mesclada (`user_view_flow_*`) vs tabela física: validar ambos os nomes permitidos por flow.
163
+ - Elevação com `puca-user` é poderosa: o assert de escopo **antes** do proxy é crítico.
164
+ - Concorrência com `dictionary-admin`: documentar que admin de flow ≠ admin de dicionário global.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@puca/puca-core",
3
- "version": "14.11.1",
3
+ "version": "14.12.0",
4
4
  "description": "",
5
5
  "author": "Raphael Aguiar",
6
6
  "license": "UNLICENSED",
@@ -0,0 +1,368 @@
1
+ # Pesquisa Consolidada: SQL Injection
2
+
3
+ ## Escopo da pesquisa
4
+
5
+ - Banco prioritario: PostgreSQL
6
+ - Ecossistema prioritario: Node.js/TypeScript
7
+ - Profundidade: ofensiva orientada a testes automatizados
8
+ - Foco: tecnicas de leitura indevida, escrita indevida e bypass de controles de acesso
9
+
10
+ ## Fontes principais usadas
11
+
12
+ - OWASP SQL Injection Prevention Cheat Sheet
13
+ https://cheatsheetseries.owasp.org/cheatsheets/SQL_Injection_Prevention_Cheat_Sheet
14
+ - OWASP WSTG - Testing for SQL Injection
15
+ https://owasp.org/www-project-web-security-testing-guide/stable/4-Web_Application_Security_Testing/07-Input_Validation_Testing/05-Testing_for_SQL_Injection
16
+ - PortSwigger SQL Injection Cheat Sheet
17
+ https://portswigger.net/web-security/sql-injection/cheat-sheet
18
+ - PortSwigger SQLi UNION attacks
19
+ https://portswigger.net/web-security/sql-injection/union-attacks
20
+ - PortSwigger Blind SQLi
21
+ https://portswigger.net/web-security/sql-injection/blind
22
+ - PortSwigger Second-order SQLi
23
+ https://portswigger.net/kb/issues/00100210_sql-injection-second-order
24
+ - PostgreSQL lexical syntax/comments
25
+ https://www.postgresql.org/docs/18/sql-syntax-lexical.html
26
+ - node-postgres queries/parameterization
27
+ https://node-postgres.com/features/queries
28
+
29
+ ## Taxonomia de tecnicas de SQL Injection
30
+
31
+ ### 1) Tautology/Auth bypass
32
+
33
+ **Descricao**
34
+ Ataque que fecha o contexto de string e injeta condicao sempre verdadeira.
35
+
36
+ **Vetores tipicos**
37
+ - Campo de login (email/username/password)
38
+ - Query string em filtros de listagem
39
+
40
+ **Pre-condicoes**
41
+ - Concatenacao de entrada do usuario no SQL
42
+ - Falta de bind de parametros
43
+
44
+ **Leitura indevida**
45
+ - Retorna registros de outros usuarios
46
+ - Pode autenticar como usuario indevido
47
+
48
+ **Escrita indevida**
49
+ - Acesso indevido a endpoints de alteracao/exclusao
50
+
51
+ **Payloads exemplo (PostgreSQL)**
52
+ - `' OR '1'='1'--`
53
+ - `admin' OR 1=1 --`
54
+
55
+ **Sinal para teste automatizado**
56
+ - Endpoint que deveria responder 401/403 passa a responder 200
57
+
58
+ ---
59
+
60
+ ### 2) UNION-based SQLi (in-band)
61
+
62
+ **Descricao**
63
+ Usa `UNION SELECT` para anexar dados arbitrarios no resultado devolvido pela aplicacao.
64
+
65
+ **Vetores tipicos**
66
+ - Busca/listagem com retorno tabular
67
+ - Parametros de filtro em endpoints de leitura
68
+
69
+ **Pre-condicoes**
70
+ - Ponto injetavel em query SELECT
71
+ - Compatibilidade de numero de colunas e tipos
72
+
73
+ **Leitura indevida**
74
+ - Exfiltracao de metadados e dados sensiveis (`information_schema`, `pg_catalog`)
75
+
76
+ **Escrita indevida**
77
+ - Nao e o vetor principal de escrita, mas suporta reconhecimento para ataques seguintes
78
+
79
+ **Payloads exemplo (PostgreSQL)**
80
+ - `' ORDER BY 1--`, `' ORDER BY 2--`, ... (enumeracao de colunas)
81
+ - `' UNION SELECT NULL,NULL,NULL--`
82
+ - `' UNION SELECT current_database(), current_user, version()--`
83
+
84
+ **Sinal para teste automatizado**
85
+ - Corpo da resposta passa a conter dados inesperados (ex.: versao do banco, nome de tabela, usuario DB)
86
+
87
+ ---
88
+
89
+ ### 3) Error-based SQLi (in-band)
90
+
91
+ **Descricao**
92
+ Forca erros SQL para revelar estrutura interna da consulta e do banco.
93
+
94
+ **Vetores tipicos**
95
+ - Qualquer parametro concatenado em query
96
+
97
+ **Pre-condicoes**
98
+ - Aplicacao expor erro SQL (direto na resposta ou em logs acessiveis)
99
+
100
+ **Leitura indevida**
101
+ - Vaza nomes de tabelas/colunas, sintaxe da query, tipo de DBMS
102
+
103
+ **Escrita indevida**
104
+ - Facilita elaboracao de payload de escrita ao mapear estrutura
105
+
106
+ **Payloads exemplo**
107
+ - `'`
108
+ - `';`
109
+
110
+ **Sinal para teste automatizado**
111
+ - Presenca de mensagens como `syntax error`, SQL bruto ou stacktrace
112
+
113
+ ---
114
+
115
+ ### 4) Blind Boolean-based (inferencial)
116
+
117
+ **Descricao**
118
+ Sem erro nem dados na resposta; o atacante infere condicoes por diferencas observaveis.
119
+
120
+ **Vetores tipicos**
121
+ - Cookies de tracking
122
+ - Parametros de busca/filtro que influenciam resposta
123
+
124
+ **Pre-condicoes**
125
+ - Query executada com entrada injetavel
126
+ - Diferenca observavel entre condicao verdadeira/falsa (status, tamanho, conteudo)
127
+
128
+ **Leitura indevida**
129
+ - Exfiltracao caractere a caractere (senha, email, etc.)
130
+
131
+ **Escrita indevida**
132
+ - Indireta: mapeia alvo/chaves para operacoes de escrita posteriores
133
+
134
+ **Payload exemplo (conceitual)**
135
+ - `' AND (SELECT SUBSTR(password,1,1)='a' FROM users WHERE username='admin')--`
136
+
137
+ **Sinal para teste automatizado**
138
+ - Diferenca estatisticamente consistente entre resposta de payload `true` e `false`
139
+
140
+ ---
141
+
142
+ ### 5) Blind Time-based com `pg_sleep` (inferencial)
143
+
144
+ **Descricao**
145
+ Infere condicao por atraso intencional na resposta.
146
+
147
+ **Vetores tipicos**
148
+ - Cookies, headers, query params, campos de formulario
149
+
150
+ **Pre-condicoes**
151
+ - Query executada de forma sincrona
152
+ - Medicao de latencia confiavel no teste
153
+
154
+ **Leitura indevida**
155
+ - Exfiltracao sem retorno visual de dados
156
+
157
+ **Escrita indevida**
158
+ - Confirmacao robusta de injetabilidade para avancar ao ataque de alteracao de dados
159
+
160
+ **Payloads exemplo (PostgreSQL)**
161
+ - `x'||pg_sleep(10)--`
162
+ - `x'||(SELECT CASE WHEN (1=1) THEN pg_sleep(5) ELSE pg_sleep(0) END)--`
163
+ - `x'||(SELECT CASE WHEN (username='administrator' AND SUBSTR(password,1,1)='a') THEN pg_sleep(5) ELSE pg_sleep(0) END FROM users)--`
164
+
165
+ **Sinal para teste automatizado**
166
+ - Delta de latencia acima de limiar apenas no payload condicional verdadeiro
167
+
168
+ ---
169
+
170
+ ### 6) Stacked queries (multi-statement)
171
+
172
+ **Descricao**
173
+ Termina query original e injeta nova statement com `;`.
174
+
175
+ **Vetores tipicos**
176
+ - Parametros em endpoints legados de leitura/escrita
177
+
178
+ **Pre-condicoes**
179
+ - Driver/API aceitar multiplas statements na mesma chamada
180
+ - Usuario DB com permissao de escrita
181
+
182
+ **Leitura indevida**
183
+ - Secundaria; foco nao e extracao
184
+
185
+ **Escrita indevida**
186
+ - `INSERT`, `UPDATE`, `DELETE`, ou DDL indevidos
187
+
188
+ **Payloads exemplo (conceituais)**
189
+ - `1; UPDATE users SET role='admin' WHERE id=123--`
190
+ - `1; DELETE FROM users WHERE id=123--`
191
+
192
+ **Sinal para teste automatizado**
193
+ - Estado de dados alterado apos requisicao que nao deveria escrever
194
+
195
+ **Nota**
196
+ - A viabilidade depende do driver e da configuracao da camada de acesso a dados.
197
+
198
+ ---
199
+
200
+ ### 7) Second-order SQLi
201
+
202
+ **Descricao**
203
+ Payload e armazenado em uma etapa e executado em outra, quando valor persistido e reutilizado de forma insegura.
204
+
205
+ **Vetores tipicos**
206
+ - Campos de perfil (nome, email, company, referral code)
207
+ - Fluxos de exportacao, relatorios e telas administrativas
208
+
209
+ **Pre-condicoes**
210
+ - Dado armazenado sem risco aparente
211
+ - Reuso posterior em SQL dinamico concatenado
212
+
213
+ **Leitura indevida**
214
+ - Exfiltracao em telas/rotinas de consulta posterior
215
+
216
+ **Escrita indevida**
217
+ - Update/delete indevido quando trigger posterior concatena valor armazenado
218
+
219
+ **Sinal para teste automatizado**
220
+ - Teste em duas fases:
221
+ 1. Seed: grava payload
222
+ 2. Trigger: executa endpoint/rotina que reusa dado armazenado
223
+
224
+ ---
225
+
226
+ ### 8) SQLi em partes nao-parameterizaveis (identificadores e ordenacao)
227
+
228
+ **Descricao**
229
+ Ataque em segmentos que nao aceitam bind (`table`, `column`, `ORDER BY`, etc.) quando montados por concatenacao.
230
+
231
+ **Vetores tipicos**
232
+ - Parametros de ordenacao (`sort`, `direction`)
233
+ - Parametros de campos/colunas dinamicas
234
+ - DDL dinamico
235
+
236
+ **Pre-condicoes**
237
+ - Falta de allowlist para identificadores
238
+ - SQL montado por template string
239
+
240
+ **Leitura indevida**
241
+ - Enumeracao de estrutura e alteracao de comportamento da consulta
242
+
243
+ **Escrita indevida**
244
+ - Em SQL dinamico de DDL/manutencao, pode abrir caminho para alteracoes indevidas
245
+
246
+ **Observacao Node/Postgres**
247
+ - Em `node-postgres`, placeholders (`$1`, `$2`) nao valem para identificadores; sao apenas para valores.
248
+
249
+ **Sinal para teste automatizado**
250
+ - Valor nao permitido em `sort/table/column` altera query executada, causa erro de sintaxe ou comportamento inesperado
251
+
252
+ ## Catalogo de payloads para bateria de testes (PostgreSQL)
253
+
254
+ ### Basicos de deteccao
255
+ - `'`
256
+ - `";` (variantes de delimitador/contexto)
257
+ - `--`
258
+ - `/* test */`
259
+
260
+ ### Bypass logico
261
+ - `' OR '1'='1'--`
262
+ - `') OR ('1'='1'--`
263
+
264
+ ### Enumeracao de colunas para UNION
265
+ - `' ORDER BY 1--`
266
+ - `' ORDER BY 2--`
267
+ - `' ORDER BY 3--`
268
+ - `' UNION SELECT NULL--`
269
+ - `' UNION SELECT NULL,NULL--`
270
+ - `' UNION SELECT NULL,NULL,NULL--`
271
+
272
+ ### Exfiltracao de metadados
273
+ - `' UNION SELECT current_database(), current_user, version()--`
274
+ - `' UNION SELECT table_name, NULL, NULL FROM information_schema.tables--`
275
+
276
+ ### Time-based
277
+ - `x'||pg_sleep(5)--`
278
+ - `x'||(SELECT CASE WHEN (1=1) THEN pg_sleep(5) ELSE pg_sleep(0) END)--`
279
+ - `x'||(SELECT CASE WHEN (1=2) THEN pg_sleep(5) ELSE pg_sleep(0) END)--`
280
+
281
+ ### Second-order (semente)
282
+ - Valores de perfil com delimitadores e operadores logicos para disparo posterior em fluxo vulneravel
283
+
284
+ ## Anti-patterns Node/TypeScript para cobrir em testes
285
+
286
+ - Interpolar entrada em template string SQL (ex.: `` `... '${input}' ...` ``)
287
+ - Concatenar `WHERE`, `ORDER BY`, `LIMIT/OFFSET` com entrada externa
288
+ - Uso de raw SQL em ORM/query builder sem bind seguro
289
+ - Confiar em dado vindo do proprio banco (origem persistida) sem tratar como nao-confiavel
290
+ - Falta de allowlist para identificadores dinamicos (`table`, `column`, `sort`)
291
+ - Validacao fraca de tipo/formato antes de montar query
292
+
293
+ ## Inspiracoes de suites/arquivos no GitHub
294
+
295
+ ### 1) Testes TypeScript focados em deteccao de SQLi
296
+
297
+ - Repositorio: `dot-do/workers`
298
+ - Arquivo: `packages/security/test/sql-injection.test.ts`
299
+ - Link: https://github.com/dot-do/workers/blob/main/packages/security/test/sql-injection.test.ts
300
+ - Cobertura observada:
301
+ - Padroes de `tautology`, `union`, `stacked`, `comment`, `hex`
302
+ - Casos positivos e negativos
303
+ - Testes de funcoes auxiliares de sanitizacao e identificadores
304
+ - Uso como inspiracao:
305
+ - Base para tabela inicial de payloads
306
+ - Estrutura de testes unitarios para detector/guardas
307
+
308
+ ### 2) Benchmark extensivo para vulnerabilidades reais
309
+
310
+ - Repositorio: `OWASP-Benchmark/BenchmarkJava`
311
+ - Link: https://github.com/OWASP-Benchmark/BenchmarkJava
312
+ - Arquivo de referencia:
313
+ - `expectedresults-1.2.csv`
314
+ - https://github.com/OWASP-Benchmark/BenchmarkJava/blob/master/expectedresults-1.2.csv
315
+ - Cobertura observada:
316
+ - Grande volume de casos de CWE-89 (SQLi)
317
+ - Ground truth de vulneravel vs nao vulneravel
318
+ - Uso como inspiracao:
319
+ - Curadoria de cenarios por tecnica
320
+ - Modelo para matriz de cobertura e oraculo esperado
321
+
322
+ ### 3) Aplicacao propositalmente vulneravel com desafio SQLi
323
+
324
+ - Repositorio: `juice-shop/juice-shop`
325
+ - Arquivo de codigo relevante:
326
+ - `routes/login.ts`
327
+ - https://github.com/juice-shop/juice-shop/blob/master/routes/login.ts
328
+ - Cobertura observada:
329
+ - Exemplo pratico de concatenacao vulneravel no login
330
+ - Facil para reproduzir ataque de bypass e validar correcao
331
+ - Uso como inspiracao:
332
+ - Cenario de teste de integracao end-to-end para autenticao
333
+
334
+ ### 4) Ferramenta de automacao ofensiva para validacao externa
335
+
336
+ - Repositorio: `sqlmapproject/sqlmap`
337
+ - Link: https://github.com/sqlmapproject/sqlmap/
338
+ - Cobertura observada:
339
+ - Deteccao/exploracao automatica de varias tecnicas SQLi
340
+ - Suporte a canais blind e time-based
341
+ - Uso como inspiracao:
342
+ - Validacao complementar em pipeline de seguranca (fora de unit/integration)
343
+
344
+ ## Estrutura sugerida para futura bateria de testes automatizados
345
+
346
+ Para cada caso de teste, usar estrutura padrao:
347
+
348
+ - `id`: identificador unico do caso
349
+ - `tecnica`: ex. `union_based`, `time_blind`, `second_order`
350
+ - `objetivo`: `leitura_indevida` ou `escrita_indevida`
351
+ - `vetor`: endpoint/campo/cookie/header
352
+ - `pre_condicoes`: estado necessario antes da execucao
353
+ - `payload`: string exata usada no teste
354
+ - `passos`: sequencia reproducivel
355
+ - `assert_esperado`:
356
+ - bloqueio correto, ou
357
+ - evidencia de vulnerabilidade (quando teste de seguranca ofensivo controlado)
358
+ - `observacoes`: restricoes de driver/ORM/permissao
359
+
360
+ ## Observacoes finais para implementacao
361
+
362
+ - Diferenciar claramente testes de **deteccao de risco** e testes de **exploracao controlada**.
363
+ - Em cenarios time-based, usar limiar de latencia e repeticoes para reduzir falso positivo.
364
+ - Em second-order, manter testes em duas fases (`seed` + `trigger`) com isolamento de dados.
365
+ - Em Node/Postgres, testar explicitamente que:
366
+ - valores usam placeholders (`$1`, `$2`, ...)
367
+ - identificadores dinamicos usam allowlist/escape apropriado
368
+ - nao ha concatenacao de entrada externa em SQL bruto