# LuxID Docs

> Documentation for LuxID users, developers, and partners.


## api

API used by partners

- [LuxID Partner api](https://docs.luxid.lu/api.md): API used by partners

### delete-current-subscription

Remove the current subscription from the application

- [Remove the current subscription from the application](https://docs.luxid.lu/api/delete-current-subscription.md): Remove the current subscription from the application

### edit-group-memberships

Add/Remove accounts into/from groups

- [Add/Remove accounts into/from groups](https://docs.luxid.lu/api/edit-group-memberships.md): Add/Remove accounts into/from groups

### get-account-memberships

Get group memberships of an account. Only groups managed by the calling partner are returned.

- [Get group memberships of an account. Only groups managed by the calling partner are returned.](https://docs.luxid.lu/api/get-account-memberships.md): Get group memberships of an account. Only groups managed by the calling partner are returned.

### get-all-applications

Get all applications managed by calling partner

- [Get all applications managed by calling partner](https://docs.luxid.lu/api/get-all-applications.md): Get all applications managed by calling partner

### get-application-groups

Get list of groups of the application

- [Get list of groups of the application](https://docs.luxid.lu/api/get-application-groups.md): Get list of groups of the application

### get-application

Get single application

- [Get single application](https://docs.luxid.lu/api/get-application.md): Get single application

### get-current-email-subscription

Get current subscription details based on email

- [Get current subscription details based on email](https://docs.luxid.lu/api/get-current-email-subscription.md): Get current subscription details based on email

### get-current-subscription

Get current subscription details

- [Get current subscription details](https://docs.luxid.lu/api/get-current-subscription.md): Get current subscription details

### get-events

Search for user events that occured between the provided 'from' and 'to' timestamps. Format must be ISO-8601: '2018-08-17T07:00:00'. Viewed events depend on the caller of this endpoint.

- [Search for events](https://docs.luxid.lu/api/get-events.md): Search for user events that occured between the provided 'from' and 'to' timestamps. Format must be ISO-8601: '2018-08-17T07:00:00'. Viewed events depend on the caller of this endpoint.

### get-group-memberships

Get members of a group

- [Get members of a group](https://docs.luxid.lu/api/get-group-memberships.md): Get members of a group

### remove-member-claim-value

Remove claim value of a member

- [Remove claim value of a member](https://docs.luxid.lu/api/remove-member-claim-value.md): Remove claim value of a member

### set-member-claim-value

Set claim value of a member

- [Set claim value of a member](https://docs.luxid.lu/api/set-member-claim-value.md): Set claim value of a member

## developers

Landing page for the LuxID developer documentation: positioning, supported standards, top-level navigation, and persona entry points.

- [LuxID developer documentation](https://docs.luxid.lu/developers.md): Landing page for the LuxID developer documentation: positioning, supported standards, top-level navigation, and persona entry points.

### tags

- [Tags](https://docs.luxid.lu/developers/tags.md)
- [2 docs tagged with "accessibility"](https://docs.luxid.lu/developers/tags/accessibility.md)
- [3 docs tagged with "advanced-security"](https://docs.luxid.lu/developers/tags/advanced-security.md)
- [One doc tagged with "android"](https://docs.luxid.lu/developers/tags/android.md)
- [One doc tagged with "angular"](https://docs.luxid.lu/developers/tags/angular.md)
- [7 docs tagged with "app-security"](https://docs.luxid.lu/developers/tags/app-security.md)
- [One doc tagged with "atlassian"](https://docs.luxid.lu/developers/tags/atlassian.md)
- [2 docs tagged with "attribute-enrichment"](https://docs.luxid.lu/developers/tags/attribute-enrichment.md)
- [18 docs tagged with "authentication"](https://docs.luxid.lu/developers/tags/authentication.md)
- [4 docs tagged with "authorization"](https://docs.luxid.lu/developers/tags/authorization.md)
- [15 docs tagged with "best-practice"](https://docs.luxid.lu/developers/tags/best-practice.md)
- [7 docs tagged with "branding"](https://docs.luxid.lu/developers/tags/branding.md)
- [One doc tagged with "breached-password"](https://docs.luxid.lu/developers/tags/breached-password.md)
- [9 docs tagged with "compliance"](https://docs.luxid.lu/developers/tags/compliance.md)
- [17 docs tagged with "concept"](https://docs.luxid.lu/developers/tags/concept.md)
- [2 docs tagged with "consent-ux"](https://docs.luxid.lu/developers/tags/consent-ux.md)
- [12 docs tagged with "console"](https://docs.luxid.lu/developers/tags/console.md)
- [6 docs tagged with "credentials"](https://docs.luxid.lu/developers/tags/credentials.md)
- [One doc tagged with "dotnet"](https://docs.luxid.lu/developers/tags/dotnet.md)
- [One doc tagged with "drupal"](https://docs.luxid.lu/developers/tags/drupal.md)
- [6 docs tagged with "eidas"](https://docs.luxid.lu/developers/tags/eidas.md)
- [One doc tagged with "error-ux"](https://docs.luxid.lu/developers/tags/error-ux.md)
- [6 docs tagged with "events"](https://docs.luxid.lu/developers/tags/events.md)
- [One doc tagged with "faq"](https://docs.luxid.lu/developers/tags/faq.md)
- [6 docs tagged with "federation"](https://docs.luxid.lu/developers/tags/federation.md)
- [109 docs tagged with "for-developers"](https://docs.luxid.lu/developers/tags/for-developers.md)
- [41 docs tagged with "for-it-admins"](https://docs.luxid.lu/developers/tags/for-it-admins.md)
- [38 docs tagged with "for-product-owners"](https://docs.luxid.lu/developers/tags/for-product-owners.md)
- [26 docs tagged with "for-security-officers"](https://docs.luxid.lu/developers/tags/for-security-officers.md)
- [4 docs tagged with "gdpr"](https://docs.luxid.lu/developers/tags/gdpr.md)
- [12 docs tagged with "getting-started"](https://docs.luxid.lu/developers/tags/getting-started.md)
- [58 docs tagged with "guide"](https://docs.luxid.lu/developers/tags/guide.md)
- [3 docs tagged with "identity-verification"](https://docs.luxid.lu/developers/tags/identity-verification.md)
- [One doc tagged with "ios"](https://docs.luxid.lu/developers/tags/ios.md)
- [One doc tagged with "key-management"](https://docs.luxid.lu/developers/tags/key-management.md)
- [One doc tagged with "legal"](https://docs.luxid.lu/developers/tags/legal.md)
- [2 docs tagged with "localization"](https://docs.luxid.lu/developers/tags/localization.md)
- [One doc tagged with "login-button"](https://docs.luxid.lu/developers/tags/login-button.md)
- [One doc tagged with "logs"](https://docs.luxid.lu/developers/tags/logs.md)
- [3 docs tagged with "luxtrust"](https://docs.luxid.lu/developers/tags/luxtrust.md)
- [6 docs tagged with "mfa"](https://docs.luxid.lu/developers/tags/mfa.md)
- [One doc tagged with "microsoft-365"](https://docs.luxid.lu/developers/tags/microsoft-365.md)
- [One doc tagged with "moodle"](https://docs.luxid.lu/developers/tags/moodle.md)
- [One doc tagged with "nextjs"](https://docs.luxid.lu/developers/tags/nextjs.md)
- [21 docs tagged with "no-code"](https://docs.luxid.lu/developers/tags/no-code.md)
- [One doc tagged with "nodejs"](https://docs.luxid.lu/developers/tags/nodejs.md)
- [17 docs tagged with "oauth2"](https://docs.luxid.lu/developers/tags/oauth-2.md)
- [One doc tagged with "odoo"](https://docs.luxid.lu/developers/tags/odoo.md)
- [32 docs tagged with "oidc"](https://docs.luxid.lu/developers/tags/oidc.md)
- [One doc tagged with "onboarding-rp"](https://docs.luxid.lu/developers/tags/onboarding-rp.md)
- [One doc tagged with "openroaming"](https://docs.luxid.lu/developers/tags/openroaming.md)
- [2 docs tagged with "otp"](https://docs.luxid.lu/developers/tags/otp.md)
- [6 docs tagged with "passkeys"](https://docs.luxid.lu/developers/tags/passkeys.md)
- [7 docs tagged with "privacy"](https://docs.luxid.lu/developers/tags/privacy.md)
- [One doc tagged with "production"](https://docs.luxid.lu/developers/tags/production.md)
- [One doc tagged with "react-native"](https://docs.luxid.lu/developers/tags/react-native.md)
- [One doc tagged with "react"](https://docs.luxid.lu/developers/tags/react.md)
- [3 docs tagged with "redirect-uris"](https://docs.luxid.lu/developers/tags/redirect-uris.md)
- [41 docs tagged with "reference"](https://docs.luxid.lu/developers/tags/reference.md)
- [One doc tagged with "risk-scoring"](https://docs.luxid.lu/developers/tags/risk-scoring.md)
- [One doc tagged with "salesforce"](https://docs.luxid.lu/developers/tags/salesforce.md)
- [9 docs tagged with "saml"](https://docs.luxid.lu/developers/tags/saml.md)
- [8 docs tagged with "sandbox"](https://docs.luxid.lu/developers/tags/sandbox.md)
- [One doc tagged with "servicenow"](https://docs.luxid.lu/developers/tags/servicenow.md)
- [5 docs tagged with "session-management"](https://docs.luxid.lu/developers/tags/session-management.md)
- [2 docs tagged with "sla"](https://docs.luxid.lu/developers/tags/sla.md)
- [One doc tagged with "spring"](https://docs.luxid.lu/developers/tags/spring.md)
- [One doc tagged with "sso"](https://docs.luxid.lu/developers/tags/sso.md)
- [7 docs tagged with "testing"](https://docs.luxid.lu/developers/tags/testing.md)
- [16 docs tagged with "tokens"](https://docs.luxid.lu/developers/tags/tokens.md)
- [2 docs tagged with "totp"](https://docs.luxid.lu/developers/tags/totp.md)
- [10 docs tagged with "troubleshooting"](https://docs.luxid.lu/developers/tags/troubleshooting.md)
- [4 docs tagged with "trust-framework"](https://docs.luxid.lu/developers/tags/trust-framework.md)
- [3 docs tagged with "universal-login"](https://docs.luxid.lu/developers/tags/universal-login.md)
- [6 docs tagged with "user-journey"](https://docs.luxid.lu/developers/tags/user-journey.md)
- [3 docs tagged with "webauthn"](https://docs.luxid.lu/developers/tags/webauthn.md)
- [One doc tagged with "wordpress"](https://docs.luxid.lu/developers/tags/wordpress.md)

### apis-and-advanced

- [Federate Microsoft Entra ID with LuxID Pro](https://docs.luxid.lu/developers/apis-and-advanced/entra-id-luxid-pro-federation.md): Register and configure a Microsoft Entra ID application so your users authenticate to LuxID-connected services through LuxID Pro federation.

### apis

Overview of extended LuxID technical capabilities: UserInfo, introspection, revocation, webhooks, delegated authorisation, and cross-border federation.

- [APIs and advanced](https://docs.luxid.lu/developers/apis.md): Overview of extended LuxID technical capabilities: UserInfo, introspection, revocation, webhooks, delegated authorisation, and cross-border federation.
- [Delegated authorisation](https://docs.luxid.lu/developers/apis/delegated-authorization.md): Patterns for one LuxID application acting on behalf of a user at another service: delegated tokens, token exchange, and refresh token scoping.
- [Endpoints reference](https://docs.luxid.lu/developers/apis/endpoints-reference.md): Canonical list of LuxID OIDC, SAML and supporting endpoints for production and UAT, derived from the discovery document - one place to look up every URL.
- [LuxID Partner API](https://docs.luxid.lu/developers/apis/partner-api.md): Server-to-server REST API for LuxID Partners to manage applications, subscriptions, groups, custom claims, and user events programmatically.
- [Application Subscriptions](https://docs.luxid.lu/developers/apis/partner-api/application-subscriptions.md): Read and revoke the subscription that links a LuxID user to one of your applications.
- [Applications](https://docs.luxid.lu/developers/apis/partner-api/applications.md): Discover the LuxID-registered applications and instances that belong to your partnership, and the groups attached to each application.
- [Claims](https://docs.luxid.lu/developers/apis/partner-api/claims.md): Set or remove a custom claim value on a subscriber, to be surfaced on subsequent authentications.
- [Event Hub](https://docs.luxid.lu/developers/apis/partner-api/event-hub.md): Search the time-ordered stream of user-related events tied to your partnership's applications, with pagination.
- [Getting started with the Partner API](https://docs.luxid.lu/developers/apis/partner-api/getting-started.md): Authentication, base URLs, request and response conventions, and the standard error model for the LuxID Partner API.
- [Groups](https://docs.luxid.lu/developers/apis/partner-api/groups.md): List partner-managed groups, list members, list a user's group memberships, and add or remove members in bulk.
- [Rate limits and quotas](https://docs.luxid.lu/developers/apis/rate-limits-and-quotas.md): How LuxID rate limits the authorize, token and UserInfo endpoints, and how to handle HTTP 429 with Retry-After and exponential backoff.
- [Token introspection](https://docs.luxid.lu/developers/apis/token-introspection.md): LuxID RFC 7662 token introspection reference: request format, response fields, caching, and why local JWT validation is preferred today.
- [UserInfo endpoint](https://docs.luxid.lu/developers/apis/userinfo.md): Call the LuxID UserInfo endpoint with a Bearer access token to fetch current profile claims: request formats, response claims, caching, and errors.
- [Webhooks and events API](https://docs.luxid.lu/developers/apis/webhooks-and-events-api.md): Subscribe to LuxID identity events via push (webhooks) or pull (Event Hub): subscription management, payload signing, delivery semantics, and replay protection.

### authenticate

Overview of LuxID authentication protocols - OIDC, OAuth 2.0, and SAML 2.0 - with guidance on choosing the right approach for your integration.

- [Authenticate](https://docs.luxid.lu/developers/authenticate.md): Overview of LuxID authentication protocols - OIDC, OAuth 2.0, and SAML 2.0 - with guidance on choosing the right approach for your integration.
- [Add login to your Application](https://docs.luxid.lu/developers/authenticate/add-login.md): 15-minute quickstart: implement Authorization Code Flow with PKCE against LuxID, with cURL examples, sequence diagram, and ID token validation.
- [Authorization request parameters](https://docs.luxid.lu/developers/authenticate/authorization-request-parameters.md): A consolidated reference of every parameter LuxID accepts on the authorization endpoint, with its required/optional status, accepted values, and LuxID specifics.
- [Code samples and reference repos](https://docs.luxid.lu/developers/authenticate/code-samples-and-reference-repos.md): Curated index of reference repositories, starter templates, and validation utilities for integrating LuxID with the major language ecosystems.
- [OAuth 2.0 for APIs](https://docs.luxid.lu/developers/authenticate/oauth2-for-apis.md): Protecting backend APIs with OAuth 2.0 bearer tokens, scopes, audiences, and machine-to-machine patterns at LuxID.
- [OpenID Connect](https://docs.luxid.lu/developers/authenticate/openid-connect.md): Full OIDC protocol reference for LuxID: discovery, all request parameters, token validation, UserInfo, refresh, silent re-auth, logout, and response modes.
- [Passkeys and WebAuthn: what runs where](https://docs.luxid.lu/developers/authenticate/passkeys-and-webauthn-what-runs-where.md): All WebAuthn passkey ceremonies run on LuxID Universal Login - Partners never call WebAuthn APIs. What you observe in tokens and what it means for native apps.
- [Platform and framework guides](https://docs.luxid.lu/developers/authenticate/platform-and-framework-guides.md): Minimal configuration to wire LuxID into Spring, ASP.NET, Node.js, Next.js, React SPA, Angular, React Native, iOS, Android, PHP, and Python.
- [SAML 2.0](https://docs.luxid.lu/developers/authenticate/saml-2.0.md): Integrating LuxID as a SAML 2.0 Identity Provider: metadata, AuthnRequest, Assertion validation, attribute mapping, and logout behaviour.

### concepts

Shared vocabulary and mental model for architects, senior developers, and security engineers integrating with LuxID.

- [Concepts and fundamentals](https://docs.luxid.lu/developers/concepts.md): Shared vocabulary and mental model for architects, senior developers, and security engineers integrating with LuxID.
- [Authentication levels](https://docs.luxid.lu/developers/concepts/authentication-levels.md): LuxID's auth_level authentication-strength scale, its informal eIDAS LoA alignment, and how to request a minimum level with acr_values.
- [Glossary](https://docs.luxid.lu/developers/concepts/glossary.md): Alphabetical glossary of LuxID developer terms: entities, tokens, claims, protocols, and authentication concepts, each linked to its canonical page.
- [Identity fundamentals](https://docs.luxid.lu/developers/concepts/identity-fundamentals.md): Authentication, authorisation, federation, sessions vs tokens, open standards, and JWT structure explained for LuxID integrators.
- [Mapping LuxID identities to your application](https://docs.luxid.lu/developers/concepts/mapping-identities.md): How to connect LuxID to your application: link users on the stable sub claim, keep your own internal user ID, and treat the IdP as a pluggable component.
- [Privacy and consent](https://docs.luxid.lu/developers/concepts/privacy-and-consent.md): Data minimisation, explicit consent, revocability, Sphere-based pseudonymisation, and GDPR alignment in LuxID.
- [Roles in the ecosystem](https://docs.luxid.lu/developers/concepts/roles-in-the-ecosystem.md): The LuxID domain model: User, Organisation, Partner, Application, Sphere, Subscription, Group, Claim, Consent, and Federation explained with worked examples.
- [Tokens and claims](https://docs.luxid.lu/developers/concepts/tokens-and-claims.md): ID Token, Access Token, and Refresh Token explained in depth: lifetimes, signing, validation rules, and the full LuxID claim catalogue including extensions.

### console

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

- [LuxID Console](https://docs.luxid.lu/developers/console.md): Overview of the LuxID Console - the operational portal for Partner administrators to manage Applications, credentials, logs, and branding.
- [Branding configuration](https://docs.luxid.lu/developers/console/branding-configuration.md): Configuring per-Application logos, display names, and localised descriptions shown on the LuxID consent screen, and previewing them before go-live.
- [Client credentials](https://docs.luxid.lu/developers/console/client-credentials.md): Viewing and rotating Client Secrets, and SAML signing certificate lifecycle in the LuxID Console.
- [Environments](https://docs.luxid.lu/developers/console/environments.md): How LuxID's Production and UAT environments differ, how to promote an Application between them, and data residency details.
- [Logs and audit trails](https://docs.luxid.lu/developers/console/logs-and-audit-trails.md): Querying authentication logs, Subscription events, and configuration audit records in the LuxID Console, including filtering, export, and retention.
- [Redirect URIs and domains](https://docs.luxid.lu/developers/console/redirect-uris-and-domains.md): Rules, configuration steps, and troubleshooting guidance for redirect URIs and domain ownership in LuxID Applications.
- [Register an Application](https://docs.luxid.lu/developers/console/register-an-application.md): What to submit to register a new client Application with LuxID: required fields, claim declarations, access rules, and authentication level configuration.
- [Requesting changes today (interim operations)](https://docs.luxid.lu/developers/console/requesting-changes-today.md): How to perform every Console operation while self-service is on the roadmap: one request template per operation, all routed via servicedesk@post.lu.
- [Test users and simulation](https://docs.luxid.lu/developers/console/test-users-and-simulation.md): Creating and configuring test user accounts in UAT, simulating authentication scenarios, and resetting test user state in the LuxID Console.

### faq

Frequently asked questions about integrating LuxID: onboarding, protocol support, tokens, claims, MFA, LuxID Verified, LuxID Pro, compliance, and operations.

- [Frequently asked questions](https://docs.luxid.lu/developers/faq.md): Frequently asked questions about integrating LuxID: onboarding, protocol support, tokens, claims, MFA, LuxID Verified, LuxID Pro, compliance, and operations.

### features

Overview of LuxID value-add features beyond basic OIDC login: MFA, passkeys, identity verification, SSO, security signals, and more.

- [Features](https://docs.luxid.lu/developers/features.md): Overview of LuxID value-add features beyond basic OIDC login: MFA, passkeys, identity verification, SSO, security signals, and more.
- [Attribute enrichment](https://docs.luxid.lu/developers/features/attribute-enrichment.md): Roadmap: optional enriched claims beyond standard OIDC profile - organisation, age brackets, residency, postal address - each requiring explicit user consent.
- [Breached password detection](https://docs.luxid.lu/developers/features/breached-password-detection.md): LuxID checks passwords against breach intelligence at registration and reset, blocking compromised credentials before they reach your users' accounts.
- [Events and Event Hub](https://docs.luxid.lu/developers/features/events-and-event-hub.md): Overview of LuxID identity events: the common event envelope, pull vs push delivery, the indicative event catalogue, and SIEM integration.
- [LuxID as OpenRoaming IdP](https://docs.luxid.lu/developers/features/luxid-as-openroaming-idp.md): LuxID acts as an OpenRoaming Wi-Fi identity provider, letting users roam onto participating networks in Luxembourg without re-authentication.
- [LuxID Verified: identity verification](https://docs.luxid.lu/developers/features/luxid-verified-identity-verification.md): LuxID Verified confirms a user's name and date of birth via LuxTrust: verification process, token claims, use cases, and relay-only LoA provenance.
- [Multi-factor authentication](https://docs.luxid.lu/developers/features/multi-factor-authentication.md): LuxID MFA methods (OTP, TOTP, passkeys, LuxTrust), token claims amr and acr, minimum assurance configuration, step-up flows, and recovery paths.
- [Passwordless and passkeys](https://docs.luxid.lu/developers/features/passwordless-and-passkeys.md): WebAuthn/FIDO2 passkeys on LuxID: device binding, platform and roaming authenticators, token claims, fallback behaviour, and phishing resistance.
- [Security signals and risk scoring](https://docs.luxid.lu/developers/features/security-signals-and-risk-scoring.md): LuxID evaluates each sign-in against contextual security signals and surfaces a qualitative risk indicator as an ID Token claim for Partner use.
- [Single sign-on and LuxID Pro](https://docs.luxid.lu/developers/features/single-sign-on.md): Consumer SSO across LuxID-enabled apps and LuxID Pro enterprise federation: Sphere boundaries, domain routing, corporate IdP integration, token claims.
- [Universal Login](https://docs.luxid.lu/developers/features/universal-login.md): LuxID's hosted login page: redirect-based authentication, branding boundaries, session reuse, and why Partners should never build their own login form.

### get-started

Orientation for developers and IT leads integrating with LuxID: what this section covers, two integration ramps, and where to begin.

- [Get started](https://docs.luxid.lu/developers/get-started.md): Orientation for developers and IT leads integrating with LuxID: what this section covers, two integration ramps, and where to begin.
- [Coming from Auth0, Okta or Keycloak](https://docs.luxid.lu/developers/get-started/coming-from-auth0-okta-or-keycloak.md): Concept-mapping guide for developers used to multi-tenant IdPs: what maps to what on LuxID, what stays standard OIDC, and what you cannot customize.
- [Configure LuxID](https://docs.luxid.lu/developers/get-started/configure-luxid.md): End-to-end guide: become a LuxID Partner, register an Application, obtain credentials, and complete a first test login using Authorization Code + PKCE.
- [Learn the basics](https://docs.luxid.lu/developers/get-started/learn-the-basics.md): Core identity concepts and the LuxID domain model you need before writing any integration code.
- [LuxID onboarding](https://docs.luxid.lu/developers/get-started/luxid-onboarding.md): What LuxID is, its governance structure, ecosystem role in Luxembourg, and the use cases it is designed for.
- [Plan and design](https://docs.luxid.lu/developers/get-started/plan-and-design.md): Architectural decisions to make before writing production code: protocol, required auth_level, MFA, Sphere, session strategy, logout, and branding.

### governance

Overview of LuxID's legal structure, trust framework, compliance obligations and Partner governance for enterprise and regulated integrations.

- [Governance, trust and compliance](https://docs.luxid.lu/developers/governance.md): Overview of LuxID's legal structure, trust framework, compliance obligations and Partner governance for enterprise and regulated integrations.
- [Certification and accreditation](https://docs.luxid.lu/developers/governance/certification-and-accreditation.md): LuxID's own certifications and accreditations, and Partner certification expectations by sector for high-assurance and regulated integrations.
- [Change management and roadmap](https://docs.luxid.lu/developers/governance/change-management-and-roadmap.md): How LuxID communicates platform changes to Partners: change categories, notification windows, deprecation policy, communication channels and roadmap visibility.
- [GDPR and data protection](https://docs.luxid.lu/developers/governance/gdpr-and-data-protection.md): GDPR guidance for LuxID Partners: controller and processor roles, lawful basis, data minimisation, user rights, breach notification and cross-border transfers.
- [Legal agreements and templates](https://docs.luxid.lu/developers/governance/legal-agreements-and-templates.md): LuxID Agreement structure, why no separate DPA is needed, privacy notice template and brand usage terms for LuxID integrations.
- [Security overview for assessors](https://docs.luxid.lu/developers/governance/security-overview-for-assessors.md): Entry point for security and compliance officers assessing LuxID: responsibility split, key controls, retention, and where each claim is documented.
- [Service provider onboarding](https://docs.luxid.lu/developers/governance/service-provider-onboarding.md): End-to-end journey for becoming a LuxID Partner: from first contact through KYB, agreement, UAT integration, go-live review to production credentials.
- [SLA and support](https://docs.luxid.lu/developers/governance/sla-and-support.md): LuxID service-level commitments for Partners: availability targets, maintenance windows, incident severities, support channels, and DORA considerations.
- [Trust framework](https://docs.luxid.lu/developers/governance/trust-framework.md): LuxID's legal entity structure, responsibility allocation between operator, Partners and users, assurance model, audit obligations and security baseline.

### mental-model

Mental model for navigating the LuxID developer documentation: five layers, persona-based reading paths, and one-sentence summary per top-level section.

- [How to read this documentation](https://docs.luxid.lu/developers/mental-model.md): Mental model for navigating the LuxID developer documentation: five layers, persona-based reading paths, and one-sentence summary per top-level section.

### quick-integrations

Add LuxID login to Odoo, WordPress, Drupal, Microsoft 365, Salesforce, and other off-the-shelf tools in 10-30 minutes without writing code.

- [Quick integrations (no-code / SaaS)](https://docs.luxid.lu/developers/quick-integrations.md): Add LuxID login to Odoo, WordPress, Drupal, Microsoft 365, Salesforce, and other off-the-shelf tools in 10-30 minutes without writing code.
- [Before you start](https://docs.luxid.lu/developers/quick-integrations/before-you-start.md): Checklist of prerequisites every IT admin must have in hand before configuring LuxID in an off-the-shelf tool.
- [FusionAuth](https://docs.luxid.lu/developers/quick-integrations/brokers/fusionauth.md): Add LuxID as an OpenID Connect Identity Provider in FusionAuth, including the reconcile lambda for claim mapping, testing, and production checklist.
- [Generic OIDC broker](https://docs.luxid.lu/developers/quick-integrations/brokers/generic-oidc-broker.md): Configure any OIDC-capable identity broker against LuxID: discovery URL, PKCE (S256), RS256 ID tokens, exact-match redirect URIs, and JWKS rotation.
- [Keycloak](https://docs.luxid.lu/developers/quick-integrations/brokers/keycloak.md): Add LuxID as an external OpenID Connect identity provider in Keycloak (Identity Brokering): field mapping, claim mappers, testing, production checklist.
- [Matrix homeserver (Synapse and MAS)](https://docs.luxid.lu/developers/quick-integrations/brokers/matrix.md): Configure LuxID as an OIDC provider for a Matrix homeserver: legacy Synapse built-in OIDC and the next-gen Matrix Authentication Service (MAS).
- [SAP Customer Data Cloud](https://docs.luxid.lu/developers/quick-integrations/brokers/sap-customer-data-cloud.md): Configure LuxID as an OpenID Connect identity provider in SAP Customer Data Cloud (formerly Gigya): field mapping, JIT account behaviour, and common pitfalls.
- [Generic OIDC setup](https://docs.luxid.lu/developers/quick-integrations/generic-oidc-setup.md): LuxID OIDC endpoints, scopes, claims, and field mapping reference for any tool that asks for OpenID Connect provider details.
- [Generic SAML setup](https://docs.luxid.lu/developers/quick-integrations/generic-saml-setup.md): LuxID SAML 2.0 IdP metadata, entity ID, ACS URL expectations, attribute mapping, and field reference for any SAML-capable tool.
- [Identity broker integrations](https://docs.luxid.lu/developers/quick-integrations/idp-broker-integrations.md): Configure LuxID as an upstream OIDC provider behind your own broker: Keycloak, FusionAuth, Matrix (Synapse, MAS), SAP Customer Data Cloud, or generic OIDC.
- [OIDC vs SAML decision guide](https://docs.luxid.lu/developers/quick-integrations/oidc-vs-saml-decision-guide.md): 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](https://docs.luxid.lu/developers/quick-integrations/overview.md): What the Quick Integrations section covers, the 5-step template every guide follows, and how to know you are in the right place.
- [Tool-specific integrations](https://docs.luxid.lu/developers/quick-integrations/tool-specific-integrations.md): Pick your SaaS tool to get a dedicated step-by-step LuxID integration guide: Odoo, WordPress, Drupal, ServiceNow, Atlassian, Microsoft 365, Salesforce, Moodle.
- [Atlassian Cloud](https://docs.luxid.lu/developers/quick-integrations/tools/atlassian-cloud.md): Step-by-step guide to integrate LuxID with Atlassian Cloud via SAML 2.0: prerequisites, field mapping, testing, and a production checklist.
- [Drupal](https://docs.luxid.lu/developers/quick-integrations/tools/drupal.md): Step-by-step guide to integrate LuxID with Drupal via OIDC: prerequisites, field mapping, testing, and a production checklist. Typical time: 15-20 min.
- [Microsoft 365](https://docs.luxid.lu/developers/quick-integrations/tools/microsoft-365.md): Step-by-step guide to integrate LuxID with Microsoft 365 via SAML 2.0: prerequisites, field mapping, testing, and a production checklist.
- [Moodle](https://docs.luxid.lu/developers/quick-integrations/tools/moodle.md): Step-by-step guide to integrate LuxID with Moodle via OIDC: prerequisites, field mapping, testing, and a production checklist. Typical time: 15-20 min.
- [Odoo](https://docs.luxid.lu/developers/quick-integrations/tools/odoo.md): Step-by-step guide to integrate LuxID with Odoo via OIDC: prerequisites, field mapping, testing, and a production checklist. Typical time: 15-20 min.
- [Salesforce](https://docs.luxid.lu/developers/quick-integrations/tools/salesforce.md): Step-by-step guide to integrate LuxID with Salesforce via OIDC: prerequisites, field mapping, testing, and a production checklist. Typical time: 20-30 min.
- [ServiceNow](https://docs.luxid.lu/developers/quick-integrations/tools/servicenow.md): Step-by-step guide to integrate LuxID with ServiceNow via OIDC or SAML: prerequisites, field mapping, testing, and a production checklist.
- [WordPress](https://docs.luxid.lu/developers/quick-integrations/tools/wordpress.md): Step-by-step guide to integrate LuxID with WordPress via OIDC: prerequisites, field mapping, testing, and a production checklist. Typical time: 15 min.

### secure

Security guidance for LuxID integrations: application protection, session lifecycle, key management, and advanced options such as PAR and JAR.

- [Secure](https://docs.luxid.lu/developers/secure.md): Security guidance for LuxID integrations: application protection, session lifecycle, key management, and advanced options such as PAR and JAR.
- [Advanced security options](https://docs.luxid.lu/developers/secure/advanced-security-options.md): PAR, JAR, and rate limiting for LuxID Partners with elevated security requirements. PAR and JAR are informational only - not currently implemented by LuxID.
- [Calling LuxID reliably](https://docs.luxid.lu/developers/secure/calling-luxid-reliably.md): Operational guidance for integrating with LuxID: timeouts, retries and backoff, idempotency, JWKS caching, and how to behave during a LuxID outage.
- [Integration security checklist](https://docs.luxid.lu/developers/secure/integration-security-checklist.md): A self-test checklist for LuxID Partners: what to verify in your own OIDC/OAuth 2.0 integration, and what LuxID enforces for you.
- [Key management](https://docs.luxid.lu/developers/secure/key-management.md): How LuxID signs ID Tokens, how to validate signatures using the JWKS endpoint, key rotation behaviour, and client credential security.
- [Protect your Application](https://docs.luxid.lu/developers/secure/protect-your-application.md): Security checklist for LuxID integrations: HTTPS, PKCE, state/nonce, ID Token validation, token storage, open redirects, and anti-patterns to avoid.
- [Token revocation](https://docs.luxid.lu/developers/secure/revocation.md): Revoke refresh tokens or access tokens programmatically using the RFC 7009 revocation endpoint, and understand the relationship with user-initiated revocation.
- [Security advisories and dependency currency](https://docs.luxid.lu/developers/secure/security-advisories-and-dependency-currency.md): How LuxID Partners stay informed about platform security notices, keep OIDC and JWT libraries patched, and stay ready for JWKS key rotation.
- [Session management](https://docs.luxid.lu/developers/secure/session-management.md): How to persist refresh tokens, silently renew sessions, and avoid re-prompting users for credentials and OTP on every app restart.

### testing

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

- [Testing and tooling](https://docs.luxid.lu/developers/testing.md): Overview of the LuxID developer tools and UAT environment for faster integration development and QA.
- [API explorer and Postman collections](https://docs.luxid.lu/developers/testing/api-explorer-and-postman-collections.md): Ready-made Postman collections, OpenAPI spec, and CI smoke-test scripts for the full LuxID token flow.
- [Attribute preview tool](https://docs.luxid.lu/developers/testing/attribute-preview-tool.md): Inspect which claims will be released to your application for a given test user and application configuration, before going live.
- [Consent simulator](https://docs.luxid.lu/developers/testing/consent-simulator.md): Preview the exact consent screen your application will show to users, across all supported languages, before going live.
- [Sandbox environment](https://docs.luxid.lu/developers/testing/sandbox-environment.md): How to use the LuxID UAT environment for development and QA: what differs from production, rate limits, test data lifecycle, and promoting to production.
- [Token debugger](https://docs.luxid.lu/developers/testing/token-debugger.md): How to inspect and validate LuxID ID Tokens and Access Tokens using the Token Debugger tool and offline alternatives.

### troubleshooting

Start here when your LuxID integration breaks. Decision flow, child page index, and escalation path for developers and IT admins.

- [Troubleshooting and support](https://docs.luxid.lu/developers/troubleshooting.md): Start here when your LuxID integration breaks. Decision flow, child page index, and escalation path for developers and IT admins.
- [Common errors](https://docs.luxid.lu/developers/troubleshooting/common-errors.md): The ten most frequent LuxID integration mistakes, with exact error responses, root causes, and fixes.
- [Contact and support channels](https://docs.luxid.lu/developers/troubleshooting/contact-and-support-channels.md): How to reach LuxID: the right mailbox for commercial, operational, security and end-user matters, what to include in a ticket, and response targets.
- [Diagnose a failing request](https://docs.luxid.lu/developers/troubleshooting/diagnose.md): A decision tree for diagnosing LuxID integration errors, which on-screen identifier to capture, and what to include when you raise a support ticket.
- [Endpoint cheat sheet](https://docs.luxid.lu/developers/troubleshooting/endpoint-cheat-sheet.md): Copy-paste curl and PowerShell commands to exercise LuxID's OIDC endpoints - discovery, token, refresh, userinfo, introspection - for troubleshooting.
- [Error reference](https://docs.luxid.lu/developers/troubleshooting/error-reference.md): One-table lookup of LuxID OAuth/OIDC error codes and platform errors: HTTP status, where they surface, likely cause, whether to retry, and the fix.
- [IT admin quickstart: symptom to action](https://docs.luxid.lu/developers/troubleshooting/it-admin-quickstart.md): Configuration-level troubleshooting for IT administrators: map what users report to the check to run and the request to raise - no protocol knowledge needed.
- [LuxID identifiers reference](https://docs.luxid.lu/developers/troubleshooting/luxid-identifiers-reference.md): The four LuxID diagnostic identifiers - Error ID, Transaction ID, Support ID, and Global Transaction ID - where each appears and which one to ask a user for.
- [OAuth and OIDC error codes](https://docs.luxid.lu/developers/troubleshooting/oauth-and-oidc-error-codes.md): Reference catalogue of OAuth 2.0 and OIDC error codes at LuxID with the most common cause and fix for each.
- [Redirect and domain issues](https://docs.luxid.lu/developers/troubleshooting/redirect-and-domain-issues.md): Diagnosing redirect_uri mismatches, HTTPS misconfigurations, mobile deep-link issues, and SAML ACS URL problems at LuxID.
- [Token validation issues](https://docs.luxid.lu/developers/troubleshooting/token-validation-issues.md): Diagnosing ID Token and JWT validation failures at LuxID: signature, issuer, audience, expiry, nonce, at_hash, and algorithm confusion.

### ux

Design and branding guidelines for integrating LuxID sign-in consistently, accessibly, and in a way users across Luxembourg recognise and trust.

- [UX and branding](https://docs.luxid.lu/developers/ux.md): Design and branding guidelines for integrating LuxID sign-in consistently, accessibly, and in a way users across Luxembourg recognise and trust.
- [Accessibility and localisation](https://docs.luxid.lu/developers/ux/accessibility-and-localization.md): WCAG 2.2 AA compliance, ARIA patterns, keyboard navigation, lang, the LuxID language fall-back chain, and inclusive wording guidance for LuxID integrations.
- [Brand assets and visual identity](https://docs.luxid.lu/developers/ux/brand-assets-and-visual-identity.md): Logo usage rules, clear space, forbidden distortions, colour palette, typography, and favicon guidance for LuxID integrations.
- [Consent screen design](https://docs.luxid.lu/developers/ux/consent-screen-design.md): How the LuxID consent screen works, what your application name and logo contribute, per-claim labelling, and tone-of-language guidance.
- [Error and edge-case UX](https://docs.luxid.lu/developers/ux/error-and-edge-case-ux.md): Recommended microcopy for LuxID error states - access denied, network failure, expired session, account blocked - in English, French, German and Luxembourgish.
- [Login button guidelines](https://docs.luxid.lu/developers/ux/login-button-guidelines.md): The official LuxID sign-in button: the four modes, sizes and spacing, allowed text in each language, contrast rules, and CSS patterns.
- [Multi-factor UX](https://docs.luxid.lu/developers/ux/multi-factor-ux.md): Step-up authentication UX, per-method flows for OTP, TOTP, passkeys, and LuxTrust, recovery paths, lockout prevention, and re-authentication patterns.
- [Passwordless and passkey UX](https://docs.luxid.lu/developers/ux/passwordless-and-passkey-ux.md): Passkey education, device binding, browser compatibility, fallback flows, and cross-device sign-in UX for LuxID integrations.
- [Universal Login UX](https://docs.luxid.lu/developers/ux/universal-login-ux.md): Why redirect-based login is safer, what the LuxID hosted page guarantees, branding boundaries, mobile/desktop differences, and session reuse behaviour.
- [User journey patterns](https://docs.luxid.lu/developers/ux/user-journey-patterns.md): End-to-end sequence diagrams for first-time sign-in, returning sign-in, MFA challenge, LuxID Verified, LuxID Pro federation, account linking, and logout.

## users

Help with your LuxID Account: getting started, managing your account, security, privacy, recovery, and troubleshooting.

- [LuxID Account help](https://docs.luxid.lu/users.md): Help with your LuxID Account: getting started, managing your account, security, privacy, recovery, and troubleshooting.

### tags

- [Tags](https://docs.luxid.lu/users/tags.md)
- [One doc tagged with "accessibility"](https://docs.luxid.lu/users/tags/accessibility.md)
- [2 docs tagged with "account-deletion"](https://docs.luxid.lu/users/tags/account-deletion.md)
- [21 docs tagged with "account-management"](https://docs.luxid.lu/users/tags/account-management.md)
- [23 docs tagged with "account-security"](https://docs.luxid.lu/users/tags/account-security.md)
- [2 docs tagged with "data-export"](https://docs.luxid.lu/users/tags/data-export.md)
- [2 docs tagged with "faq"](https://docs.luxid.lu/users/tags/faq.md)
- [77 docs tagged with "for-end-users"](https://docs.luxid.lu/users/tags/for-end-users.md)
- [One doc tagged with "gdpr"](https://docs.luxid.lu/users/tags/gdpr.md)
- [11 docs tagged with "getting-started"](https://docs.luxid.lu/users/tags/getting-started.md)
- [25 docs tagged with "guide"](https://docs.luxid.lu/users/tags/guide.md)
- [One doc tagged with "identity-verification"](https://docs.luxid.lu/users/tags/identity-verification.md)
- [One doc tagged with "luxtrust"](https://docs.luxid.lu/users/tags/luxtrust.md)
- [3 docs tagged with "mfa"](https://docs.luxid.lu/users/tags/mfa.md)
- [One doc tagged with "notifications"](https://docs.luxid.lu/users/tags/notifications.md)
- [One doc tagged with "passkeys"](https://docs.luxid.lu/users/tags/passkeys.md)
- [8 docs tagged with "password"](https://docs.luxid.lu/users/tags/password.md)
- [10 docs tagged with "privacy"](https://docs.luxid.lu/users/tags/privacy.md)
- [12 docs tagged with "recovery"](https://docs.luxid.lu/users/tags/recovery.md)
- [2 docs tagged with "reference"](https://docs.luxid.lu/users/tags/reference.md)
- [One doc tagged with "smishing"](https://docs.luxid.lu/users/tags/smishing.md)
- [2 docs tagged with "third-party-apps"](https://docs.luxid.lu/users/tags/third-party-apps.md)
- [23 docs tagged with "troubleshooting"](https://docs.luxid.lu/users/tags/troubleshooting.md)
- [One doc tagged with "unrequested-otp"](https://docs.luxid.lu/users/tags/unrequested-otp.md)
- [One doc tagged with "vishing"](https://docs.luxid.lu/users/tags/vishing.md)

### about

Good-to-know topics for LuxID users: age requirements, policies, password managers, browser requirements, and other background details.

- [Good to know](https://docs.luxid.lu/users/about.md): Good-to-know topics for LuxID users: age requirements, policies, password managers, browser requirements, and other background details.
- [About your legal name and your LuxID Account](https://docs.luxid.lu/users/about/about-your-legal-name-and-your-luxid-account.md): How LuxID uses your legal name and how to update it
- [Age requirements on LuxID Accounts](https://docs.luxid.lu/users/about/age-requirements-on-luxid-accounts.md): Minimum age requirements for creating and managing a LuxID Account
- [Having more than one LuxID Account](https://docs.luxid.lu/users/about/having-more-than-one-luxid-account.md): Whether you can have several LuxID Accounts, why each one needs its own email, why accounts cannot be merged, and why teams should not share an account.
- [Inactive LuxID Account policy](https://docs.luxid.lu/users/about/inactive-luxid-account-policy.md): What happens to inactive LuxID Accounts and the inactivity policy
- [LuxID human verification](https://docs.luxid.lu/users/about/luxid-human-verification.md): How LuxID uses verification methods to prevent spam and abuse during account creation
- [Manage your LuxID Pro account](https://docs.luxid.lu/users/about/manage-your-luxid-pro-account.md): Differences and settings for LuxID Pro accounts managed by an organisation
- [Password managers](https://docs.luxid.lu/users/about/password-managers.md): What password managers are, how they work with LuxID, and how to troubleshoot common issues.
- [Use passwords and passkeys across your devices](https://docs.luxid.lu/users/about/use-passwords-and-passkeys-across-your-devices.md): How to use passwords and passkeys across devices for signing in to LuxID
- [Why do you need JavaScript, SessionStorage, and cookies](https://docs.luxid.lu/users/about/why-do-you-need-javascript-sessionstorage-and-cookies.md): Why JavaScript, sessionStorage, and cookies are required for LuxID to function

### account

Settings, personal info, preferences, and account configuration.

- [Manage your LuxID Account](https://docs.luxid.lu/users/account.md): Settings, personal info, preferences, and account configuration.
- [Accessibility settings](https://docs.luxid.lu/users/account/accessibility-settings.md): Accessibility features available in LuxID and how to use them.
- [Change the phone number on your account and how it's used](https://docs.luxid.lu/users/account/change-the-phone-number-on-your-account-and-how-its-used.md): How to add, update, or remove phone numbers and control how they are used
- [Change your language and preferences on the web](https://docs.luxid.lu/users/account/change-your-language-and-preferences-on-the-web.md): How to change the display language and preferences for LuxID services on the web
- [Change your LuxID Account name and other info](https://docs.luxid.lu/users/account/change-your-luxid-account-name-and-other-info.md): How to update your name and other personal information on your LuxID Account.
- [Change your username](https://docs.luxid.lu/users/account/changing-my-username.md): How to set or remove a username on your LuxID Account.
- [Manage your addresses in your LuxID Account](https://docs.luxid.lu/users/account/manage-your-addresses-in-your-luxid-account.md): How to add, update, and remove postal addresses in your LuxID Account.
- [Manage your email addresses](https://docs.luxid.lu/users/account/manage-your-email-addresses.md): Choose which email addresses to use for signing in, recovery, and receiving information
- [Manage your information](https://docs.luxid.lu/users/account/manage-your-information.md): How to view and update your personal information in your LuxID Account.
- [Manage your personal information across LuxID partners](https://docs.luxid.lu/users/account/manage-your-personal-information-across-luxid-partners.md): Keep your personal information up to date and review or remove your connections to LuxID partner services
- [Signing in settings](https://docs.luxid.lu/users/account/signing-in-settings.md): Resources for managing your LuxID sign-in preferences and settings

### connected-apps

Sign in with LuxID, share data with apps, and manage or remove third-party connections to your LuxID Account.

- [Use your LuxID Account with third-party apps and services](https://docs.luxid.lu/users/connected-apps.md): Sign in with LuxID, share data with apps, and manage or remove third-party connections to your LuxID Account.
- [Fix issues with LuxID Account third-party connections](https://docs.luxid.lu/users/connected-apps/fix-issues-with-luxid-account-third-party-connections.md): Troubleshoot problems with Sign in with LuxID and third-party data access
- [How LuxID protects the data you share](https://docs.luxid.lu/users/connected-apps/how-sign-in-with-luxid-helps-you-share-data-safely.md): What LuxID shares with apps when you use Sign in with LuxID, how an app may use your data, and how you stay in control.
- [Sign in with LuxID](https://docs.luxid.lu/users/connected-apps/how-sign-in-with-luxid-works.md): What Sign in with LuxID is, how to use it, what data is shared, and how to review or remove your app connections.
- [What you share with apps](https://docs.luxid.lu/users/connected-apps/what-you-share-with-apps.md): What an app can ask for when you sign in with LuxID, including verified facts confirmed with a simple yes or no without revealing the underlying data.

### faq

Answers to frequently asked questions about LuxID Accounts, grouped by topic: getting started, signing in, security, multiple accounts, apps, and privacy.

- [Frequently asked questions](https://docs.luxid.lu/users/faq.md): Answers to frequently asked questions about LuxID Accounts, grouped by topic: getting started, signing in, security, multiple accounts, apps, and privacy.

### get-started

First steps with your LuxID Account - creating, securing, and setting up.

- [Get started](https://docs.luxid.lu/users/get-started.md): First steps with your LuxID Account - creating, securing, and setting up.
- [Create a LuxID Account](https://docs.luxid.lu/users/get-started/create-a-luxid-account.md): Step-by-step instructions to create a new LuxID Account
- [Create a strong password](https://docs.luxid.lu/users/get-started/create-a-strong-password.md): Tips for creating a strong and secure password for your LuxID Account
- [Secure your account](https://docs.luxid.lu/users/get-started/secure-your-account.md): Security checklist for new LuxID Account owners to protect their account
- [Set or change your password](https://docs.luxid.lu/users/get-started/set-or-change-your-password.md): Set, change, or reset your LuxID password
- [Avoid getting locked out](https://docs.luxid.lu/users/get-started/set-up-recovery-options.md): How to protect yourself from losing access to your LuxID Account by setting up multiple sign-in options.
- [Sign in on a device that's not yours](https://docs.luxid.lu/users/get-started/sign-in-on-a-device-thats-not-yours.md): How to safely sign in to your LuxID Account on public or borrowed devices
- [Verify your account](https://docs.luxid.lu/users/get-started/verify-your-account.md): How to verify your LuxID Account using email and phone verification
- [What is a LuxID Account](https://docs.luxid.lu/users/get-started/what-is-a-luxid-account.md): Learn what a LuxID Account is and how it gives you access to LuxID partner services

### known-issues

Current known issues that can affect LuxID sign-in, with temporary workarounds while we work on a fix.

- [Known issues](https://docs.luxid.lu/users/known-issues.md): Current known issues that can affect LuxID sign-in, with temporary workarounds while we work on a fix.
- [Firefox with the Firefox Relay extension can crash on macOS](https://docs.luxid.lu/users/known-issues/firefox-relay-macos.md): On macOS the Firefox Relay extension can make Firefox crash on LuxID pages. Disable the extension or use another browser while we work on a fix.

### privacy

Activity controls, data download, deletion, and GDPR rights.

- [Account privacy](https://docs.luxid.lu/users/privacy.md): Activity controls, data download, deletion, and GDPR rights.
- [Delete your LuxID Account](https://docs.luxid.lu/users/privacy/delete-your-luxid-account.md): How to delete your LuxID Account and what happens to your data
- [Find, retrieve, and delete data](https://docs.luxid.lu/users/privacy/find-retrieve-and-delete-data.md): How to find, retrieve, and delete data stored in your LuxID Account
- [Your GDPR rights](https://docs.luxid.lu/users/privacy/gdpr-rights.md): Overview of your data protection rights under GDPR as a LuxID Account holder, with links to the underlying regulation articles.
- [How to retrieve your data](https://docs.luxid.lu/users/privacy/how-to-retrieve-your-luxid-data.md): How to request a copy of the personal data LuxID holds about you - handled under the GDPR by LuxID's Data Protection Officer.
- [LuxID activity controls](https://docs.luxid.lu/users/privacy/luxid-activity-controls.md): How to control what activity and data is saved to your LuxID Account

### recovery

Steps to regain access if locked out, compromised, or forgotten credentials.

- [Account recovery](https://docs.luxid.lu/users/recovery.md): Steps to regain access if locked out, compromised, or forgotten credentials.
- [Can't sign in to your LuxID Account](https://docs.luxid.lu/users/recovery/cant-sign-in-to-your-luxid-account.md): Troubleshooting steps when you cannot sign in to your LuxID Account
- [Change or reset your password](https://docs.luxid.lu/users/recovery/change-or-reset-your-password.md): How to change your LuxID password, or reset it if you have forgotten it
- [How to recover your LuxID Account](https://docs.luxid.lu/users/recovery/how-to-recover-your-luxid-account.md): Steps to recover your LuxID Account if you forgot your password or lost access.
- [Recover a recently deleted LuxID Account](https://docs.luxid.lu/users/recovery/recover-a-recently-deleted-luxid-account.md): A deleted LuxID Account cannot be recovered. What that means for your data, and how to start using LuxID again.
- [Secure a compromised LuxID Account](https://docs.luxid.lu/users/recovery/secure-a-hacked-or-compromised-luxid-account.md): Steps to detect suspicious activity and secure a compromised LuxID Account
- [Tips to complete account recovery steps](https://docs.luxid.lu/users/recovery/tips-to-complete-account-recovery-steps.md): Helpful tips for successfully completing the LuxID Account recovery process
- [Why your account recovery request is delayed](https://docs.luxid.lu/users/recovery/why-your-account-recovery-request-is-delayed.md): Why an account recovery request handled by LuxID support can take time, and how to avoid delays

### security

Passwords, 2-Step Verification, passkeys, suspicious activity, and keeping your LuxID Account secure.

- [Account security](https://docs.luxid.lu/users/security.md): Passwords, 2-Step Verification, passkeys, suspicious activity, and keeping your LuxID Account secure.
- [2-Step Verification](https://docs.luxid.lu/users/security/2-step-verification.md): How to set up and use 2-Step Verification on your LuxID Account
- [Check you're on a genuine LuxID page](https://docs.luxid.lu/users/security/check-youre-on-a-genuine-luxid-page.md): Confirm you are on a real LuxID page before typing your password or code - check the address and connection, and let your password manager help.
- [Forget a remembered device](https://docs.luxid.lu/users/security/forget-a-remembered-device.md): Review the devices LuxID remembers for faster sign-in, and forget any you no longer use or recognise.
- [Link your digital ID to your LuxID Account](https://docs.luxid.lu/users/security/link-your-digital-id-to-your-luxid-account.md): How to link an eIDAS-compatible digital identity (via LuxTrust) to your LuxID Account for identity verification
- [Make your account more secure](https://docs.luxid.lu/users/security/make-your-account-more-secure.md): Steps and recommendations to strengthen the security of your LuxID Account
- [Passkeys](https://docs.luxid.lu/users/security/passkeys.md): What passkeys are, how they work with LuxID, and how to set them up for passwordless sign-in.
- [Recognise legitimate LuxID messages](https://docs.luxid.lu/users/security/recognise-legitimate-luxid-messages.md): How to verify that an email, SMS, or phone call is genuinely from LuxID and not a phishing attempt.
- [Suspicious activity](https://docs.luxid.lu/users/security/suspicious-activity.md): How to investigate and respond to suspicious activity on your LuxID Account

### troubleshooting

Troubleshooting common issues - login problems, blocked accounts, 2-Step Verification.

- [Fix a problem](https://docs.luxid.lu/users/troubleshooting.md): Troubleshooting common issues - login problems, blocked accounts, 2-Step Verification.
- [Check for an account that exists](https://docs.luxid.lu/users/troubleshooting/check-for-an-account-that-exists.md): How to check whether you already have a LuxID Account
- [Common login problems with your LuxID Account](https://docs.luxid.lu/users/troubleshooting/common-login-problems-with-your-luxid-account.md): Solutions for common login issues including browser problems and 2-Step Verification
- [Common signup problems and solutions](https://docs.luxid.lu/users/troubleshooting/common-signup-problems-and-solutions.md): Solutions for common issues encountered during LuxID Account registration
- [Contact LuxID support](https://docs.luxid.lu/users/troubleshooting/contact-luxid-support.md): How to reach LuxID support if you need help with your account.
- [How to send us screenshots](https://docs.luxid.lu/users/troubleshooting/how-to-send-us-screenshots.md): How to take and send screenshots when contacting LuxID support
- [Error messages and what to do](https://docs.luxid.lu/users/troubleshooting/luxid-error-messages.md): Common error messages you may see on LuxID, what each one means, and how to resolve it.
- [Receiving messages from LuxID](https://docs.luxid.lu/users/troubleshooting/receiving-messages-from-luxid.md): How to identify legitimate LuxID messages and avoid phishing or smishing attacks
- [Someone changed your password](https://docs.luxid.lu/users/troubleshooting/someone-changed-your-password.md): What to do if someone changed your LuxID Account password without your permission
- [Stay signed in or signed out of your LuxID Account](https://docs.luxid.lu/users/troubleshooting/stay-signed-in-or-signed-out-of-your-luxid-account.md): Fix issues with staying signed in or being unexpectedly signed out of your account
- [Temporarily cannot log in to LuxID](https://docs.luxid.lu/users/troubleshooting/temporarily-cannot-log-in-to-luxid.md): What to do when you are temporarily blocked from logging in due to security measures
- [2-Step Verification is not working](https://docs.luxid.lu/users/troubleshooting/two-factor-authentication-2fa-is-not-working.md): Fix common 2-Step Verification issues including time sync problems and incorrect codes
- [Unrequested password reset messages](https://docs.luxid.lu/users/troubleshooting/unrequested-password-reset-messages.md): What to do if you receive password reset emails you did not request
- [What to do if you've lost your 2-Step Verification device](https://docs.luxid.lu/users/troubleshooting/what-to-do-if-youve-lost-your-2fa-device.md): How to recover access to your account if you lost your 2-Step Verification device
- [Why LuxID blocked my account](https://docs.luxid.lu/users/troubleshooting/why-luxid-blocked-my-account.md): Why LuxID may block your account for security, and how to get it unblocked