OPS235 Assignment 2 OLD

This is a draft only!
It is still under construction and content may change. Do not rely on this information.

Please take note!
Doing your assignment is part of your ongoing learning process. As such you will be tested on this material in future tests and exams. If you have any questions or need help, please consult your instructor in a timely manner. The due date for this assignment will not be extended. This assignment will be marked partially through demonstration and partially through the submission of files.

OPS235 Assignment #1 -- Winter 2010

Weight: 5% of the overall grade

Due Date: Week 13 - week of April 15-19 (Check with your Professor for exact date)

Very Important!
Before making any changes to your system configuration, backup the original configuration files into the /backups directory.

Introduction and Purpose

In this assignment, you will demonstrate the skills you have learned to this point by configuring two services: a database server and a web server. You will install and use a database-backed web application, MediaWiki, to show that these services have been installed properly. Finally, you will configure the SELinux security system to ensure that these new services are not used to gain unauthorized access to your system.

This lab may be performed using any combination of your virtual machines and/or host disk pack.

About SELinux

SELinux stands for Security Enhanced Linux and is based on research performed at NSA and other locations. Where the normal Unix/Linux security system, based upon file permissions, is a discretionary access control system (DAC), SELinux is a mandatory access control system (MAC). This means that it attempts to enforce a consistent policy across the entire system, regardless of settings that any user has configured.

SELinux decisions are based on the security context of system resources such as files and processes. The security context consists of a user, role, type, and sensitivity component; you can see the security context of files and processes by adding the -Z option to the ls and ps commands:

$ ls -lZ
drwxr-xr-x. root  root  system_u:object_r:file_t:s0          arm
drwxr-xr-x. chris chris unconfined_u:object_r:user_home_t:s0 arm2
drwxrwxr-x. chris chris unconfined_u:object_r:user_home_t:s0 bin
drwxr-xr-x. chris chris unconfined_u:object_r:user_home_t:s0 Desktop
drwxr-xr-x. chris chris unconfined_u:object_r:user_home_t:s0 Documents
drwxr-xr-x. chris chris unconfined_u:object_r:user_home_t:s0 Downloads
-rw-------. chris chris unconfined_u:object_r:user_home_t:s0 fedora0.ks
-rw-------. chris chris unconfined_u:object_r:user_home_t:s0 fedora1.ks
-rw-------. chris chris unconfined_u:object_r:user_home_t:s0 fedora2.ks
-rw-------. chris chris unconfined_u:object_r:user_home_t:s0 fedora3.ks
-rw-rw-r--. chris chris unconfined_u:object_r:user_home_t:s0 foo
-rw-r--r--. chris chris unconfined_u:object_r:user_home_t:s0 hosts
drwxr-xr-x. chris chris unconfined_u:object_r:user_home_t:s0 Music
drwxr-xr-x. chris chris unconfined_u:object_r:user_home_t:s0 Pictures
drwxrwxr-x. chris chris unconfined_u:object_r:user_home_t:s0 play
drwxr-xr-x. chris chris unconfined_u:object_r:user_home_t:s0 Public
drwxr-xr-x. chris chris unconfined_u:object_r:user_home_t:s0 Templates
drwxr-xr-x. chris chris unconfined_u:object_r:user_home_t:s0 Videos
-rw-r--r--. chris chris unconfined_u:object_r:user_home_t:s0 x
[chris@muskoka ~]$ ps -Z
LABEL                                                  PID TTY      TIME CMD
unconfined_u:unconfined_r:unconfined_t:s0-s0:c0.c1023 2595 pts/1 00:00:00 bash
unconfined_u:unconfined_r:unconfined_t:s0-s0:c0.c1023 2612 pts/1 00:00:00 ps

The SELinux policy controls the interactions between security contexts. For example, the policy may specify that the Apache httpd webserver cannot read files in /etc, so if an attacker finds a way to make httpd (or a script run by httpd) read a file in /etc, SELinux will recognize that this is not normal and will deny the access. Since this is done at the kernel level, httpd will get a "file not found" error, even though the file is present, and there is no way for httpd to work around that error.

SELinux Context Commands

There are two main commands used to set the SELinux security context of files:

• setcon - sets the security context of a file to a particular value
• restorecon - resets the default security context of a file

You can reset the default security context of the entire system at the next boot with this command:

touch /.autorelabel

SELinux Booleans

SELinux policy can be tuned (without writing an entirely new policy) through the use of booleans or option switches. Each boolean can have a value of on (1) or off (0).

The getsebool and setsebool commands can be used to view and set SELinux boolean values:

Command	Description
getsebool -a	Displays all SELinux booleans
getsebool foo	Displays the SELinux boolean foo
setsebool foo value	Sets the SELinux boolean foo to value (where value is 0 or "off", or 1 or "on")

SELinux Graphical Tools

The system-config-selinux tool, which is on the menu as System>Adminstration>SELinux Management, provides a GUI for man aging SELinux booleans and more.

Takes Notes!
Take detailed notes of the steps you perform from this point onward.

Installing Packages

Install these packages using yum:

• httpd - this is the Apache web server software. It provides the httpd service, which runs on port 80.
• mysql-server - this is the MySQL database server. It provides the mysqld service, which runs on a Unix domain socket.
• mediawiki - this is the wiki software used by this wiki, Wikipedia, and many other sites. It is a series of PHP scripts which are run by Apache httpd as requests are received, and it connects to a local database such as MySQL.

Configuring Services

Apache httpd

1. Start the httpd service using the service command.
2. Confirm that you can connect to your web server using a web browser -- both from the machine on which the server is running as well as from another machine on the same network. You should see a test page.
3. Configure this software to start when the system is booted.
4. Create a very simple HTML index page for your system, and place it at <code>/var/www/html/index.html
5. Confirm that you can view the index page. If not, adjust your iptables configuration as necessary, or check for errors in /var/log/httpd

MySQL

1. Start the MySQL service (mysqld).
2. When started for the first time, this service will print a message telling you how to set a password and take other basic steps to secure the the MySQL server. Follow those instructions to set a password.
3. Configure this software to start when the system is booted.

MediaWiki

1. Edit MediaWiki's httpd configuration file, /etc/httpd/conf.d/mediawiki.conf
   • Uncomment the first two Alias lines
   • Reload the httpd configuration using the service command
2. Access http://localhost/wiki on the machine on which the web server is running (this will not work if done remotely, unless you use an ssh tunnel so that the access appears to be coming from the local host). You will see the MediaWiki welcome page; click on the setup link.
3. Enter the setup information for your wiki:
   • Enter a name for the wiki
   • Enter your learn e-mail address as the contact information
   • Disable all e-mail features
   • Leave the database host as "localhost"
   • Set up a database password
   • Get MediaWiki to set up the superuser account by checking the appropriate box and entering the superuser password (Note: This is the database superuser password, NOT the root password).
4. Click the "Install MediaWiki!" button The installation will fail. This is because the SELinux policy forbids connections from web scripts to the local database server.
5. To fix this, you will need to change an SELinux boolean to enable httpd scripts to connect to a database. Find the SELinux boolean that permits this type of connection, and set the appropriate value.
6. Re-submit the MediaWiki setup page.
7. Once the setup is complete, you will need to move a file within the MediaWiki directory (inside /var/www). Refer to the directions on the screen.

When you are done, you should be able to go to http://hostname/wiki from any directly-connected machine.

Additional HTTPD Configuration

1. Configure httpd to serve the public_html directories of your users. This will require changes to /etc/httpd/conf/httpd.conf as well as the SELinux configuration. See the man page for httpd_selinux and the Apache httpd documentation for details.

Write-up

Create a write-up of this assignment on your wiki. Include at least these pages:

1. A main page, describing in general terms what you did and containing links to the other pages.
2. A page for your httpd configuration. Include your httpd.conf file.
3. A page for your MySQL configuration.
4. A page for your SELinux configuration. Include a list of all of your booleans and their current settings. Demonstrate that the configuration is as tight as possible (e.g., don't change booleans unnecessarily).
5. A page for your MediaWiki configuration. Include your MediaWiki configuration file.
6. A page for your iptables configuration. Demonstrate that the configuration is as tight as possible.

The easiest way to create new page is to create a link to it from an existing page (such as the main page), and then follow that link.

Resources on markup:

• Wiki markup - Wikipedia
• Sandbox page on this wiki - examples

Bonus Opportunity!
Change the default icon in the upper-left corner of your MediaWiki installation to a picture of your choosing. Be sure that you have copyright clearance to use that image (e.g., it is licensed to you, or its your picture).

Submitting the Assignment

Your professor will require you to submit this assignment in at least one of two ways:

1. Demonstrate that the wiki is working.
2. Use wget to harvest the wiki pages:
   • Issue the command: wget -prk http://hostname/wiki
   • Create a compressed tar file containing the results.
   • Submit it to your professor in the manner he specifies.

Check with your professor for the submission details for your section.

Assessment

• 50% - completion of steps - quality of configuration, iptables and SELinux configuration as tight as possible
• 50% - documentation on the wiki - quality of writing, quality of presentation, and accuracy and completeness of information
• +5% - bonus for replacing the wiki logo