The codeSécurité(in French)7 min read
Stripe et Resend
Ce que le paiement et l’e-mail reçoivent, quelle clé les pilote et avec quels droits, et ce que les applications revérifient derrière eux.
Not translated yet
Deux prestataires touchent directement les clients : Stripe encaisse et Resend leur écrit. Chacun n’est branché qu’à l’application qui en a besoin, avec la clé la plus limitée qui suffit (Intégrations). Ce que les applications reçoivent d’eux est décrit dans Webhooks et échanges. Ici, je parle de ce qu’elles leur envoient et de ce qu’elles vérifient.
Stripe
| Risque | Protection | Ce qui la prouve |
|---|---|---|
| Des données de carte interceptées ou gardées | paiement hébergé par Stripe, aucun script de paiement sur le site | CSP du site (form-action), checkout-session-params.ts |
| Un site compromis qui rembourse ou lit tout | clé restreinte imposée sur tout déploiement du site | schéma d’environnement du site |
| Un prix modifié dans le navigateur | prix recalculés par le serveur, session rapprochée de sa commande par l’ERP | checkout-session-params.ts, reconcileSession |
| Des sessions ouvertes en masse | limite de débit, clé d’idempotence par commande | checkout-rate-limit.regression.test.ts |
| Un remboursement abusif ou mal compté | aucun depuis le site, connexion récente, rapprochement avec Stripe | assertRecentAdminSignIn, reconcileStripeRefund |
| Une configuration qui dérive | version d’API épinglée, abonnement du webhook vérifié | check-stripe-endpoint.mts, pinned-sdk-versions.regression.test.ts |
Les cartes ne passent jamais par les applications
Une page où on saisit un numéro de carte devient une cible. Et elle fait entrer toute l’application dans le périmètre des normes de paiement.
Le site ouvre une session Stripe Checkout et y envoie le client. La carte se saisit donc chez Stripe. Le site ne charge aucun script de Stripe, et sa politique de contenu n’autorise l’envoi d’un formulaire qu’à lui-même et à la page de paiement hébergée (form-action, apps/site/next.config.ts).
Le client quitte le site le temps de payer, et la page de paiement a l’apparence de Stripe. C’est le prix à payer pour n’avoir aucune donnée de carte dans le code, dans la base ou dans les journaux.
Deux clés pour un compte
La clé de paiement du site est la plus exposée, puisque le site est ouvert à tout Internet. Avec une clé complète, on pourrait rembourser, lire l’historique des paiements et modifier le compte.
L’ERP a une clé complète ou, de préférence, une clé restreinte à ses propres appels (sessions de paiement et remboursements en écriture, litiges et événements en lecture : la liste exacte est dans le README). Le site n’a qu’une clé restreinte. Elle n’écrit que les sessions de paiement et les coupons, les seuls appels qu’il fait. Son schéma d’environnement refuse de démarrer un déploiement avec une clé complète (apps/site/shared/schemas/env.schema.ts). Les appels du site ont un délai et un nombre de reprises limités (apps/site/shared/server/stripe.ts).
Les droits d’une clé restreinte se règlent dans le tableau de bord de Stripe, pas dans le dépôt. Le code vérifie donc qu’elle est restreinte, mais il ne vérifie pas ce qu’elle autorise. Le site garde le droit d’ouvrir des sessions et d’écrire des coupons. On ne peut pas lui retirer ça sans lui retirer le paiement.
Le montant est celui du serveur
Avec un panier modifié dans le navigateur, ou une session de paiement détournée vers une autre commande, on encaisserait un autre montant que celui qui est dû.
- Le site rapproche le panier du catalogue côté serveur, et il calcule lui-même chaque prix envoyé à Stripe (
apps/site/modules/checkout/lib/checkout-session-params.ts). Aucun prix ne vient du navigateur. - Quand le paiement arrive, l’ERP compare l’identifiant de commande, le montant et la devise de la session à ceux de la commande. S’ils ne correspondent pas, il ferme la commande sans la marquer payée et il lève une alerte pour qu’on rembourse (
reconcileSession,apps/erp/modules/payments/services/webhook-session.service.ts). La devise est écrite une seule fois pour les deux applications (CHECKOUT_CURRENCY,packages/contracts/src/stripe.ts). - L’ouverture d’une session est plafonnée par visiteur (
checkout-rate-limit.regression.test.ts). Chaque session porte la clé d’idempotence de sa commande. Et si une commande identique est déjà lancée, elle est reprise, sans doublon (findCheckoutTwin). Un double clic n’ouvre donc pas deux paiements.
stripe-webhook.service.test.ts rejoue les divergences de rapprochement, et checkout-twin.db.test.ts (site) vérifie sur une vraie base qu’une commande déjà lancée est reprise.
Un remboursement compté une fois
Un remboursement, c’est de l’argent qui sort. Il peut être déclenché par erreur ou par une session restée ouverte, compté deux fois, ou compté alors que Stripe l’a refusé.
Le site ne peut pas rembourser, sa clé ne l’autorise pas. Dans l’ERP, un remboursement part avec son avoir et demande une connexion récente (Comptes et sessions). Qu’il parte de l’ERP ou du tableau de bord de Stripe, il est ensuite rapproché de l’événement que Stripe renvoie. Un remboursement refusé ou annulé n’a pas fait sortir d’argent, donc il ne compte pas dans la caisse (reconcileStripeRefund). Les encaissements et les remboursements sont chaînés et on ne peut pas les retoucher (Droits PostgreSQL).
C’est vérifié par dashboard-refund.db.test.ts (des remboursements faits au tableau de bord et livrés en même temps), par stripe-webhook.service.test.ts, et par monitoring-refunds.db.test.ts pour la veille qui signale un remboursement échoué sans reprise.
Quelqu’un qui a accès au tableau de bord de Stripe peut rembourser sans passer par l’ERP. L’ERP le voit et le compte, mais il ne l’empêche pas. Il faut donc protéger l’accès au compte Stripe comme celui de l’ERP.
Une configuration vérifiée
check-stripe-endpoint.mts contrôle que l’adresse du webhook, la version de l’API et les événements abonnés sont ceux que le code attend (stripe-endpoint.regression.test.ts). La version de l’API est épinglée une seule fois (STRIPE_API_VERSION) et comparée au SDK installé (pinned-sdk-versions.regression.test.ts). Le parcours complet d’un paiement est décrit dans Stripe.
Resend
| Risque | Protection | Ce qui la prouve |
|---|---|---|
| Un e-mail usurpé au nom du magasin | SPF, DKIM et DMARC sur le domaine d’envoi, contrôlés par script | check-email-dns.mts, sending-zone.ts |
| Un texte saisi qui injecte du HTML | la version HTML est tirée du texte, et tout y est échappé | packages/infra/src/email-layout.ts |
| Un e-mail envoyé deux fois, ou jamais | clé d’idempotence par envoi, délai limité, échec certain distingué | packages/infra/src/email.ts |
| Un lien vers un poste de développement | refusé à l’envoi depuis un déploiement | localLinkIn, email-localhost-link.test.ts |
Un domaine qui s’authentifie
Un faux e-mail de confirmation, ou une fausse demande de paiement au nom du magasin, c’est la fraude la plus simple contre ses clients.
Le domaine d’envoi publie les enregistrements avec lesquels les messageries vérifient l’expéditeur : SPF sur le sous-domaine de retour, signature DKIM, politique DMARC. pnpm email:check-dns lit la vraie zone et échoue s’il en manque un. pnpm email:apply-dns les crée (apps/erp/scripts/lib/sending-zone.ts).
Une politique DMARC en surveillance seule (p=none) ne fait rien rejeter. Le script la signale comme un état de départ, à durcir en quarantine puis en reject une fois les rapports lus. Si on durcit trop tôt, les e-mails légitimes d’un expéditeur oublié partent dans les indésirables.
Un e-mail tiré du texte
Un nom, une adresse ou une note saisis par un client se retrouvent dans un e-mail. Si on les interprétait comme du HTML, ils pourraient y glisser un lien trompeur.
Chaque e-mail s’écrit d’abord en texte. Une mise en page unique en tire la version HTML, et elle échappe tout le texte et tous les liens (emailHtml, packages/infra/src/email-layout.ts). Si elle échoue, l’e-mail part en texte seul. Aucun gabarit ne reçoit de HTML brut.
La mise en page est volontairement pauvre : des paragraphes, des lignes de montants, un bouton. C’est pour ça qu’elle est sûre et qu’elle se lit partout.
Les envois en double ou incertains
Un e-mail renvoyé à chaque reprise d’un traitement inquiète le client. Et un e-mail qu’on croit parti alors qu’il ne l’est pas le laisse sans facture.
Chaque envoi porte une clé d’idempotence, et Resend refuse de servir deux fois la même. L’attente a un délai limité (RESEND_TIMEOUT_MS). Le code fait la différence entre un échec certain, qu’on peut retenter, et un envoi peut-être parti (isCertainlyUnsent). Depuis un déploiement, un e-mail qui contiendrait un lien vers un poste de développement est refusé avant l’envoi (localLinkIn). Les étiquettes jointes à l’envoi ne contiennent que sa nature et sa référence technique, sans l’adresse du client.
Les deux applications envoient des e-mails, donc chacune a une clé d’envoi. Resend ne renvoie aucun événement aux applications. Un e-mail rejeté par la messagerie du client se retrouve par sa référence dans la console de Resend, et l’ERP ne le voit pas.