Skip to content

docs(hmac-auth): re-port with Admin API, ADC, and Ingress Controller tabs#13242

Merged
Yilialinn merged 9 commits intoapache:masterfrom
Yilialinn:docs/update-hmac-auth
Apr 22, 2026
Merged

docs(hmac-auth): re-port with Admin API, ADC, and Ingress Controller tabs#13242
Yilialinn merged 9 commits intoapache:masterfrom
Yilialinn:docs/update-hmac-auth

Conversation

@Yilialinn
Copy link
Copy Markdown
Contributor

Summary

Re-ports the hmac-auth plugin documentation with the following updates:

  • Added canonical link in <head> pointing to API7 docs
  • Updated Consumer/Credential attribute table to 6-column format with key_id field (replacing incorrect access_key)
  • Added ADC and Ingress Controller (Gateway API + APISIX CRD) tabs to all four examples
  • Added separate Implementation section describing how HMAC verification works
  • Fixed X-Credential-Identifier header name typo (IndentifierIdentifier)
  • Updated admin_key retrieval path to /usr/local/apisix/conf/config.yaml
  • Removed highlight annotations and enterprise-only content
  • Updated Chinese translation with full tab structure and fixed field names

@dosubot dosubot Bot added size:XXL This PR changes 1000+ lines, ignoring generated files. doc Documentation things labels Apr 17, 2026
@Yilialinn Yilialinn requested a review from Copilot April 17, 2026 09:18
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR re-ports and modernizes the hmac-auth plugin documentation (EN/ZH) to align with current APISIX usage patterns, adding canonical links and expanding examples to cover Admin API, ADC, and Ingress Controller flows.

Changes:

  • Added canonical link and Docusaurus tabbed examples (Admin API / ADC / Ingress Controller, incl. Gateway API + APISIX CRD).
  • Updated Consumer/Credential attribute tables (e.g., key_id/secret_key) and fixed the X-Credential-Identifier header typo.
  • Added an “Implementation/实现原理” section and refreshed multiple examples (e.g., admin_key retrieval path, removed enterprise-only content).

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 8 comments.

File Description
docs/en/latest/plugins/hmac-auth.md Canonical link + tabs for multi-API examples; updated attribute tables and added Implementation section.
docs/zh/latest/plugins/hmac-auth.md Chinese parity update with canonical link + full tab structure; updated attribute tables and added 实现原理 section.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/zh/latest/plugins/hmac-auth.md
Comment thread docs/en/latest/plugins/hmac-auth.md Outdated
Comment thread docs/en/latest/plugins/hmac-auth.md Outdated
Comment thread docs/en/latest/plugins/hmac-auth.md Outdated
Comment thread docs/en/latest/plugins/hmac-auth.md Outdated
Comment thread docs/en/latest/plugins/hmac-auth.md
Comment thread docs/zh/latest/plugins/hmac-auth.md Outdated
Comment thread docs/zh/latest/plugins/hmac-auth.md Outdated
Yilialinn and others added 7 commits April 20, 2026 10:29
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@Yilialinn Yilialinn requested a review from kayx23 April 20, 2026 03:24
Comment thread docs/en/latest/plugins/hmac-auth.md
@Yilialinn Yilialinn requested a review from kayx23 April 21, 2026 10:02
@Yilialinn Yilialinn merged commit f9226b2 into apache:master Apr 22, 2026
10 checks passed
@Yilialinn Yilialinn deleted the docs/update-hmac-auth branch April 22, 2026 06:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

doc Documentation things size:XXL This PR changes 1000+ lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants