# yaml-language-server: $schema=../../../../schema/control.schema.json
id: CB-DEB-AUDIT-027
title: Audit login records and session files
finding:
  title: Tampering with login records is not detected
  description: The files that record who logged in and failed logins can be edited to hide a session.
status: active
profiles: [server-hardened, desktop-hardened]
risk:
  severity: low
assessment: automated
tags: [auditd, login]

description: |
  auditd rules in `/etc/audit/rules.d/60-cirsec-session.rules`:

  - writes to the session records `/run/utmp`, `/var/log/wtmp`, `/var/log/btmp` and, on Debian 13,
    the `wtmpdb` database in `/var/lib/wtmpdb/` (key `session`);
  - writes to `/var/log/lastlog` and to the `pam_faillock` counters in `/run/faillock/`
    (key `logins`).
rationale: |
  `last`, `lastb`, `who` and `faillock` read these files. Every login writes to them, so the records
  show logins and logouts; an edit outside a login is a sign of an attempt to erase a session.
impact: |
  Each login and logout produces a few records.
notes: |
  `/run/utmp` is used instead of `/var/run/utmp`: `/var/run` is a symbolic link to `/run` and the kernel watches the real path.

setting:
  location: /etc/audit/rules.d/60-cirsec-session.rules
  default_value: No audit rules
  recommended_value: "Rules loaded (auditctl -l) and present in /etc/audit/rules.d/60-cirsec-session.rules"

audit:
  manual: |
    1. Run `auditctl -l` as root. It must list the rules shown below (keys `logins`, `session`).
    2. Run `grep -h . /etc/audit/rules.d/*.rules`. The same rules must be present, so they load at boot.

    Expected rules, as `auditctl -l` prints them:
    ```
    -w /run/utmp -p wa -k session
    -w /var/log/wtmp -p wa -k session
    -w /var/log/btmp -p wa -k session
    -w /var/lib/wtmpdb -p wa -k session
    -w /var/log/lastlog -p wa -k logins
    -w /run/faillock -p wa -k logins
    ```
  checks:
    - id: rules
      engine: shell
      description: Rules loaded in the kernel and present in /etc/audit/rules.d.
      spec:
        script: |
          command -v auditctl >/dev/null 2>&1 || { echo "auditctl not found: auditd is not installed"; exit 1; }
          want() {
          cat <<'RULES'
          -w /run/utmp -p wa -k session
          -w /var/log/wtmp -p wa -k session
          -w /var/log/btmp -p wa -k session
          -w /var/lib/wtmpdb -p wa -k session
          -w /var/log/lastlog -p wa -k logins
          -w /run/faillock -p wa -k logins
          RULES
          }
          loaded=$(auditctl -l 2>&1) || { echo "$loaded"; exit 3; }
          disk=$(cat /etc/audit/rules.d/*.rules 2>/dev/null)
          n=0 rc=0
          while IFS= read -r r; do
            [ -n "$r" ] || continue
            n=$((n + 1))
            printf '%s\n' "$loaded" | grep -Fxq -- "$r" || { echo "not loaded: $r"; rc=1; }
            printf '%s\n' "$disk" | grep -Fxq -- "$r" || { echo "not in /etc/audit/rules.d: $r"; rc=1; }
          done <<EOF
          $(want)
          EOF
          [ "$rc" = 1 ] || echo "$n rules loaded and present in /etc/audit/rules.d"
          exit "$rc"

remediation:
  manual: |
    1. Write the expected rules to `/etc/audit/rules.d/60-cirsec-session.rules` (mode 0640).
    2. Run `augenrules --load`. If `auditctl -s` shows `enabled 2`, the configuration is locked:
       reboot to load the new rules.
  effects:
    restart: none
    disruption: none
    lockout_risk: false
  rollback: |
    Delete `/etc/audit/rules.d/60-cirsec-session.rules` and run `augenrules --load` (or reboot if the configuration is locked).
  scripts:
    - id: rules-file
      engine: shell
      content: |
        command -v augenrules >/dev/null 2>&1 || { echo "auditd is not installed" >&2; exit 1; }
        want() {
        cat <<'RULES'
        -w /run/utmp -p wa -k session
        -w /var/log/wtmp -p wa -k session
        -w /var/log/btmp -p wa -k session
        -w /var/lib/wtmpdb -p wa -k session
        -w /var/log/lastlog -p wa -k logins
        -w /run/faillock -p wa -k logins
        RULES
        }
        f=/etc/audit/rules.d/60-cirsec-session.rules
        t=$(mktemp)
        { echo '# Written by CIRSEC Baselines CB-DEB-AUDIT-027'; want; } >"$t"
        if ! cmp -s "$t" "$f"; then
          cb_backup "$f"
          cat "$t" >"$f"
        fi
        rm -f "$t"
        chmod 640 "$f"
        if auditctl -s | grep -q '^enabled 2'; then
          echo "audit rules are locked (-e 2): reboot to load $f"
        else
          augenrules --load >/dev/null
        fi

references:
  - title: audit.rules(7), Debian manual pages
    url: https://manpages.debian.org/trixie/auditd/audit.rules.7.en.html
    publisher: Debian
    kind: vendor-doc
    accessed: 2026-10-18
  - title: auditctl(8), Debian manual pages
    url: https://manpages.debian.org/trixie/auditd/auditctl.8.en.html
    publisher: Debian
    kind: vendor-doc
    accessed: 2026-10-18
  - title: ANSSI-BP-028 v2.0 - Recommandations de configuration d'un système GNU/Linux (R73)
    url: https://messervices.cyber.gouv.fr/documents-guides/fr_np_linux_configuration-v2.0.pdf
    publisher: ANSSI
    kind: guide
    accessed: 2026-10-18
mappings:
  - framework: anssi-linux
    framework_version: "2.0"
    id: "R73"
    relation: partial
  - framework: nist-800-53r5
    framework_version: "5.1.1"
    id: "AU-12"
    relation: related
  - framework: nist-800-53r5
    framework_version: "5.1.1"
    id: "AC-17(1)"
    relation: related
  - framework: cis-debian-12
    framework_version: "2.0.0"
    id: "6.2.3.20"
    relation: equivalent
  - framework: cis-debian-12
    framework_version: "2.0.0"
    id: "6.2.3.21"
    relation: equivalent
  - framework: cis-debian-13
    framework_version: "1.1.0"
    id: "6.2.3.22"
    relation: equivalent
  - framework: cis-debian-13
    framework_version: "1.1.0"
    id: "6.2.3.23"
    relation: equivalent
threats:
  - framework: mitre-attack
    id: T1070.002
  - framework: mitre-attack
    id: T1078
related_controls:
  - id: CB-DEB-AUDIT-011
    type: requires
  - id: CB-DEB-AUDIT-029
    type: related

authors:
  - name: Alice
    github: Sn0wAlice
verified:
  - date: 2026-10-18
    by: Sn0wAlice
    versions: ["12"]
    environment: Proxmox VM, Debian 12 genericcloud image, kernel 6.1.0-54-cloud-amd64, auditd 1:3.0.9-1, BIOS boot
    notes: "Rules fail on fresh install; fix writes /etc/audit/rules.d/60-cirsec-session.rules and loads it; rules match auditctl -l, kept after reboot; second run idempotent."
  - date: 2026-10-18
    by: Sn0wAlice
    versions: ["13"]
    environment: Proxmox VM, Debian 13 genericcloud image, kernel 6.12.113+deb13-cloud-amd64, auditd 1:4.0.2-2+deb13u1, BIOS boot
    notes: "Rules fail on fresh install; fix writes /etc/audit/rules.d/60-cirsec-session.rules and loads it; rules match auditctl -l, kept after reboot; second run idempotent."
introduced_in: 0.1.0
created: 2026-10-18
updated: 2026-10-18