Como levar os códigos de verificação por telefone do GitLab a um número que sua equipe controla

Número de uso único ou Dedicated Number para o GitLab: qual escolher?

Comece pelo tempo de vida da conta.

• OTP Gateway (uso único): é o certo quando você precisa de um único código do GitLab, por exemplo para conferir se a sua documentação de onboarding ou uma automação de cadastro ainda funcionam, ou para verificar uma conta de sandbox de curta duração. Você escolhe um país, recebe um código e o número deixa de existir depois.
• Dedicated Virtual Number (somente EUA/Canadá, a partir de $1.95/month): mais adequado para um bot ou conta de serviço em que sua equipe voltará a fazer login por meses, nos quais o GitLab pode pedir verificação de novo. O número continua seu enquanto for renovado, as mensagens recebidas chegam ao painel e ao seu webhook como number.sms_received, e você pode liberá-lo a qualquer momento.

O caminho de uso único é mais barato por evento; a linha dedicada evita um bloqueio futuro em uma conta importante. O artigo sobre números temporários versus dedicados pesa isso em mais detalhes, e as linhas dedicadas são descritas na página de números virtuais.

Quando o GitLab pede um número de telefone?

No GitLab.com, alguns usuários recém-registrados precisam concluir uma verificação de identidade antes de poderem fazer certas ações, em especial rodar pipelines em runners compartilhados. A verificação por telefone com código SMS é uma das opções aceitas. Instâncias de GitLab autogerenciadas são outro assunto, já que seus administradores controlam as regras de cadastro.

A autenticação em dois fatores do GitLab depende de apps autenticadores e chaves de segurança físicas, e não de SMS; portanto, o código de telefone que você recebe aqui serve para comprovar identidade no registro, e não como fator recorrente de login.

Quais países podem receber um código do GitLab?

O serviço gitlab tem rota hoje em 197 países, entre eles Estados Unidos, Alemanha, Índia, Brasil, Polônia, Países Baixos, Canadá, França, Japão, Ucrânia, Nigéria, Indonésia, México, Espanha, Turquia e Vietnã.

Escolha o país que corresponde à pessoa ou à equipe que de fato é dona da conta. Um contratado em Cracóvia verificando com um número polonês é coerente; uma conta registrada em uma região com um número de um continente totalmente diferente pode atrair escrutínio extra. Em verificações automatizadas, combine com o país que o seu caso de teste deve representar.

Como chamo a API de código de verificação do GitLab?

Autentique-se em https://otproute.com/api/v1 com uma chave Bearer (prefixo or_live_, até 10 por conta) do Developer console.

1. Confirme a disponibilidade com GET /api/v1/prices?country=<id>&service=gitlab; os ids de país vêm de GET /api/v1/countries.
2. Crie a ativação: POST /api/v1/activations com {"service": "gitlab", "country": "de"}, trocando pelo país de que você precisa.
3. Digite o número retornado na página de verificação do GitLab.
4. Receba o código por webhook ou faça polling em GET /api/v1/activations/{id} a cada poucos segundos. Se abandonar a tentativa, chame POST /api/v1/activations/{id}/cancel.

Adicione endpoints (até cinco) para activation.sms_received, activation.expired e activation.cancelled. Valide X-OTPRoute-Signature (t=<unix>,v1=<hex>) calculando HMAC-SHA256 sobre "<t>.<raw body>" com o segredo do endpoint, rejeite timestamps antigos e mantenha o handler idempotente pelo id de ativação, para que um evento reenviado não dispare uma segunda ação. O limite é de 300 requisições por minuto; veja a documentação.

Sem programar? O caminho do painel é mais simples: escolha GitLab e um país, faça o pedido, cole o número no GitLab e veja o código aparecer na ativação.

Por que um código do GitLab pode não chegar?

O GitLab, como muitas plataformas, pode recusar alguns números virtuais ou não enviar para determinadas faixas. Quando o SMS não vem:

• Deixe a janela de 20 minutos terminar antes de reagir.
• Tente outra rota de país, ou volte mais tarde, em vez de fazer novos pedidos em um laço rápido.
• Confirme que o número foi digitado com o código de país correto no formulário do GitLab.
• Cancele a ativação se já terminou; sem código não há cobrança, e o dinheiro volta automaticamente para a sua carteira.

Como usar a OTP Route com o GitLab de forma responsável

Siga os termos de serviço do GitLab. Uma conta por pessoa real ou empresa, e apenas contas que você tem direito de operar. Criar contas extras para juntar minutos de CI gratuitos ou para contornar uma suspensão é abuso, não teste, e a Política de Uso Aceitável da OTP Route o proíbe.

Os usos legítimos são, por exemplo, QA no onboarding da sua própria ferramenta para desenvolvedores, dar a uma conta operacional compartilhada um número de recuperação que não seja o telefone pessoal de alguém ou verificar a conta de um novo contratado que não deveria precisar expor um número privado. GitLab é marca registrada de seu titular, e a OTP Route não é afiliada a ele.

Carteira e sandbox para a verificação por SMS do GitLab em testes

Não há assinatura: abasteça uma carteira pré-paga em USD por cartão ou USDT/USDC e pague por código recebido. Cada recarga e cada compra de número gera uma fatura em PDF por e-mail. Desenvolvedores que integram isso a um pipeline podem pedir ao suporte o modo sandbox em uma conta de desenvolvimento, que devolve números e códigos simulados para que a integração seja testada de ponta a ponta sem gasto da carteira.

Perguntas frequentes

Qual id de serviço o GitLab usa na API da OTP Route?

É gitlab. Combine-o com um id de país de GET /api/v1/countries ao criar uma ativação.

Posso receber um OTP do GitLab sem chip?

Sim. Um número avulso do OTP Gateway recebe o SMS, e você lê o código no painel ou pela API.

O GitLab aceita qualquer número virtual na verificação?

Não. O GitLab pode rejeitar alguns números. Se o código nunca chegar, a ativação é reembolsada e você pode tentar outra rota de país mais tarde.

Posso usar o mesmo número de novo se o GitLab pedir uma nova verificação?

Não com um número de uso único. Para uma conta que você vai manter, um Dedicated Number nos EUA ou no Canadá, a partir de $1.95/month, é a melhor escolha.

Quanto custa um número de verificação para o GitLab?

A partir de $0.20 por código, conforme o país. O preço exato vem de GET /api/v1/prices antes de você fazer o pedido.

O GitLab oferece dois fatores por SMS?

O login em dois fatores do GitLab usa apps autenticadores e chaves de segurança, e não SMS. O código de telefone cobre a verificação de identidade no cadastro.

Meu pipeline de CI pode testar o nosso onboarding integrado ao GitLab?

Sim. Use a API com webhooks ou comece em modo sandbox, e veja o guia de testes de OTP por SMS em pipelines de CI.

Os nomes dos serviços são marcas registradas de seus respectivos proprietários. A OTP Route não é afiliada a eles. Use os números de forma lícita e siga os termos de cada serviço e nossa Política de Uso Aceitável.