Nicolas Cantu
940cf59178
- Add packages/smart-ide-upstreams (versioned dist) for resolveUpstream + listUpstreamKeys - Wire smart-ide-global-api and smart-ide-sso-gateway via file: dependency - Add systemd user unit templates and install-smart-ide-gateway-systemd-user.sh (SSO After/Requires global API) - Update docs and VERSION 0.0.3
33 lines
1.2 KiB
Markdown
33 lines
1.2 KiB
Markdown
# 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.
|
||
|
||
```bash
|
||
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`](../../docs/API/global-api.md)
|
||
- Passerelle SSO : [`docs/features/sso-gateway-service.md`](../../docs/features/sso-gateway-service.md)
|