netapp_eseries.santricity.na_santricity_ldap 模块 – NetApp E-Series 管理 LDAP 集成以用于身份验证

注意

此模块是 netapp_eseries.santricity 集合（版本 1.4.1）的一部分。

如果您正在使用 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install netapp_eseries.santricity。

要在 Playbook 中使用它，请指定：netapp_eseries.santricity.na_santricity_ldap。

概要 

配置 E-Series 系统以允许通过 LDAP 服务器进行身份验证

参数 

参数	注释
api_password 字符串 / 必需	用于使用 SANtricity Web Services Proxy 或嵌入式 Web Services API 进行身份验证的密码。
api_url 字符串 / 必需	SANtricity Web Services Proxy 或嵌入式 Web Services API 的 URL。示例 https://prod-1.wahoo.acme.com:8443/devmgr/v2
api_username 字符串 / 必需	用于使用 SANtricity Web Services Proxy 或嵌入式 Web Services API 进行身份验证的用户名。
bind_password 字符串	这是绑定用户帐户的密码。当指定 bind_user 时，此参数为必需。
bind_user 字符串	这是将用于查询 LDAP 服务器的用户帐户。当指定 bind_password 时，此参数为必需。示例：CN=MyBindAcct,OU=ServiceAccounts,DC=example,DC=com
group_attributes 列表 / 元素=字符串	应考虑用于组到角色映射的用户属性。通常，这与类似 “memberOf” 的属性一起使用，并且用户的访问权限会根据组成员资格或缺乏组成员资格进行测试。默认值： `["memberOf"]`
identifier 字符串	这是配置的唯一标识符（在配置了多个域的情况下）。默认值： `"default"`
names 列表 / 元素=字符串	在进行身份验证以识别要使用的域时，将使用的域名。默认使用 server 的 DNS 名称。唯一的要求是名称可解析。示例：user@example.com
role_mappings 字典	您可以在这里指定哪些组应该拥有对存储系统的哪些权限。例如，组 A 中的所有用户将被分配所有 4 个可用角色，这将允许访问系统的所有管理功能（超级用户）。组 B 中的用户仅具有 storage.monitor 角色，这将仅允许只读访问。这被指定为正则表达式到角色列表的映射。请参阅示例。将分配给与提供的正则表达式匹配的组/多个组的角色。 storage.admin 允许用户对存储对象和操作具有完全读/写访问权限。 storage.monitor 允许用户对存储对象和操作具有只读访问权限。 support.admin 允许用户访问硬件、诊断信息、主要事件日志和其他关键的支持相关功能，但不包括存储配置。 security.admin 允许用户访问身份验证/授权配置以及审计日志配置和证书管理。
search_base 字符串	搜索基本用于查找用户的组成员资格。示例：ou=users,dc=example,dc=com
server_url 字符串	这是 LDAP 服务器 URL。连接字符串应指定为使用 ldap 或 ldaps 协议以及端口信息。
ssid 字符串	要管理的阵列的 ID。此值对于每个阵列必须是唯一的。默认值： `"1"`
state 字符串	当 state=="present" 时，定义的 LDAP 域将被添加到存储系统。当 state=="absent" 时，指定的域将从存储系统中删除。 state=="disabled" 将导致删除存储系统上的所有现有 LDAP 域。选择 `"present"` ← (默认) `"absent"` `"disabled"`
user_attribute 字符串	这是当用户尝试进行身份验证时，我们将用于匹配提供的用户名的属性。默认值： `"sAMAccountName"`
validate_certs 布尔值	是否应验证 https 证书？选择 `假` `true` ← (默认)

备注 

注意

支持检查模式
此模块允许您定义一个或多个由 identifier 唯一标识的 LDAP 域，以用于身份验证。授权由 role_mappings 确定，即不同用户组可以被授予不同（或没有）对系统和 API 的某些方面的访问权限。
如果 LDAP 服务器变得不可用/无法访问，本地用户帐户仍然可用。
通常，您需要获取组织的 LDAP 服务器的详细信息，然后才能配置系统以使用 LDAP 身份验证；每个实现可能非常不同。
此 API 当前仅支持嵌入式 Web Services API v2.0 及更高版本，或 Web Services Proxy v3.0 及更高版本。
E 系列 Ansible 模块需要 Web Services Proxy (WSP) 的实例来管理存储系统，或者需要支持嵌入式 Web Services API 的 E 系列存储系统。
嵌入式 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 字符串	成功消息返回: 成功时示例: `"ldap 设置已更新。"`

作者

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