← Retour à ADDABlueprints
Modèles de déploiement et d’adoption adaptés à chaque contexte.
Pour les équipes qui planifient l’intégration d’ADDA dans leur environnement.
Blueprints ADDA
Architectures de référence pour déployer DNS, WAF, Access et la distribution publique d’ADDA hors du dépôt.
dns / Cloudflare Worker
ADDA DNS Edge / Cloudflare Worker
opérationnelBundle DNS défensif avec heartbeat en périphérie, résolution de politique et télémétrie opérationnelle prête à être déployée hors du dépôt.
API
- /api/adda/v1/dns/edge/bundle
- /api/adda/v1/dns/edge/telemetry
- /api/adda/v1/dns/dashboard
Commandes
curl "$BASE_URL/api/adda/v1/dns/edge/bundle?target=cloudflare-worker&domain=capacero.ar"npm run adda:smoke
Artefacts
- lib/adda/dns-waf-runtime.ts
- app/api/adda/v1/dns/edge/bundle/route.ts
- app/api/adda/v1/dns/edge/telemetry/route.ts
Vérification
- POST vers /api/adda/v1/dns/edge/telemetry avec un heartbeat healthy/degraded
- Valider le bundle et p95LatencyMs depuis la console ADDA
waf / Proxy inverse Nginx
ADDA WAF Edge / Nginx Reverse Proxy
opérationnelProxy inverse avec snippets WAF, règles adaptatives et télémétrie/heartbeat pour les routes sensibles.
API
- /api/adda/v1/waf/edge/bundle
- /api/adda/v1/waf/edge/telemetry
- /api/adda/v1/waf/dashboard
Commandes
curl "$BASE_URL/api/adda/v1/waf/edge/bundle?target=nginx&domain=capacero.ar"npm run adda:smoke
Artefacts
- lib/adda/dns-waf-runtime.ts
- app/api/adda/v1/waf/edge/bundle/route.ts
- app/api/adda/v1/waf/edge/telemetry/route.ts
Vérification
- Émettre un heartbeat WAF et vérifier blocked/challenged/allowed dans le tableau de bord
- Valider les snippets Nginx et les matched rules depuis la console
access / systemd + agent léger
ADDA Access Watch Agent / systemd rollout
prêtRunbook de déploiement pour les heartbeats et la télémétrie des pairs sur les tunnels Access, avec clé partagée et identifiants d’appareil/tunnel.
API
- /api/adda/v1/access/status
- /api/adda/v1/access/agents/manifest
- /api/adda/v1/access/agents/heartbeats
- /api/adda/v1/access/peers/telemetry
- /api/adda/v1/access/policies/evaluate
Commandes
curl "$BASE_URL/api/adda/v1/access/agents/manifest?deviceId=access-device-001"npm run adda:cli -- agent install --profile access-watchnode examples/adda-access-agent-heartbeat.mjsnpm run adda:cli -- access status
Artefacts
- examples/adda-access-agent-heartbeat.mjs
- app/api/adda/v1/access/agents/manifest/route.ts
- scripts/adda-cli.mjs
- packages/adda-cli/bin/adda.mjs
Vérification
- Confirmer un heartbeat online et un pair healthy dans AddaAccessPanel
- Examiner le score de risque, l’état stale et les actions recommandées par pair/agent
tooling / publication versionnée
ADDA SDK + CLI blueprint de publicación
prêtBlueprint de publication pour `@capacero/adda-sdk` et `@capacero/adda-cli`, avec le binaire `adda`, les contrôles de publication et les composants publics.
API
- /api/adda/v1/release/manifest
- /api/adda/v1/blueprints
- /api/adda/v1/kits
Commandes
npm run typechecknode scripts/adda-cli.mjs --helpnode packages/adda-cli/bin/adda.mjs --help
Artefacts
- packages/adda-sdk/package.json
- packages/adda-cli/package.json
- app/adda/badge.js/route.ts
- app/adda/widget.js/route.ts
Vérification
- Valider les méthodes Access et le manifeste de release dans le SDK/CLI
- Ouvrir `/adda/badge.js` et `/adda/widget.js` comme ressources publiques réelles