Debug and Troubleshooting
Last updated
Last updated
This comprehensive guide helps you debug and troubleshoot Oten IDP integration issues systematically.
OAuth Flow Stages:
JAR Creation - Creating and signing JWT authorization request
Authorization - Redirecting user to Oten IDP
Callback - Handling authorization response
Token Exchange - Converting authorization code to tokens
API Calls - Using access tokens for API requests
Before troubleshooting, collect:
Error messages (exact text and error codes)
HTTP status codes
Request/response headers
Timestamps
Environment (development/production)
Client configuration
Use this to inspect your JAR tokens:
Verify your environment configuration:
Test basic connectivity to Oten IDP:
Symptoms:
Solutions:
Symptoms:
Solutions:
Symptoms:
Solutions:
Complete this checklist before reaching out for help:
Environment Setup:
JAR Implementation:
OAuth Flow:
Error Information Collected:
If you've completed the troubleshooting checklist and still need help:
Technical Support: support@oten.dev
When contacting support, please include:
Never share these in support requests:
Network timeouts
Connection refused errors
DNS resolution failures
Check network connectivity:
Verify firewall settings:
Ensure outbound HTTPS (port 443) is allowed
Check corporate firewall/proxy settings
Verify no SSL/TLS inspection is interfering
Check DNS resolution:
Error code: invalid_request_object
Authorization request rejected
For HS256 issues:
For EdDSA issues:
Error code: invalid_grant
Authorization code rejected
Check authorization code:
Verify PKCE parameters:
Check redirect URI:
Environment details:
Development or production
Programming language and version
Library versions used
Error information:
Client secrets
Private keys
Access tokens
Refresh tokens
User credentials
Common Errors - Specific error codes and solutions
JAR Complete Implementation Guide - JAR implementation examples
API Reference - Complete API documentation
Configuration Reference - Endpoints and settings
Complete error message
Error code and HTTP status
Timestamp of the error
Configuration (sanitized):
Client ID (safe to share)
Redirect URI
Scopes requested
JAR signing method used
Code samples:
JAR creation code (remove secrets)
Authorization URL generation
Token exchange implementation
Debugging output:
JAR token structure (decoded)
Network request/response logs
Environment check results