Cómo recibir los códigos de verificación telefónica de GitLab en un número que controla tu equipo

Número de un solo uso o número dedicado para GitLab: ¿cuál elegir?

Empieza por cuánto va a vivir la cuenta.

• OTP Gateway (un solo uso): adecuado cuando necesitas un único código de GitLab, por ejemplo para comprobar que tu documentación de onboarding o una automatización de registro siguen funcionando, o para verificar una cuenta sandbox de corta vida. Eliges un país, recibes un código y el número desaparece después.
• Número virtual dedicado (solo EE. UU./Canadá, desde $1.95/month): encaja mejor con un bot o una cuenta de servicio en la que tu equipo volverá a iniciar sesión durante meses y donde GitLab podría pedir de nuevo la verificación. El número sigue siendo tuyo mientras se renueva, los mensajes entrantes llegan al panel y a tu webhook como number.sms_received, y puedes liberarlo cuando quieras.

La vía de un solo uso es más barata por evento; la línea dedicada evita un bloqueo futuro en una cuenta que importa. El artículo sobre números temporales frente a dedicados lo analiza con más detalle, y las líneas dedicadas se describen en la página de números virtuales.

¿Cuándo pide GitLab un número de teléfono?

En GitLab.com, a algunos usuarios recién registrados se les pide completar una verificación de identidad antes de poder hacer ciertas cosas, en particular ejecutar pipelines en runners compartidos. La verificación telefónica mediante un código SMS es una de las opciones aceptadas. Las instancias de GitLab autogestionadas son otra cosa, ya que sus administradores controlan por sí mismos las reglas de registro.

La autenticación de dos factores en GitLab se basa en apps de autenticación y llaves de seguridad físicas en lugar de SMS, así que el código telefónico que recibes aquí sirve para demostrar la identidad en el registro, no es un factor recurrente de inicio de sesión.

¿Qué países pueden recibir un código de GitLab?

El servicio gitlab está enrutado actualmente en 197 países, entre ellos Estados Unidos, Alemania, India, Brasil, Polonia, Países Bajos, Canadá, Francia, Japón, Ucrania, Nigeria, Indonesia, México, España, Turquía y Vietnam.

Elige el país que corresponda a la persona o al equipo que realmente es titular de la cuenta. Un contratista en Cracovia que verifica con un número polaco es coherente; una cuenta registrada desde una región con un número de un continente completamente distinto puede llamar más la atención. Para las comprobaciones automatizadas, ajusta el país al que debe representar tu caso de prueba.

¿Cómo llamo a la API de códigos de verificación de GitLab?

Autentícate en https://otproute.com/api/v1 con una clave Bearer (prefijo or_live_, hasta 10 por cuenta) de la consola de desarrollador.

1. Confirma la disponibilidad con GET /api/v1/prices?country=<id>&service=gitlab; los ids de país salen de GET /api/v1/countries.
2. Crea la activación: POST /api/v1/activations con {"service": "gitlab", "country": "de"}, cambiando por el país que necesites.
3. Introduce el número devuelto en la página de verificación de GitLab.
4. Recibe el código por webhook, o haz polling a GET /api/v1/activations/{id} cada pocos segundos. Si abandonas el intento, llama a POST /api/v1/activations/{id}/cancel.

Añade endpoints (hasta cinco) para activation.sms_received, activation.expired y activation.cancelled. Valida X-OTPRoute-Signature (t=<unix>,v1=<hex>) calculando HMAC-SHA256 sobre "<t>.<raw body>" con el secreto del endpoint, rechaza las marcas de tiempo antiguas y mantén el handler idempotente sobre el id de activación para que un evento reenviado no desencadene una segunda acción. El límite es de 300 solicitudes por minuto; consulta la documentación.

¿Prefieres no escribir código? La vía del panel es más sencilla: elige GitLab y un país, haz el pedido, pega el número en GitLab y mira cómo aparece el código en la activación.

¿Por qué podría no llegar un código de GitLab?

GitLab, como muchas plataformas, puede rechazar algunos números virtuales o no enviar a determinados rangos. Cuando el SMS no llega:

• Deja que termine la ventana de 20 minutos antes de reaccionar.
• Prueba con otra ruta de país, o vuelve más tarde, en lugar de hacer pedidos nuevos en un bucle rápido.
• Asegúrate de que el número se introdujo con el prefijo de país correcto en el formulario de GitLab.
• Cancela la activación si ya has terminado; sin código no hay cargo, y el dinero vuelve automáticamente a tu monedero.

Uso responsable de OTP Route con GitLab

Cumple las condiciones de servicio de GitLab. Una cuenta por persona real o empresa, y solo cuentas que tengas derecho a operar. Crear cuentas adicionales para acumular minutos de CI gratuitos o para sortear una suspensión es abuso, no pruebas, y la Política de Uso Aceptable de OTP Route lo prohíbe.

Los usos legítimos son, por ejemplo, QA sobre el onboarding de tu propia herramienta para desarrolladores, dar a una cuenta de operaciones compartida un número de recuperación que no sea el teléfono personal de alguien, o verificar la cuenta de una persona recién contratada que no debería tener que exponer un número privado. GitLab es una marca registrada de su titular y OTP Route no está afiliado a ella.

Monedero y sandbox para la verificación por SMS de GitLab en pruebas

No hay suscripción: recarga un monedero prepago en USD con tarjeta o con USDT/USDC y paga por cada código recibido. Cada recarga y cada compra de número genera una factura en PDF por correo. Los desarrolladores que integren esto en un pipeline pueden pedir a soporte el modo sandbox en una cuenta de desarrollo, que devuelve números y códigos simulados para ejercitar la integración de extremo a extremo sin gastar fondos del monedero.

Preguntas frecuentes

¿Qué id de servicio usa GitLab en la API de OTP Route?

Es gitlab. Combínalo con un id de país de GET /api/v1/countries al crear una activación.

¿Puedo recibir un OTP de GitLab sin tarjeta SIM?

Sí. Un número de un solo uso del OTP Gateway recibe el SMS y lees el código en el panel o desde la API.

¿GitLab acepta todos los números virtuales para su verificación?

No. GitLab puede rechazar algunos números. Si el código nunca llega, la activación se reembolsa y puedes probar con otra ruta de país más tarde.

¿Puedo reutilizar el mismo número si GitLab me pide volver a verificar?

No con un número de un solo uso. Para una cuenta que vayas a conservar, un número dedicado en EE. UU. o Canadá desde $1.95/month es la mejor opción.

¿Cuánto cuesta un número de verificación para GitLab?

Desde $0.20 por código, según el país. El precio exacto lo devuelve GET /api/v1/prices antes de hacer el pedido.

¿GitLab admite doble factor por SMS?

El inicio de sesión con doble factor de GitLab usa apps de autenticación y llaves de seguridad, no SMS. El código telefónico cubre la verificación de identidad en el registro.

¿Puede mi pipeline de CI probar nuestro onboarding integrado con GitLab?

Sí. Usa la API con webhooks, o empieza en modo sandbox, y consulta la guía de pruebas de OTP por SMS en CI.

Los nombres de los servicios son marcas registradas de sus respectivos propietarios. OTP Route no está afiliado a ellos. Usa los números de forma lícita y respeta las condiciones de cada servicio y nuestra Política de Uso Aceptable.