LiveSearchSiteAuth.xml

Overview

This XML file defines authorized users for the Live Search feature within the linuxfront-v2-logistics and linuxfront-v2 applications. It stores one or more hashed tokens to grant access to protected live-search endpoints.

File Location

The file appears in two modules, ensuring consistent authentication across services:

Path Purpose
linuxfront-v2-logistics/LiveSearchSiteAuth.xml Logistics front-end Live Search authentication
linuxfront-v2/LiveSearchSiteAuth.xml Core Live Search authentication

Content Structure

The file follows a simple XML schema with a root <users> element containing one or more <user> entries.

<?xml version="1.0"?>
<users>
  <user>FCF05F34C36EFE5CD90A3531596A0822</user>
</users>
  • <?xml version="1.0"?>: Standard XML declaration.
  • <users>: Container for all user tokens.
  • <user>: A single authorized token. You may add multiple <user> elements.

Adding or Revoking Access

To grant a new user access, insert a new <user> element with the user’s hashed identifier.

<users>
  <user>FCF05F34C36EFE5CD90A3531596A0822</user>
  <user>NEWUSERHASH1234567890ABCDEF</user>  <!-- ← added token -->
</users>

To revoke access, simply remove the corresponding <user> entry.

Usage in Code

Although no direct references were found in the PHP codebase, typical usage involves:

  • XML Parsing: Server-side script loads this file (e.g., via simplexml_load_file).
  • Token Validation: The application compares incoming user tokens against the list in <users>.
  • Access Control: Only requests presenting a matching token proceed to the Live Search service.

Security Considerations 🔒

  • File Permissions: Restrict read/write to application-level users only.
  • Web Access: Place this file outside the public web root or block direct HTTP access via web server rules.
  • Hash Management: Use strong, non-reversible hashing for user tokens.
  • Version Control: Avoid committing production tokens to public repositories.

This documentation covers the structure, purpose, and recommended handling of LiveSearchSiteAuth.xml in your logistics and core applications.