Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mengelola Server DCV Amazon
Amazon DCV berjalan pada server khusus yang membuat sesi pengguna bagi klien untuk mengakses desktop jarak jauh mereka. Sebagai administrator, Anda dapat mengelola dan mengontrol server Amazon DCV, dan sesi menghostingnya, terdaftar untuk Anda.
Mengakses manajemen ini memerlukan kredensi administrator Anda. Anda harus masuk sebagai administrator (Windows) atau root (Linux; macOS) untuk memulai, menghentikan, atau mengonfigurasi server Amazon DCV.
**Topics**
+ [Memulai server](manage-start.md)
+ [Menghentikan server](manage-stop.md)
+ [Memutakhirkan server](setting-up-upgrading.md)
+ [Menghapus instalasi server](setting-up-uninstalling.md)
+ [Menonaktifkan QUIC UDP](disable-quic.md)
+ [Mengubah TCP/UDP port dan alamat](manage-port-addr.md)
+ [Mengelola sertifikat TLS](manage-cert.md)
+ [Memutuskan sambungan klien yang menganggur](manage-disconnect.md)
+ [Mengaktifkan berbagi GPU di Linux](manage-gpu.md)
+ [Mengaktifkan layar sentuh dan dukungan stylus](enable-stylus.md)
+ [Mengaktifkan dukungan gamepad](enable-gamepad.md)
+ [Mengaktifkan remotisasi USB](manage-usb-remote.md)
+ [Mengkonfigurasi caching kartu pintar](manage-smart-card.md)
+ [Mengkonfigurasi Pengalihan WebAuthn](config-webauthn-redirect.md)
+ [Mengaktifkan penyimpanan sesi](manage-storage.md)
+ [Mengkonfigurasi printer di Linux](manage-printer.md)
+ [Mengkonfigurasi clipboard di Linux](manage-clipboard.md)
+ [Mengkonfigurasi audio multi-saluran](manage-audio.md)
+ [Mengkonfigurasi header HTTP](manage-headers.md)
+ [Mengkonfigurasi otentikasi](security-authentication.md)
+ [Mengkonfigurasi otorisasi](security-authorization.md)
+ [Aktifkan koneksi Remote X ke X Server untuk sesi virtual](setup-xforwarding.md)
+ [Sematkan klien browser web Amazon DCV di dalam iFrame](embed-in-iframe.md)
# Memulai Server DCV Amazon
Server Amazon DCV harus berjalan untuk meng-host sesi.
Secara default, server Amazon DCV dimulai setiap kali server yang di-hostingnya dimulai. Jika Anda memilih untuk menonaktifkan startup otomatis ketika Anda menginstal server Amazon DCV, Anda harus memulai server secara manual atau mengatur startup otomatis lagi. Untuk melakukan salah satu opsi, ikuti salah satu prosedur ini.
------
#### [ Windows Amazon DCV server ]
Memulai server Amazon DCV secara manual menggunakan snap-in Layanan untuk Microsoft Management Console.
**Untuk memulai server Amazon DCV di Windows**
1. Buka snap-in Layanan untuk Microsoft Management Console.
1. Di panel kanan, buka Server **DCV**.
1. Pilih **Mulai**.
**catatan**
Jika server sudah aktif dan berjalan, tombol **Start** dinonaktifkan.
Konfigurasikan startup otomatis menggunakan snap-in Layanan untuk Microsoft Management Console.
**Untuk mengkonfigurasi server Amazon DCV untuk memulai secara otomatis di Windows**
1. Buka snap-in Layanan untuk Microsoft Management Console.
1. Di panel kanan, buka Server **DCV**.
1. Untuk **layanan Startup**, pilih **Otomatis**.
------
#### [ Linux Amazon DCV server ]
Secara manual mulai server Amazon DCV menggunakan baris perintah.
**Untuk memulai server Amazon DCV di Linux**
Gunakan salah satu perintah berikut ini:
+ RHEL, CentOS, SUSE Linux Enterprise 12, dan Ubuntu 18.x
```
$ sudo systemctl start dcvserver
```
Konfigurasikan server Amazon DCV untuk mulai secara otomatis menggunakan baris perintah.
**Untuk mengkonfigurasi server Amazon DCV untuk memulai secara otomatis di Linux**
Gunakan salah satu perintah berikut ini:
+ RHEL, CentOS, SUSE Linux Enterprise 12, dan Ubuntu 18.x
```
$ sudo systemctl enable dcvserver
```
------
#### [ macOS Amazon DCV server ]
Secara manual mulai server Amazon DCV menggunakan baris perintah.
**Untuk memulai server Amazon DCV di macOS**
Gunakan salah satu perintah berikut ini:
+
```
$ sudo launchctl start com.amazon.dcv.server.dcvserver
```
Konfigurasikan server Amazon DCV untuk mulai secara otomatis menggunakan baris perintah.
**Untuk mengonfigurasi server Amazon DCV untuk memulai secara otomatis di macOS**
Gunakan salah satu perintah berikut ini:
+
```
$ sudo launchctl enable system/com.amazon.dcv.server.dcvserver
```
------
# Menghentikan Server DCV Amazon
Anda dapat menghentikan server Amazon DCV kapan saja. Menghentikan server akan menghentikan semua sesi Amazon DCV yang aktif. Anda tidak dapat memulai sesi baru sampai setelah server dimulai ulang.
------
#### [ Windows Amazon DCV server ]
Hentikan server Amazon DCV secara manual menggunakan snap-in Layanan untuk Konsol Manajemen Microsoft.
**Untuk menghentikan server Amazon DCV di Windows**
1. Buka snap-in Layanan untuk Microsoft Management Console.
1. Di panel kanan, buka Server **DCV**.
1. Pilih **Berhenti**.
**catatan**
Jika server sudah berhenti, tombol **Stop** dinonaktifkan.
Nonaktifkan startup otomatis menggunakan snap-in Layanan untuk Microsoft Management Console.
**Untuk mencegah server Amazon DCV dimulai secara otomatis di Windows**
1. Buka snap-in Layanan untuk Microsoft Management Console.
1. Di panel kanan, buka Server **DCV**.
1. Untuk **layanan Startup**, pilih **Manual**.
------
#### [ Linux Amazon DCV server ]
Hentikan server Amazon DCV menggunakan baris perintah.
**Untuk menghentikan server Amazon DCV di Linux**
Gunakan perintah berikut ini.
```
$ sudo systemctl stop dcvserver
```
Nonaktifkan startup server Amazon DCV otomatis menggunakan baris perintah.
**Untuk mencegah server Amazon DCV dimulai secara otomatis di Linux**
Gunakan perintah berikut ini.
```
$ sudo systemctl disable dcvserver
```
------
#### [ macOS Amazon DCV server ]
Hentikan server Amazon DCV menggunakan baris perintah.
**Untuk menghentikan server Amazon DCV di macOS**
Gunakan perintah berikut ini.
```
$ sudo launchctl stop com.amazon.dcv.server.dcvserver
```
Nonaktifkan startup server Amazon DCV otomatis menggunakan baris perintah.
**Untuk mencegah server Amazon DCV dimulai secara otomatis di macOS**
Gunakan perintah berikut ini.
```
$ sudo launchctl disable system/com.amazon.dcv.server.dcvserver
```
------
# Memutakhirkan Server DCV Amazon
Topik berikut menjelaskan cara memutakhirkan server Amazon DCV.
**Topics**
+ [Pertimbangan kompatibilitas](#compatibility-considerations)
+ [Memutakhirkan Server DCV Amazon di Windows](#upgrading-windows-upgrade)
+ [Memutakhirkan Server DCV Amazon di Linux](#upgrading-linux)
+ [Memutakhirkan Server DCV Amazon di macOS](#upgrading-macos)
## Pertimbangan kompatibilitas
Server Amazon DCV versi 2017 dan yang lebih baru kompatibel dengan klien Amazon DCV versi 2017 dan yang lebih baru.
**catatan**
Untuk informasi tentang persyaratan kompatibilitas lisensi server Amazon DCV untuk server lokal dan non-EC2, lihat. [Persyaratan lisensi](setting-up-license.md#licensing-requirements)
## Memutakhirkan Server DCV Amazon di Windows
**Untuk memutakhirkan server Amazon DCV di Windows**
1. Menggunakan klien RDP, sambungkan ke server Amazon DCV sebagai administrator.
1. Pastikan tidak ada sesi Amazon DCV yang berjalan. Gunakan perintah `dcv list-sessions` Amazon DCV untuk memeriksa sesi yang sedang berjalan. Jika ada sesi yang sedang berjalan, gunakan perintah `dcv close-session` Amazon DCV untuk menghentikannya.
1. Setelah Anda mengonfirmasi bahwa tidak ada sesi yang berjalan, hentikan server Amazon DCV. Untuk informasi selengkapnya, lihat [Menghentikan Server DCV Amazon](manage-stop.md).
1. Cadangkan konfigurasi server Amazon DCV Anda. **Buka Registry Editor, arahkan ke **HKEY\$1 USERS/S-1-5-18/Software/GSettings/com/nicesoftware/dcv**, klik kanan tombol **dcv**, dan pilih Ekspor.**
1. Unduh versi terbaru Amazon DCV Server dari situs web [NICE](http://download.amazondcv.com).
1. Ikuti langkah-langkah yang dijelaskan di[Menggunakan wizard](setting-up-installing-wininstall.md#setting-up-installing-windows-wizard), mulai dari langkah 3.
1. Setelah instalasi selesai, konfirmasikan bahwa konfigurasi server Amazon DCV masih benar. Buka Registry Editor, arahkan ke **HKEY\$1 USERS/S-1-5-18/Software/GSettings/com/nicesoftware/dcv** dan bandingkan parameter dengan konfigurasi yang Anda ekspor pada langkah 4.
1. Uji server Amazon DCV dengan memulai sesi Amazon DCV baru. Untuk informasi selengkapnya, lihat [Memulai sesi Amazon DCV](managing-sessions-start.md).
## Memutakhirkan Server DCV Amazon di Linux
**Untuk memutakhirkan server Amazon DCV di Linux**
1. Gunakan SSH untuk masuk ke server menggunakan `root` pengguna.
1. Pastikan tidak ada sesi Amazon DCV yang berjalan. Gunakan perintah `dcv list-sessions` Amazon DCV untuk memeriksa sesi yang sedang berjalan. Jika ada sesi yang sedang berjalan, gunakan perintah `dcv close-session` Amazon DCV untuk menghentikannya.
1. Setelah Anda mengonfirmasi bahwa tidak ada sesi yang berjalan, hentikan server Amazon DCV. Untuk informasi selengkapnya, lihat [Menghentikan Server DCV Amazon](manage-stop.md).
1. Cadangkan konfigurasi server Amazon DCV Anda. Salin `/etc/dcv/dcv.conf` file ke lokasi yang aman.
1. Ikuti langkah-langkah yang dijelaskan di[Instal Server Amazon DCV](setting-up-installing-linux-server.md#linux-server-install).
1. Setelah instalasi selesai, konfirmasikan bahwa konfigurasi server Amazon DCV masih benar. Buka file yang Anda salin di langkah 4 dan bandingkan dengan `/etc/dcv/dcv.conf` file.
1. Uji server Amazon DCV dengan memulai sesi Amazon DCV baru. Untuk informasi selengkapnya, lihat [Memulai sesi Amazon DCV](managing-sessions-start.md).
## Memutakhirkan Server DCV Amazon di macOS
**Untuk memutakhirkan server Amazon DCV di macOS**
1. Gunakan SSH untuk masuk ke server menggunakan pengguna root.
1. Pastikan tidak ada sesi Amazon DCV yang berjalan. Gunakan perintah `dcv list-sessions` Amazon DCV untuk memeriksa sesi yang sedang berjalan. Jika ada sesi yang sedang berjalan, gunakan perintah `dcv close-session` Amazon DCV untuk menghentikannya.
1. Setelah Anda mengonfirmasi bahwa tidak ada sesi yang berjalan, hentikan server Amazon DCV. Untuk informasi selengkapnya, lihat [Menghentikan Server DCV Amazon](manage-stop.md).
1. Cadangkan konfigurasi server Amazon DCV Anda. Salin `/etc/dcv/dcv.conf` file ke lokasi yang aman.
1. Ikuti langkah-langkah yang dijelaskan di[Menginstal Server DCV Amazon di macOS](setting-up-installing-macos.md).
1. Setelah instalasi selesai, konfirmasikan bahwa konfigurasi server Amazon DCV masih benar. Buka file yang Anda salin di langkah 4 dan bandingkan dengan `/etc/dcv/dcv.conf` file.
1. Uji server Amazon DCV dengan memulai sesi Amazon DCV baru. Untuk informasi selengkapnya, lihat [Memulai sesi Amazon DCV](managing-sessions-start.md).
# Menghapus instalasi Amazon DCV Server
Topik berikut menjelaskan cara menghapus server Amazon DCV.
**Topics**
+ [Mencopot instalasi Amazon DCV Server pada Windows](#uninstalling-windows)
+ [Menghapus instalasi Amazon DCV Server di Linux](#uninstalling-linux)
+ [Menghapus instalasi Amazon DCV Server di macOS](#uninstalling-macos)
## Mencopot instalasi Amazon DCV Server pada Windows
**Untuk menghapus instalasi server Amazon DCV di Windows**
1. Menggunakan klien RDP, sambungkan ke server Amazon DCV sebagai administrator.
1. Pastikan tidak ada sesi Amazon DCV yang berjalan. Gunakan perintah `dcv list-sessions` Amazon DCV untuk memeriksa sesi yang sedang berjalan. Jika ada sesi yang sedang berjalan, gunakan perintah `dcv close session` Amazon DCV untuk menghentikannya.
1. Setelah Anda mengonfirmasi bahwa tidak ada sesi yang berjalan, hentikan server Amazon DCV. Untuk informasi selengkapnya, lihat [Menghentikan Server DCV Amazon](manage-stop.md).
1. Buka aplikasi **Pengaturan** Windows dan arahkan ke panel **Aplikasi & Fitur**.
1. Pilih Amazon DCV server dan kemudian tekan **Uninstall**.
1. (Opsional) Anda mungkin juga ingin menghapus file log apa pun yang dihasilkan oleh server Amazon DCV. Setelah penghapusan instalasi selesai, arahkan ke **C:\$1\$1 NICEProgramData\$1 dcv\$1** dan hapus folder **log**.
## Menghapus instalasi Amazon DCV Server di Linux
Server Amazon DCV diinstal menggunakan serangkaian paket RPM atau .deb, tergantung pada sistem operasi server host Anda.
**catatan**
Anda harus masuk sebagai pengguna root untuk menghapus instalasi server Amazon DCV.
**Untuk menghapus instalasi server Amazon DCV di Linux**
1. Pastikan tidak ada sesi Amazon DCV yang berjalan. Gunakan perintah `dcv list-sessions` Amazon DCV untuk memeriksa sesi yang sedang berjalan. Jika ada sesi yang sedang berjalan, gunakan perintah `dcv close session` Amazon DCV untuk menghentikannya.
1. Setelah Anda mengonfirmasi bahwa tidak ada sesi yang berjalan, hentikan server Amazon DCV. Untuk informasi selengkapnya, lihat [Menghentikan Server DCV Amazon](manage-stop.md).
1. Copot pemasangan paket server Amazon DCV. Tergantung pada bagaimana Anda melakukan instalasi, beberapa paket mungkin tidak diinstal pada sistem Anda dan dapat dihilangkan dari perintah. Untuk daftar paket opsional, lihat[Menginstal Amazon DCV Server di Linux](setting-up-installing-linux.md).
------
#### [ Amazon Linux 2 and RHEL, CentOS ]
```
$ sudo yum remove nice-dcv-server nice-xdcv nice-dcv-gl nice-dcv-gltest nice-dcv-simple-external-authenticator
```
------
#### [ SLES 12.x/15.x ]
```
$ sudo zypper remove nice-dcv-server nice-xdcv nice-dcv-gl nice-dcv-gltest nice-dcv-simple-external-authenticator
```
------
#### [ Ubuntu 22.04 ]
```
$ sudo apt remove nice-dcv-server nice-xdcv nice-dcv-gl nice-dcv-gltest nice-dcv-simple-external-authenticator
```
------
1. (Opsional) Anda mungkin juga ingin menghapus file log apa pun yang dihasilkan oleh server Amazon DCV. **Setelah penghapusan instalasi selesai, navigasikan **ke/var/log** dan hapus folder dcv.**
## Menghapus instalasi Amazon DCV Server di macOS
**catatan**
Anda harus masuk sebagai pengguna root untuk menghapus instalasi server Amazon DCV.
**Untuk menghapus instalasi server Amazon DCV di macOS**
1. Pastikan tidak ada sesi Amazon DCV yang berjalan. Gunakan perintah `dcv list-sessions` Amazon DCV untuk memeriksa sesi yang sedang berjalan. Jika ada sesi yang sedang berjalan, gunakan perintah `dcv close session` Amazon DCV untuk menghentikannya.
1. Setelah Anda mengonfirmasi bahwa tidak ada sesi yang berjalan, hentikan server Amazon DCV. Untuk informasi selengkapnya, lihat [Menghentikan Server DCV Amazon](manage-stop.md).
1. Hapus paket server Amazon DCV dengan perintah berikut:
```
$ sudo rm -rf /Applications/DCV Server.app
```
1. (Opsional) Anda mungkin juga ingin menghapus file log apa pun yang dihasilkan oleh server Amazon DCV. **Setelah penghapusan instalasi selesai, navigasikan **ke/var/log** dan hapus folder dcv.**
# Menonaktifkan protokol transportasi QUIC UDP
Secara default, sejak versi 2024.0, Amazon DCV mendukung WebSocket protokol, yang didasarkan pada TCP, dan protokol QUIC, yang didasarkan pada UDP untuk transportasi data.
Protokol transportasi QUIC didasarkan pada UDP. Jika jaringan Anda mengalami latensi tinggi dan kehilangan paket, menggunakan QUIC dapat meningkatkan kinerja. Dengan QUIC, server terus digunakan WebSocket untuk lalu lintas otentikasi.
**catatan**
Anda dapat menggunakan QUIC hanya jika lalu lintas UDP diizinkan oleh jaringan dan konfigurasi keamanan Anda.
Dengan QUIC diaktifkan, klien dapat menggunakan protokol QUIC untuk mengangkut data saat menghubungkan ke sesi server Amazon DCV. Jika klien tidak menggunakan protokol QUIC saat mereka terhubung, mereka menggunakannya WebSocket. Untuk informasi selengkapnya tentang protokol QUIC, lihat [Menghubungkan ke Sesi Amazon DCV](https://docs.aws.amazon.com/dcv/latest/userguide/using-connecting.html) di Panduan Pengguna *Amazon DCV*.
------
#### [ Windows Amazon DCV server ]
**Untuk menonaktifkan penggunaan QUIC (UDP) untuk transportasi data di Amazon DCV**
1. Buka Windows Registry Editor dan arahkan ke **HKEY\$1USERS\$1 S-1-5-18\$1 Software\$1\$1 com\$1nicesoftwareGSettings\$1** dcv\$1 connectivity\$1 key.
1. Buka **enable-quic-frontend**parameternya. Untuk **data Nilai**, masukkan`0`.
**catatan**
Jika Anda tidak dapat menemukan parameter, buat parameter DWORD (32-bit) baru dan beri nama. `enable-quic-frontend`
1. Tutup Windows Registry Editor.
1. [Hentikan](manage-stop.md) dan [mulai ulang](manage-start.md) server Amazon DCV.
------
#### [ Linux Amazon DCV server ]
**Untuk menonaktifkan penggunaan QUIC (UDP) untuk transportasi data di Amazon DCV**
1. Buka `/etc/dcv/dcv.conf` dengan editor teks pilihan Anda.
1. Di `[connectivity]` bagian ini, lakukan hal berikut:
+ Untuk `enable-quic-frontend`, tentukan `false`.
```
[connectivity]
enable-quic-frontend=false
```
1. Simpan dan tutup file .
1. [Hentikan](manage-stop.md) dan [mulai ulang](manage-start.md) server Amazon DCV.
------
#### [ macOS Amazon DCV server ]
**Untuk menonaktifkan penggunaan QUIC (UDP) untuk transportasi data di Amazon DCV**
1. Buka `/etc/dcv/dcv.conf` dengan editor teks pilihan Anda.
1. Di `[connectivity]` bagian ini, lakukan hal berikut:
+ Untuk `enable-quic-frontend`, tentukan `false`.
```
[connectivity]
enable-quic-frontend=false
```
1. Simpan dan tutup file .
1. [Hentikan](manage-stop.md) dan [mulai ulang](manage-start.md) server Amazon DCV.
------
# Mengubah TCP/UDP port Amazon DCV Server dan mendengarkan alamat
Secara default, server Amazon DCV dikonfigurasi untuk mendengarkan pada port TCP `8443` dan untuk berkomunikasi pada salah satu antarmuka jaringan pada host yang dijalankannya.
Anda dapat menentukan port TCP khusus setelah Anda menginstal server Amazon DCV. Jika Anda mengonfigurasi server Amazon DCV untuk [mengaktifkan QUIC](disable-quic.md), Anda juga dapat menentukan port UDP khusus untuk lalu lintas QUIC. Nomor port harus lebih tinggi dari 1024.
Anda dapat menentukan alamat jaringan yang didengarkan server Amazon DCV. Misalnya, ini memungkinkan Anda untuk menentukan apakah hanya IPv4 atau IPv6 harus digunakan. Ini juga memungkinkan Anda untuk mengikat server ke antarmuka jaringan tertentu dan memastikan bahwa lalu lintas mengalir melalui jaringan tertentu.
**penting**
Setiap kali Anda menerapkan perubahan pada konfigurasi jaringan server Amazon DCV, pastikan Anda mengkomunikasikan perubahan tersebut kepada klien Anda, misalnya mereka perlu mengetahui nomor port yang digunakan untuk terhubung ke sesi.
**Tip**
Pendekatan alternatif untuk mengontrol alamat jaringan dan port yang terpapar ke klien Anda terdiri dari menggunakan [Amazon DCV Connection Gateway](https://docs.aws.amazon.com/dcv/latest/gw-admin/what-is-gw.html) atau proxy web lain atau penyeimbang beban sebagai frontend ke server Anda. Mengakses host server Amazon DCV Anda melalui gateway memungkinkan Anda memiliki satu alamat untuk server Anda. Ini juga memungkinkan untuk menggunakan nomor port yang lebih rendah dari 1024, termasuk 443, nomor port standar untuk HTTPS.
Lihat dokumentasi gateway Anda untuk informasi lebih lanjut tentang mengonfigurasi alamat jaringan dan port-portnya.
**Topics**
+ [Mengubah TCP/UDP port server](#manage-ports)
+ [Mendengarkan pada titik akhir tertentu](#manage-listen-endpoints)
## Mengubah port server TCP/UDP Amazon DCV
------
#### [ Windows Amazon DCV server ]
Untuk mengubah port yang digunakan oleh server Amazon DCV, konfigurasikan `web-port` dan `quic-port` parameter menggunakan Windows Registry Editor.
**Untuk mengubah port untuk server pada Windows**
1. Buka Windows Registry Editor.
1. Arahkan ke **tombol HKEY\$1USERS\$1 S-1-5-18\$1 Software\$1\$1 com\$1nicesoftware\$1 GSettings dcv\$1 connectivity/**.
1. Untuk mengkonfigurasi port TCP, pilih parameter **web-port**.
Jika tidak ada `web-port` parameter dalam kunci registri, buat satu:
1. Di panel navigasi, buka menu konteks (klik kanan) untuk tombol **konektivitas**. Kemudian, pilih **New**, **DWORD (32-bit) value**.
1. Untuk **Nama**, masukkan `web-port` dan tekan **Enter**.
1. Buka parameter **web-port**. Untuk **data Nilai**, masukkan nomor port TCP baru. Jika Anda tidak mengonfigurasi parameter ini, server Amazon DCV menggunakan port TCP 8443 secara default.
**catatan**
Nomor port TCP harus lebih tinggi dari 1024.
1. **Jika QUIC diaktifkan, untuk mengkonfigurasi port UDP, pilih parameter quic-port.**
Jika tidak ada `quic-port` parameter dalam kunci registri, buat satu:
1. Di panel navigasi, buka menu konteks (klik kanan) untuk tombol **konektivitas**. Kemudian, pilih **New**, **DWORD (32-bit) value**.
1. Untuk **Nama**, masukkan `quic-port` dan tekan **Enter**.
1. Buka parameter **quic-port**. Untuk **data Nilai**, masukkan nomor port UDP yang baru. Jika Anda tidak mengonfigurasi parameter ini dan dukungan QUIC diaktifkan, server Amazon DCV menggunakan port UDP 8443 secara default.
**catatan**
Nomor port UDP harus lebih tinggi dari 1024.
1. Pilih **OK** dan tutup Windows Registry Editor.
1. [Hentikan](manage-stop.md) dan [mulai ulang](manage-start.md) server Amazon DCV.
------
#### [ Linux Amazon DCV server ]
Untuk mengubah port yang digunakan oleh server Amazon DCV, konfigurasikan `web-port` dan `quic-port` parameter dalam `dcv.conf` file.
**Untuk mengubah port untuk server di Linux**
1. Arahkan ke `/etc/dcv/` dan buka `dcv.conf` dengan editor teks pilihan Anda.
1. Temukan `web-port` parameter di `[connectivity]` bagian. Kemudian, ganti nomor port TCP yang ada dengan nomor port TCP yang baru.
Jika tidak ada `web-port` parameter di `[connectivity]` bagian ini, tambahkan secara manual menggunakan format berikut:
```
[connectivity]
web-port=port_number
```
**catatan**
Nomor port TCP harus 1024 atau lebih tinggi.
1. Temukan `quic-port` parameter di `[connectivity]` bagian. Kemudian, ganti nomor port UDP yang ada dengan nomor port UDP yang baru.
Jika tidak ada `quic-port` parameter di `[connectivity]` bagian ini, tambahkan secara manual menggunakan format berikut:
```
[connectivity]
quic-port=port_number
```
**catatan**
Nomor port UDP harus 1024 atau lebih tinggi.
1. Simpan dan tutup file .
1. [Hentikan](manage-stop.md) dan [mulai ulang](manage-start.md) server Amazon DCV.
------
#### [ macOS Amazon DCV server ]
Untuk mengubah port yang digunakan oleh server Amazon DCV, konfigurasikan `web-port` dan `quic-port` parameter dalam `dcv.conf` file.
**Untuk mengubah port untuk server di macOS**
1. Arahkan ke `/etc/dcv/` dan buka `dcv.conf` dengan editor teks pilihan Anda.
1. Temukan `web-port` parameter di `[connectivity]` bagian. Kemudian, ganti nomor port TCP yang ada dengan nomor port TCP yang baru.
Jika tidak ada `web-port` parameter di `[connectivity]` bagian ini, tambahkan secara manual menggunakan format berikut:
```
[connectivity]
web-port=port_number
```
**catatan**
Nomor port TCP harus 1024 atau lebih tinggi.
1. Temukan `quic-port` parameter di `[connectivity]` bagian. Kemudian, ganti nomor port UDP yang ada dengan nomor port UDP yang baru.
Jika tidak ada `quic-port` parameter di `[connectivity]` bagian ini, tambahkan secara manual menggunakan format berikut:
```
[connectivity]
quic-port=port_number
```
**catatan**
Nomor port UDP harus 1024 atau lebih tinggi.
1. Simpan dan tutup file .
1. [Hentikan](manage-stop.md) dan [mulai ulang](manage-start.md) server Amazon DCV.
------
## Mendengarkan pada titik akhir tertentu
Untuk mendengarkan hanya pada alamat jaringan tertentu, Anda dapat mengatur `web-listen-endpoints` dan `quic-listen-endpoints` parameter dalam konfigurasi server Amazon DCV.
Setiap titik akhir diwakili oleh IPv6 alamat IPv4 atau, secara opsional diikuti oleh nomor port yang dipisahkan oleh. `:` Nomor port yang ditentukan di titik akhir diprioritaskan di atas port yang ditentukan dalam `quic-port` parameter `web-port` dan.
Karena dimungkinkan untuk menentukan lebih dari satu titik akhir, satu set titik akhir diwakili oleh daftar yang dipisahkan koma, diapit dalam tanda kurung siku, di mana setiap titik akhir berada di antara tanda kutip tunggal. Misalnya, `['0.0.0.0:8443', '[::]:8443']` mewakili IPv4 alamat lokal dan IPv6 alamat lokal apa pun, baik pada port 8443, `'[::%1]:8443'` mewakili IPv6 alamat yang terikat ke antarmuka jaringan dengan indeks 1 pada host Windows, `'[::%eth1]:8443'` mewakili IPv6 alamat yang terikat ke antarmuka `eth1` jaringan pada host Linux.
**catatan**
Parameter konfigurasi ini hanya tersedia mulai dari Amazon DCV Server 2022.0.
------
#### [ Windows Amazon DCV server ]
**Untuk mengubah titik akhir untuk server pada Windows**
1. Buka Windows Registry Editor.
1. Arahkan ke **kunci HKEY\$1USERS\$1 S-1-5-18\$1 Software\$1\$1 com\$1nicesoftwareGSettings\$1** dcv\$1 connectivity\$1 key.
1. Untuk mengkonfigurasi titik akhir TCP, pilih parameter. **web-listen-endpoints**
Jika tidak ada `web-listen-endpoints` parameter dalam kunci registri, buat satu:
1. Di panel navigasi, buka menu konteks (klik kanan) untuk tombol **konektivitas**. Kemudian, pilih **Baru**, **nilai String**.
1. Untuk **Nama**, masukkan `web-listen-endpoints` dan tekan **Enter**.
1. Buka **web-listen-endpoints**parameternya. Untuk **data Nilai**, masukkan daftar titik akhir.
1. Jika QUIC diaktifkan, untuk mengkonfigurasi endpoint UDP, pilih parameter. **quic-listen-endpoints**
Jika tidak ada `quic-listen-endpoints` parameter dalam kunci registri, buat satu:
1. Di panel navigasi, buka menu konteks (klik kanan) untuk tombol **konektivitas**. Kemudian, pilih **Baru**, **nilai String**.
1. Untuk **Nama**, masukkan `quic-listen-endpoints` dan tekan **Enter**.
1. Buka **quic-listen-endpoints**parameternya. Untuk **data Nilai**, masukkan daftar titik akhir.
1. Pilih **OK** dan tutup Windows Registry Editor.
1. [Hentikan](manage-stop.md) dan [mulai ulang](manage-start.md) server Amazon DCV.
------
#### [ Linux Amazon DCV server ]
**Untuk mengubah titik akhir untuk server di Linux**
1. Arahkan ke `/etc/dcv/` dan buka `dcv.conf` dengan editor teks pilihan Anda.
1. Temukan `web-listen-endpoints` parameter di `[connectivity]` bagian. Kemudian, ganti daftar endpoint yang ada.
Jika tidak ada `web-listen-endpoints` parameter di `[connectivity]` bagian ini, tambahkan secara manual menggunakan format berikut:
```
[connectivity]
web-listen-endpoints=[endpoint1, endpoint2]
```
1. Temukan `quic-listen-endpoints` parameter di `[connectivity]` bagian. Kemudian, ganti daftar endpoint yang ada.
Jika tidak ada `quic-listen-endpoints` parameter di `[connectivity]` bagian ini, tambahkan secara manual menggunakan format berikut:
```
[connectivity]
quic-listen-endpoints=[endpoint1, endpoint2]
```
1. Simpan dan tutup file .
1. [Hentikan](manage-stop.md) dan [mulai ulang](manage-start.md) server Amazon DCV.
------
#### [ macOS Amazon DCV server ]
**Untuk mengubah titik akhir server di macOS**
1. Arahkan ke `/etc/dcv/` dan buka `dcv.conf` dengan editor teks pilihan Anda.
1. Temukan `web-listen-endpoints` parameter di `[connectivity]` bagian. Kemudian, ganti daftar endpoint yang ada.
Jika tidak ada `web-listen-endpoints` parameter di `[connectivity]` bagian ini, tambahkan secara manual menggunakan format berikut:
```
[connectivity]
web-listen-endpoints=[endpoint1, endpoint2]
```
1. Temukan `quic-listen-endpoints` parameter di `[connectivity]` bagian. Kemudian, ganti daftar endpoint yang ada.
Jika tidak ada `quic-listen-endpoints` parameter di `[connectivity]` bagian ini, tambahkan secara manual menggunakan format berikut:
```
[connectivity]
quic-listen-endpoints=[endpoint1, endpoint2]
```
1. Simpan dan tutup file .
1. [Hentikan](manage-stop.md) dan [mulai ulang](manage-start.md) server Amazon DCV.
------
# Mengelola sertifikat TLS
Amazon DCV secara otomatis menghasilkan sertifikat yang ditandatangani sendiri yang digunakan untuk mengamankan lalu lintas antara klien Amazon DCV dan server Amazon DCV. Secara default, jika tidak ada sertifikat lain yang diinstal, sertifikat ini digunakan. Sertifikat default mencakup dua file. Mereka adalah sertifikat itu sendiri (`dcv.pem)`dan kunci (`dcv.key`). Untuk informasi selengkapnya, lihat [Klarifikasi pengalihan dengan sertifikat yang ditandatangani sendiri](redirection-clarifications-with-self-signed-certs.md).
Ketika pengguna klien DCV terhubung ke server, mereka mungkin menerima peringatan sertifikat server bahwa mereka dapat bertindak untuk memverifikasi, sebelum koneksi dibuat.
Jika mereka menggunakan browser web untuk terhubung, browser mungkin memperingatkan pengguna klien tentang mempercayai sertifikat server dan bahwa mereka harus menghubungi administrator untuk mengonfirmasi keaslian sertifikat.
Demikian pula, jika mereka menggunakan klien Windows, Linux atau macOS, mereka mungkin disarankan untuk mengonfirmasi sidik jari sertifikat yang diberikan dengan administrator server Amazon DCV.
Untuk memverifikasi keaslian sidik jari sertifikat mereka, jalankan `dcv list-endpoints -j` dan periksa output terhadap sidik jari sertifikat mereka.
Anda dapat mengganti sertifikat Amazon DCV default dan kuncinya dengan sertifikat dan kunci Anda sendiri.
Saat Anda membuat sertifikat sendiri, pilih atribut sertifikat yang memenuhi kebutuhan spesifik Anda. `CN (Common Name)`Atribut dalam banyak kasus harus cocok dengan nama host publik dari host. Anda juga mungkin ingin menentukan `SAN (Subject Alternative Name)` atribut dan mengaturnya ke alamat IP host.
Untuk petunjuk tentang cara membuat sertifikat, lihat dokumentasi Otoritas Sertifikasi khusus Anda.
**penting**
Jika Anda menggunakan sertifikat dan kunci Anda sendiri, Anda harus memberi nama sertifikat Anda `dcv.pem` dan Anda harus memberi nama kuncinya`dcv.key`.
------
#### [ Windows Amazon DCV server ]
**Untuk mengubah sertifikat TLS server pada Windows**
+ Tempatkan sertifikat dan kuncinya di lokasi berikut di server DCV Amazon Windows Anda:
```
C:\Windows\System32\config\systemprofile\AppData\Local\NICE\dcv\
```
------
#### [ Linux Amazon DCV server ]
**Untuk mengubah sertifikat TLS server di Linux**
1. Tempatkan sertifikat dan kuncinya di lokasi berikut di server DCV Amazon Linux Anda:
```
/etc/dcv/
```
1. Berikan kepemilikan kedua file kepada `dcv` pengguna, dan ubah izinnya menjadi 600 (hanya pemilik yang dapat membaca atau menulis kepada mereka).
```
$ sudo chown dcv dcv.pem dcv.key
```
```
$ sudo chmod 600 dcv.pem dcv.key
```
------
#### [ macOS Amazon DCV server ]
**Untuk mengubah sertifikat TLS server di macOS**
1. Tempatkan sertifikat dan kuncinya di lokasi berikut di server DCV Amazon macOS Anda:
```
/etc/dcv/
```
1. Berikan kepemilikan kedua file kepada `dcv` pengguna, dan ubah izinnya menjadi 600 (hanya pemilik yang dapat membaca atau menulis kepada mereka).
```
$ sudo chown dcv dcv.pem dcv.key
```
```
$ sudo chmod 600 dcv.pem dcv.key
```
------
**catatan**
Dimulai dengan Amazon DCV 2022.0, jika Anda memperbarui file sertifikat saat server Amazon DCV berjalan, sertifikat baru akan dimuat ulang secara otomatis. Untuk versi Amazon DCV sebelumnya, Anda harus [menghentikan](manage-stop.md) dan [memulai ulang](manage-start.md) server Amazon DCV secara manual.
# Memutuskan sambungan klien yang menganggur
Anda dapat mengonfigurasi Amazon DCV untuk memutuskan sambungan klien yang menganggur. Lebih khusus lagi, Anda dapat melakukan ini untuk klien yang tidak mengirim input keyboard atau pointer apa pun ke server Amazon DCV untuk jangka waktu tertentu. Secara default, server Amazon DCV memutus klien Amazon DCV setelah menganggur selama 60 menit (satu jam).
Ada tindakan tertentu yang akan mengatur ulang periode batas waktu pemutusan idle. Jika salah satu tindakan berikut terjadi, periode batas waktu idle akan diatur ulang ke kerangka waktu yang ditetapkan:
+ Memindahkan mouse
+ Menekan tombol mouse atau menggerakkan roda mouse
+ Menekan tombol apa saja pada keyboard
+ Menyentuh layar sentuh (jika diaktifkan)
+ Menggunakan stylus (jika diaktifkan)
+ Menggunakan gamepad (jika diaktifkan)
+ Streaming dengan webcam (jika diaktifkan)
+ Operasi penyimpanan file apa pun seperti mengunggah file, membuat direktori, mengunduh file, atau mencantumkan item
**catatan**
Menghubungkan dan menggunakan perangkat audio apa pun tidak mengatur ulang periode batas waktu idle.
Anda juga dapat mengonfigurasi server Amazon DCV untuk mengirim pemberitahuan ke klien yang menganggur. Pemberitahuan ini untuk memberi tahu mereka bahwa sesi mereka akan terputus. Pemberitahuan batas waktu hanya didukung dengan server Amazon DCV dan klien versi 2017.4 dan yang lebih baru.
Anda dapat menggunakan prosedur berikut untuk menentukan periode batas waktu idle kustom.
------
#### [ Windows Amazon DCV server ]
Untuk mengubah periode batas waktu idle server Amazon DCV, Anda harus mengonfigurasi `idle-timeout` parameter menggunakan Windows Registry Editor.
**Untuk mengubah periode batas waktu idle pada Windows**
1. Buka Windows Registry Editor.
1. **Arahkan ke **tombol HKEY\$1USERS\$1 S-1-5-18\$1 Software\$1\$1 com\$1nicesoftwareGSettings\$1 dcv\$1 connectivity\$1** dan pilih parameter idle-timeout.**
Jika parameter tidak dapat ditemukan, gunakan langkah-langkah berikut untuk membuatnya:
1. Di panel navigasi, buka menu konteks (klik kanan) untuk tombol **konektivitas**. Kemudian, pilih **New**, **DWORD (32-bit) value**.
1. Untuk **Nama**, masukkan `idle-timeout` dan tekan **Enter**.
1. Buka parameter **idle-timeout**. Untuk **data Nilai**, masukkan nilai untuk periode batas waktu idle (dalam menit, desimal). Untuk menghindari pemutusan klien yang menganggur, masukkan. `0`
1. Pilih **OK** dan tutup Windows Registry Editor.
**(Opsional) Untuk mengonfigurasi server Amazon DCV untuk mengirim pemberitahuan batas waktu ke klien yang menganggur**
1. Arahkan ke **tombol HKEY\$1USERS\$1 S-1-5-18\$1 Software\$1\$1 com\$1nicesoftwareGSettings\$1 dcv\$1 connectivity\$1** dan pilih parameternya. **idle-timeout-warning**
Jika parameter tidak dapat ditemukan, gunakan langkah-langkah berikut untuk membuatnya:
1. Di panel navigasi, buka menu konteks (klik kanan) untuk tombol **konektivitas**. Kemudian, pilih **New**, **DWORD (32-bit) value**.
1. Untuk **Nama**, masukkan `idle-timeout-warning` dan tekan **Enter**.
1. Buka **idle-timeout-warning**parameternya. Untuk **data Nilai**, masukkan jumlah detik (desimal) sebelum pemutusan bahwa pemberitahuan peringatan terkait dikirim. Misalnya, jika Anda ingin notifikasi dikirim dua menit sebelum batas waktu idle tercapai, masukkan. `120`
1. Pilih **OK** dan tutup Windows Registry Editor.
------
#### [ Linux Amazon DCV server ]
Untuk mengubah periode batas waktu idle server Amazon DCV, Anda harus mengonfigurasi `idle-timeout` parameter dalam file. `dcv.conf`
**Untuk mengubah periode batas waktu idle di Linux**
1. Buka `/etc/dcv/dcv.conf` dengan editor teks pilihan Anda.
1. Temukan `idle-timeout` parameter di `[connectivity]` bagian. Kemudian, ganti periode timeout yang ada dengan periode timeout baru (dalam menit, desimal).
Jika tidak ada `idle-timeout` parameter di `[connectivity]` bagian ini, tambahkan secara manual menggunakan format berikut:
```
[connectivity]
idle-timeout=timeout_in_minutes
```
Untuk menghindari pemutusan klien yang menganggur, masukkan. `0`
1. Simpan dan tutup file .
**(Opsional) Untuk mengonfigurasi server Amazon DCV untuk mengirim pemberitahuan batas waktu ke klien yang menganggur**
1. Buka `/etc/dcv/dcv.conf` dengan editor teks pilihan Anda.
1. Tambahkan `idle-timeout-warning` parameter ke `[connectivity]` bagian dan tentukan jumlah detik (desimal) sebelum pemutusan bahwa pemberitahuan peringatan terkait dikirim.
```
idle-timeout-warning=seconds_before_idle_timeout
```
Misalnya, jika Anda ingin notifikasi dikirim dua menit sebelum batas waktu idle tercapai, tentukan. `120`
1. Simpan dan tutup file .
------
#### [ macOS Amazon DCV server ]
Untuk mengubah periode batas waktu idle server Amazon DCV, Anda harus mengonfigurasi `idle-timeout` parameter dalam file. `dcv.conf`
**Untuk mengubah periode batas waktu idle di macOS**
1. Buka `/etc/dcv/dcv.conf` dengan editor teks pilihan Anda.
1. Temukan `idle-timeout` parameter di `[connectivity]` bagian. Kemudian, ganti periode timeout yang ada dengan periode timeout baru (dalam menit, desimal).
Jika tidak ada `idle-timeout` parameter di `[connectivity]` bagian ini, tambahkan secara manual menggunakan format berikut:
```
[connectivity]
idle-timeout=timeout_in_minutes
```
Untuk menghindari pemutusan klien yang menganggur, masukkan. `0`
1. Simpan dan tutup file .
**(Opsional) Untuk mengonfigurasi server Amazon DCV untuk mengirim pemberitahuan batas waktu ke klien yang menganggur**
1. Buka `/etc/dcv/dcv.conf` dengan editor teks pilihan Anda.
1. Tambahkan `idle-timeout-warning` parameter ke `[connectivity]` bagian dan tentukan jumlah detik (desimal) sebelum pemutusan bahwa pemberitahuan peringatan terkait dikirim.
```
idle-timeout-warning=seconds_before_idle_timeout
```
Misalnya, jika Anda ingin notifikasi dikirim dua menit sebelum batas waktu idle tercapai, tentukan. `120`
1. Simpan dan tutup file .
------
# Mengaktifkan berbagi GPU di Linux Amazon DCV Server
Dengan berbagi GPU, Anda dapat berbagi satu atau lebih fisik GPUs antara beberapa sesi virtual Amazon DCV. Untuk informasi lebih lanjut tentang sesi, lihat[Mengelola sesi Amazon DCV](managing-sessions.md). Menggunakan berbagi GPU, Anda dapat menggunakan satu server Amazon DCV dan menghosting beberapa sesi virtual yang berbagi sumber daya GPU fisik server.
**catatan**
Berbagi GPU hanya didukung di server Linux Amazon DCV.
**Prasyarat**
Sebelum menggunakan fungsi , pastikan untuk melengkapi prasyarat berikut:
+ Instal server Amazon DCV di server Linux.
+ Instal Amazon DCV `dcv-gl` dan `nice-Xdcv` paket di server.
+ Pastikan server memiliki setidaknya satu GPU NVIDIA yang didukung.
+ Instal driver GPU NVIDIA di server. Driver NVIDIA resmi diperlukan. Driver NVIDIA open-source tidak didukung.
+ Pastikan driver GPU NVIDIA mendukung OpenGL yang dipercepat perangkat keras.
+ Instal X Server dan konfigurasikan `Screen` bagian `Device` dan dalam `xorg.conf` file.
**catatan**
Anda dapat menggunakan utilitas `nvidia-xconfig` NVIDIA untuk secara otomatis membuat `xorg.conf` file dan mengkonfigurasinya untuk semua NVIDIA yang tersedia GPUs.
+ Pastikan X Server sedang berjalan.
+ (Opsional) Verifikasi konfigurasi server Amazon DCV dengan menjalankan `dcvgldiag` alat. Untuk informasi selengkapnya, lihat [Melakukan pemeriksaan pasca-instalasi](setting-up-installing-linux-checks.md).
Anda juga dapat menginstal `nice-dcv-gltest` paket dan menjalankan aplikasi `dcvgltest` pengujian untuk memeriksa apakah server dikonfigurasi dengan benar untuk berbagi GPU.
Untuk mengaktifkan berbagi GPU, Anda harus menentukan daftar GPUs yang akan digunakan oleh sesi virtual. Jika Anda tidak menentukan GPUs, hanya GPU yang digunakan oleh Server X standar, dengan nama tampilan`:0.0`, yang digunakan.
Tentukan GPUs `gl-displays` parameter dalam `dcv.conf` file setelah Anda menyelesaikan prasyarat yang dijelaskan sebelumnya dalam topik ini.
**Untuk mengaktifkan berbagi GPU di server DCV Amazon Linux**
1. Arahkan ke `/etc/dcv/` dan buka `dcv.conf` file dengan editor teks pilihan Anda.
1. Tambahkan `[display/linux]` bagian dan `gl-displays` parameter. Kemudian, tentukan yang tersedia GPUs dalam format berikut:
```
[display/linux]
gl-displays = [':xserver_port.screen_number_1',':xserver_port.screen_number_2', ...]
```
Di *xserver\$1port* mana server dan nomor *screen\$1number* yang terkait dengan layar yang terkait dengan GPU. *screen\$1number*Dimulai dari`0`.
Contoh berikut menunjukkan `gl-displays` parameter untuk dua GPUs berjalan pada sesi default X Server:
```
[display/linux]
gl-displays = [':0.0',':0.1']
```
1. Simpan dan tutup file .
1. [Hentikan](manage-stop.md) dan [mulai ulang](manage-start.md) server Amazon DCV.
# Mengaktifkan layar sentuh dan dukungan stylus
**catatan**
Pengalihan USB untuk perangkat layar sentuh dan stylus tidak diperlukan. Selain itu, tidak ada driver vendor yang perlu diinstal di server Amazon DCV.
Amazon DCV mendukung layar sentuh dan stylus dengan menggunakan sistem operasi asli. APIs
Windows menggunakan Windows Ink.
Linux menggunakan injeksi input X11.
+ **Dukungan server Windows**
Layar sentuh didukung pada semua sistem operasi Windows yang didukung. Stylus didukung pada semua sistem operasi Windows yang didukung mulai dari Windows 10 dan Windows 2019, mereka tidak didukung pada Windows 2016, Windows 8.1 dan versi yang lebih lama. Secara default, fitur diaktifkan di server Windows Amazon DCV. Tidak diperlukan konfigurasi tambahan.
+ **Dukungan server Linux**
Layar sentuh dan stylus didukung pada semua sistem operasi Linux yang didukung. Fitur diaktifkan secara default pada sesi virtual yang dihosting di server Linux Amazon DCV. Namun, beberapa konfigurasi tambahan diperlukan untuk mengaktifkan fitur pada sesi konsol yang dihosting di server Linux Amazon DCV.
**penting**
Penggunaan layar sentuh dan stylus dengan Amazon DCV diaktifkan jika fitur ini didukung *pada klien dan server, dan diaktifkan di server*. Untuk informasi tentang dukungan klien, lihat [fitur klien](https://docs.aws.amazon.com/dcv/latest/userguide/client.html#client-features) di *Panduan Pengguna Amazon DCV*.
**Untuk mengaktifkan dukungan layar sentuh dan stylus untuk sesi konsol yang dihosting di server DCV Amazon Linux**
1. Buka `/etc/X11/xorg.conf` menggunakan editor teks pilihan Anda.
1. Tambahkan bagian berikut ke file.
```
Section "InputDevice"
Identifier "DCV Stylus Pen"
Driver "dcvinput"
EndSection
Section "InputDevice"
Identifier "DCV Stylus Eraser"
Driver "dcvinput"
EndSection
Section "InputDevice"
Identifier "DCV Touchscreen"
Driver "dcvinput"
EndSection
```
1. Tambahkan yang berikut ini ke akhir `ServerLayout` bagian.
```
InputDevice "DCV Stylus Pen"
InputDevice "DCV Stylus Eraser"
InputDevice "DCV Touchscreen"
```
Contoh:
```
Section "ServerLayout"
...existing content...
InputDevice "DCV Stylus Pen"
InputDevice "DCV Stylus Eraser"
InputDevice "DCV Touchscreen"
EndSection
```
1. Simpan perubahan Anda dan tutup file .
1. Mulai ulang server X.
+ RHEL, Rocky, CentOS, Amazon Linux 2, Ubuntu, dan SUSE Linux Enterprise 12.x
```
$ sudo systemctl isolate multi-user.target
```
```
$ sudo systemctl isolate graphical.target
```
1. Untuk memastikan bahwa perangkat input dikonfigurasi dengan benar, jalankan perintah berikut.
```
$ sudo DISPLAY=:0 xinput
```
Pena stylus DCV, penghapus stylus DCV, dan layar sentuh DCV muncul di output perintah. Berikut ini adalah output contoh.
```
| Virtual core pointer id=2 [master pointer (3)]
| | Virtual core XTEST pointer id=4 [slave pointer (2)]
| | dummy_mouse id=6 [slave pointer (2)]
| | dummy_keyboard id=7 [slave pointer (2)]
| | DCV Stylus Pen id=8 [slave pointer (2)]
| | DCV Stylus Eraser id=9 [slave pointer (2)]
| | DCV Touchscreen id=10 [slave pointer (2)]
| Virtual core keyboard id=3 [master keyboard (2)]
| Virtual core XTEST keyboard id=5 [slave keyboard (3)]
```
## Mengkonfigurasi rentang tekanan stylus
Ada beberapa aplikasi yang mengharuskan Anda mengurangi rentang tekanan stylus antara 0 dan 2048. Anda dapat mengonfigurasi rentang tekanan dengan mengatur `Pressure2k` opsi ke true dalam `/etc/X11/xorg.conf` file.
**Untuk mengkonfigurasi tekanan stylus**
1. Buka `/etc/X11/xorg.conf` menggunakan editor teks pilihan Anda.
1. Tambahkan bagian berikut ke file.
```
Section "InputDevice"
Identifier "DCV Stylus Pen"
Driver "dcvinput"
Option "Pressure2K" "true"
EndSection
Section "InputDevice"
Identifier "DCV Stylus Eraser"
Driver "dcvinput"
Option "Pressure2K" "true"
EndSection
```
1. Simpan perubahan Anda dan tutup file .
1. Mulai ulang server X.
# Mengaktifkan dukungan gamepad
Dimulai dengan Amazon DCV Server 2022.0, perangkat gamepad dapat digunakan saat menghubungkan ke salah satu sistem operasi Windows atau Linux yang didukung.
Perangkat gamepad berikut didukung:
+ Pengontrol Xbox 360
+ DualShock 4 pengontrol
Perangkat lain yang kompatibel dengan perangkat yang tercantum di atas, atau yang dapat dikonfigurasi untuk meniru salah satu perangkat yang didukung, juga dapat berfungsi.
**catatan**
Perangkat Gamepad hanya didukung saat menggunakan klien DCV Amazon asli Windows atau klien web. Pastikan Anda terhubung ke server DCV versi 2025.0 atau yang lebih baru menggunakan klien web atau menggunakan klien DCV Amazon asli Windows 2022.0 atau yang lebih baru.
Untuk mengaktifkan dukungan gamepad, pastikan bahwa Anda telah menginstal versi terbaru dari Amazon DCV Server dan bahwa Anda memilih untuk menginstal driver Gamepad. Untuk informasi selengkapnya, lihat [Menginstal Server DCV Amazon di Windows](setting-up-installing-windows.md). Saat driver diinstal, fitur ini diaktifkan secara default di server Windows Amazon DCV.
## Mendukung pengontrol Xbox 360
Pengontrol Xbox 360 memerlukan instalasi driver Windows mereka. Driver ini tidak diinstal secara otomatis pada Windows dan perlu diambil dari situs web pembaruan windows resmi.
**Untuk mengunduh dan menginstal driver pengontrol Xbox 360:**
1. Cari driver di halaman Katalog Pembaruan Microsoft:[https://www.catalog.update.microsoft.com/Search.aspx?q=game+devices+XBOX+360+Controller+For+Windows](https://www.catalog.update.microsoft.com/Search.aspx?q=game+devices+XBOX+360+Controller+For+Windows).
1. Unduh versi terbaru driver untuk sistem operasi Anda.
1. Buka file.cab dan ekstrak isinya:
```
expand filename.cab -F:* .
```
1. Instal file.inf driver dengan perintah berikut:
```
pnputil /add-driver filename.inf /install
```
# Mengaktifkan remotisasi USB
Dengan Amazon DCV, klien dapat menggunakan berbagai perangkat USB khusus, seperti perangkat penunjuk 3D atau perangkat otentikasi. Perangkat terhubung secara fisik ke komputer mereka untuk berinteraksi dengan aplikasi yang berjalan di server Amazon DCV.
**penting**
Amazon DCV menyediakan mekanisme generik untuk mengarahkan perangkat USB. Beberapa perangkat yang sensitif terhadap latensi jaringan mungkin mengalami masalah. Selain itu, beberapa perangkat mungkin tidak berfungsi seperti yang diharapkan karena masalah kompatibilitas driver. Pastikan perangkat Anda berfungsi seperti yang diharapkan sebelum menerapkan ke produksi.
**catatan**
Remotisasi USB hanya didukung dengan klien Windows. Ini tidak didukung dengan klien Windows portabel atau klien browser web. Konfigurasi tambahan mungkin diperlukan pada klien Amazon DCV. Untuk informasi tentang menginstal remotisasi USB pada klien, lihat langkah-langkah opsional di Klien [Windows yang dapat diinstal di Panduan](https://docs.aws.amazon.com/dcv/latest/userguide/client-windows-install.html) Pengguna *Amazon DCV*.
Server Amazon DCV menggunakan daftar izin untuk menentukan perangkat USB mana yang diizinkan untuk digunakan klien. Secara default, beberapa perangkat USB yang umum digunakan ditambahkan ke daftar izinkan. Ini berarti klien dapat menghubungkan perangkat USB ini ke komputer mereka dan menggunakannya di server tanpa konfigurasi tambahan. Untuk informasi selengkapnya, lihat [Menggunakan Remotisasi USB](https://docs.aws.amazon.com/dcv/latest/userguide/using-usb.html) di Panduan Pengguna *Amazon DCV*
Namun, beberapa perangkat khusus mungkin tidak ditambahkan ke daftar izinkan secara default. Perangkat ini harus ditambahkan secara manual ke daftar izinkan di server Amazon DCV sebelum dapat digunakan oleh klien. Setelah ditambahkan, mereka muncul di menu **Pengaturan** klien Windows.
------
#### [ Windows Amazon DCV server ]
Untuk menambahkan perangkat USB ke daftar izinkan, Anda harus mendapatkan string filter perangkat USB dari klien dan menambahkannya ke `usb-devices.conf` file.
**Untuk menambahkan perangkat USB ke daftar izinkan di server Windows Amazon DCV**
1. Pastikan Anda telah menginstal versi terbaru dari server Amazon DCV dan Anda memilih untuk menginstal driver remotisasi USB. Untuk informasi selengkapnya, lihat [Menginstal Server DCV Amazon di Windows](setting-up-installing-windows.md).
1. Instal driver perangkat keras perangkat USB di server Amazon DCV.
1. Pada mesin klien Windows, `C:\Program Files (x86)\NICE\DCV\Client\bin\` navigasikan ke Manajer File.
1. Jalankan `dcvusblist.exe`.
1. Klik kanan pada perangkat USB dalam daftar.
1. Pilih **Salin string filter** dari menu tarik-turun.
1. Di server, buka `C:\Program Files\NICE\DCV\Server\conf\usb-devices.conf` menggunakan editor teks pilihan Anda dan tambahkan string filter ke baris baru di bagian bawah file.
1. Simpan dan tutup file .
1. [Hentikan](https://docs.aws.amazon.com/dcv/latest/adminguide/manage-stop.html) dan [mulai ulang](https://docs.aws.amazon.com/dcv/latest/adminguide/manage-start.html) server Amazon DCV.
------
#### [ Linux Amazon DCV server ]
Untuk menambahkan perangkat USB ke daftar izinkan, tambahkan string filter untuk perangkat USB ke `usb-devices.conf` file.
**Menambahkan perangkat USB ke daftar izinkan di server DCV Amazon Linux**
1. Pastikan Anda telah menginstal versi terbaru dari server Amazon DCV dan driver USB DCV. Untuk informasi selengkapnya, lihat [Menginstal Amazon DCV Server di Linux](setting-up-installing-linux.md).
1. Instal driver perangkat keras perangkat USB di server Amazon DCV.
1. Pada mesin klien Windows, navigasikan ke `C:\Program Files (x86)\NICE\DCV\Client\bin\` Manajer File Anda.
1. Jalankan `dcvusblist.exe`.
1. Klik kanan pada perangkat USB dalam daftar.
1. Pilih **Salin string filter** dari menu tarik-turun.
1. Di server, buka `/etc/dcv/usb-devices.conf` menggunakan editor teks pilihan Anda dan tambahkan string filter ke baris baru di bagian bawah file.
1. Simpan dan tutup file .
1. [Hentikan](https://docs.aws.amazon.com/dcv/latest/adminguide/manage-stop.html) dan [mulai ulang](https://docs.aws.amazon.com/dcv/latest/adminguide/manage-start.html) server Amazon DCV.
------
# Mengkonfigurasi caching kartu pintar
Fitur caching kartu pintar memungkinkan server Amazon DCV untuk menyimpan nilai kartu pintar dalam cache. Saat fitur ini diaktifkan, server Amazon DCV menyimpan hasil panggilan terbaru ke kartu pintar klien. Panggilan masa depan diambil langsung dari cache server, bukan dari klien. Ini mengurangi jumlah lalu lintas yang ditransfer antara klien dan server dan meningkatkan kinerja. Ini sangat berguna jika klien memiliki koneksi internet yang lambat.
Secara default, caching kartu pintar dinonaktifkan. Klien dapat secara manual mengaktifkan caching kartu pintar untuk setiap aplikasi yang mereka jalankan dengan mengatur variabel `DCV_PCSC_ENABLE_CACHE` lingkungan. Untuk petunjuk, lihat [Menggunakan Kartu Pintar](https://docs.aws.amazon.com/dcv/latest/userguide/using-smartcard.html) di *Panduan Pengguna Amazon DCV*. Atau, Anda dapat mengonfigurasi server Amazon DCV untuk mengaktifkan atau menonaktifkan caching kartu pintar secara permanen, terlepas dari nilai yang ditentukan untuk variabel `DCV_PCSC_ENABLE_CACHE` lingkungan.
------
#### [ Linux Amazon DCV server ]
**Untuk mengaktifkan atau menonaktifkan caching kartu pintar secara permanen di server DCV Amazon Linux**
1. Arahkan ke `/etc/dcv/` dan buka `dcv.conf` dengan editor teks pilihan Anda.
1. Temukan `enable-cache` parameter di `[smartcard]` bagian. Untuk mengaktifkan caching kartu pintar secara permanen, masukkan`'always-on'`. Untuk menonaktifkan caching kartu pintar secara permanen, masukkan`'always-off'`.
Jika tidak ada `enable-cache` parameter di `[smartcard]` bagian ini, tambahkan secara manual menggunakan format berikut:
```
[smartcard]
enable-cache='always-on'|'always-off'
```
1. Simpan dan tutup file .
1. [Hentikan](manage-stop.md) dan [mulai ulang](manage-start.md) server Amazon DCV.
------
#### [ Windows Amazon DCV server ]
**Untuk mengaktifkan atau menonaktifkan caching kartu pintar secara permanen di server Windows Amazon DCV**
1. Buka Windows Registry Editor.
1. **Arahkan ke **tombol HKEY\$1USERS\$1 S-1-5-18\$1 Software\$1\$1 com\$1nicesoftwareGSettings\$1 dcv\$1 smartcard\$1** dan pilih parameter enable-cache.**
Jika parameter tidak ada, gunakan langkah-langkah berikut untuk membuatnya:
1. **Di panel kiri, buka menu konteks (klik kanan) untuk kunci **smartcard**, dan pilih **New**, String Value.**
1. Untuk **Nama**, masukkan `enable-cache` dan tekan **Enter**.
1. Buka parameter **enable-cache**. Untuk **data Nilai**, masukkan `always-on` untuk mengaktifkan caching kartu pintar secara permanen, atau masukkan `always-off` untuk menonaktifkan caching kartu pintar secara permanen.
1. Pilih **OK** dan tutup Windows Registry Editor.
------
# Mengkonfigurasi Pengalihan WebAuthn
Dimulai dengan Amazon DCV Server 2023.1, pengguna dapat melakukan autentikasi pada aplikasi web yang menggunakan standar Otentikasi Web (WebAuthn) di browser yang didukung dalam sesi jarak jauh. Ini dilakukan dengan mengarahkan permintaan otentikasi ke autentikator yang terhubung secara lokal, seperti Windows Hello atau YubiKey, atau autentikator lain yang sesuai. FIDO2
WebAuthn pengalihan beroperasi secara independen dari pengalihan USB. Tidak ada persyaratan untuk menginstal driver khusus vendor apa pun di server Amazon DCV. Pengalihan WebAuthn permintaan difasilitasi melalui API asli browser.
Sebelum menggunakan WebAuthn, periksa kembali tabel [Fitur yang Didukung](servers.md#features) untuk memastikan Anda memenuhi semua persyaratan.
**Topics**
+ [Mengkonfigurasi WebAuthn pengalihan pada host Windows](webauth-windows.md)
+ [Mengkonfigurasi WebAuthn pengalihan pada host Linux](webauth-linux.md)
# Mengkonfigurasi WebAuthn pengalihan pada host Windows
WebAuthn dapat diaktifkan atau dinonaktifkan menggunakan `webauthn-redirection` izin. Untuk informasi selengkapnya, lihat [Bekerja dengan file izin](https://docs.aws.amazon.com/dcv/latest/adminguide/security-authorization-file-create.html).
## Mengkonfigurasi Pengalihan WebAuthn
WebAuthn diaktifkan pada DCV secara default. Anda dapat mengaktifkan atau menonaktifkan WebAuthn menggunakan registri berikut:
```
HKEY_USERS\S-1-5-18\Software\GSettings\com\nicesoftware\dcv\webauthn
Key: enabled
Value: 1 to enable, 0 to disable
```
Selain itu, Anda dapat mengonfigurasi aplikasi dan proses mana yang diizinkan untuk mengarahkan WebAuthn prompt menggunakan kunci process-compatibilitylist dengan menambahkan nilai string.
Contoh kunci:
```
HKEY_USERS\S-1-5-18\Software\GSettings\com\nicesoftware\dcv\webauthn\process-compatibilitylist
```
Nilai Default (String):
```
['chrome.exe','msedge.exe','island.exe','firefox.exe','dcvwebauthnnativemsghost.exe','msedgewebview2.exe','Microsoft.AAD.BrokerPlugin.exe']
```
Dengan nilai default di atas, aplikasi seperti Google Chrome ('chrome.exe'), Microsoft Edge ('msedge.exe'), Island Browser ('island.exe'), dan Mozilla Firefox ('firefox.exe') didukung untuk WebAuthn pengalihan. 'dcvwebauthnnativemsghost.exe' diperlukan untuk Standar berbasis ekstensi browser, 'msedgewebview2.exe' diperlukan untuk browser Microsoft Edge tertanam dan 'Microsoft.aad. WebAuthn BrokerPlugin.exe' diperlukan untuk mengaktifkan aplikasi Microsoft Teams dan WebAuthn Microsoft Office365.
Anda dapat menambahkan executable ke daftar kompatibilitas proses untuk menambahkan dukungan untuk lebih banyak aplikasi dan proses.
Ada 2 mode untuk WebAuthn host Windows:
### Pengalihan yang WebAuthn Ditingkatkan
Dimulai dengan DCV 2025.0, Anda dapat menggunakan Enhanced WebAuthn pada server Windows DCV. Enhanced WebAuthn menghilangkan kebutuhan akan ekstensi browser, menyederhanakan pengaturan awal dan meningkatkan kinerja. Ini juga memperkenalkan dukungan untuk WebAuthn aplikasi Windows asli, yang memungkinkan pengguna untuk menggunakan WebAuthn otentikasi di browser web dan aplikasi desktop Windows.
**catatan**
Untuk meningkatkan dari Standard WebAuthn ke Enhanced WebAuthn, pengguna harus menonaktifkan atau menghapus ekstensi browser yang sebelumnya diinstal untuk Standar. WebAuthn
**catatan**
Windows Server 2016 tidak mendukung tingkat sistem WebAuthn. Untuk menggunakan WebAuthn pengalihan pada Windows Server 2016, Anda harus menggunakan Standar WebAuthn.
**Menggunakan Enhanced WebAuthn**
Setelah diaktifkan, Enhanced WebAuthn bekerja dengan mulus tanpa konfigurasi tambahan di pihak Anda. Anda dapat menggunakan WebAuthn perangkat Anda untuk otentikasi di:
+ Browser web (Chrome, Edge)
+ Aplikasi Windows asli yang mendukung WebAuthn
+ Dialog sistem Windows yang membutuhkan WebAuthn otentikasi
### WebAuthn Pengalihan Standar
Dimulai dengan DCV 2023.1, Anda dapat menggunakan Standar WebAuthn pada server Windows DCV. WebAuthn Pengalihan standar memerlukan ekstensi browser untuk diinstal pada server jarak jauh. Ketika fitur diaktifkan dan ekstensi browser diinstal, setiap WebAuthn permintaan yang diprakarsai oleh aplikasi web yang berjalan di browser dalam sesi diarahkan dengan mulus ke klien lokal. Pengguna kemudian dapat menggunakan perangkat seperti Windows Hello atau YubiKey untuk menyelesaikan otentikasi.
Browser yang didukung:
+ Google Chrome 116 atau yang lebih baru
+ Microsoft Edge 116 atau yang lebih baru
#### Menyiapkan ekstensi browser WebAuthn pengalihan
Ikuti prosedur ini untuk mengatur WebAuthn pengalihan Standar.
##### Prompt Otomatis pada Peluncuran Browser Pertama
Setelah menginstal Amazon DCV Server 2023.1 dengan WebAuthn pengalihan diaktifkan, pengguna akan diminta untuk mengaktifkan ekstensi browser saat mereka pertama kali meluncurkan browser mereka. Jika mereka memilih untuk tidak menginstal ekstensi atau menghapusnya nanti, WebAuthn pengalihan tidak akan berfungsi. Administrator dapat menerapkan penginstalan menggunakan Kebijakan Grup.
##### Menginstal Menggunakan Kebijakan Grup
Untuk organisasi yang ingin menerapkan ekstensi dalam skala yang lebih luas, Anda dapat menggunakan Kebijakan Grup.
**Menggunakan Microsoft Edge:**
1. Unduh dan instal [templat administratif Microsoft Edge.](https://learn.microsoft.com/en-us/deployedge/configure-microsoft-edge#1-download-and-install-the-microsoft-edge-administrative-template)
1. Luncurkan alat Manajemen Kebijakan Grup (gpmc.msc).
1. Arahkan melalui: Hutan> Domain> FQDN Anda (mis., example.com) > Objek Kebijakan Grup.
1. Pilih kebijakan yang diinginkan atau buat yang baru lalu klik kanan padanya dan pilih “Edit”.
1. Ikuti jalur ini: Konfigurasi Komputer> Template Administratif> Microsoft Edge > Ekstensi.
1. Akses “Konfigurasi pengaturan manajemen ekstensi”, atur ke “Diaktifkan”.
1. Di bidang untuk Konfigurasi pengaturan manajemen ekstensi, masukkan yang berikut ini:
```
{"ihejeaahjpbegmaaegiikmlphghlfmeh":{"installation_mode":"force_installed","update_url":"https://edge.microsoft.com/extensionwebstorebase/v1/crx"}}
```
1. Simpan perubahan dan reboot server.
**Menggunakan Google Chrome:**
1. Dapatkan dan terapkan [templat administratif Google Chrome](https://chromeenterprise.google/browser/download/#manage-policies-tab)
1. Mirip dengan langkah-langkah untuk Microsoft Edge, navigasikan melalui alat Manajemen Kebijakan Grup.
1. Lanjutkan ke: Konfigurasi Komputer> Template Administratif> Google Chrome > Ekstensi.
1. Akses “Konfigurasi pengaturan manajemen ekstensi”, atur ke “Diaktifkan”.
1. Di bidang untuk Konfigurasi pengaturan manajemen ekstensi, masukkan yang berikut ini:
```
{"mmiioagbgnbojdbcjoddlefhmcocfpmn":{ "installation_mode":"force_installed","update_url":"https://clients2.google.com/service/update2/crx"}}
```
1. Simpan perubahan dan reboot server.
##### Instalasi Secara Manual
Ekstensi dapat bersumber dari toko browser masing-masing:
+ [Pengaya Microsoft Edge](https://microsoftedge.microsoft.com/addons/detail/dcv-webauthn-redirection-/ihejeaahjpbegmaaegiikmlphghlfmeh)
+ [Toko Web Chrome](https://chrome.google.com/webstore/detail/dcv-webauthn-redirection/mmiioagbgnbojdbcjoddlefhmcocfpmn)
Untuk instalasi manual:
1. Connect ke sesi Amazon DCV Anda.
1. Buka browser pilihan Anda, dan arahkan ke toko browser yang relevan (tautan di atas).
1. Lanjutkan dengan memilih “Dapatkan” (Microsoft Edge) atau “Tambahkan ke Chrome” (Google Chrome).
1. Ikuti petunjuk di layar. Konfirmasi akan muncul setelah ekstensi berhasil ditambahkan.
##### Menggunakan WebAuthn pengalihan dalam mode Penyamaran (khusus Chrome)
Saat menggunakan mode Penyamaran, Ekstensi WebAuthn Pengalihan Amazon DCV harus diizinkan secara khusus untuk berjalan di dalamnya, jika tidak WebAuthn Pengalihan tidak akan terjadi. Untuk melakukannya:
1. Buka pengaturan ekstensi.
1. Temukan **Izinkan dalam Penyamaran di detailnya**.
1. **Alihkan sakelar ke Aktif.**
## Pemecahan Masalah Webauthn Windows
Jika Anda mengalami masalah dengan WebAuthn atau Ditingkatkan WebAuthn:
+ Pastikan server dan klien DCV Anda mutakhir.
+ Untuk Standar WebAuthn, verifikasi bahwa ekstensi browser diinstal dan diaktifkan.
+ Untuk Enhanced WebAuthn, konfirmasikan bahwa itu diaktifkan di file izin.
+ Coba mulai ulang browser atau sesi DCV Anda.
+ Jika masalah terus berlanjut, hubungi AWS Support.
# Mengkonfigurasi WebAuthn pengalihan pada host Linux
Server DCV Linux saat ini mendukung Standar WebAuthn. Standar WebAuthn membutuhkan ekstensi browser untuk memfasilitasi pengalihan WebAuthn prompt ke klien. WebAuthn dapat diaktifkan atau dinonaktifkan menggunakan izin pengalihan webauthn-. Untuk informasi selengkapnya, lihat [Bekerja dengan file izin](https://docs.aws.amazon.com/dcv/latest/adminguide/security-authorization-file-create.html).
**Prasyarat**
+ Server DCV versi 2025.0 atau lebih tinggi
+ Klien asli DCV untuk Windows, Linux dan Mac
+ Akses root (sudo) pada instance server Linux
+ Akses internet untuk mengunduh ekstensi browser
## Mengkonfigurasi Pengalihan WebAuthn
WebAuthn diaktifkan pada DCV secara default. Anda dapat mengaktifkan atau menonaktifkan WebAuthn dengan mengaktifkan pengaturan “[webauthn]” di file konfigurasi DCV:
```
/etc/dcv/dcv.conf
[webauthn]
enabled=true
```
**Mengkonfigurasi Webauthn untuk Linux**
1. Buat tautan simbolis ke file manifes host pesan asli untuk setiap browser yang didukung.
------
#### [ Google Chrome ]
Gunakan salah satu perintah berikut ini:
```
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 ]
Gunakan salah satu perintah berikut ini:
```
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 ]
Gunakan salah satu perintah berikut ini:
```
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/
```
------
1. Instal ekstensi browser untuk WebAuthn pengalihan. Ini dapat dilakukan secara manual atau melalui kebijakan perusahaan.
------
#### [ Google Chrome ]
Gunakan salah satu perintah berikut ini:
```
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 ]
Gunakan salah satu perintah berikut ini:
```
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 ]
Gunakan salah satu perintah berikut ini:
```
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
```
------
1. Mulai ulang browser.
WebAuthn didukung pada host Windows dan Linux, dan pada klien Windows, Mac dan Linux.
+ Google Chrome 116 atau yang lebih baru
+ Microsoft Edge 116 atau yang lebih baru
WebAuthn pengalihan dapat diaktifkan atau dinonaktifkan menggunakan `webauthn-redirection` izin. Untuk informasi selengkapnya, lihat [Bekerja dengan file izin](security-authorization-file-create.md).
WebAuthn pengalihan memerlukan ekstensi browser untuk diinstal pada server jarak jauh. Ketika fitur diaktifkan dan ekstensi browser diinstal, setiap WebAuthn permintaan yang diprakarsai oleh aplikasi web yang berjalan di browser dalam sesi diarahkan dengan mulus ke klien lokal. Pengguna kemudian dapat menggunakan perangkat seperti Windows Hello atau YubiKey untuk menyelesaikan otentikasi.
**catatan**
Meskipun fitur ini memungkinkan WebAuthn dalam browser selama sesi jarak jauh, fitur ini tidak mendukung otentikasi sesi DCV menggunakan WebAuthn autentikator.
# Mengaktifkan penyimpanan sesi
Penyimpanan sesi adalah folder di server Amazon DCV yang dapat diakses klien saat mereka terhubung ke sesi Amazon DCV tertentu. Saat Anda mengaktifkan penyimpanan sesi untuk sesi, klien dapat mengunduh file dari, dan mengunggah file ke, folder yang ditentukan. Fitur ini memungkinkan klien untuk berbagi file saat terhubung ke sesi.
**Topics**
+ [Mengaktifkan penyimpanan sesi di Windows](#manage-storage-windows)
+ [Mengaktifkan penyimpanan sesi di Linux](#manage-storage-linux)
+ [Mengaktifkan penyimpanan sesi di macOS](#manage-storage-macos)
## Mengaktifkan penyimpanan sesi di Windows Amazon DCV Server
Untuk mengaktifkan penyimpanan sesi, pertama buat folder yang akan digunakan untuk penyimpanan sesi. Kemudian, konfigurasikan `storage-root` parameter menggunakan Windows Registry Editor.
**Untuk mengaktifkan penyimpanan sesi pada Windows**
1. Buat folder yang akan digunakan untuk penyimpanan sesi (misalnya,`c:\session-storage`).
1. Konfigurasikan `storage-root` parameter.
1. Buka Windows Registry Editor.
1. **Arahkan ke **tombol HKEY\$1USERS\$1 S-1-5-18\$1 Software\$1\$1 com\$1nicesoftwareGSettings\$1 dcv\$1 session-management\$1** dan pilih parameter storage-root. automatic-console-session**
Jika tidak ada `storage-root` parameter dalam kunci registri, buat satu sebagai berikut:
1. Di panel navigasi, buka menu konteks (klik kanan) untuk **automatic-console-sessionsession-management/** key. Kemudian, pilih **New**, **String**.
1. Untuk **Nama**, masukkan `storage-root` dan tekan **Enter**.
1. Buka parameter **storage-root**. Untuk **data Nilai**, masukkan path lengkap ke folder yang dibuat di langkah 1.
Anda juga dapat menggunakan `%home%` di jalur untuk menentukan direktori home pengguna yang saat ini masuk. Misalnya, jalur berikut digunakan `c:\Users\username\storage\` sebagai direktori penyimpanan sesi.
```
%home%/storage/
```
**catatan**
Jika subdirektori yang ditentukan tidak ada, maka penyimpanan sesi dinonaktifkan.
1. Pilih **OK** dan tutup Windows Registry Editor.
1. [Hentikan](manage-stop.md) dan [mulai ulang](manage-start.md) server Amazon DCV.
1. Mulai sesi dan tentukan `--storage-root` opsi. Untuk informasi selengkapnya, lihat [Memulai sesi Amazon DCV](managing-sessions-start.md).
## Mengaktifkan penyimpanan sesi di Linux Amazon DCV Server
Untuk mengaktifkan penyimpanan sesi, buat folder yang akan digunakan untuk penyimpanan sesi dan kemudian konfigurasikan `storage-root` parameter dalam `dcv.conf` file.
**Untuk mengaktifkan penyimpanan sesi di Linux**
1. Buat folder yang akan digunakan untuk penyimpanan sesi (misalnya,`/opt/session-storage/`).
1. Konfigurasikan `storage-root` parameter.
1. Arahkan ke `/etc/dcv/` dan buka `dcv.conf` dengan editor teks pilihan Anda.
1. Temukan `storage-root` parameter di `[session-management/automatic-console-session]` bagian. Ganti jalur yang ada dengan path lengkap ke folder yang Anda buat di langkah 1.
Jika tidak ada `storage-root` parameter di `[session-management/automatic-console-session]` bagian ini, tambahkan secara manual menggunakan format berikut.
```
[session-management/automatic-console-session]
storage-root="/opt/session-storage/"
```
Anda juga dapat menggunakan `%home%` di jalur untuk menentukan direktori home pengguna yang saat ini masuk. Misalnya, parameter berikut menggunakan `$HOME/storage/` direktori untuk penyimpanan sesi.
```
[session-management/automatic-console-session]
storage-root="%home%/storage/"
```
**catatan**
Jika subdirektori yang ditentukan tidak ada, maka penyimpanan sesi dinonaktifkan.
1. Simpan dan tutup file .
1. [Hentikan](manage-stop.md) dan [mulai ulang](manage-start.md) server Amazon DCV.
1. Mulai sesi dan tentukan `--storage-root` opsi. Untuk informasi selengkapnya, lihat [Memulai sesi Amazon DCV](managing-sessions-start.md).
## Mengaktifkan penyimpanan sesi di macOS Amazon DCV Server
Untuk mengaktifkan penyimpanan sesi, buat folder yang akan digunakan untuk penyimpanan sesi dan kemudian konfigurasikan `storage-root` parameter dalam `dcv.conf` file.
**Untuk mengaktifkan penyimpanan sesi di macOS**
1. Buat folder yang akan digunakan untuk penyimpanan sesi (misalnya,`/opt/session-storage/`).
1. Konfigurasikan `storage-root` parameter.
1. Arahkan ke `/etc/dcv/` dan buka `dcv.conf` dengan editor teks pilihan Anda.
1. Temukan `storage-root` parameter di `[session-management/automatic-console-session]` bagian. Ganti jalur yang ada dengan path lengkap ke folder yang Anda buat di langkah 1.
Jika tidak ada `storage-root` parameter di `[session-management/automatic-console-session]` bagian ini, tambahkan secara manual menggunakan format berikut.
```
[session-management/automatic-console-session]
storage-root="/opt/session-storage/"
```
**catatan**
Jika subdirektori yang ditentukan tidak ada, maka penyimpanan sesi dinonaktifkan.
**catatan**
`storage-root`Nilai harus berupa jalur absolut di macOS.
1. Simpan dan tutup file .
1. [Hentikan](manage-stop.md) dan [mulai ulang](manage-start.md) server Amazon DCV.
1. Mulai sesi dan tentukan `--storage-root` opsi. Untuk informasi selengkapnya, lihat [Memulai sesi Amazon DCV](managing-sessions-start.md).
# Mengkonfigurasi printer pada Linux Amazon DCV Server
Amazon DCV memungkinkan Anda mencetak ke printer lokal yang dialihkan atau ke printer Amazon DCV virtual.
Jika Anda menggunakan distribusi Linux yang didukung, Anda harus mengonfigurasi server Amazon DCV untuk mendukung pencetakan.
Jika Anda menggunakan server Windows Amazon DCV, tidak diperlukan konfigurasi tambahan.
**Untuk mengaktifkan pengalihan printer di server DCV Amazon Linux Anda**
1. Instal `CUPS` layanan di server Anda.
+ Amazon Linux 2, RHEL, dan CentOS
```
$ sudo yum install cups
```
+ Ubuntu
```
$ sudo apt-get install cups
```
+ SUSE Linux Enterprise
```
$ sudo zypper install cups
```
1. Tambahkan `dcv` pengguna ke grup administrator printer. Nama grup administrator printer dapat bervariasi menurut sistem operasi. Misalnya, jika grup administrator printer Anda diberi nama`lpadmin`, jalankan perintah berikut:
```
$ usermod -a -G lpadmin dcv
```
1. Pastikan bahwa grup administrator printer direferensikan dalam `SystemGroup` parameter dalam file konfigurasi cup. Misalnya, jika grup administrator printer Anda diberi nama`lpadmin`, gunakan editor teks untuk membuka `/etc/cups/cups-files.conf` dan mencari baris berikut.
```
SystemGroup lpadmin
```
Jika baris muncul di file konfigurasi, instalasi selesai. Lanjutkan ke langkah berikutnya.
Jika baris tidak muncul dalam file konfigurasi, tambahkan secara manual dalam format berikut dan kemudian simpan dan tutup file.
```
SystemGroup printer_admin_groupname
```
1. (Hanya SUSE Linux Enterprise) Pastikan bahwa grup administrator printer memiliki izin untuk membaca sertifikat lokal cup. Sertifikat ini terletak di direktori berikut:`/var/run/cups/certs/`. Misalnya, jika grup administrator printer Anda diberi nama`lpadmin`, jalankan perintah berikut:
```
$ sudo chgrp -R lpadmin /var/run/cups/certs/ && chmod g+x /var/run/cups/certs
```
1. Mulai ulang layanan `cups`.
```
$ sudo systemctl restart cups
```
1. [Hentikan](manage-stop.md) dan [mulai ulang](manage-start.md) server Amazon DCV.
## Memecahkan masalah printer
SUSE Linux Enterprise dan RHEL 8 dapat mencegah koneksi ke soket printer. Jika Anda menjalankan salah satu sistem operasi ini dan memiliki masalah pencetakan, periksa file log untuk menentukan apakah ini penyebabnya.
Menggunakan editor teks, buka `/var/log/audit/audit.log` dan periksa apakah log Anda memiliki baris yang mirip dengan berikut ini:
```
type=AVC msg=audit(1617716179.487:504): avc: denied { connectto } for pid=33933 comm="dcvcupsbackend" path=002F636F6D2F6E696365736F6674776172652F6463762F637570732F636F6E736F6C65 scontext=system_u:system_r:cupsd_t:s0-s0:c0.c1023 tcontext=unconfined_u:unconfined_r:unconfined_t:s0-s0:c0.c1023 tclass=unix_stream_socket permissive=0
```
Jika baris serupa muncul di file log Anda, maka sistem operasi mencegah akses ke soket printer.
Untuk mengatasi masalah ini, Anda harus membuat kebijakan cup yang memungkinkan akses ke soket printer. Untuk melakukan ini, lakukan langkah-langkah berikut:
1. Buat file kebijakan yang diperlukan. Menggunakan editor teks pilihan Anda, buat file baru yang diberi nama `cupsd_policy` dan tambahkan konten berikut.
```
#============= cupsd_t ==============
allow cupsd_t unconfined_t:unix_stream_socket connectto;
```
1. Instal kebijakan.
```
$ ausearch -c 'dcvcupsbackend' --raw | audit2allow -M dcv-printer-policy
```
```
$ semodule -X 300 -i dcv-printer-policy.pp
```
# Mengkonfigurasi clipboard pada Linux Amazon DCV Server
Sistem operasi Linux memiliki dua buffer yang dapat Anda gunakan untuk menyalin dan menempelkan konten. Buffer adalah pilihan utama dan clipboard. Untuk menyalin konten ke dalam pilihan utama, sorot konten dengan menyeret pointer. Untuk menempelkannya dari pilihan utama, gunakan penunjuk atau pintasan keyboard **Shift\$1Insert**. Untuk menyalin konten ke clipboard, sorot konten dan pilih **Salin** dari menu konteks (klik kanan). Untuk menempelkannya dari clipboard, pilih **Tempel** dari menu konteks (klik kanan).
Di server Linux Amazon DCV, Anda dapat mengonfigurasi server untuk menggunakan pilihan utama atau clipboard saat melakukan tindakan salin dan tempel antara klien dan server.
**Topics**
+ [Menempelkan konten clipboard klien ke pilihan utama](#manage-clipboard-paste)
+ [Menyalin konten pilihan utama ke clipboard klien](#manage-clipboard-copy)
## Menempelkan konten clipboard klien ke pilihan utama
Secara default, konten yang disalin di klien ditempatkan di clipboard. Untuk menempelkan konten ini di server, Anda harus menempelkannya dari clipboard menggunakan menu konteks (klik kanan).
Anda dapat mengonfigurasi server untuk menempatkan konten clipboard ke dalam pilihan utama. Dengan demikian, pengguna dapat menempelkan konten yang disalin dari kedua clipboard menggunakan menu konteks (klik kanan). Atau, mereka dapat menempelkan konten yang disalin dari pilihan utama menggunakan tombol tengah mouse atau pintasan keyboard **Shift\$1Insert**.
**Untuk mengkonfigurasi server untuk menempatkan konten clipboard ke dalam pilihan utama**
1. Arahkan ke `/etc/dcv/` dan buka `dcv.conf` dengan editor teks pilihan Anda.
1. Temukan `primary-selection-paste` parameter di `[clipboard]` bagian dan atur nilainya`true`.
Jika tidak ada `primary-selection-paste` parameter di `[clipboard]` bagian ini, tambahkan secara manual menggunakan format berikut:
```
[clipboard]
primary-selection-paste=true
```
1. Simpan dan tutup file .
1. [Hentikan](managing-sessions-lifecycle-stop.md) dan [mulai ulang](managing-sessions-start.md) sesi Amazon DCV.
## Menyalin konten pilihan utama ke clipboard klien
Secara default, pengguna dapat menyalin konten hanya dari server ke klien menggunakan clipboard. Ini berarti bahwa konten yang disalin ke dalam pilihan utama tidak dapat ditempelkan pada klien.
Anda dapat mengonfigurasi server untuk menempatkan konten pilihan utama ke dalam clipboard. Ini berarti bahwa ketika pengguna menyalin konten ke pilihan utama di server, konten juga disalin ke clipboard. Ini juga berarti bahwa pengguna dapat menempelkan konten dari clipboard ke klien.
**Untuk mengkonfigurasi server untuk menempatkan konten pilihan utama ke clipboard**
1. Arahkan ke `/etc/dcv/` dan buka `dcv.conf` dengan editor teks pilihan Anda.
1. Temukan `primary-selection-copy` parameter di `[clipboard]` bagian dan atur nilainya`true`.
Jika tidak ada `primary-selection-copy` parameter di `[clipboard]` bagian ini, tambahkan secara manual menggunakan format berikut:
```
[clipboard]
primary-selection-copy=true
```
1. Simpan dan tutup file .
1. [Hentikan](managing-sessions-lifecycle-stop.md) dan [mulai ulang](managing-sessions-start.md) sesi Amazon DCV.
# Mengkonfigurasi audio multi-saluran
Amazon DCV mendukung hingga 7.1 saluran audio saat menggunakan klien asli Amazon DCV. Klien browser web hanya mendukung saluran audio stereo 2.0.
Amazon DCV mendukung konfigurasi audio multi-saluran berikut:
+ Stereo 2.0 (dua saluran)
+ Quadriphonic 4.0 (empat saluran)
+ Surround 5.1 (enam saluran)
+ Surround 7.1 (delapan saluran) —Server Windows Amazon DCV saja
![\[Konfigurasi audio yang didukung\]](http://docs.aws.amazon.com/id_id/dcv/latest/adminguide/images/audio.png)
Jika klien meminta jumlah saluran audio yang lebih rendah daripada jumlah saluran yang disediakan oleh server, server akan menurunkan jumlah saluran. Ini untuk mencocokkan jumlah saluran yang diminta oleh klien. Misalnya, asumsikan bahwa klien meminta surround sound 5.1 sementara server mendukung hingga surround sound 7.1. Server menurunkan audio ke 5.1.
Server tidak secara otomatis menurunkan audio agar sesuai dengan output audio dari aplikasi sumber. Misalnya, asumsikan bahwa aplikasi sumber menyediakan suara surround 7.1 sedangkan klien hanya mendukung stereo 2.0. Hanya saluran audio depan-kiri dan kanan-depan yang dialirkan ke klien. Saluran yang tersisa hilang. Jika ini benar, untuk mencegah hilangnya saluran audio, konfigurasikan server Amazon DCV untuk menurunkan saluran audio.
**Topics**
+ [Mengkonfigurasi saluran audio di server Windows Amazon DCV](#win-audio)
+ [Mengkonfigurasi saluran audio di server Linux Amazon DCV](#linux-audio)
## Mengkonfigurasi saluran audio di server Windows Amazon DCV
Server Windows mendukung surround sound 7.1 (delapan saluran audio). Konfigurasi default adalah stereo. Namun, Anda dapat mengonfigurasi server untuk menggunakan konfigurasi yang berbeda.
**Mengkonfigurasi saluran audio di server Windows:**
1. Buka Panel Kontrol Suara. **Dari bilah tugas desktop, klik kanan pada ikon Speaker, dan pilih Suara.**
1. Buka tab Playback dan pilih speaker Amazon DCV.
1. Pilih **Konfigurasikan**
1. Pilih konfigurasi saluran pilihan Anda.
1. Pilih **OK**.
## Mengkonfigurasi saluran audio di server Linux Amazon DCV
Server Linux mendukung stereo 2.0 (dua saluran audio) secara default dan memerlukan beberapa konfigurasi tambahan untuk mendukung audio multi-saluran.
Anda perlu melakukan hal berikut:
1. Konfigurasikan server PulseAudio suara.
1. Konfigurasikan server Amazon DCV untuk menggunakan PulseAudio perangkat.
1. Konfigurasikan jumlah saluran yang akan digunakan.
**Untuk mengkonfigurasi server PulseAudio suara**
1. Buka `/etc/pulse/default.pa` dengan editor teks pilihan Anda.
1. Tambahkan baris berikut ke akhir file.
```
load-module module-null-sink sink_name=dcv format=s16be channels=6 channel_map=front-left,front-right,rear-left,rear-right,front-center,lfe rate=48000 sink_properties="device.description='DCV Audio Speakers'"
```
1. Simpan dan tutup file .
Setelah Anda mengkonfigurasi server PulseAudio suara, Anda harus mengkonfigurasi server Amazon DCV untuk menangkap audio dari server PulseAudio suara.
**Untuk mengkonfigurasi server Amazon DCV untuk menggunakan perangkat PulseAudio**
1. Buka `/etc/dcv/dcv.conf` dengan editor teks pilihan Anda.
1. Temukan `grab-device` parameter di `[audio]` bagian. Kemudian, ganti nilai yang ada dengan nama perangkat yang Anda ambil di langkah sebelumnya.
Jika tidak ada `grab-device` parameter di `[audio]` bagian ini, tambahkan secara manual menggunakan format berikut:
```
[audio]
grab-device="DCV Audio Speakers"
```
1. Simpan dan tutup file .
Setelah Anda mengkonfigurasi server Amazon DCV untuk menangkap audio dari server PulseAudio suara, Anda dapat menentukan jumlah saluran yang akan digunakan.
**Untuk mengkonfigurasi jumlah saluran yang akan digunakan**
1. Buka `/etc/dcv/dcv.conf` dengan editor teks pilihan Anda.
1. Temukan `source-channels` parameter di `[audio]` bagian. Kemudian, ganti jumlah saluran yang ada dengan salah satu dari yang berikut: `2` untuk 2.0, `4` untuk 4.0, atau `6` untuk 5.1.
Jika tidak ada `source-channels` parameter di `[audio]` bagian ini, tambahkan secara manual menggunakan format berikut:
```
[audio]
source-channels=channels
```
1. Simpan dan tutup file .
1. [Hentikan](manage-stop.md) dan [mulai ulang](manage-start.md) server Amazon DCV.
# Mengkonfigurasi header HTTP
Anda dapat mengonfigurasi server Amazon DCV untuk mengirim header respons HTTP tambahan ke klien Amazon DCV saat pengguna terhubung ke sesi menggunakan klien browser web. Header respons dapat memberikan informasi tambahan tentang server Amazon DCV yang terhubung dengan pengguna.
**Topics**
+ [Mengkonfigurasi header HTTP pada Windows Amazon DCV Server](#manage-headers-windows)
+ [Mengkonfigurasi header HTTP pada Linux Amazon DCV Server](#manage-headers-linux)
## Mengkonfigurasi header HTTP pada Windows Amazon DCV Server
Untuk mengkonfigurasi header HTTP pada Windows, konfigurasikan `web-extra-http-headers` parameter menggunakan Windows Registry Editor.
**Untuk mengkonfigurasi header HTTP pada Windows**
1. Buka Windows Registry Editor.
1. Arahkan ke **kunci HKEY\$1USERS\$1 S-1-5-18\$1 Software\$1\$1 com\$1nicesoftwareGSettings\$1** dcv\$1 connectivity\$1 key.
1. Di panel navigasi, buka menu konteks (klik kanan) untuk tombol **konektivitas**. Kemudian, pilih **New**, **String**.
1. Untuk **Nama**, masukkan `web-extra-http-headers` dan tekan **Enter**.
1. Buka **web-extra-http-headers**parameternya. Untuk **data Nilai**, masukkan nama dan nilai header HTTP dalam format berikut.
```
[("header-name", "header-value")]
```
Untuk menentukan beberapa header, tambahkan mereka dalam daftar yang dipisahkan koma.
```
[("header1-name", "header1-value"), ("header2-name", "header2-value")]
```
1. Pilih **OK** dan tutup Windows Registry Editor.
1. [Hentikan](manage-stop.md) dan [mulai ulang](manage-start.md) server Amazon DCV.
## Mengkonfigurasi header HTTP pada Linux Amazon DCV Server
Untuk mengkonfigurasi header HTTP di Linux, konfigurasikan `web-extra-http-headers` parameter dalam `dcv.conf` file.
**Untuk mengkonfigurasi header HTTP di Linux**
1. Buka `/etc/dcv/dcv.conf` dengan editor teks pilihan Anda.
1. Temukan `[connectivity]` bagian tersebut. Tentukan nama dan nilai header HTTP dalam format berikut.
```
[connectivity]
web-extra-http-headers=[("header-name", "header-value")]
```
Untuk menentukan beberapa header, tambahkan mereka dalam daftar yang dipisahkan koma.
```
[connectivity]
web-extra-http-headers=[("header1-name", "header1-value"), ("header2-name", "header2-value")]
```
1. Simpan dan tutup file .
1. [Hentikan](manage-stop.md) dan [mulai ulang](manage-start.md) server Amazon DCV.
# Mengkonfigurasi otentikasi Amazon DCV
Secara default, klien diharuskan untuk melakukan autentikasi terhadap server tempat Amazon DCV di-host sebelum menghubungkan ke sesi Amazon DCV. Jika klien gagal mengautentikasi, ini mungkin karena dicegah terhubung ke sesi. Persyaratan otentikasi klien dapat dinonaktifkan untuk memungkinkan klien terhubung ke sesi tanpa mengautentikasi terhadap server.
Amazon DCV mendukung metode otentikasi berikut:
+ `system`— Ini adalah metode otentikasi default. Otentikasi klien didelegasikan ke sistem operasi yang mendasarinya. Untuk server Windows Amazon DCV, otentikasi didelegasikan ke. WinLogon Untuk server Linux dan macOS Amazon DCV, otentikasi didelegasikan ke PAM. Klien memberikan kredensi sistem mereka saat menghubungkan ke sesi Amazon DCV. Verifikasi bahwa klien Anda memiliki kredenal masuk yang sesuai untuk server Amazon DCV.
+ `none`— Tidak diperlukan otentikasi klien saat menghubungkan ke sesi Amazon DCV. Server Amazon DCV memberikan akses ke semua klien yang mencoba terhubung ke sesi.
Pastikan klien Anda mengetahui metode otentikasi yang digunakan oleh server Amazon DCV. Mereka juga harus memastikan bahwa mereka memiliki informasi yang diperlukan untuk terhubung ke sesi.
**Topics**
+ [Mengkonfigurasi otentikasi pada Windows](#set-authentication-windows)
+ [Mengkonfigurasi otentikasi di Linux](#set-authentication-linux)
+ [Mengkonfigurasi otentikasi di macOS](#set-authentication-macos)
+ [Mengkonfigurasi otentikasi dengan otentikator eksternal](#set-authentication-external)
+ [Gunakan Otentikasi Eksternal](external-authentication.md)
## Mengkonfigurasi otentikasi pada Windows
Untuk mengubah metode otentikasi server Amazon DCV, Anda harus mengonfigurasi `authentication` parameter menggunakan Windows Registry Editor.
**Untuk mengubah metode otentikasi pada Windows**
1. Buka Windows Registry Editor.
1. **Arahkan ke **kunci HKEY\$1USERS\$1 S-1-5-18\$1 Software\$1\$1 com\$1nicesoftwareGSettings\$1 dcv\$1 security\$1** dan pilih parameter otentikasi.**
Jika tidak ada `authentication` parameter dalam kunci registri, buat satu:
1. Di panel navigasi, buka menu konteks (klik kanan) untuk tombol **otentikasi**. Kemudian, pilih **New**, **nilai string**.
1. Untuk **Nama**, masukkan `authentication` dan tekan **Enter**.
1. Buka parameter **otentikasi**. Untuk **data Nilai**, masukkan salah satu `system` atau`none`.
1. Pilih **OK** dan tutup Windows Registry Editor.
### Penyedia Kredensyal Windows
Dengan Windows Credentials Provider, pengguna dapat melewati login Windows jika mereka dapat mengautentikasi terhadap server DCV.
Windows Credentials Provider hanya didukung jika `authentication` parameter DCV diatur ke. `system` Jika `authentication` parameter DCV diatur ke`none`, pengguna harus masuk secara manual ke Windows setelah mereka secara otomatis diautentikasi terhadap server DCV.
Secara default, Windows Credentials Provider diaktifkan saat Anda menginstal server Amazon DCV.
**Untuk menonaktifkan Windows Credentials Provider**
1. Buka Windows Registry Editor.
1. Arahkan ke **kunci HKEY\$1LOCAL\$1MACHINE\$1 SOFTWARE\$1 Microsoft\$1 Windows\$1\$1 Authentication\$1 Credential Providers\$1 \$1CurrentVersion8A2C93D0-D55F-4045-99D7-B27F5E263407**\$1.
1. Pilih **Edit**, **Baru**, **Nilai DWORD**.
1. Untuk namanya, masukkan**Disabled**.
1. Buka nilainya. Untuk **data Nilai**, masukkan `1` dan pilih **OK**.
1. Tutup Windows Registry Editor.
**Untuk mengaktifkan kembali Windows Credentials Provider**
1. Buka Windows Registry Editor.
1. Arahkan ke **kunci HKEY\$1LOCAL\$1MACHINE\$1 SOFTWARE\$1 Microsoft\$1 Windows\$1\$1 Authentication\$1 Credential Providers\$1 \$1CurrentVersion8A2C93D0-D55F-4045-99D7-B27F5E263407**\$1.
1. Buka nilai **Dinonaktifkan**. Untuk **data Nilai**, masukkan `0` dan pilih **OK**.
1. Tutup Windows Registry Editor.
## Mengkonfigurasi otentikasi di Linux
Untuk mengubah metode otentikasi server Amazon DCV, Anda harus mengonfigurasi `authentication` parameter dalam file. `dcv.conf`
**Untuk mengubah metode otentikasi di Linux**
1. Arahkan ke `/etc/dcv/` dan buka `dcv.conf` dengan editor teks pilihan Anda.
1. Temukan `authentication` parameter di `[security]` bagian. Kemudian, ganti nilai yang ada dengan salah satu `system` atau`none`.
Jika tidak ada `authentication` parameter di `[security]` bagian ini, tambahkan menggunakan format berikut.
```
[security]
authentication=method
```
1. Simpan dan tutup file .
### Layanan PAM
Di Linux, ketika `authentication` parameter Amazon DCV disetel ke`system`, otentikasi dilakukan dengan menjalankan layanan PAM.
Secara default, layanan Privileged Access Management (PAM) yang dijalankan oleh server Amazon DCV adalah. `/etc/pam.d/dcv`
Jika Anda ingin mengubah langkah-langkah yang dilakukan oleh PAM saat mengautentikasi pengguna melalui Amazon DCV, Anda dapat mengatur `pam-service` parameter di `authentication` bagian. `dcv.conf`
**Untuk mengubah layanan PAM**
1. Sebagai root, navigasikan ke `/etc/pam.d` direktori dan buat file baru, misalnya`dcv-custom`.
1. Edit `dcv-custom` file menggunakan editor teks pilihan Anda. Lihat dokumentasi sistem Anda untuk sintaks file layanan PAM.
1. Arahkan ke `/etc/dcv/` dan buka `dcv.conf` dengan editor teks pilihan Anda.
1. Temukan `pam-service` parameter di `[authentication]` bagian. Kemudian, ganti nama layanan yang ada dengan nama layanan PAM yang baru.
Jika tidak ada `pam-service` parameter di `[authentication]` bagian ini, tambahkan secara manual menggunakan format berikut:
```
[authentication]
pam-service=service_name
```
**catatan**
Nama layanan PAM harus sesuai dengan nama file yang Anda buat`/etc/pam.d`.
1. Simpan dan tutup file .
## Mengkonfigurasi otentikasi di macOS
Untuk mengubah metode otentikasi server Amazon DCV, Anda harus mengonfigurasi `authentication` parameter dalam file. `dcv.conf`
**Untuk mengubah metode otentikasi di macOS**
1. Arahkan ke `/etc/dcv/` dan buka `dcv.conf` dengan editor teks pilihan Anda.
1. Temukan `authentication` parameter di `[security]` bagian. Kemudian, ganti nilai yang ada dengan salah satu `system` atau`none`.
Jika tidak ada `authentication` parameter di `[security]` bagian ini, tambahkan menggunakan format berikut.
```
[security]
authentication=method
```
1. Simpan dan tutup file .
### Layanan PAM
Di macOS, ketika `authentication` parameter Amazon DCV disetel ke`system`, otentikasi dilakukan dengan menjalankan layanan PAM.
Secara default, layanan Privileged Access Management (PAM) yang dijalankan oleh server Amazon DCV adalah. `/etc/pam.d/dcv`
Jika Anda ingin mengubah langkah-langkah yang dilakukan oleh PAM saat mengautentikasi pengguna melalui Amazon DCV, Anda dapat mengatur `pam-service` parameter di `authentication` bagian. `dcv.conf`
**Untuk mengubah layanan PAM**
1. Sebagai root, navigasikan ke `/etc/pam.d` direktori dan buat file baru, misalnya`dcv-custom`.
1. Edit `dcv-custom` file menggunakan editor teks pilihan Anda. Lihat dokumentasi sistem Anda untuk sintaks file layanan PAM.
1. Arahkan ke `/etc/dcv/` dan buka `dcv.conf` dengan editor teks pilihan Anda.
1. Temukan `pam-service` parameter di `[authentication]` bagian. Kemudian, ganti nama layanan yang ada dengan nama layanan PAM yang baru.
Jika tidak ada `pam-service` parameter di `[authentication]` bagian ini, tambahkan secara manual menggunakan format berikut:
```
[authentication]
pam-service=service_name
```
**catatan**
Nama layanan PAM harus sesuai dengan nama file yang Anda buat`/etc/pam.d`.
1. Simpan dan tutup file .
## Mengkonfigurasi otentikasi dengan otentikator eksternal
DCV dapat dikonfigurasi untuk menggunakan autentikator eksternal. Untuk informasi lebih lanjut tentang proses ini dan persyaratannya, lihat[Gunakan Otentikasi Eksternal](external-authentication.md).
# Gunakan Otentikasi Eksternal
Secara default, otentikasi klien Amazon DCV didelegasikan ke sistem operasi yang mendasarinya. Dengan server Windows Amazon DCV, otentikasi didelegasikan ke. WinLogon Dengan server Linux dan macOS Amazon DCV, otentikasi didelegasikan ke Linux PAM.
Anda dapat mengonfigurasi Amazon DCV untuk menggunakan server otentikasi eksternal untuk mengautentikasi klien. Ini memungkinkan Anda untuk menggunakan sistem otentikasi yang ada. Dengan otentikasi eksternal, Amazon DCV memanfaatkan mekanisme login yang ada dan mendelegasikan otentikasi ke server otentikasi eksternal.
Otentikasi eksternal memvalidasi pengguna dengan akses server DCV untuk mengaktifkan penggunaan pembuatan sesi. Ini tidak akan mengautentikasi pengguna Anda terhadap OS yang mendasarinya seperti otentikasi **sistem**, kecuali jika Anda mengatur autentikator eksternal Anda sendiri untuk melakukannya.
[DCV Session Manager](https://docs.aws.amazon.com/dcv/latest/sm-admin/what-is-sm.html) dilengkapi dengan autentikator eksternal bawaan. Untuk menggunakan fitur ini, server DCV Anda perlu mengatur [auth-token-verifier](https://docs.aws.amazon.com/dcv/latest/sm-admin/configure-dcv-server.html)parameter dengan alamat Session Manager.
Untuk menggunakan server otentikasi eksternal, Anda harus memiliki yang berikut:
+ **Mekanisme login** —Ini adalah mekanisme front-end yang digunakan pengguna Anda untuk masuk. Itu harus dapat memverifikasi pengguna Anda dengan menggunakan sistem verifikasi kredensional yang ada dan harus dapat menghasilkan token dan memberikannya ke server Amazon DCV. Untuk informasi selengkapnya, lihat [Menggunakan Token](#using-token).
+ Server **otentikasi —Ini adalah server** yang mengautentikasi token yang dihasilkan oleh mekanisme login. Server ini harus dapat menerima permintaan HTTP (S) POST dari server Amazon DCV yang menyertakan token, melakukan otentikasi yang diperlukan, dan kemudian mengirim respons kembali ke server Amazon DCV. Untuk informasi selengkapnya tentang penerapan server otentikasi, lihat[Persyaratan layanan otentikasi](#configure-authenticator).
+ **Konfigurasi Amazon DCV Server** —Server Amazon DCV harus dikonfigurasi untuk menggunakan server otentikasi eksternal. Untuk informasi selengkapnya, lihat [Konfigurasi Server Amazon DCV](#configure-server).
**Topics**
+ [Konfigurasi Server Amazon DCV](#configure-server)
+ [Menggunakan Token](#using-token)
+ [Persyaratan layanan otentikasi](#configure-authenticator)
## Konfigurasi Server Amazon DCV
Anda harus mengonfigurasi server Amazon DCV untuk menggunakan layanan otentikasi eksternal.
------
#### [ Windows Amazon DCV server ]
**Untuk menentukan server otentikasi eksternal pada Windows**
1. Buka Windows Registry Editor.
1. Arahkan ke **kunci HKEY\$1USERS\$1 S-1-5-18\$1 Software\$1\$1 com\$1nicesoftwareGSettings\$1** dcv\$1.
1. Temukan **auth-token-verifier**parameter di [Parameter keamanan](config-param-ref.md#security).
1. Lakukan salah satu tindakan berikut:
+ Untuk **data Nilai**, masukkan URL server otentikasi eksternal dan port untuk berkomunikasi, dalam format berikut:`url:port`.
**Example**
Misalnya, jika Anda menggunakan DcvSimpleExternalAuthenticator, tentukan yang berikut ini:`http://127.0.0.1:8444`.
+ Jika tidak ada **auth-token-verifier**parameter di bagian keamanan, tambahkan di PowerShell. Lihat [Memodifikasi Parameter Konfigurasi](https://docs.aws.amazon.com/dcv/latest/adminguide/config-param-ref-modify.html).
1. Tutup Windows Registry Editor.
1. [Hentikan](manage-stop.md) dan [mulai ulang](manage-start.md) server Amazon DCV.
------
#### [ Linux Amazon DCV server ]
**Untuk menentukan server otentikasi eksternal di Linux**
1. Arahkan ke `/etc/dcv/` dan buka `dcv.conf` dengan editor teks pilihan Anda.
1. Temukan `auth-token-verifier` parameter di `[security]` bagian, dan ganti nilai yang ada dengan URL server otentikasi eksternal dan port untuk berkomunikasi, dalam format berikut:`url:port`. Misalnya, jika Anda menggunakan DcvSimpleExternalAuthenticator, tentukan yang berikut ini:`http://127.0.0.1:8444`.
Jika tidak ada `auth-token-verifier` parameter di `[security]` bagian ini, tambahkan secara manual menggunakan format berikut:
```
[security] auth-token-verifier=url:port
```
1. Simpan dan tutup file .
------
#### [ macOS Amazon DCV server ]
**Untuk menentukan server otentikasi eksternal di macOS**
1. Arahkan ke `/etc/dcv/` dan buka `dcv.conf` dengan editor teks pilihan Anda.
1. Temukan `auth-token-verifier` parameter di `[security]` bagian, dan ganti nilai yang ada dengan URL server otentikasi eksternal dan port untuk berkomunikasi, dalam format berikut:`url:port`. Misalnya, jika Anda menggunakan DcvSimpleExternalAuthenticator, tentukan yang berikut ini:`http://127.0.0.1:8444`.
Jika tidak ada `auth-token-verifier` parameter di `[security]` bagian ini, tambahkan secara manual menggunakan format berikut:
```
[security] auth-token-verifier=url:port
```
1. Simpan dan tutup file .
------
## Menggunakan Token
Setelah Anda membuat token, Anda harus dapat mengirimkannya ke server Amazon DCV. Dengan klien browser web, tambahkan token ke URL koneksi sebagai berikut:
```
https://server_hostname_or_IP:port/?authToken=token#session_id
```
Contoh:
```
https://my-dcv-server.com:8443/?authToken=1234567890abcdef#my-session
```
## Persyaratan layanan otentikasi
Layanan otentikasi kustom Anda dapat berjalan di host yang sama dari server Amazon DCV atau dapat berjalan pada host terpisah. Layanan otentikasi harus mendengarkan permintaan HTTP (S) POST dari server Amazon DCV.
Berikut ini menunjukkan format permintaan POST yang digunakan oleh server Amazon DCV.
```
POST / HTTP/1.1
Content-Type: application/x-www-form-urlencoded
sessionId=session_id&authenticationToken=token&clientAddress=client_address
```
Layanan otentikasi Anda bertanggung jawab untuk menentukan apakah token yang diberikan valid.
Setelah token divalidasi, server otentikasi harus mengembalikan respons ke server Amazon DCV. Badan respons harus menyertakan salah satu dari berikut ini, tergantung pada hasil dari proses otentikasi:
+ Jika otentikasi berhasil, layanan otentikasi mengembalikan hasil `yes` dan pengenal pengguna. Contoh:
```
username
```
+ Jika otentikasi tidak berhasil, layanan otentikasi mengembalikan hasil dari. `no` Contoh:
```
message
```
### DcvSimpleExternalAuthenticator
Amazon DCV dikirimkan dengan server otentikasi eksternal referensi yang disebut,. `DcvSimpleExternalAuthenticator` DcvSimpleExternalAuthenticator adalah skrip Python tunggal yang dapat Anda gunakan titik awal untuk membuat server otentikasi kustom Anda sendiri.
DcvSimpleExternalAuthenticator server mendukung HTTP dan HTTPS, dan harus berjalan di server yang sama di mana server Amazon DCV diinstal. Secara default, DcvSimpleExternalAuthenticator mendengarkan permintaan pada port`8444`. Anda dapat mengubah port, jika diperlukan. Untuk melakukan ini, buka `/etc/dcv/simpleextauth.conf` dengan editor teks pilihan Anda, cari `EXTAUTH_PORT` parameter, dan ganti nilai yang ada dengan nomor port yang diperlukan.
Untuk menggunakannya DcvSimpleExternalAuthenticator, Anda harus menginstal `nice-dcv-simple-external-authenticator` paket. Untuk informasi selengkapnya, lihat [Instal Server Amazon DCV](setting-up-installing-linux-server.md#linux-server-install).
### Menggunakan Authenticator Eksternal Sederhana
1. Arahkan ke direktori otentikasi Anda.
`sudo mkdir -p /var/run/dcvsimpleextauth`
1. Hasilkan token otentikasi Anda.
**Example**
Dalam contoh ini, `123456` adalah token otentikator sampel, `session-123` adalah ID sesi sampel, dan `username` pengguna.
`echo "123456" | sudo dcvsimpleextauth add-user --session session-123 --auth-dir /var/run/dcvsimpleextauth/ --user username --append`
1. Mulai server Anda.
`sudo dcvsimpleextauth --port 8444 --auth-dir /var/run/dcvsimpleextauth/ start-server`
1. Setelah server berjalan, uji konfigurasi untuk validasi.
**Example**
Sekali lagi, menggunakan contoh ini, pengujian akan berjalan seperti ini:
`curl -k http://localhost:8444 -d sessionId=session-123 -d authenticationToken=123456`
Jika berhasil, Anda akan menerima hasil otentikasi. `yes`
# Mengkonfigurasi otorisasi Amazon DCV
Otorisasi digunakan untuk memberikan atau menolak izin klien Amazon DCV ke fitur Amazon DCV tertentu. Di Amazon DCV, otorisasi dikonfigurasi menggunakan file *izin*. File izin menentukan fitur Amazon DCV tertentu yang tersedia untuk pengguna tertentu saat mereka terhubung ke sesi.
Amazon DCV mendukung dua jenis file izin:
**Topics**
+ [File izin default](#security-authorization-default)
+ [File izin kustom](#security-authorization-custom)
+ [Memahami file izin](security-authorization-file-create.md)
## File izin default
Jika Anda tidak menentukan file izin khusus saat membuat sesi, file izin default digunakan untuk semua sesi. File izin default hanya memberikan pemilik sesi akses penuh ke semua fitur.
Anda dapat menyesuaikan file izin default untuk menyertakan otorisasi kustom. File izin default terletak di server Windows Amazon DCV dan `C:\Program Files\NICE\DCV\Server\conf\default.perm` di server Linux dan `/etc/dcv/default.perm` macOS Amazon DCV.
Untuk informasi tentang menyesuaikan file izin default, lihat. [Memahami file izin](security-authorization-file-create.md)
## File izin kustom
Anda dapat menggunakan file izin khusus untuk menentukan fitur yang dapat diakses oleh pengguna atau grup tertentu saat mereka terhubung ke sesi Amazon DCV. Saat Anda menggunakan file izin khusus, Anda mengganti file izin default.
Untuk menggunakan file izin khusus, Anda harus terlebih dahulu membuat file izin. Selanjutnya, tentukan saat Anda memulai sesi menggunakan `--permissions-file` opsi dengan `dcv create-session` perintah. Untuk informasi selengkapnya tentang memulai sesi, lihat[Memulai sesi Amazon DCV](managing-sessions-start.md).
Untuk informasi tentang membuat file izin khusus, lihat[Memahami file izin](security-authorization-file-create.md).
# Memahami file izin
Anda dapat membuat file izin khusus atau memperbarui file izin yang ada menggunakan editor teks pilihan Anda. File izin biasanya mengambil format berikut:
```
#import file_to_import
[groups]
group_definitions
[aliases]
alias_definitions
[permissions]
user_permissions
```
Bagian berikut menjelaskan cara mengisi bagian saat memperbarui atau membuat file izin.
**Topics**
+ [Mengimpor file izin](security-authorization-file-create-import.md)
+ [Membuat grup](security-authorization-file-create-group.md)
+ [Membuat alias](security-authorization-file-create-alias.md)
+ [Menambahkan izin](security-authorization-file-create-permission.md)
# Mengimpor file izin
`imports`Bagian ini biasanya bagian pertama dari file izin. Anda dapat menggunakan bagian ini untuk referensi dan menyertakan file izin yang ada. Anda juga dapat menggunakannya untuk memasukkan izin Amazon DCV yang ditentukan sebelumnya ke dalam file izin Anda.
File izin dapat mencakup beberapa impor. File izin yang diimpor mungkin mengimpor file izin lainnya.
**Untuk mengimpor file izin ke file izin Anda**
+ Gunakan `#import` pernyataan dan tentukan lokasi file dengan jalur absolut atau relatif
+ Server DCV Amazon Windows:
```
#import ..\file_path\file
```
+ Server DCV Amazon Linux:
```
#import ../file_path/file
```
**Contoh**
Pernyataan berikut mengimpor file izin bernama `dcv-permissions.file` menggunakan path absolut. Itu terletak di folder instalasi Amazon DCV di server Windows Amazon DCV.
```
#import c:\Program Files\NICE\DCV\dcv-permissions.file
```
# Membuat grup
Anda dapat menggunakan `[groups]` bagian dari file izin untuk menentukan grup pengguna bagi pengguna yang memiliki kasus penggunaan atau persyaratan izin serupa. Grup dapat diberi izin khusus. Izin yang ditetapkan ke grup berlaku untuk semua pengguna yang disertakan dalam grup.
Untuk membuat grup dalam file izin Anda, Anda harus terlebih dahulu menambahkan judul bagian grup ke file.
```
[groups]
```
Anda kemudian dapat membuat grup Anda di bawah judul bagian. Untuk membuat grup, berikan nama grup, lalu tentukan anggota grup dalam daftar yang dipisahkan koma. Anggota grup dapat berupa pengguna individu, grup lain, dan grup pengguna sistem operasi.
```
group_name=member_1, member_2, member_3
```
**Untuk menambahkan pengguna ke grup**
Tentukan nama pengguna.
**catatan**
Anda dapat mengawali nama pengguna dengan`user:`. Nama pengguna domain Windows dapat menyertakan nama domain.
```
group_name=user_1, user:user_2, domain_name\user_3
```
**Untuk menambahkan grup yang ada ke grup**
Tentukan nama grup yang diawali dengan `group:`
```
group_name=group:group_1, group:group_2
```
**Untuk menambahkan grup pengguna sistem operasi ke grup (hanya server DCV Amazon Linux)**
Tentukan nama grup yang diawali dengan `osgroup:`
```
group_name=osgroup:os_group_1, osgroup:os_group2
```
**Contoh**
Contoh berikut menambahkan judul bagian grup dan membuat grup yang diberi nama`my-group`. Grup ini mencakup pengguna individu. Mereka diberi nama `john` dan`jane`. Salah satunya adalah grup yang sudah ada bernama`observers`. Yang lainnya adalah grup pengguna sistem operasi yang bernama`guests`:
```
[groups]
my-group=john, user:jane, group:observers, osgroup:guests
```
# Membuat alias
Anda dapat menggunakan `[aliases]` bagian file izin untuk membuat set fitur Amazon DCV. Setelah alias didefinisikan, Anda dapat memberikan atau menolak izin grup atau pengguna individu untuk menggunakannya. Memberikan atau menolak izin untuk alias memberikan atau menolak izin untuk semua fitur yang disertakan di dalamnya.
Untuk membuat alias di file izin Anda, Anda harus terlebih dahulu menambahkan judul bagian alias ke file.
```
[aliases]
```
Anda kemudian dapat membuat alias Anda di bawah judul bagian. Untuk membuat alias, berikan nama alias, lalu tentukan anggota alias dalam daftar yang dipisahkan koma. Anggota alias dapat berupa fitur Amazon DCV individual atau alias lainnya.
```
alias_name=member_1, member_2, member_3
```
**Contoh**
Contoh berikut menambahkan judul bagian alias dan membuat alias yang diberi nama. `file-management` Ini termasuk `file-upload` dan `file-download` fitur dan alias yang ada yang diberi `clipboard-management` nama.
```
[aliases]
file-management=file-upload, file-download, clipboard-management
```
# Menambahkan izin
`[permissions]`Bagian dari file izin memungkinkan Anda mengontrol akses pengguna dan grup ke fitur atau alias tertentu.
Untuk menambahkan izin ke file izin Anda, pertama-tama tambahkan bagian izin yang mengarah ke file.
```
[permissions]
```
Anda kemudian dapat menambahkan izin Anda di bawah judul bagian. Untuk menambahkan izin, tentukan aktor yang mengaturnya, aturan yang akan diterapkan, dan fitur yang berlaku.
```
actor rule features
```
Aktor dapat berupa pengguna, grup, atau grup sistem operasi. Grup harus diawali dengan`group:`. Grup sistem operasi harus diawali dengan`osgroup:`. Amazon DCV menyertakan `%owner%` referensi bawaan yang dapat digunakan untuk merujuk ke pemilik sesi. Ini juga dapat digunakan untuk merujuk ke `%any%` referensi bawaan yang dapat digunakan untuk merujuk ke pengguna mana pun.
Aturan berikut dapat digunakan dalam pernyataan izin:
+ `allow`— Memberikan akses ke fitur.
+ `disallow`— Menolak akses ke fitur, tetapi dapat diganti dengan izin berikutnya.
+ `deny`— Menolak akses ke fitur dan tidak dapat diganti dengan izin berikutnya.
Fitur tersebut dapat mencakup fitur Amazon DCV individual, alias, atau kombinasi keduanya. Daftar fitur harus dipisahkan oleh spasi. Amazon DCV menyertakan `builtin` alias bawaan yang mencakup semua fitur Amazon DCV.
Fitur-fitur berikut dapat direferensikan dalam file izin:
+ `audio-in`— Masukkan audio dari klien ke server Amazon DCV.
+ `audio-out`— Putar kembali audio server Amazon DCV pada klien.
+ `builtin`— Semua fitur.
+ `clipboard-copy`— Salin data dari server Amazon DCV ke clipboard klien.
+ `clipboard-paste`— Tempel data dari clipboard klien ke server Amazon DCV.
+ `display`— Menerima data visual dari server Amazon DCV.
+ `extensions-client`— Memungkinkan untuk memulai ekstensi yang diinstal pada klien Amazon DCV.
+ `extensions-server`— Memungkinkan untuk memulai ekstensi yang diinstal di server Amazon DCV.
+ `file-download`— Unduh file dari penyimpanan sesi.
+ `file-upload`— Unggah file ke penyimpanan sesi.
+ `gamepad`— Gunakan gamepad yang terhubung ke komputer klien dalam satu sesi. Didukung pada versi Amazon DCV 2022.0 dan yang lebih baru.
+ `keyboard`— Masukan dari keyboard klien ke server Amazon DCV.
+ `keyboard-sas`— Gunakan urutan perhatian yang aman (**Ctrl\$1Alt\$1del**). Membutuhkan `keyboard` fitur. Didukung pada versi Amazon DCV 2017.3 dan yang lebih baru.
+ `mouse`— Masukan dari pointer klien ke server Amazon DCV.
+ `pointer`— Lihat peristiwa posisi mouse server Amazon DCV dan bentuk penunjuk. Didukung pada versi Amazon DCV 2017.3 dan yang lebih baru.
+ `printer`— Buat PDFs atau file XPS dari server Amazon DCV ke klien.
+ `screenshot`— Simpan tangkapan layar desktop jarak jauh. Ini didukung pada versi Amazon DCV 2021.2 dan yang lebih baru.
Saat menghapus `screenshot` otorisasi, kami menyarankan Anda menonaktifkan `clipboard-copy` izin. Ini mencegah pengguna menangkap tangkapan layar di clipboard server dan kemudian menempelkannya pada klien. Ketika `screenshot` otorisasi ditolak, Windows dan macOS juga akan mencegah alat eksternal menangkap tangkapan layar klien. Misalnya, menggunakan Windows Snipping Tool pada jendela klien Amazon DCV akan menghasilkan gambar hitam.
+ `smartcard`— Baca kartu pintar dari klien.
+ `stylus`— Masukan dari perangkat USB khusus, seperti perangkat penunjuk 3D atau tablet grafis.
+ `touch`— Gunakan acara sentuhan asli. Didukung pada versi DCV 2017.3 dan yang lebih baru.
+ `unsupervised-access`— Gunakan untuk mengatur akses pengguna tanpa pemilik dalam sesi kolaboratif.
+ `usb`— Gunakan perangkat USB dari klien.
+ `webcam`— Gunakan webcam yang terhubung ke komputer klien dalam satu sesi. Didukung pada versi Amazon DCV 2021.0 dan yang lebih baru.
+ `webauthn-redirection`— Arahkan permintaan Webauthn dari browser jarak jauh ke klien lokal. Didukung pada versi Amazon DCV 2023.1 dan yang lebih baru.
**Contoh**
Contoh berikut menambahkan judul bagian izin dan menambahkan empat izin. Izin pertama memberikan pengguna bernama `john` akses ke`display`,`file-upload`, dan `file-download` fitur. Izin kedua menolak akses `observers` grup ke `audio-in` dan `audio-out` fitur, dan alias `clipboard-management` fitur. Izin ketiga memberikan akses grup sistem `guests` operasi ke `clipboard-management` dan `file-management` alias. Izin keempat memberi pemilik sesi akses ke semua fitur.
```
[permissions]
john allow display file-upload file-download
group:observers deny audio-in audio-out clipboard-management
osgroup:guests allow clipboard-management file-management
%owner% allow builtin
```
# Aktifkan koneksi Remote X ke X Server untuk sesi virtual
Secara default, `Xdcv` mencegah penggunaan penerusan X, karena risiko keamanan yang melekat. Amazon DCV mewarisi perilaku ini dari versi server Xorg yang lebih baru. Server Amazon DCV mengimplementasikan mitigasi default berikut untuk meminimalkan risiko keamanan:
+ Server X mencegah koneksi X dari jaringan. Server X dikonfigurasi untuk memulai dengan opsi baris `-nolisten tcp` perintah. Namun, dimungkinkan untuk mengubah perilaku default untuk mengaktifkan koneksi X jarak jauh ke server X. Untuk informasi lebih lanjut tentang solusi ini, lihat. [Aktifkan koneksi Remote X ke X Server](#enable-remotex)
+ Server X menonaktifkan konteks tidak langsung GLX. Karena konflik dengan DCV-GL, saat ini tidak ada solusi untuk mengaktifkan konteks tidak langsung GLX.
Untuk informasi selengkapnya tentang risiko keamanan dan mitigasi, lihat Penasihat Keamanan [X.Org](https://www.x.org/wiki/Development/Security/Advisory-2014-12-09/).
## Aktifkan koneksi Remote X ke X Server
Secara default, `Xdcv` dikonfigurasi untuk memulai dengan opsi baris `-nolisten tcp` perintah untuk mengurangi eksposur terhadap risiko keamanan. Namun, dimungkinkan untuk mengubah perilaku default untuk mengaktifkan penerusan X.
**Untuk mengaktifkan penerusan X**
Buka `/etc/dcv/dcv.conf` menggunakan editor teks pilihan Anda. Tambahkan yang berikut ini ke akhir file:
+ Untuk mengaktifkan penerusan X melalui dan IPv4 IPv6
```
[session-management]
virtual-session-xdcv-args="-listen tcp"
```
+ Untuk mengaktifkan penerusan X hanya IPv4
```
[session-management]
virtual-session-xdcv-args="-listen tcp -nolisten inet6"
```
**catatan**
Mengaktifkan penerusan X tidak memengaruhi sesi yang ada, tetapi hanya sesi baru yang dimulai setelah diaktifkan.
**Untuk menguji penerusan X**
1. Hubungkan sesi Amazon DCV.
1. Konfirmasikan bahwa server X dari sesi Amazon DCV mendengarkan pada port dalam kisaran antara 6000-6063.
```
$ netstat -punta | grep 600
```
1. Tambahkan server jarak jauh ke daftar akses host server X.
```
$ xhost +remote_server
```
1. Ambil nomor tampilan sesi Amazon DCV.
```
$ dcv describe-session session_name | grep display
```
1. SSH ke server jarak jauh tempat aplikasi di-host.
```
$ ssh user@remote_server
```
1. Dari server jarak jauh, ekspor variabel lingkungan tampilan untuk menunjuk ke server X dari sesi Amazon DCV.
```
$ export DISPLAY=dcv_server_ip:display_number
```
1. Dari server jarak jauh, jalankan aplikasi untuk menguji fungsionalitas penerusan X. Contoh:
```
xterm
```
Aplikasi pengujian, dalam hal ini xterm, akan muncul di lingkungan desktop server Amazon DCV.
# Sematkan klien browser web Amazon DCV di dalam iFrame
Secara default, untuk melindungi dari serangan clickjacking, Amazon DCV tidak mengizinkan klien browser web disematkan di dalam iFrame. Namun, Anda dapat mengganti perilaku default ini untuk memungkinkan klien browser web berjalan di dalam iFrame.
Untuk informasi selengkapnya, tentang mencegah serangan clickjacking, lihat Lembar Cheat [Kebijakan Keamanan Konten](https://cheatsheetseries.owasp.org/cheatsheets/Content_Security_Policy_Cheat_Sheet.html#Preventing_Clickjacking).
Untuk mengizinkan browser web berjalan di dalam iFrame, Anda harus mengonfigurasi server Amazon DCV untuk mengirim header respons HTTP tambahan berikut ke klien browser web:
+ `web-x-frame-options`
+ `web-extra-http-headers`
Kami menyarankan Anda menambahkan kedua header untuk memastikan kompatibilitas terbaik di seluruh browser web.
**catatan**
Jika menghubungkan melalui Amazon DCV Connection Gateway, opsi x-frame perlu ditentukan dalam konfigurasi gateway. Hal ini dilakukan dengan menggunakan `local-resources-http-headers` parameter dalam [`[web-resources]`bagian](https://docs.aws.amazon.com/dcv/latest/gw-admin/config-reference.html#config-web-resources) konfigurasi gateway.
------
#### [ Windows server ]
1. Buka Windows Registry Editor dan arahkan ke **HKEY\$1USERS\$1 S-1-5-18\$1 Software\$1\$1 com\$1nicesoftwareGSettings\$1** dcv\$1 connectivity\$1 key.
1. Buka **web-x-frame-options**parameternya. Untuk **data Nilai**, masukkan`"ALLOW-FROM https://server_hostname"`.
**catatan**
Jika parameter tidak ada, buat parameter String baru dan beri nama`web-x-frame-options`.
1. Buka **web-extra-http-headers**parameternya. Untuk **data Nilai**, masukkan`[("Content-Security-Policy", "frame-ancestors https://server_hostname")]`.
**catatan**
Jika parameter tidak ada, buat parameter String baru dan beri nama`web-extra-http-headers`.
1. Tutup Windows Registry Editor.
1. [Hentikan](manage-stop.md) dan [mulai ulang](manage-start.md) server Amazon DCV.
------
#### [ Linux server ]
1. Buka `/etc/dcv/dcv.conf` dengan editor teks pilihan Anda.
1. Di `[connectivity]` bagian ini, lakukan hal berikut:
+ Untuk `web-x-frame-options`, masukkan `"ALLOW-FROM https://server_hostname"`.
+ Untuk `web-extra-http-headers`, masukkan `[("Content-Security-Policy", "frame-ancestors https://server_hostname")]`.
Contoh:
```
[connectivity]
web-x-frame-options="ALLOW-FROM https://my-dcv-server.com"
web-extra-http-headers=[("Content-Security-Policy", "frame-ancestors https://my-dcv-server.com")]
```
1. Simpan dan tutup file .
1. [Hentikan](manage-stop.md) dan [mulai ulang](manage-start.md) server Amazon DCV.
------
Secara default, sebagian besar browser mencegah akses ke beberapa fitur, seperti akses mikrofon dan akses layar penuh. Untuk memungkinkan akses ke fitur-fitur ini, modifikasi elemen iFrame pada halaman web. Misalnya, untuk memungkinkan akses ke mikrofon dan ke mode layar penuh, ubah elemen iFrame sebagai berikut:
```
```