Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

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

クローズ 初心者向け
#1,282 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

@danbarr がすでに取り組んでいます。

2026年10月29日 から。

  • #1291 @danbarr による — オープン

評価

難易度
1/5
見積もり時間
1〜3時間
初心者へのやさしさ
88/100
issue の種類
ドキュメント
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
javascript
領域
documentation

調査の方向性

docs/connector-gateway/connectors.mdx の「Review activity」セクションと、docs/connector-gateway/support-connector-access.mdx のステップ 3 を読みます。両方を更新し、現在 Activity に表示されるのは許可された呼び出しのみであること、呼び出しが見当たらない場合はクライアントの問題またはポリシーによる拒否が考えられることを説明します。両者を見分けるため、管理者に Connector Gateway audit log を確認するよう案内します。両方のセクションで、Denied の結果が記録されるという記述がなくなり、一貫したトラブルシューティングの案内が示されれば完了です。

索引モデルが issue の本文から書いたものです。

説明

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.

主要言語
JavaScript
スター
4
フォーク
4
平均マージ
17時間 57分
マージ済み PR(30日)
87

環境構築

Codespaces で開く

このプロジェクトの開発コンテナを、あなたの GitHub アカウントでブラウザ上に起動します。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

stacklok/docs-website のほかの issue

stacklok/docs-website の issue をすべて見る

似ている issue

JavaScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。