community.general.ipa_otpconfig 模块 – 管理 FreeIPA OTP 配置设置

注意

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

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

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

要在 playbook 中使用它，请指定：community.general.ipa_otpconfig。

community.general 2.5.0 中的新功能

概要

  • 修改 FreeIPA 服务器关于 OTP（一次性密码）的全局配置设置。

参数

参数

注释

ipa_host

字符串

IPA 服务器的 IP 或主机名。

如果任务中未指定该值，则将使用环境变量 IPA_HOST 的值。

如果任务中既未指定环境变量 IPA_HOST，也未指定该值，则将使用 DNS 尝试发现 FreeIPA 服务器。

FreeIPA 中需要的相关条目是 ipa-ca 条目。

如果任务中 DNS 条目、环境变量 IPA_HOST 或值都不可用，则将使用默认值。

默认值： "ipa.example.com"

ipa_pass

字符串

管理用户的密码。

如果任务中未指定该值，则将使用环境变量 IPA_PASS 的值。

请注意，如果 urllib_gssapi 库可用，则可以使用 GSSAPI 向 FreeIPA 进行身份验证。

如果环境变量 KRB5CCNAME 可用，则该模块将使用此 Kerberos 凭据缓存向 FreeIPA 服务器进行身份验证。

如果环境变量 KRB5_CLIENT_KTNAME 可用，并且 KRB5CCNAME 不可用；则该模块将使用此 Kerberos Keytab 进行身份验证。

如果 GSSAPI 不可用，则必须使用 ipa_pass。

ipa_port

整数

FreeIPA/IPA 服务器的端口。

如果任务中未指定该值，则将使用环境变量 IPA_PORT 的值。

如果任务中既未指定环境变量 IPA_PORT，也未指定该值，则将设置默认值。

默认值： 443

ipa_prot

字符串

IPA 服务器使用的协议。

如果任务中未指定该值，则将使用环境变量 IPA_PROT 的值。

如果任务中既未指定环境变量 IPA_PROT，也未指定该值，则将设置默认值。

选择

  • "http"

  • "https" ← (默认)

ipa_timeout

整数

指定连接的空闲超时时间（以秒为单位）。

对于批量操作，您可能需要增加此值，以避免来自 IPA 服务器的超时。

如果任务中未指定该值，则将使用环境变量 IPA_TIMEOUT 的值。

如果任务中既未指定环境变量 IPA_TIMEOUT，也未指定该值，则将设置默认值。

默认值： 10

ipa_user

字符串

在 IPA 服务器上使用的管理帐户。

如果任务中未指定该值，则将使用环境变量 IPA_USER 的值。

如果任务中既未指定环境变量 IPA_USER 也未指定该值，则将设置默认值。

默认值： "admin"

ipatokenhotpauthwindow

别名：hotpauthwindow

整数

HOTP 身份验证窗口，以跳数表示。

ipatokenhotpsyncwindow

别名：hotpsyncwindow

整数

HOTP 同步窗口，以跳数表示。

ipatokentotpauthwindow

别名：totpauthwindow

整数

TOTP 身份验证窗口，以秒为单位。

ipatokentotpsyncwindow

别名：totpsyncwindow

整数

TOTP 同步窗口，以秒为单位。

validate_certs

布尔值

仅当 ipa_prot 为 https 时适用。

如果设置为 false，则不会验证 SSL 证书。

仅应在个人控制的站点使用自签名证书时设置为 false。

选择

  • false

  • true ←（默认）

属性

属性

支持

描述

check_mode

支持：完全支持

可以在 check_mode 模式下运行，并返回更改状态预测，而无需修改目标。

diff_mode

支持：不支持

当处于差异模式时，将返回已更改内容（或在 check_mode 中可能需要更改的内容）的详细信息。

示例

- name: Ensure the TOTP authentication window is set to 300 seconds
  community.general.ipa_otpconfig:
    ipatokentotpauthwindow: '300'
    ipa_host: localhost
    ipa_user: admin
    ipa_pass: supersecret

- name: Ensure the TOTP synchronization window is set to 86400 seconds
  community.general.ipa_otpconfig:
    ipatokentotpsyncwindow: '86400'
    ipa_host: localhost
    ipa_user: admin
    ipa_pass: supersecret

- name: Ensure the HOTP authentication window is set to 10 hops
  community.general.ipa_otpconfig:
    ipatokenhotpauthwindow: '10'
    ipa_host: localhost
    ipa_user: admin
    ipa_pass: supersecret

- name: Ensure the HOTP synchronization window is set to 100 hops
  community.general.ipa_otpconfig:
    ipatokenhotpsyncwindow: '100'
    ipa_host: localhost
    ipa_user: admin
    ipa_pass: supersecret

返回值

通用返回值记录在此处：此处，以下是此模块独有的字段

键

描述

otpconfig

字典

IPA API 返回的 OTP 配置。

返回：始终

作者

  • justchris1 (@justchris1)