Exposer une application Spring Boot en HTTPS depuis localhost

Réponse rapide

Exécutez localement un fixture Spring Boot testé, publiez uniquement le port sélectionné et prouvez une vraie requête externe. La page doit résoudre les comportements propres à la stack - comportement Host, proxy, cookie et temps réel - plutôt que répéter le démarrage générique.

Étapes

1. Utiliser les versions prises en charge de Spring Boot et Oxaa ainsi que le commit d’exemple épinglé.
2. Démarrer l’application avec ./mvnw spring-boot:run ou la commande de développement documentée dans le dépôt.
3. Vérifier une route de santé locale déterministe sur loopback.
4. Exécuter oxaa login et oxaa http <port> ; attendre edge-ready.
5. Ouvrir l’URL publique depuis un second réseau ou un sandbox fournisseur.
6. Tester les comportements Host, proxy, cookie, redirection, body brut et temps réel propres à la stack.
7. Confirmer le log local, la réponse attendue et l’état de l’Inspector.
8. Arrêter la route, retirer la configuration temporaire et archiver la version testée.

Points propres à Spring Boot

• Versions testées du framework et d’Oxaa
• Dépôt d’exemple fonctionnel et commande de démarrage locale
• Commande Oxaa et sortie edge-ready
• Comportement Host, proxy, cookie ou temps réel propre à la stack
• Vraie requête externe, sortie attendue et erreurs courantes
• Nettoyage et liens vers le fournisseur ou cas d’usage précis

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 ».

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.