本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 在 Linux WebAuthn 上配置 WorkSpaces
<a name="webauthn_linux"></a>

Linux WorkSpaces 目前支持 Standard WebAuthn，它需要浏览器扩展程序来便于将 WebAuthn 提示重定向到客户端。

## 先决条件
<a name="prerequisites"></a>
+ 亚马逊 WorkSpaces WSP 主机适配器版本 2.1.0.1923 或更高版本
+ 支持 Windows、Linux 和 Mac 的亚马逊 WorkSpaces 原生客户端 WebAuthn。

   有关更多信息，请参阅 [客户端版本要求](webauthn_support.md#webauthn-client-versions)。
+ Linux 实例上的根访问权限 (su WorkSpaces do)
+ 可通过互联网下载浏览器扩展程序

## 配置步骤
<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 重定向的浏览器扩展程序。这可以手动完成，也可以通过企业策略完成。

   **手动安装**

   从相应的浏览器商店中下载扩展：
   + [微软 Edge 插件](https://microsoftedge.microsoft.com/addons/detail/dcv-webauthn-redirection-/ihejeaahjpbegmaaegiikmlphghlfmeh)
   + [Chrome 网上应用店](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 browser**

   ```
   $ 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 会话中可供重定向。如果您遇到任何问题，请联系 Su AWS pport 或参阅您的 WorkSpaces 文档进行进一步的故障排除。