Web Only User Activation and Account Recovery URLs

🎯 URL Localization Overview

User activation and account recovery screens can be localized by adding a language parameter to the URL, enabling direct language specification for specific processes.


📋 URL Parameter Implementation

🔧 Language Parameter

  • Parameter Name: lang\
  • Format: Locale identifier (e.g., es-ES, fr-FR, de-DE)
  • Usage: Appended to existing URLs as query parameter
  • Override Behavior: Overrides previously selected language preference

🌐 URL Examples

📧 Web Only User Activation URLs

Before Internationalization:

https://auth.relid.com:8006/relid/authserver/register?token=9d14686f6a3e-4506-a260-c4fc77da7071

After Internationalization (Spanish Language):

https://auth.relid.com:8006/relid/authserver/register?token=9d14686f6a3e-4506-a260-c4fc77da7071&lang=es-ES

🔄 Account Recovery URLs

The same lang parameter pattern applies to account recovery URLs:

Standard Recovery URL:

https://auth.relid.com:8006/relid/authserver/recovery?token=recovery_token_value

Localized Recovery URL (French):

https://auth.relid.com:8006/relid/authserver/recovery?token=recovery_token_value&lang=fr-FR

📊 Parameter Behaviour

🎯 Language Override

  • Immediate Effect: URL language parameter takes precedence over stored preference\
  • Session Impact: Language selection affects entire user session
  • Persistence: New language preference saved for future sessions
  • Scope: Applies to all screens in the activation or recovery flow

⚙️ Integration Benefits

  • Direct Links: Organizations can provide language-specific links\
  • Email Integration: Localized links can be included in notification emails
  • Support Efficiency: Support teams can provide language-appropriate URLs
  • User Experience: Users immediately see interface in expected language

🔧 Implementation Considerations

  • URL Construction: Properly encode language parameters in URLs\
  • Link Generation: System-generated links can include language parameters
  • Email Templates: Notification emails can use localized URLs
  • Documentation: Provide URL examples for different supported languages