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

access_control

string

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

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

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

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

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

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

Если state имеет значение present, все ACL, не указанные в acls, удаляются, когда этот параметр отсутствует. Если этот параметр указан, удаляются только ACL, соответствующие его значению.

Если state имеет значение absent, все ACL удаляются, когда этот параметр отсутствует. Если этот параметр указан, удаляются только ACL, соответствующие его значению.

Варианты:

• "file_directory"
• "slag"

acls

list / elements=dictionary

Список управления произвольным доступом (DACL) определяет доверенных субъектов, которым разрешен или запрещен доступ к защищаемому объекту.

Когда процесс пытается получить доступ к защищаемому объекту, система проверяет записи управления доступом (ACE) в DACL объекта, чтобы определить, следует ли предоставить ему доступ.

access

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

Указывает, предназначена ли ACL для DACL или SACL.

В настоящее время проверены значения access_allow и access_deny для DACL, а также audit_failure и audit_success для SACL.

Варианты:

• "access_allow"
• "access_deny"
• "access_allowed_callback"
• "access_denied_callback"
• "access_allowed_callback_object"
• "access_denied_callback_object"
• "system_audit_callback"
• "system_audit_callback_object"
• "system_resource_attribute"
• "system_scoped_policy_id"
• "audit_failure"
• "audit_success"
• "audit_success_and_failure"

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"

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.

Необходимо установить значение true как минимум для одного подопараметра. Для неуказанных подопараметров предполагается значение false.

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

files

boolean

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

Варианты:

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

sub_folders

boolean

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

Варианты:

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

this_folder

boolean

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

Варианты:

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

ignore_paths

list / elements=string

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

propagation_mode

string

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

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

Этот параметр действителен только при создании ACL.

Варианты:

• "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"

user

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

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

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

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

Для удобства при совместном использовании с na_ontap_file_security_permissions_acl этому параметру присвоен псевдоним acl_user.

cert_filepath

string

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

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

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

control_flags

string

Указывает управляющие флаги в SD. Значение задается в шестнадцатеричном формате.

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, где каждый компонент является целым числом.

group

string

Указывает основную группу владельца.

Укажите группу владельца, используя имя группы или SID.

hostname

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

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

http_port

integer

Заменяет используемый по умолчанию порт (80 или 443) на этот порт

https

boolean

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

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

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

Варианты:

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

ignore_paths

list / elements=string

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

key_filepath

string

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

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

owner

string

Указывает владельца дескриптора безопасности NTFS (SD).

В качестве владельца можно указать имя пользователя или идентификатор безопасности (SID).

Владелец SD может изменять разрешения для файла (или папки) либо файлов (или папок), к которым применяется SD, а также предоставлять другим пользователям право стать владельцами объекта или объектов, к которым применяется SD.

password

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

string

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

path

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

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

propagation_mode

string

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

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

Варианты:

• "propagate"
• "replace"

state

string

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

При значении absent удаляются все ACL независимо от содержимого acls.

См. access_control, чтобы удалить только все ACL SLAG или только ACL file-directory.

Унаследованные 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 — завершить работу модуля с ошибкой.

При использовании SLAGS ONTAP может разделить одну ACL на две ACL в зависимости от настроек apply_to. Для обеспечения идемпотентности передавайте на вход две ACL.

Варианты:

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

vserver

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

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