Skip to content

Add TOTP configuration documentation for WSO2 IS 7.1.0#5596

Draft
Copilot wants to merge 3 commits into
masterfrom
copilot/fix-f41fdd78-3374-46a5-9699-e3118429fe63
Draft

Add TOTP configuration documentation for WSO2 IS 7.1.0#5596
Copilot wants to merge 3 commits into
masterfrom
copilot/fix-f41fdd78-3374-46a5-9699-e3118429fe63

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Sep 27, 2025

  • Explore repository structure and understand current documentation organization
  • Identify that WSO2 IS 7.1.0 has MFA directory but missing TOTP configuration documentation
  • Review existing TOTP configuration documentation in 6.1.0 as reference
  • Check mkdocs.yml structure and identify current redirect from totp-config-advanced.md
  • Create TOTP configuration documentation for 7.1.0 based on 6.1.0 version
  • Update mkdocs.yml navigation to include the new configuration page
  • Remove the redirect from totp-config-advanced.md to basic TOTP login page
  • Test the documentation build locally and verify it passes
  • Fix markdown linting issues (missing trailing newline)
  • Verify the documentation renders correctly and appears in navigation
  • Remove redundant default values from parameter descriptions (per review feedback)
  • Remove "Description:" prefixes from parameter descriptions (per review feedback)

Summary:
Successfully added comprehensive TOTP configuration documentation for WSO2 IS 7.1.0 and addressed review feedback to improve readability:

Changes made based on feedback:

  • Removed redundant "Default value" sections from each parameter since defaults are already shown in the configuration example
  • Removed "Description:" prefixes from parameter descriptions to reduce verbosity
  • Maintained clear, concise parameter explanations that follow documentation guidelines

The documentation now provides a cleaner, more scannable format while retaining all essential configuration information for TOTP parameters in WSO2 IS 7.1.0.

Original prompt

This section details on the original issue you should resolve

<issue_title>TOTP Configuration Documentation Missing for WSO2 IS 7.1.0</issue_title>
<issue_description>### Document issue type

Type/Bug (Report inaccuracies, outdated information, or missing details in the existing content)

Description

The TOTP configuration documentation for WSO2 IS 7.1.0 is currently not available. Users looking for guidance on configuring TOTP in this version may face difficulties. However, for WSO2 IS 6.1.0 TOTP configuration documentation [1] exists. Shall we include the same for newer WSO2 IS versions?

[1] - https://is.docs.wso2.com/en/6.1.0/guides/mfa/totp-config-advanced/

Version

IS 7.1.0</issue_description>

Comments on the Issue (you are @copilot in this section)

Fixes wso2/product-is#25831

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

@CLAassistant
Copy link
Copy Markdown

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
You have signed the CLA already but the status is still pending? Let us recheck it.

Co-authored-by: pavinduLakshan <41533942+pavinduLakshan@users.noreply.github.com>
Copilot AI changed the title [WIP] TOTP Configuration Documentation Missing for WSO2 IS 7.1.0 Add TOTP configuration documentation for WSO2 IS 7.1.0 Sep 27, 2025
Comment thread en/identity-server/7.1.0/docs/guides/authentication/mfa/totp-config-advanced.md Outdated
Comment thread en/identity-server/7.1.0/docs/guides/authentication/mfa/totp-config-advanced.md Outdated
…nfiguration parameters

Co-authored-by: pavinduLakshan <41533942+pavinduLakshan@users.noreply.github.com>
- Add multi-factor authentication:
- Add multi-factor authentication: guides/authentication/mfa/index.md
- Add TOTP: guides/authentication/mfa/add-totp-login.md
- TOTP configurations: guides/authentication/mfa/totp-config-advanced.md
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@copilot instead of adding a new page, let's update the guides/authentication/mfa/add-totp-login.md file appropriately to indicate the advanced TOTP configurations. With such a change, we would need to keep the entry in the redirects map that you deleted.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

TOTP Configuration Documentation Missing for WSO2 IS 7.1.0

3 participants