This documentation is currently under development. Certain sections are not yet complete and will be added shortly.
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Sécurité et infrastructure

Consultez le modèle de sécurité de The Wallet Crew, l’isolation des locataires, les environnements et la liste blanche des IP sortantes.

Sécurité et infrastructure

The Wallet Crew est une plateforme Wallet as a Service (WaaS) native du cloud, multi-locataire, hébergée sur Microsoft Azure en Europe. Elle prend en charge la création de cartes et les mises à jour pour Apple Wallet et Google Wallet.

Le trafic public est routé via Cloudflare pour la protection WAF et la limitation de débit. Cloudflare fournit également la mise en cache CDN et la terminaison TLS.

Exemples concrets
  • Un partenaire a besoin de l'IP sortante pour autoriser la livraison des webhooks ou le trafic des connecteurs.

  • Une équipe de sécurité doit confirmer que qa et prod sont isolés.

  • Un déploiement multimarque doit comprendre si les locataires partagent des identifiants Wallet ou des magasins de données.

Pourquoi cette architecture est importante

Les choix d’infrastructure influencent directement les revues de sécurité, la configuration des intégrations et le dépannage opérationnel.

L’isolation des locataires définit qui peut accéder aux données et aux identifiants. L’isolation des environnements définit comment les tests et la production restent séparés. Les IP sortantes sont importantes lorsque les systèmes partenaires restreignent le trafic entrant. Les services gérés réduisent la charge opérationnelle tout en gardant la plateforme évolutive et résiliente.

Vue d’ensemble de la sécurité de la plateforme

The Wallet Crew utilise des services cloud gérés, des contrôles réseau et des contrôles d’accès limités au locataire. La plateforme sépare les données, les identifiants, la configuration et l’accès API du locataire.

Les cartes sont signées avec des identifiants configurés pour le locataire concerné. Les mises à jour d’Apple Wallet et de Google Wallet utilisent leurs services de livraison pris en charge.

High-level architecture diagram showing the edge, application, data, and integration layers of The Wallet Crew
Architecture de haut niveau de la plateforme à travers les couches edge, application, données et intégration.

La plateforme prend en charge les intégrations via des connecteurs, des API et des webhooks. Les capacités sont configurées selon les besoins de chaque locataire.

Locataires

Un locataire est la principale frontière d’isolation dans The Wallet Crew. Toutes les données et opérations de la plateforme sont limitées à un locataire.

  • Données: les cartes, identifiants, métadonnées, événements et analyses restent limités au locataire.

  • Configuration: les modèles de cartes, les paramètres des connecteurs et les règles opérationnelles sont gérés indépendamment pour chaque locataire.

  • Identifiants: les identifiants Wallet sont configurés et gérés dans le périmètre du locataire.

  • Utilisateurs et autorisations: les rôles et autorisations du back-office sont évalués par locataire. Un utilisateur peut être affecté à plusieurs locataires ; chaque affectation à un locataire est indépendante.

  • Appels API: chaque requête API est évaluée dans son contexte de locataire.

La plupart des clients utilisent un seul locataire. Les programmes plus vastes peuvent utiliser des locataires séparés pour les marques, les régions ou d’autres programmes isolés.

Environnements

The Wallet Crew fournit des environnements distincts d’assurance qualité et de production pour les configurations de locataires prises en charge.

Environnement
Objectif
Accès

prod

Opérations clients en direct

Clients, partenaires, utilisateurs finaux

qa

Préproduction et tests d’intégration

Utilisateurs clients et partenaires approuvés

Isolation entre les environnements

Les environnements utilisent des données, des identifiants, des clés API et des enregistrements de cartes distincts. Testez avec qa avant d’utiliser les identifiants de production et les cartes de production.

Portabilité de la configuration

La configuration peut être promue entre les environnements sans copier les données de cartes en production ni l’état du Wallet installé.

Adresses IP sortantes

Lorsque The Wallet Crew effectue des requêtes API sortantes (trafic egress) vers des systèmes partenaires ou des fournisseurs tiers, ces requêtes proviennent d’adresses IP publiques fixes. Ce sont les IP source utilisées par les requêtes quittant The Wallet Crew. Elles apparaissent comme l’IP client ou source dans les journaux de la passerelle, du WAF ou de l’application destinataire.

Ces IP s’appliquent aux appels initiés par The Wallet Crew, tels que les requêtes de connecteur, la livraison des webhooks et tous les rappels serveur à serveur configurés sur le locataire.

Ces IP ne sont nécessaires que lorsque l’accès entrant aux points de terminaison de réception est restreint. C’est courant pour les pare-feu d’entreprise, les passerelles API et les API partenaires privées.

Les appels vers les API The Wallet Crew ne nécessitent généralement aucune mise en liste d’autorisation. Ce trafic sortant provient du réseau appelant.

Ajoutez l’IP de l’environnement utilisé à la liste d’autorisation. Lorsque plusieurs environnements sont utilisés, ajoutez à la liste d’autorisation chaque IP concernée.

  • Production (prod): 20.111.54.22

  • Assurance qualité (qa): 51.11.248.115

Webhooks : ne vous fiez pas uniquement aux IP

La mise en liste d’autorisation des IP réduit le bruit et bloque le trafic non sollicité évident. Elle ne prouve pas que la requête est authentique.

L’authenticité des webhooks doit toujours être vérifiée au niveau de l’application.

The Wallet Crew peut signer les requêtes de webhook à l’aide de x-neostore-signature (HMAC SHA-256). La signature prouve que la charge utile a été envoyée par The Wallet Crew et qu’elle n’a pas été modifiée.

Voir Webhooks pour la configuration et la vérification de la signature.

Gestion des données

The Wallet Crew stocke la configuration et les données opérationnelles des cartes nécessaires au fonctionnement du service. La source de vérité métier reste généralement dans les systèmes de la marque et est accessible via des intégrations. Cela inclut les plateformes CRM, de ticketing, de fidélité et d’automatisation marketing.

Les données personnelles identifiables (PII) ne sont pas stockées par défaut. Lorsque le stockage des PII est requis, il dépend de la configuration du locataire et du cas d’usage.

La gestion des données dépend de la configuration du locataire et du cas d’usage. N’insérez pas de données personnelles inutiles dans les champs des cartes, les identifiants, les charges utiles des webhooks ou les journaux d’intégration.

FAQ

The Wallet Crew utilise-t-il une IP unique pour tout ?

Non. Cela varie selon l’environnement. Certaines intégrations peuvent également avoir des points de terminaison dédiés selon la manière dont elles sont déployées et activées.

Je vois une autre IP source. Que dois-je faire ?

Vérifiez d’abord que la requête atteint le bon environnement. Vérifiez également que les journaux affichent la véritable IP du client. Certaines configurations consignent plutôt les IP de proxy intermédiaires.

Si cela diffère toujours, contactez le support avec le point de terminaison et un horodatage.

The Wallet Crew peut-il se connecter à nos systèmes via un VPN ?

Oui, cela peut être configuré à la demande pour des contraintes réseau strictes. Il s’agit généralement d’une configuration dédiée avec une charge opérationnelle supplémentaire. Cela peut aussi entraîner des coûts supplémentaires d’infrastructure et de support.

La plupart des clients préfèrent plutôt la mise en liste d’autorisation des IP et la signature des requêtes.

Existe-t-il un Security Insurance Plan (SIP) ?

Oui. Le SIP résume la gouvernance de sécurité, les contrôles et les responsabilités liés à l’exploitation de The Wallet Crew. C’est le meilleur point de départ pour les revues de sécurité des fournisseurs et l’évaluation interne des risques.

Le Security Insurance Plan est disponible sur demande.

Existe-t-il une référence d’architecture plus détaillée ?

Une architecture technique complète et une référence de sécurité sont disponibles pour les équipes informatiques des clients et les partenaires techniques. Contactez le support ou l’équipe de compte pour en faire la demande.

Mis à jour