netapp.storagegrid.na_sg_org_identity_federation 模块 – NetApp StorageGRID 管理租户身份联合。

注意

此模块是 netapp.storagegrid 集合 (版本 21.13.0) 的一部分。

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

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

要在playbook中使用它，请指定： netapp.storagegrid.na_sg_org_identity_federation。

netapp.storagegrid 21.6.0 中的新增功能

概要

  • 配置NetApp StorageGRID中的租户身份联合。

  • 如果模块使用 check_mode 运行，则将使用提供的数值执行连接测试，而不会更改配置。

  • 如果不指定*password*，则此模块是幂等的。

参数

参数

注释

api_url

字符串 / 必需

StorageGRID管理节点REST API的URL。

auth_token

字符串 / 必需

API请求的授权令牌

base_group_dn

字符串

要搜索组的LDAP子树的区分名称。

base_user_dn

字符串

要搜索用户的LDAP子树的区分名称。

ca_cert

字符串

用于连接到LDAP服务器的自定义证书。

如果没有提供自定义证书，则将使用操作系统CA证书。

hostname

字符串

LDAP服务器的主机名或IP地址。

ldap_group_id_attribute

字符串

包含用户组的LDAP属性。

如果ldap_service_type=Other，则应配置。

ldap_group_uuid_attribute

字符串

包含组永久唯一标识的LDAP属性。

如果ldap_service_type=Other，则应配置。

ldap_service_type

字符串

LDAP服务器的类型。

选项

  • "Active Directory"

  • "OpenLDAP"

  • "Other"

ldap_user_id_attribute

字符串

包含用户唯一名称的LDAP属性。

如果ldap_service_type=Other，则应配置。

ldap_user_uuid_attribute

字符串

包含用户永久唯一标识的LDAP属性。

如果ldap_service_type=Other，则应配置。

password

字符串

与用户名关联的密码。

port

整数

用于连接到LDAP服务器的端口。LDAP通常为389，LDAPS通常为636。

state

字符串

是否应启用身份联合。

选项

  • "present" ← (默认)

  • "absent"

tls

字符串

是否使用传输层安全来连接到LDAP服务器。

选项

  • "STARTTLS" ← (默认)

  • "LDAPS"

  • "Disabled"

type

字符串

身份源的类型。

默认为'ldap'。

默认值： "ldap"

username

字符串

绑定到LDAP服务器的用户名。

validate_certs

布尔值

是否应验证https证书？

选项

  • false

  • true ← (默认)

备注

注意

  • 以 na_sg 为前缀的模块旨在管理NetApp StorageGRID。

示例

- name: test identity federation configuration
  netapp.storagegrid.na_sg_org_identity_federation:
    api_url: "https://<storagegrid-endpoint-url>"
    auth_token: "storagegrid-auth-token"
    validate_certs: false
    state: present
    ldap_service_type: "Active Directory"
    hostname: "ad.example.com"
    port: 389
    username: "binduser"
    password: "bindpass"
    base_group_dn: "DC=example,DC=com"
    base_user_dn: "DC=example,DC=com"
    tls: "Disabled"
  check_mode: yes

- name: configure identity federation with AD and TLS
  netapp.storagegrid.na_sg_org_identity_federation:
    api_url: "https://<storagegrid-endpoint-url>"
    auth_token: "storagegrid-auth-token"
    validate_certs: false
    state: present
    ldap_service_type: "Active Directory"
    hostname: "ad.example.com"
    port: 636,
    username: "binduser"
    password: "bindpass"
    base_group_dn: "DC=example,DC=com"
    base_user_dn: "DC=example,DC=com"
    tls: "LDAPS"
    ca_cert: |
        -----BEGIN CERTIFICATE-----
        MIIC+jCCAeICCQDmn9Gow08LTzANBgkqhkiG9w0BAQsFADA/..swCQYDVQQGEwJV
        bXBsZTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEB..JFzNIXQEGnsgjV
        JGU4giuvOLOZ8Q3gyuUbkSUQDjmjpMR8PliwJ6iW2Ity89Dv..dl1TaIYI/ansyZ
        Uxk4YXeN6kUkrDtNxCg1McALzXVAfxMTtj2SFlLxne4Z6rX2..UyftQrfM13F1vY
        gK8dBPz+l+X/Uozo/xNm7gxe68p9le9/pcULst1CQn5/sPqq..kgWcSvlKUItu82
        lq3B2169rovdIaNdcvaQjMPhrDGo5rvLfMN35U3Hgbz41PL5..x2BcUE6/0ab5T4
        qKBxKa3t9twj+zpUqOzyL0PFfCE+SK5fEXAS1ow4eAcLN+eB..gR/PuvGAyIPCtE
        1+X4GrECAwEAATANBgkqhkiG9w0BAQsFAAOCAQEAFpO+04Ra..FMJPH6dBmzfb7l
        k04BWTvSlur6HiQdXY+oFQMJZzyI7MQ8v9HBIzS0ZAzYWLp4..VZhHmRxnrWyxVs
        u783V5YfQH2L4QnBDoiDefgxyfDs2PcoF5C+X9CGXmPqzst2..y/6tdOVJzdiA==
        -----END CERTIFICATE-----

返回值

常见的返回值已在此处记录，以下是此模块特有的字段

键

描述

resp

字典

返回有关StorageGRID租户帐户身份源配置的信息。

已返回：成功

示例： {"baseGroupDn": "DC=example,DC=com", "baseUserDn": "DC=example,DC=com", "caCert": "-----BEGIN CERTIFICATE----- abcdefghijkl123456780ABCDEFGHIJKL 123456/7890ABCDEFabcdefghijklABCD -----END CERTIFICATE----- ", "disable": false, "disableTLS": false, "enableLDAPS": false, "hostname": "10.1.2.3", "id": "00000000-0000-0000-0000-000000000000", "ldapServiceType": "Active Directory", "password": "********", "port": 389, "type": "ldap", "username": "MYDOMAIN\\Administrator"}

作者

  • NetApp Ansible团队 (@joshedmonds)