L’inscription par téléphone est courante en Asie : un numéro à 11 chiffres et un code SMS en Chine, un numéro mobile et un code à usage unique en Inde et au Pakistan, et en Indonésie souvent un code par WhatsApp. Pour la tester, il vous faut des codes qui arrivent à chaque fois, rapidement, pour des numéros que vous contrôlez. Les vrais SMS ne vous offrent rien de tout cela de façon fiable.
Pourquoi les vrais SMS sont difficiles à tester
- Enregistrement avant l’envoi. L’Inde exige que les entreprises enregistrent leur identifiant d’expéditeur et leurs modèles de messages (DLT) avant que les SMS soient délivrés. En Chine continentale, les signatures et modèles de SMS sont approuvés par le fournisseur avant utilisation.
- Cartes SIM nominatives. En Chine et au Pakistan, une carte SIM est enregistrée sur la pièce d’identité d’une personne : une équipe ne peut donc pas simplement acheter un lot de numéros de test.
- Coût et délais. Chaque exécution de test paie les messages, et la livraison peut prendre des secondes ou des minutes.
- Numéros virtuels refusés. Les services de vérification savent distinguer un numéro virtuel (VoIP) d’un numéro mobile, et beaucoup d’apps refusent les numéros virtuels avant d’envoyer un code, car les bots les utilisent. Les services de SMS en ligne fournissent justement ceux-là.
Option 1 : les numéros de test de votre fournisseur d’authentification
La plupart des fournisseurs d’authentification permettent d’enregistrer des numéros de test qui acceptent un code fixe et n’envoient jamais de message :
- Firebase Authentication : ajoutez jusqu’à 10 numéros fictifs, chacun avec un code à 6 chiffres, sous Phone numbers for testing dans les réglages du fournisseur Phone. Aucun SMS n’est envoyé.
- Supabase Auth : ajoutez des numéros de test et leurs codes sous Authentication → Sign In / Providers → Phone, dans Test Phone Numbers and OTPs, avec une date d’expiration. Un fournisseur SMS doit tout de même être configuré, mais aucun SMS n’est envoyé.
- Clerk : en développement, les numéros de +1 (XXX) 555-0100 à 555-0199 acceptent le code 424242.
Gardez-les dans les projets de développement et de préproduction. Un projet de production ne doit en avoir aucun.
Option 2 : un code de mode test dans votre propre backend
Si vous envoyez vous-même les SMS, un mode test avec un code fixe est la réponse habituelle. En Chine, on parle souvent de code universel (万能验证码). Mal fait, il ouvre l’accès à tous les comptes. Bien fait :
- Limitez-le aux numéros listés. Le code fixe ne fonctionne que pour les numéros d’une courte liste de test, jamais pour n’importe quel numéro.
- Activez-le par réglage, désactivé par défaut. Lisez-le depuis une variable d’environnement que seuls le développement et la préproduction définissent.
- Excluez-le des builds de release. Dans une app mobile, placez ce code derrière un flag de build que le build de release n’inclut pas. Vérifiez que le build de release refuse le code avant sa publication.
- Vérifiez que la production le refuse. Ajoutez à vos vérifications de release un test qui se connecte en production avec un numéro de test et le code fixe, et qui attend un échec.
Ce qu’il faut tester dans le parcours
- Un code erroné est refusé, et le nombre d’essais est limité.
- Un code expiré est refusé, et une nouvelle demande en envoie un nouveau.
- Après un renvoi, un ancien code fonctionne ou non, selon votre choix, et l’app indique lequel.
- Le numéro est stocké dans un seul format (avec l’indicatif pays) quelle que soit la saisie : espaces, 0 initial ou +86.
- Une personne qui s’inscrit à nouveau avec le même numéro est redirigée vers la connexion, sans recevoir un second compte.
- Si l’app demande aussi une adresse e-mail, l’e-mail de confirmation arrive et fonctionne. Proxy Mail QA couvre cette étape : créez une adresse, inscrivez-vous avec, et attendez le code ou le lien.