302 Logger

302 Logger is a utility designed to capture and log visitor interactions before a seamless redirection. This tool is ideal for analytical evaluations and can be used in various scenarios, including website migrations, A/B testing, and more.

Features

• Captures a wide range of data points, including IP address, User-Agent, screen dimensions, and more.
• Logs both server-side and client-side data.
• Utilizes cookies to assign unique identifiers to new users and to reliably identify returning visitors across sessions.
• Performs seamless redirection to a specified URL.
• Wildcard redirection support. (e.g., redirecting webapp.net/asd to webapp.com/asd)

Setup

1. Clone the Repository

   git clone https://github.com/omerbustun/302-logger.git

   cd 302-logger

2. Configure the Tool

   • Rename config.ini.default to config.ini.
   • Edit config.ini and set your desired REDIRECT_URL and LOG_FILE path.

3. Deploy

   Upload the files to your web server's root directory or a subdirectory. Make sure your server supports and has enabled PHP and the Apache mod_rewrite module.

4. Access the Tool

   Any request to your domain (or the subdirectory where you've placed the logger) will now capture data and then redirect to the specified REDIRECT_URL.

Usage Notes

• Make sure the directory containing your logs is writable by the server for data logging.
• Ensure that direct access to the config.ini file is restricted. The provided .htaccess file already contains a directive for this, but always double-check for security reasons.
• Respect user privacy. Only deploy this tool in scenarios where you have the right to capture user data.

Advanced Configurations

Handling Proxies and CDNs

If your server is behind a reverse proxy like Cloudflare, the logged IP address may not be the actual IP address of the client. Instead, it might capture the IP address of the proxy server.

To capture the real IP address of the client:

1. Cloudflare: Replace the line capturing the IP address in logger.php with the following:

   $ip_address = $_SERVER["HTTP_CF_CONNECTING_IP"] ?? $_SERVER['REMOTE_ADDR'] ?? 'unknown';

   Cloudflare sets the HTTP_CF_CONNECTING_IP header to the visitor's IP address.

2. Other Proxies: Different proxies may use different headers to forward the original IP address. For example, many proxies use the X-Forwarded-For header. Check the documentation of the proxy or CDN you are using to find the correct header.

Misc.

Log Parser Script

If you're looking to parse the generated logs into a structured format for easy analysis, you can use the log parser script. The script reads the .txt log file, extracts the data, and saves it in an Excel sheet.

Contribution

Feel free to fork this repository and submit pull requests for improvements or additional features.

License

This project is licensed under the GNU General Public License, version 3 (GPLv3). See the LICENSE file for the full license text.