- 2 minutes to read

OAuth 2.0 Troubleshooting

Common issues and solutions for OAuth 2.0 / OpenID Connect (OIDC) authentication during Nodinite v7 installation and operation. In OAuth2 mode, the installer CLI checks the identity provider values from the Portal Step 2: Auth before it changes anything, and reports problems as numbered pre-flight errors, such as Error 10.3 for client credentials and Error 10.4 for token claims. Problems after installation usually show up at sign-in or as 401 responses.

Find the Right Page

flowchart TB Start["fa:fa-circle-question What fails?"] --> Phase{"When?"} Phase -->|"CLI pre-flight check"| Code{"Error code?"} Phase -->|"After installation"| Access{"Symptom?"} Code -->|"10.3: client credentials"| Failures["fa:fa-file-lines Troubleshooting OAuth 2.0
Validation Failures"] Code -->|"10.4: token claims"| Claims["fa:fa-file-lines Entra ID Token
Claims Validation"] Access -->|"Signed in, but access denied"| Model["fa:fa-key Claims, Policies, and Roles"] Access -->|"Web API or Log API returns 401"| Callers["fa:fa-plug Web API and Log API
client troubleshooting"] style Failures fill:#2678BD style Claims fill:#2678BD style Model fill:#3F827B style Callers fill:#3F827B

Blue nodes are the installation troubleshooting pages in this folder: Troubleshooting OAuth 2.0 Validation Failures and Entra ID Token Claims Validation. Teal nodes lead to the runtime pages: What is a Claim? with Policies, Call the Web API with OAuth 2.0 Client Credentials, and Protect the Log API with OAuth 2.0 and Entra ID.

Installation Validation Failures

If the CLI pre-flight check reports Error [10.3] or [10.4], start with Troubleshooting OAuth 2.0 Validation Failures. It covers:

  • Error [10.3] – OAuth2 client credentials validation failed
  • Error [10.4] – Token claims validation failed for InstallationClient
  • Root cause analysis, quick-fix checklists, common mistakes, and debugging tips

Issues by Category

Authentication and Token Issues

Configuration Issues

Access After Installation

  1. First time with OAuth? Start with Register Nodinite Applications in Azure AD to understand the app registration architecture.
  2. Installation fails with Error [10.3] or [10.4]? Go to Troubleshooting OAuth 2.0 Validation Failures.
  3. Token claims still missing? See Entra ID Token Claims Validation for detailed diagnosis.

Next Steps