-
Notifications
You must be signed in to change notification settings - Fork 226
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Create two-factor-authentication.md (#341)
* Create two-factor-authentication Initial version of 2FA authentication page * Add media for two-factor-authentication page Add media for two-factor-authentication page * Rename two-factor-authentication to two-factor-authentication.md Rename page * Update two-factor-authentication.md Fix filename * Update config.ts Add link to 2FA authentication page in the Sidebar
- Loading branch information
Showing
7 changed files
with
51 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,50 @@ | ||
# Two-Factor Authentication (2FA) | ||
|
||
One of the best ways to protect your Kagi account is to set up two-factor authentication (2FA), this allows you to use an authenticator app to generate a verification code that will be requested every time you sign in to your account. | ||
|
||
In the event that your account password was compromised, attackers wouldn’t be able to log in to your account as they would be required to enter the verification code generated by your authenticator app. | ||
|
||
## Authenticator Apps | ||
|
||
Kagi’s 2FA implementation is compatible with most authenticator apps, some options are provided below: | ||
iOS: | ||
- [Raivo Authenticator](https://apps.apple.com/us/app/raivo-authenticator/id1459042137) | ||
- [Google Authenticator](https://apps.apple.com/us/app/google-authenticator/id388497605) | ||
- [Microsoft Authenticator](https://apps.apple.com/us/app/microsoft-authenticator/id983156458) | ||
|
||
Android: | ||
- [Aegis Authenticator](https://play.google.com/store/apps/details?id=com.beemdevelopment.aegis&hl=en&gl=US) | ||
- [Google Authenticator](https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2&hl=en&gl=US) | ||
- [Microsoft Authenticator](https://play.google.com/store/apps/details?id=com.azure.authenticator&hl=en&gl=US) | ||
|
||
Some password managers such as 1Password and Bitwarden also have a 2FA authenticator built-in. | ||
|
||
## Setting up 2FA authentication | ||
|
||
If you want to set up 2FA authentication in your Kagi account, first visit the [Account Settings](https://kagi.com/settings?p=user_details) page. Then, click the **Get Started** button. | ||
|
||
![2FA authentication - Get Started](./media/2fa_auth_get_started.png){width=600px data-zoomable} | ||
|
||
On the next screen, a QR code will be displayed. You can scan this QR code from your favorite authenticator app. | ||
|
||
![2FA authentication - QR code](./media/2fa_auth_qr_code.png){width=600px data-zoomable} | ||
|
||
If you are using a desktop app to generate the verification codes, then it might be easier to copy your setup key and paste it in your authenticator app directly. | ||
|
||
As a way to prevent from being locked out from your account, we recommend you download and store your backup codes safely, these can be used to regain access to your account if you lose access to your authenticator app. | ||
|
||
Finally, enter the verification code generated by your authenticator app in the boxes to complete the setup process and then click **Continue**. | ||
|
||
![2FA authentication - Finish setup](./media/2fa_auth_finish_setup.png){width=600px data-zoomable} | ||
|
||
## Sign-in with 2FA authentication | ||
|
||
If you have 2FA authentication enabled in your account, you will prompted to enter your verification code after entering your username and password. | ||
|
||
![2FA authentication - Login](./media/2fa_auth_login.png){width=600px data-zoomable} | ||
|
||
## Disabling 2FA authentication | ||
|
||
If you need to disable 2FA authentication for your account, first visit the [Account Settings](https://kagi.com/settings?p=user_details) page. Then, click the **Remove 2FA** button. | ||
|
||
![2FA authentication - Login](./media/2fa_auth_remove_2fa.png){width=600px data-zoomable} |