Как получить телефонные коды GitLab на номер, который контролирует ваша команда

Одноразовый номер или Dedicated Number для GitLab: что выбрать?

Начните с вопроса, как долго проживёт аккаунт.

• OTP Gateway (одноразовый): подходит, когда нужен один код GitLab, например чтобы проверить, что ваша собственная документация по онбордингу или автоматизация регистрации всё ещё работают, либо чтобы подтвердить недолговечный песочничный аккаунт. Вы выбираете страну, получаете один код, и номер после этого исчезает.
• Dedicated Virtual Number (только США и Канада, от $1.95/месяц): лучше подходит для бота или сервисного аккаунта, в который ваша команда будет входить месяцами и где GitLab может снова запросить подтверждение. Номер остаётся за вами, пока вы его продлеваете, входящие SMS приходят в личный кабинет и на ваш вебхук как number.sms_received, а освободить его можно в любой момент.

Одноразовый путь дешевле в расчёте на событие; выделенная линия защищает от будущей блокировки важного аккаунта. Статья одноразовые и выделенные номера разбирает выбор подробнее, а о выделенных линиях рассказано на странице виртуальных номеров.

Когда GitLab просит телефонный номер?

На GitLab.com некоторых недавно зарегистрированных пользователей просят пройти проверку личности, прежде чем они смогут выполнять определённые действия, в первую очередь запускать пайплайны на общих раннерах. Подтверждение телефона кодом из SMS — один из допустимых вариантов. Самостоятельно развёрнутые экземпляры GitLab — другое дело, поскольку их администраторы сами задают правила регистрации.

Двухфакторная аутентификация в GitLab опирается на приложения-аутентификаторы и аппаратные ключи безопасности, а не на SMS, поэтому полученный здесь телефонный код нужен для подтверждения личности при регистрации, а не как постоянный фактор входа.

В каких странах можно получить код GitLab?

Сервис gitlab сейчас маршрутизируется в 197 странах, включая США, Германию, Индию, Бразилию, Польшу, Нидерланды, Канаду, Францию, Японию, Украину, Нигерию, Индонезию, Мексику, Испанию, Турцию и Вьетнам.

Выбирайте страну, которая соответствует человеку или команде, реально владеющим аккаунтом. Подрядчик в Кракове, подтверждающийся польским номером, выглядит логично; аккаунт, зарегистрированный в одном регионе, с номером с совсем другого континента может привлечь лишнее внимание. Для автоматических проверок берите страну, которую должен представлять ваш тест-кейс.

Как вызвать API кода подтверждения GitLab?

Авторизуйтесь на https://otproute.com/api/v1 с помощью Bearer-ключа (префикс or_live_, до 10 на аккаунт) из консоли разработчика.

1. Проверьте наличие через GET /api/v1/prices?country=<id>&service=gitlab; идентификаторы стран берутся из GET /api/v1/countries.
2. Создайте активацию: POST /api/v1/activations с {"service": "gitlab", "country": "de"}, подставив нужную страну.
3. Введите полученный номер на странице верификации GitLab.
4. Получите код по вебхуку или опрашивайте GET /api/v1/activations/{id} каждые несколько секунд. Если попытку нужно прекратить, вызовите POST /api/v1/activations/{id}/cancel.

Добавьте эндпоинты (до пяти) для activation.sms_received, activation.expired и activation.cancelled. Проверяйте X-OTPRoute-Signature (t=<unix>,v1=<hex>): вычислите HMAC-SHA256 от "<t>.<raw body>" с секретом эндпоинта, отклоняйте старые метки времени и делайте обработчик идемпотентным по идентификатору активации, чтобы повторно доставленное событие не вызвало второго действия. Лимит — 300 запросов в минуту; см. документацию.

Без кода? Через личный кабинет проще: выберите GitLab и страну, закажите, вставьте номер в GitLab и смотрите, как код появляется в активации.

Почему код GitLab может не прийти?

GitLab, как и многие платформы, может отклонять некоторые виртуальные номера или не отправлять сообщения на определённые диапазоны. Если SMS не пришло:

• Дождитесь конца 20-минутного окна, прежде чем действовать.
• Попробуйте маршрут другой страны или вернитесь позже, вместо того чтобы быстро создавать новые заказы подряд.
• Убедитесь, что номер введён в форме GitLab с правильным кодом страны.
• Отмените активацию, если она больше не нужна: нет кода — нет списания, деньги автоматически вернутся на баланс.

Ответственное использование OTP Route с GitLab

Соблюдайте условия использования GitLab. Один аккаунт на реального человека или компанию и только те аккаунты, которыми вы вправе управлять. Создание лишних аккаунтов ради бесплатных минут CI или обхода блокировки — это злоупотребление, а не тестирование, и Политика допустимого использования OTP Route это запрещает.

Законные сценарии выглядят так: QA вашего собственного онбординга для инструментов разработчика, выдача общему операционному аккаунту номера для восстановления, который не является чьим-то личным телефоном, или подтверждение аккаунта нового сотрудника, которому не придётся раскрывать личный номер. GitLab — товарный знак его владельца, OTP Route с ним не связан.

Баланс и песочница для SMS-верификации GitLab при тестировании

Подписки нет: пополните предоплаченный баланс в долларах США картой или USDT/USDC и платите за каждый полученный код. На каждое пополнение и покупку номера по электронной почте приходит PDF-счёт. Разработчики, которые встраивают это в пайплайн, могут попросить у поддержки режим песочницы на аккаунте разработки: он возвращает имитированные номера и коды, так что интеграцию можно проверить от начала до конца без трат с баланса.

Частые вопросы

Какой идентификатор сервиса использует GitLab в API OTP Route?

gitlab. При создании активации сочетайте его с идентификатором страны из GET /api/v1/countries.

Можно ли получить OTP GitLab без SIM-карты?

Да. SMS принимает одноразовый номер OTP Gateway, а код вы читаете в личном кабинете или через API.

Принимает ли GitLab любые виртуальные номера для верификации?

Нет. GitLab может отклонять некоторые номера. Если код так и не пришёл, активация возвращается, и позже можно попробовать маршрут другой страны.

Можно ли снова использовать тот же номер, если GitLab потребует повторной проверки?

Не с одноразовым номером. Для аккаунта, который вы сохраните, лучше подходит Dedicated Number в США или Канаде от $1.95/месяц.

Сколько стоит номер для верификации GitLab?

От $0.20 за код в зависимости от страны. Точную цену возвращает GET /api/v1/prices до заказа.

Поддерживается ли двухфакторная защита GitLab через SMS?

Двухфакторный вход GitLab использует приложения-аутентификаторы и ключи безопасности, а не SMS. Телефонный код относится к подтверждению личности при регистрации.

Может ли мой CI-пайплайн тестировать наш онбординг с интеграцией GitLab?

Да. Используйте API с вебхуками или начните в режиме песочницы, а также см. руководство по тестированию SMS OTP в CI.

Названия сервисов являются товарными знаками их владельцев. OTP Route не связан с ними. Используйте номера законно, соблюдайте условия каждого сервиса и нашу Политику допустимого использования.