@puca/puca-core 14.11.2 → 14.13.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.
- package/dist/core/services/auth.service.js +3 -2
- package/dist/core/services/auth.service.js.map +1 -1
- package/dist/core/services/install.service.js +25 -0
- package/dist/core/services/install.service.js.map +1 -1
- package/dist/core/services/report.service.d.ts +8 -0
- package/dist/core/services/report.service.js +81 -16
- package/dist/core/services/report.service.js.map +1 -1
- package/dist/core/services/table-permission.service.js +3 -1
- package/dist/core/services/table-permission.service.js.map +1 -1
- package/dist/models/crud-controller-especification-environment.d.ts +4 -1
- package/dist/models/crud-controller-especification.d.ts +4 -0
- package/dist/models/crud-controller-especification.js.map +1 -1
- package/dist/models/table-dictionary.d.ts +6 -0
- package/dist/orm/services/sql/column-security.helper.d.ts +22 -0
- package/dist/orm/services/sql/column-security.helper.js +108 -0
- package/dist/orm/services/sql/column-security.helper.js.map +1 -0
- package/dist/orm/services/sql/sql-security-layer.service.d.ts +4 -0
- package/dist/orm/services/sql/sql-security-layer.service.js +137 -9
- package/dist/orm/services/sql/sql-security-layer.service.js.map +1 -1
- package/dist/orm/services/sql/table-permission.helper.d.ts +2 -0
- package/dist/orm/services/sql/table-permission.helper.js +113 -1
- package/dist/orm/services/sql/table-permission.helper.js.map +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/dist/utils/cpf-cnpj.d.ts +7 -0
- package/dist/utils/cpf-cnpj.js +92 -0
- package/dist/utils/cpf-cnpj.js.map +1 -0
- package/docs/column-level-security/column-level-security-analysis.md +156 -0
- package/docs/column-level-security/column-level-security-by-rule-analysis.md +201 -0
- package/docs/column-level-security/dictionary-admin-permission-plan.md +164 -0
- package/docs/column-level-security/pending-flow-runtime-function-columns.md +39 -0
- package/docs/column-level-security/pending-javascript-source-columns.md +19 -0
- package/docs/column-level-security/puca-flow-dictionary-admin-exception-plan.md +164 -0
- package/package.json +1 -1
- package/sqli-pesquisa-consolidada.md +368 -0
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
# Pendências: colunas com código-fonte JavaScript
|
|
2
|
+
|
|
3
|
+
**Status:** pendente
|
|
4
|
+
**Data:** 2026-07-27
|
|
5
|
+
**Escopo:** column-level security apenas em colunas que armazenam source JavaScript (ignorar fórmulas, templates HTML, condições e FKs UUID)
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## Lista de pendências
|
|
10
|
+
|
|
11
|
+
| # | View | Coluna | Ação pendente |
|
|
12
|
+
| --- | --- | --- | --- |
|
|
13
|
+
| 1 | `puca_indicators_api_data_source` | `script` | Definir e aplicar `columnAccess` no service do puca-indicators |
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## Relacionado
|
|
18
|
+
|
|
19
|
+
- Runtime JS do flow: [pending-flow-runtime-function-columns.md](./pending-flow-runtime-function-columns.md)
|
|
@@ -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
|
@@ -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
|