Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

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

Chiusa Adatta ai principianti
#1,282 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

@danbarr ci sta già lavorando.

Dal 29/10/2026.

  • #1291 di @danbarr — aperta

Valutazione

Difficoltà
1/5
Tempo stimato
1-3 ore
Idoneità per principianti
88/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
javascript
Ambito
documentation

Direzione di ricerca

Leggi la sezione «Review activity» in docs/connector-gateway/connectors.mdx e il passaggio 3 in docs/connector-gateway/support-connector-access.mdx. Aggiorna entrambi per spiegare che al momento Activity mostra solo le chiamate consentite e che le chiamate mancanti possono dipendere da problemi del client o da rifiuti delle policy; indica agli amministratori di consultare il Connector Gateway audit log per distinguerli. Il lavoro è completato quando entrambe le sezioni non promettono più che gli esiti Denied vengano registrati e forniscono indicazioni coerenti per la risoluzione dei problemi.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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.

Lingua principale
JavaScript
Stelle
4
Fork
4
Merge medio
18h 24m
PR unite (30g)
88

Preparare l'ambiente

Apri in Codespaces

Avvia il container di sviluppo del progetto nel browser, con il tuo account GitHub.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di stacklok/docs-website

Tutte le issue di stacklok/docs-website

Issue simili

Altre issue su JavaScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.