Skip to content

Troubleshooting

Nemu-x edited this page Jul 14, 2026 · 1 revision

Troubleshooting

"graph: 403 …" on a tab

The app registration is missing a Graph permission for that call. Add the required Application permission (see Permissions) and click Grant admin consent. SwissKnife appends a hint to 403 errors reminding you of this.

A tab I can't use is still showing

Open Settings → Available features → Check access, then enable Hide tabs the app has no permission for. Intune is also gated on an actual Intune license being present in the tenant.

Requests are slow / "429 TooManyRequests"

That's Microsoft Graph throttling. SwissKnife automatically retries with backoff and honors Retry-After, so just wait — large list operations across big tenants can take a moment.

Service health returns 403

It needs ServiceHealth.Read.All (Application) with admin consent — it isn't in the core set.

Connection fails immediately

  • Double-check Tenant ID / Client ID / secret (secrets expire — check Certificates & secrets).
  • App-only needs Application permissions + admin consent; device code needs Allow public client flows = Yes and Delegated permissions.

Windows: the app icon looks wrong / shows a generic icon

That's the Windows Explorer icon cache holding a stale icon; the binary itself is correct. Refresh it:

taskkill /IM explorer.exe /F & del /A /Q "%LocalAppData%\IconCache.db" & del /A /Q "%LocalAppData%\Microsoft\Windows\Explorer\iconcache*" & start explorer.exe

macOS: "app is damaged / can't be opened"

It isn't notarized yet. Clear the quarantine flag:

xattr -dr com.apple.quarantine SwissKnifeGraph.app

Linux: app won't start

Install the runtime libs: webkit2gtk-4.1 and gtk3 from your distro's package manager.

Password reset fails for a user

Cloud-only accounts work; users synced from on-prem AD can't have their password reset via Graph — manage those in your on-prem directory.