Skip to main content

2026 年 11 月 18 日

在 Ubuntu/Debian 虛擬機器上設定智慧卡重新導向

若要在 Ubuntu/Debian 虛擬機器 (VM) 上設定智慧卡重新導向,請安裝該功能所依賴的程式庫,以及支援受信任的智慧卡驗證所需的根憑證授權機構 (CA) 憑證。此外,您還必須編輯某些組態檔以完成驗證設定。

此程序中的某些範例使用預留位置值來代表您網路組態中的實體,例如 AD 網域的 DNS 名稱。請將預留位置值取代為您的組態特有的資訊,如下表所說明。

預留位置值說明
dns_IP_ADDRESSDNS 名稱伺服器的 IP 位址
mydomain.comAD 網域的 DNS 名稱
MYDOMAIN.COMAD 網域的 DNS 名稱 (全部使用大寫字母)
MYDOMAIN包含 Samba 伺服器的工作群組或 NT 網域的 DNS 名稱 (全部使用大寫字母)
ads-hostnameAD 伺服器的主機名稱
ads-hostname.mydomain.comAD 伺服器的完整網域名稱 (FQDN)
mytimeserver.mycompany.comNTP 時間伺服器的 DNS 名稱
AdminUser虛擬機器管理員的使用者名稱

先決條件

整合 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 虛擬機器,並重新登入。

Was this page helpful?

Provide feedback for this topic

Was this topic helpful?

Please do not include any personal or confidential information.

Generating link…