在 Ubuntu/Debian 虚拟机上设置智能卡重定向

要在 Ubuntu/Debian 虚拟机 (VM) 上配置智能卡重定向功能，请安装该功能所依赖的库以及用于支持可信智能卡身份验证的根证书颁发机构 (CA) 证书。此外，您还必须编辑某些配置文件以完成身份验证设置。

该过程中的一些示例使用占位符值以表示网络配置中的实体，例如，AD 域的 DNS 名称。请将占位符值替换为您的配置特定的信息，如下表中所述。

必备条件

将 Ubuntu/Debian 虚拟机与 AD 集成以进行智能卡重定向

步骤

1. 在 Ubuntu/Debian 虚拟机上安装所需的库。

   sudo apt-get install -y pcscd pcsc-tools pkg-config libpam-pkcs11 opensc libengine-pkcs11-openssl libnss3-tools
   

2. 安装根 CA 证书。

   1. 下载一个根 CA 证书，并将其保存到 Ubuntu 虚拟机上的 /tmp/certificate.cer 中。请参阅如何导出根证书颁发机构证书。

   2. 找到下载的根 CA 证书，并将其传输到 .pem 文件。

      sudo openssl x509 -inform der -in /tmp/certificate.cer -out /tmp/certificate.pem
      

   3. 将根 CA 证书复制到 /etc/pam_pkcs11/cacerts 目录中。

      sudo cp /tmp/certificate.pem /etc/pam_pkcs11/cacerts
      

3. 创建一个 pkcs11 哈希文件。

   sudo chmod a+r certificate.pem
   sudo pkcs11_make_hash_link
   

4. 配置 pam_pkcs11 库。

   1. 使用默认示例内容创建一个 pam_pkcs11.conf 文件。

      • (Ubuntu 20.04) 运行以下命令序列。

        sudo mkdir /etc/pam_pkcs11
        sudo zcat /usr/share/doc/libpam-pkcs11/examples/pam_pkcs11.conf.example.gz | tee /etc/pam_pkcs11/pam_pkcs11.conf
        

      • （Ubuntu 20.04.1 及更高版本、Ubuntu 24.04/22.04、Debian）运行以下命令序列。

        sudo mkdir /etc/pam_pkcs11
        sudo cat /usr/share/doc/libpam-pkcs11/examples/pam_pkcs11.conf.example | tee /etc/pam_pkcs11/pam_pkcs11.conf
        

   2. 编辑 /etc/pam_pkcs11/pam_pkcs11.conf 文件，如以下示例中所示。

      use_pkcs11_module = opensc;                            
      ...
      pkcs11_module opensc {                                 
           module = /usr/lib/x86_64-linux-gnu/opensc-pkcs11.so;         
           description = "OpenSC PKCS#11 module";               
           slot_num = 0;                           
           ca_dir = /etc/pam_pkcs11/cacerts;
           crl_dir = /etc/pam_pkcs11/crls;       
           support_threads = false;
           cert_policy = ca,signature;
           token_type = "Smart card";                       
      }                                                    
      ...
      use_mappers = cn, null;                        
      ...
      mapper cn {
           debug = false;
           module = internal;
           ignorecase = true;
           mapfile = file:///etc/pam_pkcs11/cn_map; 
      }
      

   3. 编辑 /etc/pam_pkcs11/cn_map 文件，使其包含以下行。

      Common name -> Login ID
      

5. 编辑 /etc/pam.d/gdm-password 配置文件。将 pam_pkcs11.so 授权行放置在 common-auth 行之前，如以下示例中所示。

   #%PAM-1.0
   auth    requisite       pam_nologin.so
   auth    required        pam_succeed_if.so user != root quiet_success
   auth sufficient pam_pkcs11.so                                                                               
   @include common-auth
   auth    optional        pam_gnome_keyring.so
   @include common-account
   

6. 要确认已在智能卡上安装智能卡硬件和证书，请运行以下命令。

   sudo pcsc_scan
   sudo pkcs11_listcerts
   sudo pkcs11_inspect
   

7. 要在停用 SSO 时支持智能卡 SSO 功能和 Horizon Greeter，请配置 /etc/omnissa/viewagent-greeter.conf 文件。请参阅在 Linux 桌面上编辑配置文件。

8. 安装 Horizon Agent 软件包并启用智能卡重定向。

   sudo ./install_viewagent.sh -m yes
   

   **注意：**如果您收到一条错误消息，指示您安装默认 PC/SC Lite 库，请卸载计算机上当前存在的自定义 PC/SC Lite 库，并使用以下命令安装默认 PC/SC Lite 库。

   sudo apt-get install --reinstall pcscd libpcsclite1
   

   然后，可以运行 Horizon Agent 安装程序。

9. 如果您使用的是自定义 PC/SC Lite 库，请在 /etc/omnissa/config 文件中配置 pcscd.maxReaderContext 和 pcscd.readBody 选项。

   请参阅在 Linux 桌面上编辑配置文件。

10. 重新启动 Ubuntu 虚拟机，然后重新登录。