community.general.ipa_sudocmd 模块 – 管理 FreeIPA sudo 命令

注意

此模块是 community.general 集合（版本 10.1.0）的一部分。

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

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

要在剧本中使用它，请指定：community.general.ipa_sudocmd。

概要 

使用 FreeIPA API 在 FreeIPA 服务器中添加、修改或删除 sudo 命令。

参数 

参数	注释
description string	此命令的描述。
ipa_host string	IPA 服务器的 IP 或主机名。如果任务中未指定值，则将使用环境变量 `IPA_HOST` 的值。如果环境变量 `IPA_HOST` 和该值均未在任务中指定，则将使用 DNS 尝试发现 FreeIPA 服务器。 FreeIPA 中需要的相关条目是 `ipa-ca` 条目。如果 DNS 条目、环境变量 `IPA_HOST` 和该值均在任务中不可用，则将使用默认值。默认值： `"ipa.example.com"`
ipa_pass string	管理用户的密码。如果任务中未指定值，则将使用环境变量 `IPA_PASS` 的值。请注意，如果 `urllib_gssapi` 库可用，则可以使用 GSSAPI 对 FreeIPA 进行身份验证。如果环境变量 `KRB5CCNAME` 可用，则模块将使用此 Kerberos 凭据缓存对 FreeIPA 服务器进行身份验证。如果环境变量 `KRB5_CLIENT_KTNAME` 可用，且 `KRB5CCNAME` 不可用；则模块将使用此 Kerberos 密钥表进行身份验证。如果 GSSAPI 不可用，则必须使用 `ipa_pass`。
ipa_port integer	FreeIPA / IPA 服务器的端口。如果任务中未指定值，则将使用环境变量 `IPA_PORT` 的值。如果环境变量 `IPA_PORT` 和该值均未在任务中指定，则将设置默认值。默认值： `443`
ipa_prot string	IPA 服务器使用的协议。如果任务中未指定值，则将使用环境变量 `IPA_PROT` 的值。如果环境变量 `IPA_PROT` 和该值均未在任务中指定，则将设置默认值。选项 `"http"` `"https"` ← (默认)
ipa_timeout integer	指定连接的空闲超时时间（以秒为单位）。对于批量操作，您可能希望增加此值，以避免来自 IPA 服务器的超时。如果任务中未指定值，则将使用环境变量 `IPA_TIMEOUT` 的值。如果环境变量 `IPA_TIMEOUT` 和该值均未在任务中指定，则将设置默认值。默认值： `10`
ipa_user string	在 IPA 服务器上使用的管理帐户。如果任务中未指定值，则将使用环境变量 `IPA_USER` 的值。如果环境变量 `IPA_USER` 和该值均未在任务中指定，则将设置默认值。默认值： `"admin"`
state string	要确保的状态。选项 `"absent"` `"disabled"` `"enabled"` `"present"` ← (默认)
sudocmd 别名：name string / required	Sudo 命令。
validate_certs boolean	这仅在 `ipa_prot` 为 `https` 时适用。如果设置为 `false`，则不会验证 SSL 证书。只有在使用自签名证书的个人控制站点上，才应将其设置为 `false`。选项 `false` `true` ← (默认)

属性 

属性	支持	描述
check_mode	支持: 完全	可以在 `check_mode` 下运行，并返回更改状态预测，而无需修改目标。
diff_mode	支持: 无	当处于 diff 模式时，将返回已更改的内容（或在 `check_mode` 中可能需要更改的内容）的详细信息。

示例 

- name: Ensure sudo command exists
  community.general.ipa_sudocmd:
    name: su
    description: Allow to run su via sudo
    ipa_host: ipa.example.com
    ipa_user: admin
    ipa_pass: topsecret

- name: Ensure sudo command does not exist
  community.general.ipa_sudocmd:
    name: su
    state: absent
    ipa_host: ipa.example.com
    ipa_user: admin
    ipa_pass: topsecret

返回值 

常见的返回值在这里有记录，以下是此模块独有的字段

键	描述
sudocmd 字典	从 IPA API 返回的 Sudo 命令返回: 总是

作者

Thomas Krahn (@Nosmoht)