第 27 章 使用 Ansible playbook 安装身份管理客户端

步骤

1. 打开 inventory 文件进行编辑。

2. 指定要成为 IdM 客户端的主机的完全限定主机名(FQDN)。完全限定域名必须是有效的 DNS 名称：

   • 仅允许数字、字母字符和连字符(-)。例如，不允许使用下划线，这可能导致 DNS 失败。
   • 主机名必须都是小写。不允许使用大写字母。

   如果在 IdM DNS 区中正确设置了 SRV 记录，该脚本会自动发现所有其他必要的值。

   只带有客户端 FQDN 定义的简单的清单主机文件示例

   [ipaclients]
   client.idm.example.com
   [...]

3. 指定注册客户端的凭证。可用的验证方法如下：

   • 注册 客户端的用户权限的密码。这是默认选项。

     • 红帽建议使用 Ansible Vault 来存储密码，并从 playbook 文件引用 Vault 文件，如 install-client.yml ：

       使用来自清单文件和 Ansible Vault 文件中的密码的主体的 playbook 文件示例

       - name: Playbook to configure IPA clients with username/password
         hosts: ipaclients
         become: true
         vars_files:
         - playbook_sensitive_data.yml
       
         roles:
         - role: ipaclient
           state: present

     • 在 inventory/hosts 文件的 [ipaclients:vars] 部分中使用 ipaadmin_password 选项来提供 admin 的凭证不太安全。或者，指定不同的授权用户，请使用 ipaadmin_principal 选项作为用户名，使用 ipaadmin_password 选项作为密码。然后，inventory/hosts 清单文件和 install-client.yml playbook 文件类似如下：

       清单主机文件示例

       [...]
       [ipaclients:vars]
       ipaadmin_principal=my_admin
       ipaadmin_password=Secret123

       使用清单文件中的主体和密码的 Playbook 示例

       - name: Playbook to unconfigure IPA clients
         hosts: ipaclients
         become: true
       
         roles:
         - role: ipaclient
           state: true

   • 之前的注册的 客户端 keytab ，如果其仍然可用。

     如果系统之前作为身份管理客户端注册，则可以使用这个选项。要使用此身份验证方法，请取消 #ipaclient_keytab 选项的注释，指定存储 keytab 的文件的路径，例如在 inventory/hosts 的 [ipaclient:vars] 部分。

   • 在注册过程中生成的随机一次性密码 (OTP)。要使用此身份验证方法，请在清单文件中使用 ipaclient_use_otp=true 选项。例如，您可以取消 inventory/hosts 文件的 [ipaclients:vars] 部分中 ipaclient_use_otp=true 选项的注释。请注意，对于 OTP，还必须指定以下选项之一：

     • 授权注册客户端的用户的密码 ，例如，为 inventory/hosts 文件的 [ipaclients:vars] 部分的 ipaadmin_password 提供值。
     • admin keytab，例如，为 inventory/hosts 的 [ipaclients:vars] 部分中的 ipaadmin_keytab 提供值。

4. 可选：使用 ipaclient_configure_dns_resolve 和 ipaclient_dns_servers 选项（如可用的话）指定 DNS 解析器，以简化集群部署。这在您的 IdM 部署使用集成的 DNS 时特别有用：

   指定 DNS 解析器的清单文件片段：

   [...]
   [ipaclients:vars]
   ipaadmin_password: "{{ ipaadmin_password }}"
   ipaclient_domain=idm.example.com
   ipaclient_configure_dns_resolver=true
   ipaclient_dns_servers=192.168.100.1

   注意

   ipaclient_dns_servers 列表必须仅包含 IP 地址。主机名不允许。

5. 从 RHEL 9.3 开始，您还可以指定 ipaclient_subid: true 选项，来在 IdM 级别上为 IdM 用户配置子范围。