Модуль community.general.pamd — управление модулями PAM

Примечание

Этот модуль входит в коллекцию community.general (версия 12.6.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.general.

Чтобы использовать коллекцию в плейбуке, укажите: community.general.pamd.

Краткое описание
Параметры
Атрибуты
Примечания
Примеры
Возвращаемые значения

Краткое описание

Изменение типа, элемента управления, пути к модулю и аргументов модуля службы PAM.
Чтобы изменить правило PAM, значения типа, элемента управления и module_path должны совпадать с существующим правилом. Подробности см. в man(5) pam.d.

Параметры

Параметр	Комментарии
backup boolean	Создать резервную копию с информацией о временной метке, чтобы можно было восстановить исходный файл, если он был случайно повреждён. Варианты: `false` ← (по умолчанию) `true`
control string / обязательный	Элемент управления изменяемого правила PAM. Элемент управления может быть сложным и содержать скобки. В этом случае заключите «[элементы управления в скобках]» в кавычки. Значения параметров `type`, `control` и `module_path` должны совпадать с правилом, которое требуется изменить.
module_arguments list / элементы=string	Если задано `state=updated`, значения `module_arguments` заменяют существующие аргументы module_arguments. Если задано `state=args_absent`, аргументы, совпадающие с указанными в `module_arguments`, удаляются. Если задано `state=args_present`, все аргументы из `module_arguments` добавляются, если их нет в существующем правиле. Кроме того, если аргумент модуля принимает значение, обозначенное как `=`, оно изменяется на значение, указанное в module_arguments.
module_path string / обязательный	Путь к модулю в изменяемом правиле PAM. Значения параметров `type`, `control` и `module_path` должны совпадать с правилом, которое требуется изменить.
name string / обязательный	Как правило, name обозначает имя файла службы PAM, который требуется изменить, например system-auth.
new_control string	Новый элемент управления, назначаемый новому правилу.
new_module_path string	Новый путь к модулю, назначаемый новому правилу.
new_type string	Новый тип, назначаемый новому правилу. Варианты: `"account"` `"-account"` `"auth"` `"-auth"` `"password"` `"-password"` `"session"` `"-session"`
path path	Путь к файлам службы PAM. По умолчанию: `"/etc/pam.d"`
state string	По умолчанию `updated` изменяет существующее правило, если тип, элемент управления и module_path совпадают со значениями существующего правила. При значении `before` новое правило вставляется перед правилом, совпадающим по типу, элементу управления и module_path. Аналогично, при значении `after` новое правило вставляется после существующего правила, совпадающего по типу, элементу управления и module_path. При значении `before` или `after` необходимо указать все параметры `new_type`, `new_control` и `new_module_path`. Если state имеет значение `args_absent` или `args_present`, параметры `new_type`, `new_control` и `new_module_path` игнорируются. Значение state `absent` удаляет правило. Варианты: `"absent"` `"before"` `"after"` `"args_absent"` `"args_present"` `"updated"` ← (по умолчанию)
type string / обязательный	Тип изменяемого правила PAM. Значения параметров `type`, `control` и `module_path` должны совпадать с правилом, которое требуется изменить. Варианты: `"account"` `"-account"` `"auth"` `"-auth"` `"password"` `"-password"` `"session"` `"-session"`

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Модуль может работать в режиме `check_mode` и возвращать прогноз статуса изменений, не изменяя целевую систему.
diff_mode	Поддержка: отсутствует	В режиме diff возвращает сведения об изменениях (или об изменениях, которые могут потребоваться в `check_mode`).

Примечания

Примечание

Этот модуль не обрабатывает профили authselect.

Примеры

- name: Update pamd rule's control in /etc/pam.d/system-auth
  community.general.pamd:
    name: system-auth
    type: auth
    control: required
    module_path: pam_faillock.so
    new_control: sufficient

- name: Update pamd rule's complex control in /etc/pam.d/system-auth
  community.general.pamd:
    name: system-auth
    type: session
    control: '[success=1 default=ignore]'
    module_path: pam_succeed_if.so
    new_control: '[success=2 default=ignore]'

- name: Insert a new rule before an existing rule
  community.general.pamd:
    name: system-auth
    type: auth
    control: required
    module_path: pam_faillock.so
    new_type: auth
    new_control: sufficient
    new_module_path: pam_faillock.so
    state: before

- name: Insert a new rule pam_wheel.so with argument 'use_uid' after an existing rule pam_rootok.so
  community.general.pamd:
    name: su
    type: auth
    control: sufficient
    module_path: pam_rootok.so
    new_type: auth
    new_control: required
    new_module_path: pam_wheel.so
    module_arguments: 'use_uid'
    state: after

- name: Remove module arguments from an existing rule
  community.general.pamd:
    name: system-auth
    type: auth
    control: required
    module_path: pam_faillock.so
    module_arguments: ''
    state: updated

- name: Replace all module arguments in an existing rule
  community.general.pamd:
    name: system-auth
    type: auth
    control: required
    module_path: pam_faillock.so
    module_arguments: 'preauth silent deny=3 unlock_time=604800 fail_interval=900'
    state: updated

- name: Remove specific arguments from a rule
  community.general.pamd:
    name: system-auth
    type: session
    control: '[success=1 default=ignore]'
    module_path: pam_succeed_if.so
    module_arguments: crond,quiet
    state: args_absent

- name: Ensure specific arguments are present in a rule
  community.general.pamd:
    name: system-auth
    type: session
    control: '[success=1 default=ignore]'
    module_path: pam_succeed_if.so
    module_arguments: crond,quiet
    state: args_present

- name: Ensure specific arguments are present in a rule (alternative)
  community.general.pamd:
    name: system-auth
    type: session
    control: '[success=1 default=ignore]'
    module_path: pam_succeed_if.so
    module_arguments:
      - crond
      - quiet
    state: args_present

- name: Module arguments requiring commas must be listed as a Yaml list
  community.general.pamd:
    name: special-module
    type: account
    control: required
    module_path: pam_access.so
    module_arguments:
      - listsep=,
    state: args_present

- name: Update specific argument value in a rule
  community.general.pamd:
    name: system-auth
    type: auth
    control: required
    module_path: pam_faillock.so
    module_arguments: 'fail_interval=300'
    state: args_present

- name: Add pam common-auth rule for duo
  community.general.pamd:
    name: common-auth
    new_type: auth
    new_control: '[success=1 default=ignore]'
    new_module_path: '/lib64/security/pam_duo.so'
    state: after
    type: auth
    module_path: pam_sss.so
    control: 'requisite'

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ	Описание
backupdest string	Имя файла резервной копии, если она была создана. Возвращается: при успехе
change_count integer	Количество изменённых правил. Возвращается: при успехе Пример: `1`

Авторы

Kenneth D. Evensen (@kevensen)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/pamd_module.html