| layout | title | url | previous | next |
|---|---|---|---|---|
default |
Setting up WebAuthn / Passkey multi-factor authentication |
/setting-up-webauthn-mfa |
/setting-up-multifactor-authentication |
/setting-up-otp-mfa |
Setting up WebAuthn multi-factor authentication
Using WebAuthn for multi-factor authentication (MFA) is the best way to protect your account from takeover. It's stronger and easier to use than OTP codes.
To use WebAuthn, you will need at least one of the following:
- A hardware security token (sometimes called a security key), such as a YubiKey or Google Titan Key.
- A built-in hardware device, such as TouchID, FaceID or Windows Hello.
- A browser that supports the "Passkey" standard. Up-to-date versions of Chrome, Safari, Firefox and Edge all support this standard.
Unfortunately implementations of these experiences vary, so we can't show the exact details, but we will point out the steps that are specific to using RubyGems.org.
- Login to rubygems.org using your existing account and go to the edit settings page.
- In the "Multi-factor Authentication" section you will see two options:
"Authentication App" and "Security Device". Under "Security Device" you
will see a field for "Nickname".
{:class="t-img"} - Choose a name for your device. Use something that helps you remember which device you used. For example, you might use nicknames like "Mary's YubiKey" or "Naveen's iPhone".
- Below the Nickname field, click Register device.
- Your browser will prompt you to set up a device or a Passkey. This experience varies according to browser. Chrome tries to set up a Passkey that it manages, though you can select "Try another way" to use a USB hardware token. Safari asks you to enable iCloud Keychain, but you can click "Other Options" to use a hardware token. Other browsers may vary.
- You will now see your security device on the screen above the Nickname field.
