チームが管理する番号で GitLab の電話認証コードを受け取る

GitLab はワンタイム番号と Dedicated Number のどちらを選ぶべきですか？

まず、アカウントがどのくらいの期間使われるかを考えてください。

• OTP Gateway（ワンタイム）: 自社のオンボーディング資料やサインアップの自動化がまだ動くかの確認、または短期間のサンドボックスアカウントの認証など、GitLab のコードが 1 回だけ必要な場合に適しています。国を選んでコードを 1 つ受け取ると、その番号は使えなくなります。
• Dedicated Virtual Number（米国・カナダのみ、1 か月 $1.95 から）: チームが数か月にわたって再びログインするボットやサービスアカウントで、GitLab が再び認証を求めるかもしれない場合に向いています。更新を続ける限り番号は自分のものとして保持され、受信テキストはダッシュボードと number.sms_received として Webhook に届き、いつでも解約できます。

1 回あたりのコストは、ワンタイムのほうが安く済みます。一方、重要なアカウントでは、専用回線が将来のロックアウトを防ぎます。詳しい比較は一時的な番号と専用番号の違いの記事に、専用回線の説明は仮想番号のページにあります。

GitLab はいつ電話番号を求めますか？

GitLab.com では、新しく登録した一部のユーザーが、特に共有ランナーでのパイプライン実行といった特定の操作をする前に、本人確認を完了するよう求められます。SMS コードによる電話認証は、受け付けられる方法の 1 つです。セルフマネージドの GitLab インスタンスは別で、サインアップのルールは管理者自身が管理します。

GitLab の 2 要素認証は、SMS ではなく認証アプリやハードウェアセキュリティキーに依存しています。そのため、ここで受け取る電話コードは、登録時の本人確認のためのもので、継続的なログイン要素ではありません。

GitLab のコードはどの国で受信できますか？

gitlab サービスは、現在 197 か国でルーティングされており、アメリカ、ドイツ、インド、ブラジル、ポーランド、オランダ、カナダ、フランス、日本、ウクライナ、ナイジェリア、インドネシア、メキシコ、スペイン、トルコ、ベトナムなどが含まれます。

アカウントを実際に所有する個人またはチームに合う国を選んでください。クラクフにいるコントラクターがポーランドの番号で認証するのは筋が通っていますが、ある地域で登録したアカウントに、まったく別の大陸の番号を使うと、追加の確認を招くことがあります。自動チェックでは、テストケースが表す国に合わせてください。

GitLab 認証コード API はどのように呼び出しますか？

開発者コンソールで発行した Bearer キー（プレフィックス or_live_、1 アカウントにつき最大 10 個）で https://otproute.com/api/v1 に対して認証します。

1. GET /api/v1/prices?country=<id>&service=gitlab で提供状況を確認します。国 ID は GET /api/v1/countries から取得します。
2. アクティベーションを作成します: POST /api/v1/activations に {"service": "gitlab", "country": "de"} を送ります。国は必要なものに置き換えてください。
3. 返された番号を GitLab の認証ページに入力します。
4. Webhook でコードを受け取るか、数秒ごとに GET /api/v1/activations/{id} をポーリングします。試行を中止する場合は POST /api/v1/activations/{id}/cancel を呼び出します。

activation.sms_received、activation.expired、activation.cancelled のエンドポイント（最大 5 つ）を追加します。エンドポイントのシークレットで "<t>.<raw body>" に対する HMAC-SHA256 を計算して X-OTPRoute-Signature（t=<unix>,v1=<hex>）を検証し、古いタイムスタンプを拒否してください。また、ハンドラーはアクティベーション ID に対して冪等にし、再配信されたイベントで 2 回目のアクションが起きないようにします。上限は 1 分あたり 300 リクエストです。詳しくはドキュメントをご覧ください。

コードを書かない場合は、ダッシュボードのほうが簡単です。GitLab と国を選んで注文し、番号を GitLab に貼り付け、アクティベーションにコードが表示されるのを待ちます。

GitLab のコードが届かないのはなぜですか？

GitLab も多くのプラットフォームと同様に、一部の仮想番号を拒否したり、特定の番号帯への送信を行わなかったりすることがあります。SMS が届かないときは次のとおりにしてください。

• 対応する前に、20 分のウィンドウが終わるのを待ちます。
• 新しい注文を短い間隔で繰り返すのではなく、別の国のルートを試すか、時間を置いて戻ってきます。
• GitLab のフォームに、番号が正しい国コードで入力されていることを確認します。
• 用が済んだら、アクティベーションをキャンセルします。コードが届かなければ課金されず、お金は自動的にウォレットに戻ります。

OTP Route を GitLab で責任を持って使う

GitLab の利用規約を守ってください。アカウントは実在する 1 人または 1 社につき 1 つとし、運用する権利のあるアカウントに限ります。無料の CI 時間を集めたり、停止処分を回避したりするためにアカウントを追加で作成することは、テストではなく不正利用であり、OTP Route の Acceptable Use Policy で禁止されています。

正当な用途の例は、自社の開発者向けツールのオンボーディングの QA、共有の運用アカウントに個人の電話ではない復旧用番号を持たせること、あるいは個人の番号を公開したくない新入社員のアカウントを認証することです。GitLab は所有者の商標であり、OTP Route は GitLab と提携していません。

GitLab の SMS 認証テストのためのウォレットとサンドボックス

サブスクリプションはありません。前払いの USD ウォレットをカードまたは USDT/USDC でチャージし、受信したコードごとに支払います。チャージと番号の購入のたびに、PDF の請求書がメールで届きます。パイプラインに組み込む開発者は、サポートに依頼して開発用アカウントをサンドボックスモードにでき、ウォレットの資金を使わずに連携をエンドツーエンドで試せるよう、シミュレートされた番号とコードが返されます。

よくある質問

OTP Route の API で GitLab が使うサービス ID は何ですか？

gitlab です。アクティベーションを作成するときに、GET /api/v1/countries で取得した国 ID と組み合わせます。

SIM カードなしで GitLab の OTP を受け取れますか？

はい。OTP Gateway のワンタイム番号が SMS を受信し、コードはダッシュボードまたは API で確認できます。

GitLab の認証では、すべての仮想番号が受け付けられますか？

いいえ。GitLab が一部の番号を拒否することがあります。コードが届かなければアクティベーションは返金されるので、あとで別の国のルートを試せます。

GitLab が再認証を求めたら、同じ番号をもう一度使えますか？

ワンタイム番号では使えません。継続して使うアカウントには、米国またはカナダの Dedicated Number（1 か月 $1.95 から）が適しています。

GitLab の認証用番号はいくらですか？

1 コード $0.20 からで、国によって異なります。正確な料金は、注文する前に GET /api/v1/prices で確認できます。

GitLab は SMS による 2 要素認証に対応していますか？

GitLab の 2 要素ログインは、SMS ではなく認証アプリとセキュリティキーを使います。電話コードは、サインアップ時の本人確認を担います。

自社の GitLab 連携のオンボーディングを CI パイプラインでテストできますか？

はい。Webhook を使った API を利用するか、サンドボックスモードから始めてください。CI での SMS OTP テストのガイドも参照してください。

サービス名はそれぞれの所有者の商標です。OTP Route はこれらの企業と提携していません。番号は合法的にご利用いただき、各サービスの利用規約および当社の利用規定に従ってください。