f5networks.f5_modules.bigip_password_policy 模块 – 管理 BIG-IP 上的身份验证密码策略

注意

此模块是 f5networks.f5_modules 集合(版本 1.32.1)的一部分。

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

要安装它,请使用:ansible-galaxy collection install f5networks.f5_modules

要在 playbook 中使用它,请指定:f5networks.f5_modules.bigip_password_policy

f5networks.f5_modules 1.0.0 中的新功能

概要

  • 管理 BIG-IP 设备上的身份验证密码策略。

参数

参数

注释

expiration_warning

整数

指定密码过期前的天数。

此值确定 BIG-IP 系统何时自动警告用户他们的密码即将过期。

max_duration

整数

指定密码有效的最大天数。

max_login_failures

整数

指定系统在锁定用户之前允许的连续不成功登录尝试次数。

指定零 (0) 以禁用此参数。

min_duration

整数

指定密码有效的最小天数。

min_length

整数

指定有效密码中的最小字符数。

此值必须在 6 到 255 之间。

password_memory

整数

指定用户是否已配置 BIG-IP 系统来记住特定计算机上的密码以及要记住的密码数量。

policy_enforcement

布尔值

在 BIG-IP 系统上启用或禁用密码策略。

选择

  • false

  • true

provider

字典

在 f5networks.f5_modules 1.0.0 中添加

包含连接详细信息的字典对象。

auth_provider

字符串

配置身份验证提供程序以从远程设备获取身份验证令牌。

此选项在处理 BIG-IQ 设备时真正使用。

no_f5_teem

布尔值

如果 yes,则不会将 TEEM 遥测数据发送到 F5。

您可以通过设置环境变量 F5_TELEMETRY_OFF 来省略此选项。

先前使用的变量 F5_TEEM 已弃用,因为其名称令人困惑。

选择

  • false ← (默认)

  • true

password

别名: pass, pwd

字符串 / 必需

用于连接到 BIG-IP 或 BIG-IQ 的用户帐户的密码。

您可以通过设置环境变量 F5_PASSWORD 来省略此选项。

server

字符串 / 必需

BIG-IP 主机或 BIG-IQ 主机。

您可以通过设置环境变量 F5_SERVER 来省略此选项。

server_port

整数

BIG-IP 服务器端口。

您可以通过设置环境变量 F5_SERVER_PORT 来省略此选项。

默认值: 443

timeout

整数

指定与网络设备通信以进行连接或发送命令的超时时间(以秒为单位)。如果在操作完成之前超过超时时间,则模块将出错。

transport

字符串

配置连接到远程设备时使用的传输连接。

选择

  • "rest" ← (默认)

user

字符串 / 必需

用于连接到 BIG-IP 或 BIG-IQ 的用户名。此用户必须在设备上具有管理权限。

您可以通过设置环境变量 F5_USER 来省略此选项。

validate_certs

布尔值

如果为 no,则不会验证 SSL 证书。仅在个人控制的站点上使用自签名证书时才使用此选项。

您可以通过设置环境变量 F5_VALIDATE_CERTS 来省略此选项。

选择

  • false

  • true ← (默认)

required_lowercase

整数

指定密码要有效,密码中必须存在的最小小写字母字符数。

required_numeric

整数

指定密码要有效,密码中必须存在的最小数字字符数。

required_special

整数

指定密码要有效,密码中必须存在的最小特殊字符数。

required_uppercase

整数

指定密码要有效,密码中必须存在的最小大写字母字符数。

注释

注意

  • 有关使用 Ansible 管理 F5 Networks 设备的更多信息,请参阅 https://ansible.org.cn/integrations/networks/f5

  • 需要 BIG-IP 软件版本 >= 12。

  • F5 模块仅操作 F5 产品的运行配置。为确保 BIG-IP 的特定配置持久保存到磁盘,请务必至少包含一个使用 f5networks.f5_modules.bigip_config 模块保存运行配置的任务。请参阅该模块的文档,了解如何正确使用该模块来保存您的运行配置。

示例

- name: Change password policy to require 2 numeric characters
  bigip_password_policy:
    required_numeric: 2
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

返回值

常用返回值在此处记录 此处,以下是此模块特有的字段

描述

expiration_warning

整数

新的到期警告。

返回: changed

示例: 7

max_duration

整数

新的最大持续时间。

返回: changed

示例: 99999

max_login_failures

整数

新的最大登录失败次数。

返回: changed

示例: 0

min_duration

整数

新的最小持续时间。

返回: changed

示例: 0

min_length

整数

新的最小密码长度。

返回: changed

示例: 6

password_memory

整数

新的记住的密码数量

返回: changed

示例: 0

policy_enforcement

布尔值

新的策略执行设置。

返回: changed

示例: true

required_lowercase

整数

小写字母要求。

返回: changed

示例: 1

required_numeric

整数

数字要求。

返回: changed

示例: 2

required_special

整数

特殊字符要求。

返回: changed

示例: 1

required_uppercase

整数

大写字母要求。

返回: changed

示例: 1

作者

  • Tim Rupp (@caphrim007)