Модуль netapp_eseries.santricity.na_santricity_ldap — управление интеграцией LDAP в NetApp E-Series для аутентификации

Примечание

Этот модуль входит в коллекцию netapp_eseries.santricity (версия 1.4.1).

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

Чтобы установить её, используйте: ansible-galaxy collection install netapp_eseries.santricity.

Чтобы использовать её в плейбуке, укажите: netapp_eseries.santricity.na_santricity_ldap.

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

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

Настройка системы E-Series для аутентификации через LDAP-сервер

Параметры

Параметр	Комментарии
api_password string / обязательный	Пароль для аутентификации в SANtricity Web Services Proxy или API Embedded Web Services.
api_url string / обязательный	URL-адрес SANtricity Web Services Proxy или API Embedded Web Services. Пример: https://prod-1.wahoo.acme.com:8443/devmgr/v2
api_username string / обязательный	Имя пользователя для аутентификации в SANtricity Web Services Proxy или API Embedded Web Services.
bind_password string	Пароль учетной записи пользователя для привязки. Обязателен, если указан bind_user.
bind_user string	Учетная запись пользователя, которая будет использоваться для отправки запросов к LDAP-серверу. Обязательна, если указан bind_password. Пример: CN=MyBindAcct,OU=ServiceAccounts,DC=example,DC=com
group_attributes list / элементы=string	Атрибуты пользователя, которые следует учитывать при сопоставлении групп с ролями. Обычно для этого используется атрибут наподобие «memberOf», а доступ пользователя проверяется по наличию или отсутствию его членства в группе. По умолчанию: `["memberOf"]`
identifier string	Уникальный идентификатор конфигурации (используется, если настроено несколько доменов). По умолчанию: `"default"`
names list / элементы=string	Имя или имена доменов, которые будут использоваться при аутентификации для определения нужного домена. По умолчанию используется DNS-имя server. Единственное требование — имя или имена должны разрешаться. Пример: user@example.com
role_mappings dictionary	Здесь указываются группы, которым предоставляются те или иные разрешения для системы хранения данных. Например, всем пользователям группы A будут назначены все 4 доступные роли, что обеспечит им доступ ко всем функциям управления системой (права суперпользователя). Пользователям группы B будет назначена только роль storage.monitor, которая предоставляет доступ только для чтения. Значение задаётся как сопоставление регулярных выражений со списком ролей. См. примеры. Роли, назначаемые группе или группам, соответствующим указанному регулярному выражению. Роль storage.admin предоставляет пользователям полный доступ на чтение и запись к объектам и операциям хранения данных. Роль storage.monitor предоставляет пользователям доступ только для чтения к объектам и операциям хранения данных. Роль support.admin предоставляет пользователям доступ к оборудованию, диагностической информации, журналу основных событий и другим важным функциям поддержки, но не к конфигурации системы хранения данных. Роль security.admin предоставляет пользователям доступ к настройке аутентификации и авторизации, конфигурации журнала аудита и управлению сертификатами.
search_base string	База поиска используется для определения членства пользователя в группах. Пример: ou=users,dc=example,dc=com
server_url string	URL-адрес LDAP-сервера. Строку подключения следует указывать с протоколом ldap или ldaps и номером порта.
ssid string	Идентификатор управляемого массива. Это значение должно быть уникальным для каждого массива. По умолчанию: `"1"`
state string	Если state==”present”, указанный домен LDAP будет добавлен в систему хранения данных. Если state==”absent”, указанный домен будет удалён из системы хранения данных. Значение state==”disabled” приведёт к удалению всех существующих доменов LDAP из системы хранения данных. Варианты: `"present"` ← (по умолчанию) `"absent"` `"disabled"`
user_attribute string	Атрибут, который будет использоваться для сопоставления указанного имени пользователя при попытке аутентификации. По умолчанию: `"sAMAccountName"`
validate_certs boolean	Следует ли проверять сертификаты HTTPS? Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Поддерживается режим проверки.
Этот модуль позволяет определить один или несколько доменов LDAP, уникально идентифицируемых по identifier, для использования при аутентификации. Авторизация определяется параметром role_mappings: различным группам пользователей можно предоставить разные разрешения (или не предоставлять их вовсе) для доступа к определённым компонентам системы и API.
Локальные учетные записи пользователей останутся доступными, даже если LDAP-сервер станет недоступен.
Как правило, перед настройкой системы для аутентификации через LDAP необходимо получить сведения о LDAP-сервере организации; каждая реализация, вероятно, будет существенно отличаться.
В настоящее время этот API поддерживается только в API Embedded Web Services версии 2.0 и выше или в Web Services Proxy версии 3.0 и выше.
Для работы модулей E-Series Ansible требуется экземпляр Web Services Proxy (WSP), доступный для управления системой хранения данных, или система хранения данных E-Series с поддержкой API Embedded Web Services.
В настоящее время Embedded Web Services доступен на моделях E2800, E5700, EF570 и более новых.
netapp_eseries.santricity.netapp_e_storage_system можно использовать для настройки систем, управляемых экземпляром WSP.

Примеры

- name: Disable LDAP authentication
  na_santricity_ldap:
    ssid: "1"
    api_url: "https://192.168.1.100:8443/devmgr/v2"
    api_username: "admin"
    api_password: "adminpass"
    validate_certs: true
    state: absent

- name: Remove the "default" LDAP domain configuration
  na_santricity_ldap:
    ssid: "1"
    api_url: "https://192.168.1.100:8443/devmgr/v2"
    api_username: "admin"
    api_password: "adminpass"
    validate_certs: true
    state: absent
    identifier: default

- name: Define a new LDAP domain, utilizing defaults where possible
  na_santricity_ldap:
    ssid: "1"
    api_url: "https://192.168.1.100:8443/devmgr/v2"
    api_username: "admin"
    api_password: "adminpass"
    validate_certs: true
    state: enabled
    bind_username: "CN=MyBindAccount,OU=ServiceAccounts,DC=example,DC=com"
    bind_password: "mySecretPass"
    server: "ldap://example.com:389"
    search_base: "OU=Users,DC=example,DC=com"
    role_mappings:
      ".*dist-dev-storage.*":
        - storage.admin
        - security.admin
        - support.admin
        - storage.monitor

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

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

Ключ	Описание
msg string	Сообщение об успешном выполнении Возвращается: при успешном выполнении Пример: `"The ldap settings have been updated."`

Авторы

Michael Price (@lmprice)
Nathan Swartz (@swartzn)
Vu Tran (@VuTran007)

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

© 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_eseries/santricity/na_santricity_ldap_module.html