Faire arriver les codes de vérification téléphonique GitLab sur un numéro que votre équipe contrôle

Numéro à usage unique ou Dedicated Number pour GitLab : lequel choisir ?

Commencez par la durée de vie du compte.

• OTP Gateway (usage unique) : adapté lorsque vous avez besoin d'un seul code GitLab, par exemple pour vérifier que votre propre documentation d'intégration ou une automatisation d'inscription fonctionne toujours, ou pour valider un compte sandbox de courte durée. Vous choisissez un pays, recevez un code, puis le numéro disparaît.
• Dedicated Virtual Number (États-Unis/Canada uniquement, dès $1.95/mois) : mieux adapté à un bot ou à un compte de service sur lequel votre équipe se reconnectera pendant des mois, et où GitLab pourrait redemander une vérification. Le numéro reste à vous tant qu'il est renouvelé, les SMS entrants arrivent dans le tableau de bord et sur votre webhook sous la forme number.sms_received, et vous pouvez le libérer à tout moment.

La voie à usage unique coûte moins cher par événement ; la ligne dédiée évite un futur blocage sur un compte qui compte. L'article numéros temporaires et numéros dédiés détaille ce choix, et les lignes dédiées sont présentées sur la page numéros virtuels.

Quand GitLab demande-t-il un numéro de téléphone GitLab ?

Sur GitLab.com, certains utilisateurs nouvellement inscrits doivent effectuer une vérification d'identité avant de pouvoir accomplir certaines actions, notamment exécuter des pipelines sur des runners partagés. La vérification téléphonique par code SMS fait partie des options acceptées. Les instances GitLab auto-hébergées sont un autre cas, puisque leurs administrateurs définissent eux-mêmes les règles d'inscription.

L'authentification à deux facteurs de GitLab repose sur des applications d'authentification et des clés de sécurité matérielles plutôt que sur le SMS : le code téléphonique reçu ici sert donc à prouver l'identité à l'inscription, pas de facteur de connexion récurrent.

Quels pays peuvent recevoir un code GitLab ?

Le service gitlab est actuellement routé dans 197 pays, dont les États-Unis, l'Allemagne, l'Inde, le Brésil, la Pologne, les Pays-Bas, le Canada, la France, le Japon, l'Ukraine, le Nigeria, l'Indonésie, le Mexique, l'Espagne, la Turquie et le Vietnam.

Choisissez le pays qui correspond à la personne ou à l'équipe qui possède réellement le compte. Un prestataire à Cracovie qui se vérifie avec un numéro polonais est cohérent ; un compte enregistré dans une région avec un numéro d'un tout autre continent peut attirer un examen supplémentaire. Pour des vérifications automatisées, alignez-vous sur le pays que votre cas de test est censé représenter.

Comment appeler l'API de code de vérification GitLab ?

Authentifiez-vous auprès de https://otproute.com/api/v1 avec une clé Bearer (préfixe or_live_, jusqu'à 10 par compte) issue de la console développeur.

1. Confirmez la disponibilité avec GET /api/v1/prices?country=<id>&service=gitlab ; les identifiants de pays viennent de GET /api/v1/countries.
2. Créez l'activation : POST /api/v1/activations avec {"service": "gitlab", "country": "de"}, en remplaçant par le pays dont vous avez besoin.
3. Saisissez le numéro renvoyé sur la page de vérification de GitLab.
4. Recevez le code par webhook, ou interrogez GET /api/v1/activations/{id} toutes les quelques secondes. Si vous abandonnez la tentative, appelez POST /api/v1/activations/{id}/cancel.

Ajoutez des endpoints (jusqu'à cinq) pour activation.sms_received, activation.expired et activation.cancelled. Validez X-OTPRoute-Signature (t=<unix>,v1=<hex>) en calculant un HMAC-SHA256 sur "<t>.<raw body>" avec le secret de l'endpoint, rejetez les horodatages anciens et gardez le gestionnaire idempotent sur l'identifiant d'activation, pour qu'un événement renvoyé ne déclenche pas une seconde action. La limite est de 300 requêtes par minute ; voir la documentation.

Pas de code à écrire ? Le chemin du tableau de bord est plus simple : choisissez GitLab et un pays, commandez, collez le numéro dans GitLab, et regardez le code apparaître sur l'activation.

Pourquoi un code GitLab pourrait-il ne pas arriver ?

GitLab, comme beaucoup de plateformes, peut refuser certains numéros virtuels ou ne pas envoyer vers certaines plages. Quand le SMS ne vient pas :

• Laissez la fenêtre de 20 minutes se terminer avant de réagir.
• Essayez une autre route de pays, ou revenez plus tard, au lieu de passer de nouvelles commandes en boucle rapide.
• Assurez-vous que le numéro a été saisi avec le bon indicatif de pays dans le formulaire de GitLab.
• Annulez l'activation si vous avez terminé ; pas de code, pas de frais, et l'argent retourne automatiquement sur votre portefeuille.

Utiliser OTP Route avec GitLab de façon responsable

Respectez les conditions d'utilisation de GitLab. Un compte par personne réelle ou par entreprise, et uniquement des comptes que vous avez le droit d'exploiter. Créer des comptes supplémentaires pour récupérer des minutes de CI gratuites ou pour contourner une suspension relève de l'abus, pas du test, et la politique d'utilisation acceptable d'OTP Route l'interdit.

Les usages légitimes ressemblent à ceci : QA de l'intégration de votre propre outil pour développeurs, attribution à un compte d'exploitation partagé d'un numéro de récupération qui n'est pas le téléphone personnel de quelqu'un, ou vérification du compte d'une nouvelle recrue qui ne devrait pas avoir à exposer un numéro privé. GitLab est une marque de son propriétaire, et OTP Route n'est pas affilié à celui-ci.

Portefeuille et sandbox pour la vérification SMS GitLab en test

Il n'y a pas d'abonnement : alimentez un portefeuille prépayé en USD par carte ou en USDT/USDC et payez par code reçu. Chaque recharge et chaque achat de numéro déclenche une facture PDF par e-mail. Les développeurs qui intègrent cela dans un pipeline peuvent demander au support le mode sandbox sur un compte de développement, qui renvoie des numéros et des codes simulés afin de tester l'intégration de bout en bout sans dépenser de fonds du portefeuille.

Questions fréquentes

Quel identifiant de service GitLab utilise-t-il dans l'API OTP Route ?

C'est gitlab. Associez-le à un identifiant de pays issu de GET /api/v1/countries lorsque vous créez une activation.

Puis-je recevoir un OTP GitLab sans carte SIM ?

Oui. Un numéro OTP Gateway à usage unique reçoit le SMS, et vous lisez le code dans le tableau de bord ou depuis l'API.

GitLab accepte-t-il tous les numéros virtuels pour sa vérification ?

Non. GitLab peut rejeter certains numéros. Si le code n'arrive jamais, l'activation est remboursée et vous pouvez essayer une autre route de pays plus tard.

Puis-je réutiliser le même numéro si GitLab me demande de me revérifier ?

Pas avec un numéro à usage unique. Pour un compte que vous conserverez, un Dedicated Number aux États-Unis ou au Canada à partir de $1.95/mois est le meilleur choix.

Combien coûte un numéro de vérification GitLab ?

À partir de $0.20 par code, selon le pays. Le prix exact provient de GET /api/v1/prices avant de commander.

Le SMS est-il pris en charge pour l'authentification à deux facteurs de GitLab ?

L'authentification à deux facteurs de GitLab utilise des applications d'authentification et des clés de sécurité, pas le SMS. Le code téléphonique sert à la vérification d'identité à l'inscription.

Mon pipeline CI peut-il tester notre propre intégration avec GitLab ?

Oui. Utilisez l'API avec des webhooks, ou commencez en mode sandbox, et consultez le guide tests OTP par SMS en CI.

Les noms de services sont des marques déposées de leurs propriétaires respectifs. OTP Route n'est affilié à aucun d'entre eux. Utilisez les numéros de manière licite et respectez les conditions de chaque service ainsi que notre Politique d'utilisation acceptable.