[Bug]: Connector Activity docs promise Denied outcomes that are never recorded

Đã đóng Phù hợp với người mới
  • Có gì không ổn?
#1,282 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

@danbarr đang làm issue này rồi.

Từ ngày 29/10/2026.

  • #1291 của @danbarr — đang mở

Đánh giá

Độ khó
1/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
88/100
Loại issue
Tài liệu
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
javascript
Lĩnh vực
documentation

Hướng nghiên cứu

Đọc mục “Review activity” trong docs/connector-gateway/connectors.mdx và bước 3 trong docs/connector-gateway/support-connector-access.mdx. Cập nhật cả hai để giải thích rằng hiện tại Activity chỉ hiển thị các lệnh gọi được cho phép, và các lệnh gọi bị thiếu có thể do sự cố phía client hoặc do chính sách từ chối; hướng dẫn quản trị viên xem Connector Gateway audit log để phân biệt hai trường hợp. Hoàn tất khi cả hai mục không còn cam kết rằng các kết quả Denied được ghi lại và đưa ra hướng dẫn khắc phục sự cố nhất quán.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

bug documentation needs-triage
Page or section
  • docs/connector-gateway/connectors.mdx, "Review activity"
  • docs/connector-gateway/support-connector-access.mdx, "Check a user's access", step 3
What's wrong?

Both pages say a connector's Activity tab lists each call's Outcome as Allowed or Denied. The troubleshooting step then reads: "A denied call points to the policy; no call at all points to the client configuration or connection."

Denied calls are never recorded in Activity. The usage emitter doesn't attribute a denied call to its connector, so the per-connector read can't return it (stacklok/stacklok-enterprise-platform#3901). On the demo cluster, blocking a tool for a group and calling it twice produced failed calls in the client and nothing in Activity. The audit log records the same refusals as application_error, not denied (stacklok/stacklok-enterprise-platform#5758).

So today, an admin following step 3 for a user blocked by policy sees no call at all. The docs then tell them to look at the client configuration, which is the wrong conclusion.

Suggested fix

Until the platform issues are fixed:

  • In "Review activity", say that the tab currently shows allowed calls only, and that refusals by connector policy or a group tool restriction don't appear there.
  • In "Check a user's access", rewrite step 3 so that "no calls" covers both client problems and policy refusals, and point admins to the Connector Gateway audit log to tell them apart.

When #3901 and #5758 land, restore the Denied wording and say which audit outcome a policy refusal produces.

Additional context

Found while walking through demo flows on the demo cluster, October 27, 2026.

Fully or partially written by an AI agent.

Ngôn ngữ chính
JavaScript
Star
4
Fork
4
Merge trung bình
18 giờ 24 phút
Pull request đã merge (30 ngày)
88

Chuẩn bị môi trường

Mở trong Codespaces

Khởi chạy dev container của dự án ngay trên trình duyệt, bằng tài khoản GitHub của bạn.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của stacklok/docs-website

Tất cả issue của stacklok/docs-website

Issue tương tự

Thêm issue về JavaScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.