Aller au contenu principal

Debug authentication issue

This page is a post-V1 curated runbook entry generated from the Fabric-owned runbook inventory contract. It is intentionally contract-first: owner and source truth are explicit, and unresolved gaps are recorded instead of being silently invented.

Symptom​

Authentication, claims, session, or secret-bound identity behavior fails before the intended task can run.

Likely Owner​

  • Canonical owner: JaddaHelpifyr/jhf-heddle
  • Supporting owner: JaddaHelpifyr/jhf-keystore
  • Supporting owner: JaddaHelpifyr/jhf-spindle

First Checks​

  • Start with the canonical owner repo JaddaHelpifyr/jhf-heddle and confirm the reported symptom is owned there.
  • Read the owner troubleshooting or operations source before attempting any runtime mutation.
  • Collect the current readiness or deployment evidence first so recovery stays reversible and auditable.

Commands​

  • No new copy-paste-safe command bundle is admitted in this contract-first slice.
  • Use only the bounded verify or recovery commands that already exist in the listed owner source references.

Evidence​

  • Readiness or health endpoint readback for the affected surface.
  • Relevant deployment, workflow, or task evidence referenced by the owner repo runbook or troubleshooting source.

Recovery​

  • Follow the canonical owner repo path first; supporting repos only extend the investigation after owner truth is exhausted.
  • If the remaining gap list below still blocks a safe public procedure, stop and route the issue back to the owning repo instead of inventing a workaround.

Escalation​

  • Primary owner: JaddaHelpifyr/jhf-heddle.
  • Supporting owner: JaddaHelpifyr/jhf-keystore.
  • Supporting owner: JaddaHelpifyr/jhf-spindle.

Verify After Recovery​

  • Re-run the bounded owner verify path and confirm the original symptom is no longer present.
  • Only treat the incident as closed when the post-recovery readback matches the owner repo expectation.

Source Truth​

  • Fabric runbook contract: contracts/docs/public_manufacturer_docs_post_v1_runbooks_v1.json
  • Owner source: JaddaHelpifyr/jhf-heddle:docs/TROUBLESHOOTING.md
  • Owner source: JaddaHelpifyr/jhf-heddle:docs/SECURITY.md
  • Owner source: JaddaHelpifyr/jhf-keystore:docs/SECURITY.md

Current Inventory Status​

  • Status: ready_for_authoring

Remaining Gaps​

  • Need explicit redirect-URI and claims mismatch examples redacted for public-safe publication.