Skip to main content

Performance Authentication and Access Troubleshooting

Symptoms​

Performance navigation is absent, a route displays unauthorized, or a session is redirected.

Scope​

Client authentication, tenant membership, feature/permission visibility, route checks, and dashboard component access.

Cause​

Likely causes​

Missing/expired session; tenant mismatch; route feature not present; dashboard role/feature check fails; API policy differs from UI visibility.

Safe diagnostic steps​

  1. Confirm the user can access the tenant portal.\n2. Compare the requested route with documented navigation rules.\n3. Confirm only feature/role categories through approved identity evidence.\n4. Check sanitized response status and correlation evidence.

Resolution​

Safe resolution​

Refresh supported identity/entitlement state through approved processes; use a route the user is authorized to access. Do not alter client storage or permissions manually.

Validation​

Reopen the intended route and verify both UI visibility and supported API response.

Evidence to collect​

Collect only environment category, time window, capability/route, status or error category, sanitized correlation reference, lifecycle state category, and recent approved change context.

Escalation​

Escalate identity/session issues to Identity; client-rule defects to frontend; API enforcement questions to Performance/security owners.

Source References​

  • UI/salary-ui/apps/client-hrms-portal/src/utils/ProtectedRoute.tsx
  • UI/salary-ui/apps/client-hrms-portal/src/dashboard/DashboardPages.tsx
  • microservices/src/performance-service/Program.cs

Summary​

This Draft page provides non-destructive, source-backed diagnosis and explicitly stops where recovery authority is not confirmed.

Audience​

Performance users, support, operations, engineering, QA, architecture, security, and implementation teams.

Overview​

Use supported reads and sanitized evidence. Never expose personal/evaluation content, credentials, configuration values, infrastructure details, or operational commands.

See Also​

Keywords​

  • Performance troubleshooting
  • Safe diagnostics

Revision Information​

  • Status: Draft
  • Last reviewed: 2026-07-17
  • Review cycle: Quarterly