You’ve got your own authentication system. We get it. Rather than making users log in twice, you can seamlessly pass them from your platform into Nudj. We support two approaches depending on your setup.Documentation Index
Fetch the complete documentation index at: https://docs.nudj.cx/llms.txt
Use this file to discover all available pages before exploring further.
Settings Location: Navigate to Control Room > Settings > User Authentication to configure custom login methods.
Choose Your Path
The method you choose depends on where your users are in their journey.- Users are already logged in (API Link)
- Users arrive at Nudj fresh (OAuth)
Best for: Apps, dashboards, and embedded experiencesYour users are already logged into your platform. They click a button, and boom—they’re in Nudj. No login screen. No password re-entry. Just a seamless handoff.How it works: You generate a secure token on your backend and pass it to Nudj. We verify the token, recognize the user, and let them in instantly.Setup complexity: Medium (requires backend code)User experience: Instant, frictionless login
Decision Matrix
Not sure which one fits your use case? This should help:| Scenario | Use This |
|---|---|
| Users are in your app → you want to show Nudj inline | API Link |
| Users are in your app → you want to open Nudj in a new tab | API Link |
| Users navigate directly to Nudj’s URL | OAuth |
| You want the fewest steps for your users | API Link |
| You’re following industry-standard auth patterns | OAuth |
| Your users need to authenticate to multiple services | OAuth |
Implementation Details
Both methods are secure and production-ready. The main difference is orchestration: who’s coordinating the login flow? API Link: Your system is the coordinator. You hold the credentials and decide when/how to send users to Nudj. OAuth: Both systems coordinate together through standardized protocols.API Link User Token Authentication
Step-by-step guide for generating secure JWT tokens and auto-signing users into Nudj.View API Link Guide →
OAuth Integration Setup
Configure your OAuth provider to work with Nudj’s OpenID Connect flow.View OAuth Guide →
Quick Setup Comparison
API Link (Quick Overview)
API Link (Quick Overview)
- Get your
clientIdandclientSecretfrom Nudj - Generate a JWT token on your backend with user details
- Build a URL:
https://your-domain/api/link?userToken=<token>&clientId=<id> - Redirect your user to that URL
- User lands in Nudj, fully authenticated
OAuth (Quick Overview)
OAuth (Quick Overview)
- Set up OIDC configuration in Nudj (provide issuer, clientId, clientSecret)
- Nudj generates a callback URL
- Add that callback URL to your OAuth provider’s whitelist
- User clicks “Log in” at Nudj
- User authenticates with your provider
- User is redirected back to Nudj, fully authenticated