From 86881f4b4294e505c8fcf02a390e66f23f583e81 Mon Sep 17 00:00:00 2001 From: bidi Date: Tue, 7 Apr 2026 12:39:08 +0300 Subject: [PATCH] updated totp pages Signed-off-by: bidi --- docs/book/v7/security/2fa-with-totp.md | 21 ++------------------- docs/book/v7/tutorials/install-dot-totp.md | 8 ++++---- mkdocs.yml | 4 ++-- 3 files changed, 8 insertions(+), 25 deletions(-) diff --git a/docs/book/v7/security/2fa-with-totp.md b/docs/book/v7/security/2fa-with-totp.md index aaeba76..7b54fa4 100644 --- a/docs/book/v7/security/2fa-with-totp.md +++ b/docs/book/v7/security/2fa-with-totp.md @@ -9,25 +9,8 @@ Our implementation follows the industry standard of using an Authenticator app t Below is a simplified flow for the 2FA with a TOTP mechanism. -```mermaid -sequenceDiagram - participant U as 👤 User - participant A as 📱 Authenticator App - participant S as 🖥 Server - - U->>S: 1. Enter username + password - S->>S: 2. Verify credentials - - S-->>U: 3. Request TOTP code - - A->>U: 4. Display TOTP (time-based) - U->>S: 5. Submit TOTP code - - S->>S: 6. Validate (shared secret + time) - - S-->>U: 7. ✅ Access granted -``` +![totp-flow!](https://docs.dotkernel.org/img/admin/v7/install-totp/totp-flow.jpg) ## Next Steps -[Install 2FA with dot-totp](../configuring-2fa-with-totp.md). +[Install 2FA with dot-totp](https://docs.dotkernel.org/admin-documentation/v7/tutorials/install-dot-totp/). diff --git a/docs/book/v7/tutorials/install-dot-totp.md b/docs/book/v7/tutorials/install-dot-totp.md index 1b0700a..ca1ae73 100644 --- a/docs/book/v7/tutorials/install-dot-totp.md +++ b/docs/book/v7/tutorials/install-dot-totp.md @@ -43,7 +43,7 @@ There are still some code snippets in the [_misc](https://github.com/dotkernel/a Once you have `dot-totp` implemented, you can activate the feature in your admin accounts. If you navigate to your profile from the top-right image in Dotkernel Admin, you should see this box. -![Dotkernel Admin File Structure!](https://docs.dotkernel.org/img/admin/v7/install-totp/profile-totp-deactivated.jpg) +![profile-totp-deactivated!](https://docs.dotkernel.org/img/admin/v7/install-totp/profile-totp-deactivated.jpg) Simply click on 'Enable TOTP' to begin the activation process. @@ -52,7 +52,7 @@ Simply click on 'Enable TOTP' to begin the activation process. > You will need to have an Authenticator app installed on your mobile device. -![Dotkernel Admin File Structure!](https://docs.dotkernel.org/img/admin/v7/install-totp/totp-activate-qr.jpg) +![totp-activate-qr!](https://docs.dotkernel.org/img/admin/v7/install-totp/totp-activate-qr.jpg) Follow the instructions on the screen: @@ -63,7 +63,7 @@ Follow the instructions on the screen: The TOPT activation flow will list several recovery codes you can use if your mobile device isn't available. -![Dotkernel Admin File Structure!](https://docs.dotkernel.org/img/admin/v7/install-totp/totp-recovery-codes.jpg) +![totp-recovery-codes!](https://docs.dotkernel.org/img/admin/v7/install-totp/totp-recovery-codes.jpg) > Each recovery code is usable only once. @@ -75,7 +75,7 @@ Whenever you need to log into the account, you will start by entering your usern Since TOTP is activated, you will need to also submit the code from your Authenticator app. Alternatively, you can submit a recovery code. -![Dotkernel Admin File Structure!](https://docs.dotkernel.org/img/admin/v7/install-totp/totp-ask-code.jpg) +![totp-ask-code!](https://docs.dotkernel.org/img/admin/v7/install-totp/totp-ask-code.jpg) That's it! You are now logged in securely. diff --git a/mkdocs.yml b/mkdocs.yml index d90ca17..dc57614 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -35,10 +35,10 @@ nav: - "Set Up CSRF": v7/how-to/csrf.md - Security: - "Basic Security": v7/security/basic-security.md - - "Two Factor Authorization with Time-based One-Time Password": v7/security/2fa-with-totp.md + - "Two-Factor Authentication with Time-based One-Time Password": v7/security/2fa-with-totp.md - Tutorials: - "Creating a book module using DotMaker": v7/tutorials/create-book-module-via-dot-maker.md - - "Installing dot-totp": v7/tutorials/install-dot-totp.md + - "Enabling Time-based One-Time Password (TOTP)": v7/tutorials/install-dot-totp.md - v6: - Introduction: v6/introduction/introduction.md - Overview: