パスキー

パスキーは、パスワードを使用せずにGitLabアカウントにサインインするための安全で便利な方法です。パスキーは、フィッシングに強いサインインを提供するとともに、脆弱なパスワードの脆弱性や認証情報の漏洩からユーザーを保護します。

パスキーの仕組み

パスキーは、公開キーの暗号学的技術を使用してGitLabに安全に認証します。パスキーを作成すると:

• お使いのデバイスは、一意の暗号学的キーペアを生成します。
• 秘密キーはデバイスに安全に保管され、共有されることはありません。
• GitLabは公開キーのみを保存し、その公開キーを使用してユーザーになりすますことはできません。
• サインイン時、お使いのデバイスは生体認証またはPINを使用して秘密キーのロックを解除し、身元を証明します。

このアプローチにより、GitLabサーバーが侵害された場合でも、攻撃者があなたのパスキーを使用してアカウントにアクセスすることはできません。

セキュリティに関する考慮事項

• バックアップ認証方法を維持: リカバリーコードやその他の2FA方法など、アカウントにアクセスするための代替手段を常に維持してください。
• デバイスのセキュリティを維持: デバイスが強力なPIN、パスワード、または生体認証ロックで保護されていることを確認してください。
• 定期的にレビュー: 登録されているパスキーを定期的にレビューし、使用しなくなったデバイスのパスキーは削除してください。
• 共有デバイスを使用しない: 共有デバイスや公共デバイスにパスキーを設定しないでください。

あなたのパスキーを表示

登録されているパスキーに関する情報（パスキー名、デバイスの種類、使用状況の詳細など）を表示するには:

1. 右上隅で、アバターを選択します。
2. プロファイルを編集を選択します。
3. 左側のサイドバーで、アクセス > Password and authenticationを選択します。
4. Passkey sign-inセクションで、あなたのパスキーを表示します。

パスキーを追加

前提条件:

• WebAuthn標準をサポートするデバイスが必要です。
  • デスクトップブラウザ: Chrome、Firefox、Safari、Edge。
  • モバイルデバイス: iOS 16以降、およびAndroid 9以降で、生体認証またはデバイスPINがオンになっているもの。
  • セキュリティキー: FIDO2またはWebAuthnをサポートするハードウェアセキュリティキー。
• パスキーサインインは、グループまたはインスタンスで無効にされていないこと。

パスキーを追加するには:

1. 右上隅で、アバターを選択します。
2. プロファイルを編集を選択します。
3. 左側のサイドバーで、アクセス > Password and authenticationを選択します。
4. Passkey sign-inセクションで、パスキーを追加を選択します。
5. デバイスまたはブラウザのプロンプトに従ってください。
6. 現在のパスワードを入力して、身元を確認します。
7. あなたのパスキーに名前を入力します。
8. パスキーを追加を選択します。

パスキーでサインイン

パスワードの代わりにパスキーを使用してGitLabにサインインするには:

1. GitLabサインインページにアクセスします。

   • GitLab.comでは、https://gitlab.com/users/sign_inにアクセスします。
   • GitLab Self-Managedでは、あなたのインスタンスドメインを使用します。例: https://gitlab.example.com/users/sign_in。

2. 追加のサインインオプションで、パスキーを選択します。

3. 生体認証、顔認識、またはデバイスPINを使用して認証するために、デバイスのプロンプトに従ってください。

2要素認証にパスキーを使用する

アカウントの2要素認証（2FA）を有効にしている場合、パスキーは追加のデフォルト2FAオプションとして利用可能になります。

パスキーを2FA方法として使用するには:

1. GitLabサインインページにアクセスします。

   • GitLab.comでは、https://gitlab.com/users/sign_inにアクセスします。
   • GitLab Self-Managedでは、あなたのインスタンスドメインを使用します。例: https://gitlab.example.com/users/sign_in。

2. あなたのユーザー名とパスワードを入力します。

3. プロンプトが表示されたら、パスキーで認証します。

4. 生体認証、顔認識、またはデバイスPINを使用して認証するために、デバイスのプロンプトに従ってください。

パスキーを削除

デバイスを使用しなくなった場合、または新しいパスキーに置き換えたい場合は、パスキーを削除します。唯一のパスキーを削除すると、GitLabはあなたのアカウントのパスキーサインインも無効にします。

パスキーを削除するには:

1. 右上隅で、アバターを選択します。

2. プロファイルを編集を選択します。

3. 左側のサイドバーで、アクセス > Password and authenticationを選択します。

4. Passkey sign-inセクションで、削除したいパスキーを見つけます。

5. パスキーの横にある削除 ( ) を選択します。

6. 確認ダイアログで、削除を確認します。

   • 複数のパスキーがある場合は、パスキーを削除を選択します。
   • 単一のパスキーがある場合は、パスキーでのサインインを無効にするを選択します。

トラブルシューティング

パスキーの追加に関する問題

パスキーを追加できない場合:

• お使いのデバイスとブラウザがWebAuthnおよび生体認証をサポートしていることを確認してください。
• ブラウザが最新であることを確認してください。
• デバイスにデバイスPIN、フィンガープリント、または顔認識が設定されていることを確認してください。
• 別のブラウザまたはデバイスを使用してみてください。
• デバイスがWebAuthn 2要素認証方法としてすでに登録されているか確認してください。

  • デバイスがWebAuthn 2要素認証方法としてすでに登録されている場合:

    1. 2FA方法からWebAuthnデバイスを削除します。
    2. それをパスキーとして登録します。
    3. 再度2FAを有効にする場合は、バックアップ2FA方式（Authenticatorアプリなど）を設定します。GitLabは、あなたのパスキーをデフォルト2要素認証として自動的に追加します。

パスキーでサインインできない

パスキーを使用してサインインできない場合:

• パスキーの作成に使用したデバイスと同じデバイスを使用していることを確認してください。
• 生体認証またはデバイスPINが機能していることを確認してください。
• ブラウザのキャッシュとCookieをクリアします。
• あなたのバックアップ2FA方式またはパスワードを使用してサインインし、その後にパスキーの設定を確認してください。

デバイスを紛失または交換した場合

デバイスを紛失したり、新しいデバイスを入手したりした場合は、パスワードでサインインし、新しいパスキーを設定してください。

新しいデバイスにパスキーを設定するには:

1. パスワードを使用してGitLabにサインインします。
2. パスキーを2FA方法として使用している場合は、バックアップ方法でサインインします。
3. アカウントの設定から古いパスキーを削除します。
4. 新しいデバイスに新しいパスキーを設定します。

関連トピック

• 2要素認証
• ユーザーパスワード