Spec-Zone.ru › Ansible

Модуль netapp.ontap.na_ontap_file_security_permissions_acl — ACL разрешений безопасности файлов NetApp ONTAP

Примечание

Этот модуль входит в коллекцию netapp.ontap (версия 23.5.0).

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

Для установки используйте: ansible-galaxy collection install netapp.ontap. Для использования этого модуля необходимы дополнительные требования; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: netapp.ontap.na_ontap_file_security_permissions_acl.

Добавлено в netapp.ontap 22.0.0

  • Краткое описание
  • Требования
  • Параметры
  • Примечания
  • Примеры

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

  • Добавляет, удаляет или изменяет ACL file_security_permissions в NetApp ONTAP.
  • Обратите внимание: сопоставление ACL выполняется по параметрам (‘user’, ‘access’, ‘access_control’, ‘apply_to’). Чтобы изменить любое из этих 4 свойств, необходимо удалить ACL и создать новую. Также можно использовать netapp.ontap.na_ontap_file_security_permissions.

Требования

На хосте, выполняющем этот модуль, необходимы следующие компоненты.

  • Ansible 2.9 или более поздней версии; рекомендуется версия 2.12 или более поздняя.
  • Python3; рекомендуется версия 3.9 или более поздняя.
  • netapp-lib требуется только при использовании ZAPI (установите с помощью ‘pip install netapp-lib’). Обратите внимание: netapp-lib объявлена устаревшей и больше не поддерживается. Используйте ее на свой страх и риск.
  • Физическая или виртуальная кластерная система Data ONTAP. Модули поддерживают Data ONTAP 9.1 и более поздние версии; для поддержки REST требуется ONTAP 9.6 или более поздняя версия.

Параметры

Параметр

Комментарии

access

string / обязательный

ACE — это элемент списка управления доступом (ACL). ACL может содержать ноль или более ACE.

Каждая ACE управляет доступом указанного субъекта безопасности к объекту или отслеживает его.

Варианты:

  • "access_allow"
  • "access_deny"
  • "audit_failure"
  • "audit_success"

access_control

string

Уровень управления доступом определяет управление доступом, применяемое задачей.

Допустимые значения: «file-directory» или «Storage-Level Access Guard (SLAG)».

SLAG используется для применения указанных дескрипторов безопасности к тому или qtree с помощью этой задачи.

В остальных случаях дескрипторы безопасности применяются к файлам и каталогам по указанному пути.

Значение slag не поддерживается для томов FlexGroup. Значение по умолчанию — «file-directory».

Для этого поля требуется ONTAP 9.10.1 или более поздняя версия. Значение по умолчанию — «file_directory».

Варианты:

  • "file_directory"
  • "slag"

acl_user

string / обязательный

Указывает учетную запись, к которой применяется ACE. Укажите имя или SID.

Начиная с версии 22.0.0, модуль не является идемпотентным при использовании SID.

Примечание: нельзя использовать user, так как это конфликтует с параметром для пользователя admin.

advanced_rights

dictionary

Указывает расширенные права доступа, контролируемые ACE для указанной учетной записи.

append_data

boolean

Добавление данных.

Варианты:

  • false
  • true

delete

boolean

Удаление.

Варианты:

  • false
  • true

delete_child

boolean

Удаление дочерних объектов.

Варианты:

  • false
  • true

execute_file

boolean

Выполнение файла.

Варианты:

  • false
  • true

full_control

boolean

Полный контроль.

Варианты:

  • false
  • true

read_attr

boolean

Чтение атрибутов.

Варианты:

  • false
  • true

read_data

boolean

Чтение данных.

Варианты:

  • false
  • true

read_ea

boolean

Чтение расширенных атрибутов.

Варианты:

  • false
  • true

read_perm

boolean

Чтение разрешений.

Варианты:

  • false
  • true

write_attr

boolean

Запись атрибутов.

Варианты:

  • false
  • true

write_data

boolean

Запись данных.

Варианты:

  • false
  • true

write_ea

boolean

Запись расширенных атрибутов.

Варианты:

  • false
  • true

write_owner

boolean

Изменение владельца.

Варианты:

  • false
  • true

write_perm

boolean

Запись разрешений.

Варианты:

  • false
  • true

apply_to

dictionary / обязательный

Указывает, где применять записи DACL или SACL.

Для SLAG ONTAP принимает три подопции со значением true, но создает 2 ACL. Для обеспечения идемпотентности этот модуль требует наличия обеих ACL. См. также validate_changes.

files

boolean

Применять к файлам.

Варианты:

  • false ← (по умолчанию)
  • true

sub_folders

boolean

Применять ко всем вложенным папкам.

Варианты:

  • false ← (по умолчанию)
  • true

this_folder

boolean

Применять только к этой папке.

Варианты:

  • false ← (по умолчанию)
  • true

cert_filepath

string

добавлено в netapp.ontap 20.6.0

Путь к файлу сертификата клиента SSL (.pem).

Не поддерживается в Python 2.6.

feature_flags

dictionary

добавлено в netapp.ontap 20.5.0

Включает или отключает новую функцию.

Этот параметр можно использовать для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость.

Поддерживаемые ключи и значения могут изменяться без уведомления. Неизвестные ключи игнорируются.

force_ontap_version

string

добавлено в netapp.ontap 21.23.0

Переопределяет версию ONTAP кластера при использовании REST.

Поведение не определено, если версия не соответствует целевому кластеру.

Этот параметр предусмотрен как обходное решение на случай, если версию кластера невозможно прочитать из-за проблем с разрешениями. См. https://github.com/ansible-collections/netapp.ontap/wiki/Known-issues.

Значение должно иметь формат 9.10 или 9.10.1, где каждый компонент является целым числом.

hostname

string / обязательный

Имя хоста или IP-адрес экземпляра ONTAP.

http_port

integer

Заменяет порт по умолчанию (80 или 443) указанным портом.

https

boolean

Включает и отключает HTTPS.

Игнорируется при использовании REST, поскольку поддерживается только HTTPS.

Игнорируется при использовании аутентификации с сертификатом SSL, так как для нее требуется SSL.

Варианты:

  • false ← (по умолчанию)
  • true

ignore_paths

list / элементы=string

Для каждого файла или каталога в списке указывает, что разрешения для этого файла или каталога нельзя заменить.

key_filepath

string

добавлено в netapp.ontap 20.6.0

Путь к файлу ключа клиента SSL.

password

псевдонимы: pass

string

Пароль указанного пользователя.

path

string / обязательный

Путь к файлу или каталогу, для которого нужно применить разрешения безопасности.

propagation_mode

string

Определяет способ распространения параметров безопасности на вложенные папки и файлы.

По умолчанию параметры распространяются.

Этот параметр можно указать при создании, но нельзя изменить.

Варианты:

  • "propagate"
  • "replace"

rights

string

Указывает право доступа, контролируемое ACE для указанной учетной записи.

Параметры «rights» и «advanced_rights» взаимоисключающие.

ONTAP преобразует rights в advanced_rights, поэтому модуль не является идемпотентным при использовании rights.

Для сохранения идемпотентности используйте advanced_rights. С помощью rights можно определить соответствие advanced_rights.

Варианты:

  • "no_access"
  • "full_control"
  • "modify"
  • "read_and_execute"
  • "read"
  • "write"

state

string

Указывает, должна ли существовать заданная ACL разрешений безопасности файла.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

use_lambda

boolean

добавлено в netapp.ontap 23.4.0

Указывает, следует ли использовать прокси-функциональность AWS Lambda для подключения к системе ONTAP.

Поддерживается только с REST.

Варианты:

  • false ← (по умолчанию)
  • true

use_rest

string

Этот модуль поддерживает только REST.

always — всегда использовать REST API. Если модуль не поддерживает REST, выдается предупреждение.

По умолчанию: "always"

username

псевдонимы: user

string

Это может быть учетная запись уровня кластера или уровня SVM — в зависимости от того, требуется ли API уровня кластера или SVM.

Дополнительные сведения см. в документации: https://docs.netapp.com/us-en/ontap/authentication/create-svm-user-accounts-task.html.

Поддерживаются два метода аутентификации:

  1. Базовая аутентификация с использованием имени пользователя и пароля.
  2. Аутентификация с помощью сертификата SSL с использованием файла сертификата клиента SSL и, при необходимости, файла закрытого ключа.

Для использования сертификата он должен быть установлен в кластере ONTAP, а аутентификация с помощью сертификата должна быть включена.

validate_certs

boolean

Если задано значение no, сертификаты SSL проверяться не будут.

Устанавливайте значение False только на контролируемых вами сайтах, использующих самоподписанные сертификаты.

Варианты:

  • false
  • true ← (по умолчанию)

validate_changes

string

ACL могут применяться не так, как ожидалось.

Например, если для Everyone наследуются все разрешения, дополнительные пользователи получат все разрешения независимо от запроса.

В этом конкретном случае можно либо удалить Everyone на верхнем уровне, либо создать новую ACL для Everyone на более низком уровне.

При использовании rights ONTAP преобразует их в advanced_rights, поэтому проверка всегда завершается ошибкой.

Допустимые значения: ignore — не выполнять проверку; warn — выдать предупреждение; error — завершить выполнение модуля с ошибкой.

Для SLAG ONTAP может разделить одну ACL на две в зависимости от параметров apply_to. Для сохранения идемпотентности укажите на входе 2 ACL.

Варианты:

  • "ignore"
  • "warn"
  • "error" ← (по умолчанию)

vserver

string / обязательный

Имя используемого vserver.

Примечания

Примечание

  • Поддерживается check_mode.
  • Поддерживается только REST; требуется ONTAP 9.9.1 или более поздняя версия.
  • Для SLAG требуется ONTAP 9.10.1 или более поздняя версия.
  • Модули с префиксом na_ontap предназначены для поддержки платформы хранения ONTAP.
  • HTTPS включен по умолчанию и рекомендуется к использованию. Чтобы включить HTTP в кластере, выполните следующие команды: ‘set -privilege advanced;’ ‘system services web modify -http-enabled true;’

Примеры

- name: Add ACL for file or directory security permissions.
  netapp.ontap.na_ontap_file_security_permissions_acl:
    vserver: "{{ vserver_name }}"
    access_control: file_directory
    path: "{{ file_mount_path }}"
    validate_changes: warn
    access: access_allow
    # Note, without quotes, use a single backslash in AD user names
    # with quotes, it needs to be escaped as a double backslash
    # user: "ANSIBLE_CIFS\user1"
    # we can't show an example with a single backslash as this is a python file, but it works in YAML.
    acl_user: "user1"
    apply_to:
      this_folder: true
    advanced_rights:
      append_data: true
      delete: false

- name: Modify ACL for file or directory security permissions.
  netapp.ontap.na_ontap_file_security_permissions_acl:
    vserver: "{{ vserver_name }}"
    access_control: file_directory
    path: "{{ file_mount_path }}"
    validate_changes: warn
    access: access_allow
    acl_user: "user1"
    apply_to:
      this_folder: true
    advanced_rights:
      append_data: false
      delete: true

- name: Delete ACL for file or directory security permissions.
  netapp.ontap.na_ontap_file_security_permissions_acl:
    vserver: "{{ vserver_name }}"
    access_control: file_directory
    path: "{{ file_mount_path }}"
    validate_changes: warn
    access: access_allow
    acl_user: "user1"
    apply_to:
      this_folder: true
    state: absent

Авторы

  • NetApp Ansible Team (@carchi8py)

Ссылки коллекции

  • Трекер проблем
  • Главная страница
  • Репозиторий (исходный код)

© 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/netapp/ontap/na_ontap_file_security_permissions_acl_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API