Update README with comprehensive documentation improvements#363
Open
assisted-by-ai wants to merge 1 commit intoKicksecure:masterfrom
Open
Update README with comprehensive documentation improvements#363assisted-by-ai wants to merge 1 commit intoKicksecure:masterfrom
assisted-by-ai wants to merge 1 commit intoKicksecure:masterfrom
Conversation
Fix outdated/wrong documentation: - Replace tally2-security-misc PAM reference with faillock equivalents - Fix debian/security-misc.postinst -> debian/security-misc-shared.postinst (3 locations) - Fix /lib/systemd -> /usr/lib/systemd for permission-hardener.service - Fix /etc/permission-hardener.d -> /usr/lib/permission-hardener.d - Fix /lib/systemd -> /usr/lib/systemd for haveged drop-in - Mark SRSO CPU mitigation as Optional (commented out in code) - Fix emergency shutdown key combo from Ctrl+Alt+Delete to Ctrl+Alt+End - Remove nonexistent pkexec.security-misc section Add documentation for previously undocumented features: - USBGuard integration (device rules, daemon config, IPC access) - Recovery mode restriction (GRUB, dracut shell/emergency) - Quiet boot configuration (loglevel, printk) - Git hardening (symlinks, fsckObjects) - LKRG VirtualBox compatibility - Emergency shutdown dracut module and udev rules - Block unsafe logins PAM module - virusforget script (noted as WIP) - askpass GUI helper - check-for-usb-controller helper - PAM conditional helpers (pam_only_if_login, pam_only_if_su) - kill-vboxdrmclient-on-shutdown service - XDG_CONFIG_DIRS setup via profile.d - AppArmor tunable for displaced files - sysinit-post.target custom ordering target - user@.service.d sysfs group drop-in - Systemd preset defaults section Improve insufficient documentation: - SSH: describe crypto restrictions, disabled password auth, disabled forwarding - Faillock: add fail_interval, unlock_time, even_deny_root, remote skip - Thunar: add volume management, network bookmark, date format - Bluetooth: add AutoEnable, timeouts, MaxControllers, Privacy specifics https://claude.ai/code/session_0125G25dF8DVff618hmCMMNw
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This PR updates the README.md documentation to reflect recent implementation changes, add missing feature documentation, and improve clarity on various security hardening features.
Key Changes
Documentation Updates
File Path Updates
debian/security-misc.postinsttodebian/security-misc-shared.postinst/lib/systemd/to/usr/lib/systemd//etc/permission-hardener.dto/usr/lib/permission-hardener.dNew Features Documented
loglevel=0andquietparametersvirusforgetfor detecting unauthorized shell startup file changesaskpassfor GUI password promptscheck-for-usb-controllerfor conditional USBGuard activationpam_only_if_loginandpam_only_if_sufor PAM conditional helpersblock-unsafe-loginsfor privileged account protectionsysinit-post.targetfor boot synchronizationRemoved Content
Notable Implementation Details
https://claude.ai/code/session_0125G25dF8DVff618hmCMMNw