Skip to content

SDK Java/Kotlin 0.1.0 (Spring Boot, Servlet) - #1

Merged
JIV-DLS merged 2 commits into
mainfrom
feat/sdk-v0.1.0
Nov 15, 2026
Merged

JIV-DLS merged 2 commits into
mainfrom
feat/sdk-v0.1.0

Conversation

@JIV-DLS

@JIV-DLS JIV-DLS commented Nov 15, 2026 •

Copy link
Copy Markdown
Member

Premier SDK Technas Pay pour Java 17+ et Kotlin, même surface et même contrat que Node, Python, PHP et Dart.

Ce qu'il contient

  • TechnasPay : paiements mobile money et carte, statut, historique, remboursements (dont hors Technas), recharges, numéro de reversement, change, règles de pays, compte carte, avis signés, createTestWebhook, simulateTestPayment.
  • Routes toutes faites pour l'app (technas_pay_flutter) : pay.appRoutes(authorize, resolveOrder)…build(), contrat contract/app-contract.v1.json (23 cas, copie à l'identique) rejoué par AppContractTest.
  • Adaptateur Servlet (Spring Boot MVC, Quarkus, Tomcat, Jetty) : TechnasPayServlet.handle(routes, req, res, "/api/technas-pay").
  • Exemples Spring Boot en Java et en Kotlin, compilés en CI contre ce SDK.
  • README (intro du hub et tarif), AGENTS.md, llms.txt, SECURITY.md, CHANGELOG.

Installation

Depuis GitHub par JitPack (com.github.Technas-Organization:technas-pay-java:v0.1.0). Aucune publication sur Maven Central.

Sécurité (exigences du 15/11)

Chaque garantie a son test, tableau dans SECURITY.md :

  • signature comparée en temps constant (MessageDigest.isEqual) sur le corps brut, tolérance 300 s ; avis falsifié, rejoué, trop vieux ou du futur : refusé (SecurityTest) ;
  • JSON strict, modèle en arbre seulement (aucune désérialisation polymorphe) : ni NaN, ni clé en double, ni texte après la valeur, profondeur 64 ;
  • TLS du JDK jamais touché (aucun TrustManager/HostnameVerifier/SSLContext), aucune redirection suivie (testé contre un vrai serveur local : la clé ne suit pas un 302), délais de connexion et de réponse posés (testé) ;
  • clé seulement dans Authorization, jamais vers http (sauf localhost), jamais dans une URL, ni dans toString, message ou exception ; client non sérialisable ;
  • casse ASCII seulement (FindSecBugs IMPROPER_UNICODE) ; réponses JSON échappées pour le HTML + nosniff ; corps Servlet borné à 64 Ko.

Trouvé et corrigé en écrivant les tests : texte après le JSON accepté, 302 de l'API pris pour un succès vide, Jackson 2.18.2 vulnérable (OSV-Scanner : 14 avis) → 2.23.0.

CI (ubuntu-latest, dépôt public) : JDK 17 et 21, -Xlint:all -Werror, SpotBugs effort max seuil bas + FindSecBugs, OSV-Scanner, TruffleHog. Dependabot et alertes de vulnérabilité activés.

Relecture de sécurité par un sous-agent : constats ci-dessous en commentaire.

Remboursement par carte : kind vaut "card" (l'ancien "stripe" est lu "card"). Aucun fournisseur nommé dans la doc, sauf l'étape d'inscription du compte carte.

Paiements mobile money et carte, statut, historique, remboursements, recharges,
numéro de reversement, change, avis signés, routes toutes faites pour l'app
(contrat v1, 23 cas rejoués) et adaptateur Servlet (Spring Boot).

Sécurité : signature en temps constant sur le corps brut, tolérance 300 s,
JSON strict en arbre (ni NaN, ni clé en double, ni texte après, profondeur 64),
TLS du JDK jamais touché, aucune redirection suivie, délais posés, clé
seulement dans l'en-tête Authorization et jamais vers http, casse ASCII,
réponses JSON échappées pour le HTML. CI : -Werror, SpotBugs max + FindSecBugs,
OSV-Scanner, TruffleHog, Dependabot.

Remboursement par carte : kind "card" (l'ancien "stripe" est lu "card").
M1 lecture d'un paiement : metadata.order_id d'abord, référence exacte exigée.
M2 et F1 identifiants de commande et de paiement bornés, refusés sans appel.
M4 secret en ASCII imprimable ; message du JDK (qui cite l'en-tête) remplacé.
F2 401/403 de Technas rendus 502 upstream_error à l'app.
F3 Optional.empty() refuse.
F4 actions épinglées par empreinte, binaire OSV-Scanner vérifié (sha256).
F5 exemples : la commande d'un autre rend 404.
Info : réponse bornée à 1 Mo, tolérance des avis entre 1 s et 1 h,
préfixe Servlet vérifié à la frontière, toString des secrets masqué.
M3 (deux paiements par deux moyens) documenté pour le marchand ; correction
commune à tous les SDK à suivre.
@JIV-DLS

JIV-DLS commented Nov 15, 2026

Copy link
Copy Markdown
Member Author

Relecture de sécurité dédiée (sous-agent, en entrée le code seul)

Aucun constat élevé. Points jugés sûrs par la relecture : signature en temps constant et tolérance dans les deux sens sur le corps brut ; JSON en arbre, doublons et NaN refusés, profondeur bornée ; aucune redirection, délais, TLS du JDK ; montant et devise toujours de resolveOrder ; routes carte derrière authorizeAdmin ; réponse JSON échappée + nosniff ; corps Servlet ≤ 64 Ko.

# Gravité Constat Suite donnée Preuve
M1 Moyenne GET /payments/{id} jugeait la propriété sur une lecture ambiguë de la référence (x-card-1 : commande x ou x-card ?) Corrigé : metadata.order_id d'abord, référence exactement orderId-N / orderId-card-N, sinon 404 RevueDeSecuriteTest.m1…
M2 Moyenne orderId de l'app non borné ni canonique Corrigé : ^[A-Za-z0-9_-]{1,128}$, sinon 404 sans appel m2EtF1…
M3 Moyenne Une commande peut être payée par mobile money ET par carte (séries de références séparées) Non corrigé ici : le changement touche le contrat commun à tous les SDK. Documenté dans AGENTS.md (traiter un second paiement dans onCompleted). Suite commune à ouvrir. —
M4 Moyenne Un secret mal collé faisait citer la clé dans le message d'erreur du JDK Corrigé : secret en ASCII imprimable, erreur du JDK remplacée m4…
F1 Faible .. et %2F possibles dans un chemin vers l'API Corrigé : identifiants validés avant tout appel ClientTest.identifiantEchappeEtSimulation, m2EtF1…
F2 Faible 401/403 de Technas transmis à l'app Corrigé : 502 upstream_error f2…
F3 Faible Optional.empty() accepté par authorize/authorizeAdmin Corrigé : refusé, Optional plein déballé f3…
F4 Faible Actions CI non épinglées, binaire OSV non vérifié Corrigé : SHA de commit, sha256sum -c CI
F5 Faible Exemples sans contrôle de propriété Corrigé : 404 pour la commande d'un autre exemples compilés en CI
I Info Réponse non bornée ; tolérance non bornée ; préfixe Servlet sans frontière ; toString du record privé des secrets Corrigés (1 Mo, 1 s–1 h, 404 hors préfixe, toString masqué) i…, ServletTest.horsDuPrefixe…
I Info start() ne compare pas montant/devise d'un essai déjà ouvert ; reference_conflict bloque Suite commune (même logique dans tous les SDK) —
I Info Signature vérifiée sur la chaîne UTF-8, pas sur les octets Accepté : Technas envoie de l'UTF-8 ; un octet invalide ne fait qu'échouer la vérification (pas de faux positif) —

@JIV-DLS
JIV-DLS merged commit 1803f8d into main Nov 15, 2026
3 checks passed
@JIV-DLS
JIV-DLS deleted the feat/sdk-v0.1.0 branch November 15, 2026 02:22
JIV-DLS added a commit that referenced this pull request Nov 15, 2026
Paiements mobile money et carte, avis signés, routes toutes faites pour l'app (contrat v1), adaptateur Servlet. Relecture de sécurité dédiée : constats corrigés et testés (voir la PR).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant