Sécurité

La sécurité est le socle de l'infrastructure SOAMTAR. Cette page décrit les protections en place et ce que vous devez faire de votre côté.

Protection des clés API

Vos clés API (sk_test_…, sk_live_…) sont traitées avec le plus haut niveau de confidentialité :

• Hachage à sens unique : les clés ne sont jamais stockées en clair, seul un hachage HMAC-SHA256 est conservé en base.
• Affichage unique : une clé n'est affichée qu'une seule fois, à sa création. En cas de perte, générez-en une nouvelle.
• Liste d'IP autorisées : vous pouvez restreindre chaque clé à des adresses IP précises pour bloquer tout usage non autorisé.

Intégrité des webhooks

Pour garantir que chaque notification de paiement provient réellement de SOAMTAR :

• Signature HMAC-SHA256 : chaque webhook est signé (X-Soamtar-Signature: t=<timestamp>,v1=<hmac>).
• Protection anti-rejeu : l'horodatage fait partie de la signature. Votre serveur doit rejeter les requêtes de plus de 5 minutes.
• Rotation de secret : pendant une rotation du secret de webhook, SOAMTAR envoie deux signatures (v1 avec le secret actuel, v2 avec le nouveau) dans X-Soamtar-Signature, pour que vous puissiez mettre à jour votre code sans interruption.

Chiffrement et isolation

• En transit : tout le trafic passe en HTTPS (TLS 1.2 ou plus, TLS 1.3 pris en charge).
• Isolation des données : les données de chaque marchand sont isolées ; celles d'un marchand ne peuvent jamais atteindre un autre.
• Protection SSRF : les URL de webhook pointant vers des adresses loopback, des réseaux privés ou des domaines internes sont refusées, pour que nos webhooks ne puissent jamais être retournés contre une infrastructure interne.

Les identifiants du payeur ne vous parviennent jamais

Avec Orange Money Sierra Leone, le client valide le paiement sur son propre téléphone, avec son code PIN Orange Money. Ni SOAMTAR ni vous ne voyez ou ne stockez ce code, et aucune donnée de carte n'est en jeu.

Audit et surveillance

• Journal d'audit non modifiable : chaque changement de statut, accès API et modification de compte est consigné dans un journal d'audit qui ne peut pas être modifié.
• Surveillance continue : les activités suspectes et les tentatives de force brute sont détectées et bloquées.

Signaler une vulnérabilité

Si vous pensez avoir découvert une faille de sécurité, écrivez-nous directement à security@so-amtar.com. Merci de nous laisser un délai raisonnable pour la corriger avant toute publication.