Get started
Developers building a LuxID integration - this is your on-ramp. IT administrators integrating an off-the-shelf tool should switch to Quick integrations after the onboarding page. Product owners get the most from LuxID onboarding and Plan and design.
What this section covers
This section gives you everything you need to go from zero to a working LuxID integration. It is split into four pages:
| Page | What you will do |
|---|---|
| LuxID onboarding | Understand what LuxID is, who governs it, and when it is the right choice |
| Learn the basics | Learn the conceptual model and the three supported standards |
| Configure LuxID | Become a Partner, register an Application, and run a first test login |
| Plan and design | Make the architectural decisions before writing production code |
By the end of this section you will have completed a full Authorization Code + PKCE login against the UAT environment and will know exactly which design choices to make before going to production.
Two integration ramps
LuxID supports two integration paths. Choose the one that matches your stack.
Ramp 1 - Developer (code-based)
You own the application code and want full control over the authentication flow. Use OIDC or OAuth 2.0 with your framework of choice (Node.js, Spring, .NET, React Native, etc.). Start with Learn the basics then Configure LuxID.
Ramp 2 - IT Lead / no-code (SaaS integrations)
Your application is a SaaS platform (WordPress, Odoo, Microsoft 365, Salesforce, Atlassian, ServiceNow, Moodle) with a built-in OIDC or SAML connector. You configure the connector - no custom code required. Start with Quick Integrations.
Where to next
What you need before you begin
- An idea of the application you want to integrate (web, mobile, server-to-server, kiosk)
- Permission to sign a LuxID Agreement on behalf of your organisation
- A development environment able to make HTTPS requests
You do not need credentials yet - this section walks you through obtaining them.