本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 Linux WorkSpaces 上設定 WebAuthn
<a name="webauthn_linux"></a>

Linux WorkSpaces 目前支援標準 WebAuthn，需要瀏覽器擴充功能，才能將 WebAuthn 提示重新導向至用戶端。

## 先決條件
<a name="prerequisites"></a>
+ Amazon WorkSpaces WSP 主機轉接器 2.1.0.1923 版或更新版本
+ 支援 WebAuthn 的 Windows、Linux 和 Mac 的 Amazon WorkSpaces 原生用戶端。

   如需詳細資訊，請參閱[用戶端版本需求](webauthn_support.md#webauthn-client-versions)。
+ Linux WorkSpaces 執行個體上的根存取 (sudo)
+ 網際網路存取以下載瀏覽器擴充功能

## 組態步驟
<a name="configuration_steps"></a>

**1. 驗證 WSP 主機轉接器版本**
+ 使用下列命令來驗證 WSP 主機轉接器的版本。如果版本低於 2.1.0.1923，請重新啟動 WorkSpace，轉接器將自動更新。

  ```
  $ apt show wsp-dcv-host-adapter
  ```

**2. 設定原生傳訊主機**
+ 針對每個支援的瀏覽器，建立原生傳訊主機資訊清單檔案的符號連結：

  **Google Chrome**

  ```
  $ sudo mkdir -p /etc/opt/chrome/native-messaging-hosts  
  sudo ln -s -f /usr/share/dcv/webauthn/com.dcv.webauthnredirection.nativemessagehost.json /etc/opt/chrome/native-messaging-hosts/
  ```

  **Chromium**

  ```
  $ sudo mkdir -p /etc/chromium/native-messaging-hosts  
  sudo ln -s -f /usr/share/dcv/webauthn/com.dcv.webauthnredirection.nativemessagehost.json /etc/chromium/native-messaging-hosts/
  ```

  **Microsoft Edge**

  ```
  $ sudo mkdir -p /etc/opt/edge/native-messaging-hosts  
  sudo ln -s -f /usr/share/dcv/webauthn/com.dcv.webauthnredirection.nativemessagehost.json /etc/opt/edge/native-messaging-hosts/
  ```

**3. 安裝 DCV WebAuthn 延伸模組**

1. 安裝 WebAuthn 重新導向的瀏覽器延伸模組。這可以手動或透過企業政策來完成。

   **手動安裝**

   從各自的瀏覽器存放區下載擴充功能：
   + [Microsoft Edge 附加元件](https://microsoftedge.microsoft.com/addons/detail/dcv-webauthn-redirection-/ihejeaahjpbegmaaegiikmlphghlfmeh)
   + [Chrome Web Store](https://chrome.google.com/webstore/detail/dcv-webauthn-redirection/mmiioagbgnbojdbcjoddlefhmcocfpmn)

   對於手動安裝：

   1. 連線至 Amazon DCV 工作階段。

   1. 開啟您偏好的瀏覽器，然後導覽至相關的瀏覽器存放區 （上述連結）。

   1. 選取**取得** (Microsoft Edge) 或**新增至 Chrome** (Google Chrome) 以繼續。

   1. 遵循螢幕說明。成功新增延伸項目後，系統就會顯示確認。

1. 若要啟用無縫設定，您可以設定系統來預先安裝 DCV WebAuthn 延伸模組，如下所示：

   **Google Chrome**

   ```
   $ sudo mkdir -p /usr/share/google-chrome/extensions/  
   echo '{"external_update_url": "https://clients2.google.com/service/update2/crx"}' | \
   sudo tee /usr/share/google-chrome/extensions/mmiioagbgnbojdbcjoddlefhmcocfpmn.json
   sudo chmod a+r /usr/share/google-chrome/extensions/mmiioagbgnbojdbcjoddlefhmcocfpmn.json
   ```

   **Chromium、Brave 瀏覽器**

   ```
   $ sudo mkdir -p /usr/share/chromium/extensions/  
   echo '{"external_update_url": "https://clients2.google.com/service/update2/crx"}' | \
   sudo tee /usr/share/chromium/extensions/mmiioagbgnbojdbcjoddlefhmcocfpmn.json
   sudo chmod a+r /usr/share/chromium/extensions/mmiioagbgnbojdbcjoddlefhmcocfpmn.json
   ```

   **Microsoft Edge**

   ```
   $ sudo mkdir -p /usr/share/microsoft-edge/extensions/  
   echo '{"external_update_url": "https://edge.microsoft.com/extensionwebstorebase/v1/crx"}' | \
   sudo tee /usr/share/microsoft-edge/extensions/ihejeaahjpbegmaaegiikmlphghlfmeh.json
   sudo chmod a+r /usr/share/microsoft-edge/extensions/ihejeaahjpbegmaaegiikmlphghlfmeh.json
   ```

**4. 重新啟動瀏覽器。**

在重新啟動期間，DCV WebAuthn 延伸模組應該會自動安裝，WebAuthn 裝置將可在 WorkSpaces 工作階段中重新導向。如果您遇到任何問題，請聯絡 AWSSupport 或參閱 WorkSpaces 文件以進一步進行故障診斷。