feat(seguridad): rutas admin bajo prefijo configurable obligatorio
deploy-branch / deploy (push) Failing after 3m7s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Failing after 3m17s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Failing after 3m10s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
deploy-branch / deploy (push) Failing after 3m7s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Failing after 3m17s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Failing after 3m10s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
Cambio openspec hide-admin-route: las rutas de administración se montan bajo LOCALESP_ADMIN_PREFIX (única variable, obligatoria, sin valor por defecto) y las rutas históricas /api/... dejan de existir (404 natural). - server: autocarga de .env (sin pisar el entorno) y fail-fast claro si falta LOCALESP_ADMIN_PREFIX; reportar/confirmar siguen públicas - frontend: src/api.js usa el prefijo expuesto por Vite (envPrefix); npm run build falla sin la variable; proxy de dev la lee vía loadEnv - .env.example como template único de configuración - tests: 109/109 en verde (rutas bajo prefijo, 404s históricos y fail-fast sin configurar) - openspec: artefactos del cambio sincronizados (design/spec/tasks)
This commit is contained in:
@@ -1,2 +1,48 @@
|
||||
# LocalESP
|
||||
Registro colaborativo de negocios españoles
|
||||
|
||||
Registro colaborativo de negocios españoles.
|
||||
|
||||
## Rutas de administración (prefijo configurable)
|
||||
|
||||
Las rutas de administración **solo se sirven bajo un prefijo configurable**;
|
||||
las rutas históricas (`/api/pendientes`, `/api/reportes`, `/api/aprobar/:id`,
|
||||
`/api/rechazar/:id`, `DELETE /api/locales/:id`, `/api/reportes/:id/descartar`)
|
||||
dejan de existir y devuelven 404. Esto oculta la superficie admin de la
|
||||
enumeración de rutas sin añadir autenticación (ocultación, no seguridad real).
|
||||
|
||||
| Ruta admin | Método |
|
||||
|---|---|
|
||||
| `$ADMIN_PREFIX/pendientes` | GET |
|
||||
| `$ADMIN_PREFIX/aprobar/:id` | POST |
|
||||
| `$ADMIN_PREFIX/rechazar/:id` | POST |
|
||||
| `$ADMIN_PREFIX/locales/:id` | DELETE |
|
||||
| `$ADMIN_PREFIX/reportes` | GET |
|
||||
| `$ADMIN_PREFIX/reportes/:id/descartar` | POST |
|
||||
|
||||
Siguen siendo públicas (las usa la web): `GET /api/locales`,
|
||||
`POST /api/propuestas`, `POST /api/check-duplicado`,
|
||||
`POST /api/locales/:id/confirmar`, `POST /api/locales/:id/reportar` y
|
||||
`GET/POST /api/config/filtro_palabras`.
|
||||
|
||||
### Configuración
|
||||
|
||||
`LOCALESP_ADMIN_PREFIX` es **obligatoria, sin valor por defecto y la única
|
||||
variable necesaria**: servidor, proxy de desarrollo y build del frontend
|
||||
leen la misma. Sin ella, `node server/index.js` y `npm run build` fallan con
|
||||
un error claro. La forma más cómoda de configurarla es copiar el template:
|
||||
|
||||
```bash
|
||||
cp .env.example .env # y rellena LOCALESP_ADMIN_PREFIX
|
||||
```
|
||||
|
||||
- **Servidor:** lee `LOCALESP_ADMIN_PREFIX` del entorno y de `.env` (el
|
||||
fichero no sobrescribe variables ya presentes).
|
||||
- **Frontend:** Vite expone `LOCALESP_ADMIN_PREFIX` al código cliente vía
|
||||
`envPrefix` (`.env` o entorno en dev/build); `npm run build` falla si falta.
|
||||
- **Desarrollo:** `npm run dev` proxya `/api` y el prefijo admin al backend
|
||||
en `localhost:3000`, leyendo ambos del entorno o de `.env`.
|
||||
|
||||
> Nota: sin prefijo configurado el servidor no arranca (no existe modo sin
|
||||
> ocultación). El prefijo viaja en el bundle del frontend, así que esto es
|
||||
> ocultación básica frente a enumeración, no un mecanismo de seguridad; la
|
||||
> autenticación real queda como trabajo futuro.
|
||||
|
||||
Reference in New Issue
Block a user