===== Setting up DAZ =====

Dazuko is an interface for Antivirus scanners. In this document we will use the [[http://www.clamav.net|ClamAV]] scanner to connect with the Dazuko interface provided by the RSBAC DAZ module.

===== Preparing your system =====

First of all, make sure the DAZ module is selected, compiled and active in your RSBAC kernel.
<code>
# grep DAZ /proc/rsbac-info/active
Switching: available for DAZ FF RC ACL CAP JAIL RES PAX
Module: DAZ on
</code>

A device is also needed for communication between the userland scanner and the Dazuko implementation of RSBAC. You will have to create it, if you do not have it.

//Note: The following is only required using the Linux kernel 2.4. On 2.6 and above, the device is automatically created by udev.//

Note that depending on your Linux distribution, you might be able to simply create the dazuko device the standard way, as it will be backed up and restored automatically. Make sure that your /dev/dazuko will be anyway created or recreated at boot time.

Check Dazuko's device major number (default in RSBAC is 250, you can change it during the kernel configuration):
<code>
# grep dazuko /proc/devices
250 dazuko <= Major number is 250
</code>

Create the device (with major number 250):
<code>
# mknod -m 0600 /dev/dazuko c 250 0
</code>


===== Setting up ClamAV =====
Note that the configuration might be different if you use another Antivirus scanner with Dazuko support.

Please edit /etc/clamd.conf (or where your clamd.conf is stored) and make sure you have these options :
<code>
ClamukoScanOnAccess true
ClamukoScanOnOpen true
ClamukoScanOnClose true
ClamukoScanOnExec true
# All files in IncludePath will be scanned on-access
ClamukoIncludePath /
# But all files in ExcludePath will not be scanned :)
ClamukoExcludePath /var/amavis/quarantine
# Maximum file size to scan
ClamukoMaxFileSize 20M
</code>
Also make sure that "clamd" runs as root! Remove any "User" configuration directive from the configuration file, or set "User root"

===== Setting up RSBAC =====

Tell RSBAC that clamd is our on-access scanner:
<code>
# attr_set_file_dir  FD $(which clamd) daz_scanner 1
</code>

Tell RSBAC that the user root has the Dazuko role of Administrator (2):
<code>
# attr_set_user root daz_role 2
</code>

And that the security officer has the Dazuko role of .. Security Officer :) (1):
<code>
# attr_set_user secoff daz_role 1
</code>


===== Running, testing, troubleshooting =====

You can now start clamd using your initscripts (make sure those will start it as root user) or by hand:
<code>
# /etc/init.d/clamav start
</code>

//Alternative//
<code>
# clamd
</code>

Check your clamav logs:
<code>
# tail /var/log/clamav/clamd.log
Mon Jul 18 11:29:20 2005 -> Clamuko: Correctly registered with Dazuko.
Mon Jul 18 11:29:20 2005 -> Clamuko: Scan-on-open mode activated.
Mon Jul 18 11:29:20 2005 -> Clamuko: Scan-on-close mode activated.
Mon Jul 18 11:29:20 2005 -> Clamuko: Scan-on-exec mode activated.
</code>

Ok everything works!
You can download a test virus file from here:
http://www.eicar.org/anti_virus_test_file.htm

And play with it, RSBAC+Dazuko+ClamAV will deny every access (provided that you are not running in Softmode). RSBAC logs will also report the interception by the DAZ module. You can watch the number of cached results going up as DAZ_SCANNED entries in the FD section of /proc/rsbac-info/stats.

//Clamuko missing//

In case ClamAV shows no Clamuko messages, or say that Clamuko is disabled/not enabled make sure that your version of ClamAV does not disable Dazuko support. In doubt, compile a new version by hand.

Debian and Ubuntu versions do not currently have Clamuko support builtin in Lenny and 8.10 respectively.
Here's a short how-to do that in a few lines:

<code>
(as root)
# apt-get install fakeroot build-essentials
# apt-get build-dep clamav-daemon
# apt-get source clamav-daemon
</code>

Edit the rule file (''clamav-xxx/debian/rules'') and look for the ''./configure'' line.
There is a ''--disable-clamuko'' argument. Remove it.

Let's rebuild the package now:

<code>
# dpkg-buildpackage -rfakeroot -uc -us
...
# dpkg -i ../clamav.....deb
</code>

Done :)


In case you get a connection error: " ERROR: Clamuko: Can't register with Dazuko", make sure that your device /dev/dazuko is created and has the correct permissions, major and minor numbers.

Enjoy the fastest on-access scanner on Linux!

\\ 
----
**Table of Contents:** [[documentation:rsbac_handbook|RSBAC Handbook]]\\
**Previous:** [[.:pm|Privacy Model (PM)]]\\ 
**Next:** [[documentation:rsbac_handbook:configuration_basics:administration_examples|Administration Examples]]\\ 
**Alternative:** [[documentation:rsbac_handbook:configuration_basics:setting_up_modules|Setting up Modules]]