Where to put log files

So far, we've put log files in the same folders as the webpages that write to them.

Reflect

Webpages and log files are in the same folders. What security issues might that cause?

If you were logged in as a student, the lesson would pause here, and you'd be asked to type in a response. If you want to try that out, ask for an account on this site.
Adela
Adela

Oh. People might be able to see the log files, by typing in their URLs.

Right! Not good.

Ethan
Ethan

But they'd have to know the names of the log files, to put them in the URLs. How would they know that?

There are URL guessing programs. They try lots of combinations, until they get lucky.

If the software is open source, hackers will have the program code. They can check it, to see what log files the programs make.

Even if the software is from a well-known vendor, like SAP, then many companies will be using it. Anyone who works with the software might know what the log file names are.

Another principle:

Principle

Security by obscurity doesn't work

Keep your code secret, and nobody can hack it, right? Well... it's not that easy.

Someone will figure out. And when they do, you are vulnerable.

Move the log files

To understand the solution, remember how web servers work. The server has a disk drive. One folder on the drive is the root of the website.

Web root

Files in this folder (or its subfolders) are accessible over the web.

Files that aren't in this folder are not accessible over the web.

Files outside the root are not on the web

PHP programs run on the server, and can access the server's entire file system. So, our PHP program could write log files in a folder that isn't under the web root. Problem solved!

file_put_contents

We can tell file_put_contents() to put data anywhere. Say I made a folder on my PC called D:\logfiles. I could use that in file_put_contents():

  • $filePath = 'D:/logfiles/dog-log.txt';
  • $logEntry = "Cutest dog: $cutestDog Rating: $rating\n";
  • file_put_contents($filePath, $logEntry, FILE_APPEND);
  • ?><!DOCTYPE html>

(Notice that I used / rather than \ in the path. In PHP, / works on Windows, Mac, and Linux, so let's use that.)

Does it work?

Log file

Yes! There's the file! W00t!

D:\logfiles isn't under the web root, so the log file isn't accessible through a URL. Hackers can try to guess the log file's URL as much as they want. The file doesn't have a URL. So... good luck with that, hackers!

Job interview

"I learned how to protect audit logs from URL guessing attacks" sounds good in a job interview.

Moving to your web server

This...

  • $filePath = 'D:/logfiles/dog-log.txt';
  • $logEntry = "Cutest dog: $cutestDog Rating: $rating\n";
  • file_put_contents($filePath, $logEntry, FILE_APPEND);
  • ?><!DOCTYPE html>

... works on my PC, but won't work on my Reclaim server. Linux doesn't use drive letters, for a start. So, I need to change the path to the log files to something that will work on Linux.

Here's ye olde cPanel file manager:

cPanel file manager

The is where my files go on the server. This is not a URL, but a file path.

I can make a folder for my log files.

Make a folder

There it is, next to an existing folder called logs.

Made a folder

Look in the new folder, and it's MT.

MT folder

So, I made new folder, at /home/cullenma/logfiles.

Let's use that in some PHP.

  1. <?php
  2. // Get data from the URL.
  3. $cutestDog = $_GET['name'];
  4. $rating = $_GET['cuteness'];
  5. // Log.
  6. $filePath = '/home/cullenma/logfiles/dog-log.txt';
  7. if ( file_exists($filePath) && filesize($filePath) > 10000) {
  8.     header('Location: log-file-size-warning.php');
  9.     exit();
  10. }
  11. $logEntry = "Cutest dog: $cutestDog Rating: $rating\n";
  12. file_put_contents($filePath, $logEntry, FILE_APPEND);
  13. ?><!DOCTYPE html>
  14. ...

You can see the path to the log file in line 6.

OK, I go to this page, then look in the cPanel file manager again. Reload, and see:

Log file created

W00t! Now I can write logs on my Reclaim server, and the log files aren't accessible over the web. The log files are limited in size, too. Take that, hackers! Sucks to be you!

Up next

Let's talk about what data will be in each event log record, and how we'll format it.