WebSocket et Server-Sent Events

Réponse rapide

Utilisez websocket et server-sent events pour accomplir un véritable workflow externe contre le code exécuté localement. Le succès correspond à la requête, au callback ou à la connexion qui atteint le bon handler et renvoie le résultat attendu.

Du service local à une vraie requête externe

1. Installez et vérifiez le paquet Oxaa signé et approuvé.
2. Exécutez oxaa login et enrôlez l’appareil.
3. Démarrez le service local sélectionné et vérifiez son état.
4. Exécutez oxaa http <port> et attendez l’état edge-ready.
5. Envoyez une requête depuis un sandbox fournisseur, un navigateur distant, un téléphone ou un second réseau.
6. Confirmez la requête et la réponse dans l’application locale et l’Inspector.
7. Arrêtez la route et supprimez callbacks, captures et identifiants de test une fois terminé.

Détails techniques

• Tâche externe réelle et signal d’achèvement clair
• Prérequis, handler local et état edge-ready
• Requête du fournisseur, navigateur ou appareil et réponse attendue
• Contraintes de signature, proxy, cookie ou protocole
• Traitement dans l’Inspector et dépannage sûr
• Nettoyage, workflow répétable et passage en production

Traitement du trafic et des données de l’Inspector

L’edge public d’Oxaa termine le TLS public afin de résoudre le nom d’hôte exact, d’identifier la route authentifiée en cours et de transférer la requête. La session entre l’appareil enrôlé et Oxaa est chiffrée ; elle remet la requête uniquement au service local sélectionné.

Oxaa conserve des métadonnées limitées de compte, route, usage, sécurité, facturation, support et diagnostic nécessaires au fonctionnement et à la protection du service. La capture de body dans l’Inspector est une action de débogage distincte et explicite : la copie limitée du body de la requête ou de la réponse affichée dans l’Inspector local reste sur l’appareil du développeur et peut être masquée, supprimée immédiatement ou expirer automatiquement. Le trafic public doit néanmoins être traité par l’edge ; la formulation exacte est donc « copies de l’Inspector conservées localement », et non « Oxaa ne peut pas voir le trafic ».

Identité de la route et périmètre du service sélectionné

La connexion est initiée par l’appareil enrôlé. L’identité générée localement, la preuve de possession, les générations de route de courte durée et la correspondance exacte du nom d’hôte lient l’adresse à la route active. Une propriété inconnue, malformée, révoquée ou obsolète est rejetée en mode fail-closed.

Oxaa ne publie que la cible locale configurée. Les destinations de réseau privé nécessitent une autorisation explicite ; les classes publiques, metadata, link-local, multicast et autres destinations dangereuses restent bloquées par la politique.

Dépannage

Commencez par vérifier le processus local, le port et le schéma. Contrôlez ensuite l’authentification et l’horloge, DNS, UDP/443, le fallback TCP/443, le proxy d’entreprise ou l’interception TLS, la propriété de la route et l’état edge-ready. Utilisez oxaa routes list, oxaa diagnose --network et des identifiants d’erreur stables ; relisez les diagnostics avant partage et retirez les secrets, bodies et chemins privés.

Nettoyage et passage en production

Supprimez le callback externe, l’URL de prévisualisation ou l’association DNS ; faites tourner les identifiants de test ; supprimez les captures locales ; arrêtez la route ; puis révoquez l’appareil ou la session si nécessaire. Le trafic de production doit être confié à l’application déployée, à un ingress de production ou à une plateforme de livraison d’événements adaptée.

Ce qu’Oxaa est - et ce qu’il n’est pas

Oxaa fournit une connectivité de développement vers un service HTTP ou HTTPS local sélectionné tant que l’appareil enrôlé et la route authentifiée restent actifs. Ce n’est ni un hébergement applicatif, ni un VPN généraliste, ni un forward proxy, ni un déploiement permanent de production, ni un tunnel raw TCP/UDP, ni un passthrough TLS arbitraire, ni un substitut de CDN/WAF, ni une plateforme de livraison de webhooks de production.

Questions fréquentes

Oxaa déploie-t-il mon application ?

Non. L’application continue de s’exécuter sur l’appareil enrôlé. Oxaa transfère les requêtes uniquement vers le service local sélectionné tant que la route authentifiée est active.

Dois-je ouvrir un port entrant ?

En principe non. L’appareil enrôlé initie la session. Un réseau restrictif peut toutefois bloquer DNS, UDP/443, TCP/443 ou intercepter TLS.

Où résident les copies de body de l’Inspector ?

Lorsque la capture limitée est activée explicitement, la copie affichée dans l’Inspector local reste sur l’appareil du développeur. Oxaa traite toujours le trafic public et conserve des métadonnées opérationnelles limitées.

S’agit-il d’un hébergement de production ?

Non. Utilisez une application déployée, un ingress de production ou une plateforme de livraison d’événements pour le trafic de production.