Skip to main content

58 docs tagged with "guide"

View all tags

Add login to your Application

15-minute quickstart: implement Authorization Code Flow with PKCE against LuxID, with cURL examples, sequence diagram, and ID token validation.

Applications

Discover the LuxID-registered applications and instances that belong to your partnership, and the groups attached to each application.

Atlassian Cloud

Step-by-step guide to integrate LuxID with Atlassian Cloud via SAML 2.0: prerequisites, field mapping, testing, and a production checklist.

Attribute enrichment

Roadmap: optional enriched claims beyond standard OIDC profile - organisation, age brackets, residency, postal address - each requiring explicit user consent.

Before you start

Checklist of prerequisites every IT admin must have in hand before configuring LuxID in an off-the-shelf tool.

Branding configuration

Configuring per-Application logos, display names, and localised descriptions shown on the LuxID consent screen, and previewing them before go-live.

Change management and roadmap

How LuxID communicates platform changes to Partners: change categories, notification windows, deprecation policy, communication channels and roadmap visibility.

Claims

Set or remove a custom claim value on a subscriber, to be surfaced on subsequent authentications.

Client credentials

Viewing and rotating Client Secrets, and SAML signing certificate lifecycle in the LuxID Console.

Code samples and reference repos

Curated index of reference repositories, starter templates, and validation utilities for integrating LuxID with the major language ecosystems.

Configure LuxID

End-to-end guide: become a LuxID Partner, register an Application, obtain credentials, and complete a first test login using Authorization Code + PKCE.

Delegated authorisation

Patterns for one LuxID application acting on behalf of a user at another service: delegated tokens, token exchange, and refresh token scoping.

Diagnose a failing request

A decision tree for diagnosing LuxID integration errors, which on-screen identifier to capture, and what to include when you raise a support ticket.

Drupal

Step-by-step guide to integrate LuxID with Drupal via OIDC: prerequisites, field mapping, testing, and a production checklist. Typical time: 15-20 min.

Environments

How LuxID's Production and UAT environments differ, how to promote an Application between them, and data residency details.

Event Hub

Search the time-ordered stream of user-related events tied to your partnership's applications, with pagination.

Events and Event Hub

Overview of LuxID identity events: the common event envelope, pull vs push delivery, the indicative event catalogue, and SIEM integration.

FusionAuth

Add LuxID as an OpenID Connect Identity Provider in FusionAuth, including the reconcile lambda for claim mapping, testing, and production checklist.

Generic OIDC broker

Configure any OIDC-capable identity broker against LuxID: discovery URL, PKCE (S256), RS256 ID tokens, exact-match redirect URIs, and JWKS rotation.

Groups

List partner-managed groups, list members, list a user's group memberships, and add or remove members in bulk.

Identity broker integrations

Configure LuxID as an upstream OIDC provider behind your own broker: Keycloak, FusionAuth, Matrix (Synapse, MAS), SAP Customer Data Cloud, or generic OIDC.

IT admin quickstart: symptom to action

Configuration-level troubleshooting for IT administrators: map what users report to the check to run and the request to raise - no protocol knowledge needed.

Keycloak

Add LuxID as an external OpenID Connect identity provider in Keycloak (Identity Brokering): field mapping, claim mappers, testing, production checklist.

Logs and audit trails

Querying authentication logs, Subscription events, and configuration audit records in the LuxID Console, including filtering, export, and retention.

LuxID as OpenRoaming IdP

LuxID acts as an OpenRoaming Wi-Fi identity provider, letting users roam onto participating networks in Luxembourg without re-authentication.

LuxID Console

Overview of the LuxID Console - the operational portal for Partner administrators to manage Applications, credentials, logs, and branding.

LuxID Partner API

Server-to-server REST API for LuxID Partners to manage applications, subscriptions, groups, custom claims, and user events programmatically.

Matrix homeserver (Synapse and MAS)

Configure LuxID as an OIDC provider for a Matrix homeserver: legacy Synapse built-in OIDC and the next-gen Matrix Authentication Service (MAS).

Microsoft 365

Step-by-step guide to integrate LuxID with Microsoft 365 via SAML 2.0: prerequisites, field mapping, testing, and a production checklist.

Moodle

Step-by-step guide to integrate LuxID with Moodle via OIDC: prerequisites, field mapping, testing, and a production checklist. Typical time: 15-20 min.

Multi-factor authentication

LuxID MFA methods (OTP, TOTP, passkeys, LuxTrust), token claims amr and acr, minimum assurance configuration, step-up flows, and recovery paths.

OAuth 2.0 for APIs

Protecting backend APIs with OAuth 2.0 bearer tokens, scopes, audiences, and machine-to-machine patterns at LuxID.

Odoo

Step-by-step guide to integrate LuxID with Odoo via OIDC: prerequisites, field mapping, testing, and a production checklist. Typical time: 15-20 min.

OIDC vs SAML decision guide

Decision matrix and flowchart to help IT admins choose between OpenID Connect and SAML 2.0 when integrating LuxID with an off-the-shelf tool.

Overview

What the Quick Integrations section covers, the 5-step template every guide follows, and how to know you are in the right place.

Passwordless and passkeys

WebAuthn/FIDO2 passkeys on LuxID: device binding, platform and roaming authenticators, token claims, fallback behaviour, and phishing resistance.

Platform and framework guides

Minimal configuration to wire LuxID into Spring, ASP.NET, Node.js, Next.js, React SPA, Angular, React Native, iOS, Android, PHP, and Python.

Protect your Application

Security checklist for LuxID integrations: HTTPS, PKCE, state/nonce, ID Token validation, token storage, open redirects, and anti-patterns to avoid.

Redirect URIs and domains

Rules, configuration steps, and troubleshooting guidance for redirect URIs and domain ownership in LuxID Applications.

Register an Application

What to submit to register a new client Application with LuxID: required fields, claim declarations, access rules, and authentication level configuration.

Salesforce

Step-by-step guide to integrate LuxID with Salesforce via OIDC: prerequisites, field mapping, testing, and a production checklist. Typical time: 20-30 min.

SAML 2.0

Integrating LuxID as a SAML 2.0 Identity Provider: metadata, AuthnRequest, Assertion validation, attribute mapping, and logout behaviour.

Sandbox environment

How to use the LuxID UAT environment for development and QA: what differs from production, rate limits, test data lifecycle, and promoting to production.

SAP Customer Data Cloud

Configure LuxID as an OpenID Connect identity provider in SAP Customer Data Cloud (formerly Gigya): field mapping, JIT account behaviour, and common pitfalls.

Service provider onboarding

End-to-end journey for becoming a LuxID Partner: from first contact through KYB, agreement, UAT integration, go-live review to production credentials.

ServiceNow

Step-by-step guide to integrate LuxID with ServiceNow via OIDC or SAML: prerequisites, field mapping, testing, and a production checklist.

Session management

How to persist refresh tokens, silently renew sessions, and avoid re-prompting users for credentials and OTP on every app restart.

Single sign-on and LuxID Pro

Consumer SSO across LuxID-enabled apps and LuxID Pro enterprise federation: Sphere boundaries, domain routing, corporate IdP integration, token claims.

Test users and simulation

Creating and configuring test user accounts in UAT, simulating authentication scenarios, and resetting test user state in the LuxID Console.

Testing and tooling

Overview of the LuxID developer tools and UAT environment for faster integration development and QA.

Tool-specific integrations

Pick your SaaS tool to get a dedicated step-by-step LuxID integration guide: Odoo, WordPress, Drupal, ServiceNow, Atlassian, Microsoft 365, Salesforce, Moodle.

Universal Login

LuxID's hosted login page: redirect-based authentication, branding boundaries, session reuse, and why Partners should never build their own login form.

Webhooks and events API

Subscribe to LuxID identity events via push (webhooks) or pull (Event Hub): subscription management, payload signing, delivery semantics, and replay protection.

WordPress

Step-by-step guide to integrate LuxID with WordPress via OIDC: prerequisites, field mapping, testing, and a production checklist. Typical time: 15 min.