NAME

podsec-inotify-check-kubeapi - скрипт мониторинга аудита API-интерфейса kube-apiserver control-plane узла

SYNOPSIS

podsec-inotify-check-kubeapi [-d]

DESCRIPTION

Скрипт производит мониторинг файла /etc/kubernetes/audit/audit.log аудита API-интерфейса kube-apiserver.

Политика аудита располагается в файле /etc/kubernetes/audit/policy.yaml:

apiVersion: audit.k8s.io/v1
kind: Policy
omitManagedFields: true
rules:
# do not log requests to the following
- level: None


  nonResourceURLs:


  - "/healthz*"


  - "/logs"


  - "/metrics"


  - "/swagger*"


  - "/version"


  - "/readyz"


  - "/livez"
- level: None


  users:


    - system:kube-scheduler


    - system:kube-proxy


    - system:apiserver


    - system:kube-controller-manager


    - system:serviceaccount:gatekeeper-system:gatekeeper-admin
- level: None


  userGroups:


    - system:nodes


    - system:serviceaccounts


    - system:masters
# limit level to Metadata so token is not included in the spec/status
- level: Metadata


  omitStages:


  - RequestReceived


  resources:


  - group: authentication.k8s.io


    resources:


    - tokenreviews
# extended audit of auth delegation
- level: RequestResponse


  omitStages:


  - RequestReceived


  resources:


  - group: authorization.k8s.io


    resources:


    - subjectaccessreviews
# log changes to pods at RequestResponse level
- level: RequestResponse


  omitStages:


  - RequestReceived


  resources:


  - group: "" # core API group; add third-party API services and your API services if needed


    resources: ["pods"]


    verbs: ["create", "patch", "update", "delete"]
# log everything else at Metadata level
- level: Metadata


  omitStages:


  - RequestReceived

Текущие настройки производят логирование всех обращений "несистемных" пользователей (в том числе анонимных) к ресурсам kubernetes.

Скрипт производит выборку всех обращений, в ответ на которые был сформирован код более 400 - запрет доступа. Все эти факты записываются в системный журнал и накапливаются в файле логов /var/lib/podsec/u7s/log/kubeapi/forbidden.log, который периодически передается через посту системному адмиристратору.

OPTIONS

-d - скирпт запускается в режиме демона, производящего онлайн мониторинг файла /etc/kubernetes/audit/audit.log и записывающего факты запросов с запретом доступа в системный журнал и файл логов /var/lib/podsec/u7s/log/kubeapi/forbidden.log.
при запуске без параметров скрипт посылает файл логов /var/lib/podsec/u7s/log/kubeapi/forbidden.log почтой системному администратору (пользователь root) и обнуляет файл логов.

В состав пакета кроме этого скрипта входят:

•: файл описания сервиса /lib/systemd/system/podsec-inotify-check-kubeapi.service. Для его запуска необходимо выполнить команды:

Файл сервисов podsec-inotify-check-kubeapi.service описывает в параметре ExecStart строку с описанием режима запуска скрипта podsec-inotify-check-kubeapi для анализа логов, обнаружения нарушений, записи их в системный лог и передачи их почтой системному администратору.
Файла расписания podsec-inotify-check-kubeapi.timer, задающий в параметре OnCalendar расписание запуска сервиса podsec-inotify-check-kubeapi.service. Сервис вызывается ежечасно.

По умолчанию таймер запуска сервиса выключен. Для его включения наберите команду:

#  systemctl enable --now podsec-inotify-check-kubeapi.timer

Если необходимо изменить режим запуска скрипта отредактируйте параметр OnCalendar файла расписания podsec-inotify-check-kubeapi.timer.

EXAMPLE

podsec-inotify-check-kubeapi -d

podsec-inotify-check-kubeapi

SECURITY CONSIDERATIONS

Кроме мониторинга фактов запрета доступа возможен мониторинг других фактов подозрительной активности.

AUTHOR

Костарев Алексей, Базальт СПО kaf@basealt.ru

podsec-inotify-check-kubeapi(1)