Nicolas Cantu
cfa1f435cb
Initial state: - HTTP proxy utilities (Bearer parsing, hop-by-hop headers, body limits, safe path validation) were duplicated between smart-ide-sso-gateway and smart-ide-global-api. - IA_DEV_ROOT auto-resolution order differed between bash (ensure-ia-dev-project-link.sh) and TypeScript (ia-dev-gateway getIaDevRoot), and could fall back to non-existing paths. Motivation: - Reduce duplication and drift across proxy layers. - Enforce consistent, explicit IA_DEV_ROOT behavior across scripts and services. Resolution: - Add package @4nk/smart-ide-http-utils and reuse it from smart-ide-sso-gateway and smart-ide-global-api. - Align IA_DEV_ROOT resolution to prefer ./services/ia_dev then ./ia_dev; fail fast when missing/misconfigured. Root cause: - Cross-service utilities were implemented ad-hoc in each service. - Historical layout transitions (ia_dev gitlink vs vendored services/ia_dev) left multiple resolvers with different priorities. Impacted features: - HTTP proxy chain (SSO gateway -> global API -> upstream services). - ia-dev-gateway startup/operation when IA_DEV_ROOT is missing or invalid. Code modified: - packages/smart-ide-http-utils/** - services/smart-ide-global-api/src/server.ts - services/smart-ide-sso-gateway/src/server.ts - services/ia-dev-gateway/src/paths.ts - scripts/ensure-ia-dev-project-link.sh Documentation modified: - docs/system-architecture.md - docs/ia_dev-module.md - docs/repo/README.md Configurations modified: - services/smart-ide-global-api/package.json - services/smart-ide-sso-gateway/package.json Files in deploy modified: - None Files in logs impacted: - None (runtime logs only) Databases and other sources modified: - None Off-project modifications: - None Files in .smartIde modified: - None Files in .secrets modified: - None New patch version in VERSION: - 0.0.6 CHANGELOG.md updated: - yes
smart-ide-global-api
Couche HTTP interne : agrège les appels vers les micro-services smart_ide avec les jetons techniques par service. Pas d’OIDC : seul smart-ide-sso-gateway appelle cette API, avec Authorization: Bearer égal à GLOBAL_API_INTERNAL_TOKEN.
Les micro-services n’exposent pas le SSO ; ils restent sur 127.0.0.1 avec Bearer (ou clé API pour local-office).
Run
Démarrer avant la passerelle SSO.
cd services/smart-ide-global-api
cp .env.example .env
# définir GLOBAL_API_INTERNAL_TOKEN et les jetons des services
set -a && source .env && set +a
npm ci
npm run build
npm start
Écoute par défaut : http://127.0.0.1:37149.
Amonts : module @4nk/smart-ide-upstreams (../../packages/smart-ide-upstreams/). Après modification des clés ou des variables d’environnement mappées, reconstruire ce paquet et committer son dist/.
Journaux
Une ligne JSON par requête (hors GET /health) dans .logs/global-api/access.log (répertoire .logs/ à la racine du monorepo, créé au besoin).
Documentation
- API :
docs/API/global-api.md - Passerelle SSO :
docs/features/sso-gateway-service.md