jk_check(8)

hey bestie! ✨ welcome to the jk_check(8) page β€” this is the manual for jk_check, a utility that will check a jail for security problems. let's get into it πŸ’…


🌸 NAME 🌸

jk_check β€” a utility that will check a jail for security problems. πŸ’–


✨ SYNOPSIS ✨

jk_check jail

jk_check -v -c configfile jail

πŸ¦‹ DESCRIPTION πŸ¦‹

okay so jk_check will run several tests on all files and directories in a jail. the tests are:

  • -test for setuid (set user id) or setgid (set group id) files
  • -test for file modifications, using an MD5 checksum on the file in the jail and the same file in the real root
  • -test for group writable or world writable directories
  • -test for matching user information in the jail and on the real system

It will test directories based on the config file /etc/jailkit/jk_check.ini but also based on jail patterns (dir/./dir) found in the home directories in /etc/passwd.


🌈 EXAMPLE 🌈

Minimal configfile

The most minimal configuration looks like:

[/home/testchroot]

This will include all the files and directories in /home/testchroot for testing. ✨

More extended configfile

Often you want to ignore some tests on some directories, the following configfile shows some examples:

[/home/testchroot]
ignorepatheverywhere =
ignorepathoncompare = /home/testchroot/home, /home/testchroot/etc
ignorewritableforgroup = /home/testchroot/home
ignorewritableforothers = /home/testchroot/home/tmp
ignoresetuidexecuteforuser = /home/testchroot/usr/bin/smbmnt
ignoresetuidexecuteforgroup = /home/testchroot/usr/bin/smbmnt
ignoresetuidexecuteforothers =
  • ignorepatheverywhere β€” no single test is performed in these directories. You should not use this option unless you what you are doing.
  • ignorepathoncompare β€” files in listed directories are not compared with their non-jail counterparts. Useful for directories like /etc/ and /home/ where you know you'll have different files inside the jail and outside the jail.
  • ignorewritableforgroup β€” listed directories that are writable for the group are not reported.
  • ignorewritableforothers β€” listed directories that are writable for others are not reported.
  • ignoresetuidexecuteforuser β€” ignore the setuid bit on a file that is executable for a user, a file with -rws------ permissions that is. Use with care! Remember that user root can break out of a jail, therefore any program running with root privileges is theoretically capable of breaking out of the jail!
  • ignoresetuidexecuteforgroup β€” ignore the setuid bit for a file that is executable for the group, a file with -rws--x--- permissions that is.
  • ignoresetuidexecuteforothers β€” ignore the setuid bit for a file that is executable for others, a file with -rws--x--x permissions that is.

πŸ’… OPTIONS πŸ’…

  • -v β€” Will give verbose output.
  • -c configfile β€” Use alternative configfile.
  • -h β€” The help screen.

πŸŽ€ FILES πŸŽ€

/etc/jailkit/jk_check.ini


πŸ”₯ SEE ALSO πŸ”₯

jailkit(8) jk_chrootlaunch(8) jk_chrootsh(8) jk_cp(8) jk_init(8) jk_jailuser(8) jk_list(8) jk_lsh(8) jk_procmailwrapper(8) jk_socketd(8) jk_uchroot(8) jk_update(8) chroot(2)


Copyright (C) 2003, 2004, 2005, 2006, 2007, Olivier Sessink

Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved.

this page was brought to you by JAILKIT, version 07-02-2010, and the jk_check(8) manual. mwah πŸ’‹ stay safe out there bestie!