Skip to content

Conversation

buger
Copy link
Member

@buger buger commented Oct 14, 2025

User description

[DX-2107, TT-2378] Update Multi Auth Page (#7050)


PR Type

Documentation


Description

  • Rewrite multi-auth docs with modes

  • Add compliant vs legacy guidance

  • Insert multiple Mermaid flow diagrams

  • Rename sidebar item to "Multi Auth"


Diagram Walkthrough

flowchart LR
  Docs["Multi-auth docs"] -- "Rewrite" --> Modes["Legacy vs Compliant"]
  Modes -- "Explain AND/OR logic" --> Sessions["Session handling rules"]
  Docs -- "Add" --> Diagrams["Mermaid auth flows"]
  Docs -- "Guide" --> Config["Designer + Vendor Extension"]
  Config -- "securityProcessingMode" --> Modes
  Menu["Sidebar menu"] -- "Rename item" --> Label["Multi Auth"]
Loading

File Walkthrough

Relevant files
Documentation
multiple-auth.md
Multi-auth concepts rewritten with modes and flows             

tyk-docs/content/basic-config-and-security/security/authentication-authorization/multiple-auth.md

  • Comprehensive rewrite of multi-auth page
  • Document legacy and compliant modes
  • Add multiple Mermaid diagrams and examples
  • Expand configuration, migration, troubleshooting sections
+492/-54
menu.yaml
Rename menu item to Multi Auth                                                     

tyk-docs/data/menu.yaml

  • Rename sidebar entry to "Multi Auth"
  • Keep path to multiple-auth page unchanged
+1/-1     

@buger buger enabled auto-merge (squash) October 14, 2025 07:55
Copy link
Contributor

⚠️ Deploy preview for PR #7063 did not become live after 3 attempts.
Please check Netlify or try manually: Preview URL

Copy link
Contributor

PR Code Suggestions ✨

Explore these optional code suggestions:

CategorySuggestion                                                                                                                                    Impact
Possible issue
Replace invalid YAML comment syntax

Use YAML-compatible comments to prevent copy/paste errors in real configs. Replace
the inline '//' comment with a '#' comment on a separate or same line, preserving
valid YAML syntax.

tyk-docs/content/basic-config-and-security/security/authentication-authorization/multiple-auth.md [296-297]

 x-tyk-api-gateway:
   server:
     authentication:
-      securityProcessingMode: compliant // or legacy
+      # or: legacy
+      securityProcessingMode: compliant
Suggestion importance[1-10]: 8

__

Why: Replaces invalid '//' with valid YAML '#' comment, preventing copy/paste config errors; this is a concrete, correctness-focused fix directly tied to the snippet.

Medium
Fix malformed parentheses

Fix the double parenthesis which breaks Markdown rendering and can confuse readers.
Keep a single opening parenthesis to correctly format the deprecated notice link.

tyk-docs/content/basic-config-and-security/security/authentication-authorization/multiple-auth.md [252]

-2. External OAuth (([deprecated]({{< ref "api-management/client-authentication#integrate-with-external-authorization-server-deprecated" >}}))
+2. External OAuth ([deprecated]({{< ref "api-management/client-authentication#integrate-with-external-authorization-server-deprecated" >}}))
Suggestion importance[1-10]: 7

__

Why: Correctly fixes a typographical error that could break Markdown rendering; it’s precise to the diff and improves readability without altering meaning.

Medium
General
Avoid overly specific versioning

Clarify the exact minimum version and patch range for availability to avoid
ambiguity. Replace "Introduced in 5.10.0" with "Introduced in Tyk 5.10" so it
remains accurate across patch releases and distributions.

tyk-docs/content/basic-config-and-security/security/authentication-authorization/multiple-auth.md [139]

-- **Compliant Mode**: Introduced in 5.10.0, provides enhanced flexibility by supporting both AND and OR logic between authentication methods
+- **Compliant Mode**: Introduced in Tyk 5.10, provides enhanced flexibility by supporting both AND and OR logic between authentication methods
Suggestion importance[1-10]: 5

__

Why: The change is accurate and improves longevity of the docs by avoiding overly specific patch notation, but it's a minor editorial improvement with limited impact on functionality.

Low

Copy link

netlify bot commented Oct 14, 2025

PS. Add to the end of url /docs/nightly

Name Link
🔨 Latest commit 658fe65
🔍 Latest deploy log https://app.netlify.com/projects/tyk-docs/deploys/68ee0204566b9e000870f2ff
😎 Deploy Preview https://deploy-preview-7063--tyk-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

1 similar comment
Copy link

netlify bot commented Oct 14, 2025

PS. Add to the end of url /docs/nightly

Name Link
🔨 Latest commit 658fe65
🔍 Latest deploy log https://app.netlify.com/projects/tyk-docs/deploys/68ee0204566b9e000870f2ff
😎 Deploy Preview https://deploy-preview-7063--tyk-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@buger buger merged commit 2f4d255 into release-5.10 Oct 14, 2025
12 checks passed
@buger buger deleted the merge/release-5.10/b0c77bf7ed93ca68624d0eac0fdf864b1811280c branch October 14, 2025 08:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants