Skip to main content
Version 0.1Draft

LuxID identifiers reference

LuxID surfaces four distinct diagnostic identifiers. They are easy to confuse because several are long hexadecimal strings, but each appears in a different place, is aimed at a different audience, and correlates a different thing. Quoting the wrong one to support wastes a round-trip, so use this page to pick the right identifier for the situation in front of you.

The four identifiers

IdentifierWhere it appearsVisible to the end user?AudienceWhat it is forWhat to ask a user for
Error IDThe authentication error dialog ("Connection error with LuxID") and other known-scenario UI errors. A short symbolic label, e.g. login.YesUser and supportCategorises a known failure scenario (for example "user already exists", a login failure). Tells you what kind of error occurred.Yes - quote it alongside the Transaction ID; it names the scenario.
Transaction IDThe authentication error dialog ("Connection error with LuxID"), shown under the Error ID. A long hexadecimal string (~24 characters), e.g. e0b804c269ef2d7b10cbb7a2.YesUser and supportIdentifies the specific authentication transaction that failed, so LuxID can locate it in the authentication logs.Yes - this is the primary correlation handle for a failed sign-in.
Support IDThe WAF (Web Application Firewall) page shown when a request is blocked, or when the backend returns a 500 that the WAF masks.Yes (on WAF block / masked-500 pages)User and supportCorrelates a request that LuxID's edge blocked or masked, so LuxID can trace it. It is not the general authentication-error correlation ID.Yes - but only when the user is on a WAF block or "a technical error occurred" masked-500 page, not on the authentication error dialog.
Global Transaction IDThe HTTP response header. Not rendered on any screen.NoDevelopers and LuxIDCorrelates a request across LuxID's internal logs. Captured from response headers by developer tooling.No - the user never sees it. Developers can capture it from the response headers and include it in a ticket.

Which one do I ask the user for?

If the user is on the "Connection error with LuxID" authentication dialog, ask for the Error ID and the Transaction ID. If the user is on a WAF block page or a "technical error" masked-500 page, ask for the Support ID. Never ask a user for the Global Transaction ID - it lives only in HTTP headers; a developer captures it, not the user.

How to tell the screens apart

  • Authentication error dialog - titled "Connection error with LuxID" (localised per language), names support@luxid.lu, and shows an Error ID plus a long-hex Transaction ID. This is the screen a user reaches when a sign-in transaction fails.
  • WAF block / masked-500 page - a generic edge page shown when the request never reached (or was masked at) the LuxID application. It carries a Support ID rather than an Error ID / Transaction ID pair.
  • HTTP response - the Global Transaction ID header is present on responses regardless of screen; it is the developer-only tie-breaker when neither on-screen identifier is available.
Updated 2026-07-03