기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 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/
  ```

  **크롬**

  ```
  $ 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 웹 스토어](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 확장이 자동으로 설치되고 WorkSpaces 세션에서 WebAuthn 디바이스를 리디렉션할 수 있습니다. 문제가 발생하면 AWSSupport에 문의하거나 WorkSpaces 설명서를 참조하여 추가 문제를 해결하세요.