Menyiapkan Zoom Rooms dengan Office 365
Ketika Anda menghubungkan sumber daya kalender di Microsoft Office 365 dengan Zoom Room, anggota organisasi Anda dapat dengan cepat dan mudah menjadwalkan rapat ruang dengan mengundang sumber daya kalender yang terhubung ke rapat mereka di Outlook. Integrasi kalender bergantung pada pemberian izin akses Zoom ke sumber daya kalender di O365, sehingga Zoom Rooms dapat membaca sumber daya kalender yang terkait. Setelah otorisasi, Zoom Rooms akan menampilkan rapat yang akan datang di layar TV ruangan, layar penjadwalan, dan pengontrol Zoom Rooms. Pengguna dapat memulai atau bergabung dengan rapat yang ditampilkan dengan satu sentuhan pada pengontrol ruangan.
Persyaratan untuk mengonfigurasi Zoom Rooms dengan Office 365
- Akun Administrator Office 365 dengan izin administrator Exchange Online untuk melakukan perubahan konfigurasi yang diperlukan.
- Akun harus memiliki izin administrator Exchange Online untuk kedua pengaturan Organization Management dan Recipient Management.
- Izin Aplikasi MS Graph API memerlukan administrator global Office 365 atau pengguna dengan izin Administrator Aplikasi Cloud Microsoft O365 untuk menambahkan aplikasi Microsoft Entra (Azure AD) Zoom sebagai aplikasi perusahaan.
- Kemampuan untuk membuat daftar, membuat, dan mengelola sumber daya kalender untuk ruangan.
- Akses Admin untuk Windows PowerShell pada Windows 10 atau versi yang lebih baru, atau Windows Server 2016 atau versi yang lebih baru
- Peran dengan akses ke Zoom Rooms
- Untuk menggunakan integrasi Izin Aplikasi MS Graph API, akun Zoom Anda harus memiliki setidaknya satu domain yang terkait dan sesuai dengan domain kustom yang telah Anda verifikasi di tenant O365 Anda.
Cara membuat atau menemukan sumber daya kalender untuk setiap ruangan
- Masuk ke Pusat Admin Microsoft Exchange (EAC) sebagai admin.
- Di menu navigasi, klik Penerima lalu Sumber Daya.
- Klik pada tanda plus (+) jika Anda perlu menambahkan ruangan.
Zoom menyarankan agar Anda menggunakan prefiks (seperti ZR) untuk setiap ruangan, atau memilih metode lain yang Anda inginkan agar pengguna dapat dengan mudah mencari ruang rapat Zoom Rooms. - Catat nama tampilan dan alamat email dari setiap sumber kalender.
Catatan: Disarankan untuk membuat daftar ruang untuk semua sumber daya kalender Zoom Room, karena hal ini akan memungkinkan Zoom untuk mengisi daftar sumber daya kalender yang tersedia secara otomatis.
Cara menginstal modul PowerShell Microsoft Exchange Online
Banyak dari instruksi ini memerlukan penggunaan modul PowerShell Microsoft Exchange Online (AKA "EXO"). Berikut ini adalah ringkasan petunjuk yang terdapat di halaman " Install and maintain the EXO module " Microsoft.
- Jalankan Windows PowerShell menggunakan opsi " Jalankan sebagai administrator ".
Catatan: Opsi ini tersedia saat Anda mengklik kanan aplikasi Windows PowerShell tanpa menjalankannya. - Siapkan untuk menginstal modul EXO dengan menjalankan perintah berikut:
Set-ExecutionPolicy RemoteSigned - Tekan Y untuk menerima perubahan.
- Instal modul EXO dengan menjalankan perintah berikut:
Install-Module -Name ExchangeOnlineManagement -Scope CurrentUser
Catatan: Jika diperlukan, masukkan Y untuk menerima instalasi penyedia Microsoft NuGet guna memudahkan instalasi modul EXO. - Jika Anda menerima pesan "repositori tidak tepercaya" dan PowerShell meminta Anda untuk mengizinkan instalasi modul EXO dari repositori Microsoft PowerShell Gallery ("PSGallery"), masukkan Y untuk menerima.
- Tetap buka jendela PowerShell untuk perintah selanjutnya.
Cara memperbarui pengaturan sumber daya kalender menggunakan Windows PowerShell
Anda harus memperbarui pengaturan sumber daya kalender agar Zoom Rooms dapat menampilkan informasi kalender dan menghasilkan tombol bergabung dengan satu sentuhan untuk rapat Zoom.
- Buka Windows PowerShell menggunakan opsi "Jalankan sebagai administrator".
Catatan: Opsi ini tersedia saat Anda mengklik kanan aplikasi Windows PowerShell tanpa menjalankannya. - Masukkan perintah berikut:
Connect-ExchangeOnline -UserPrincipalName <UPN>
Catatan: Ganti nilai <UPN> dengan nama pengguna utama administrator Office 365 (biasanya berupa alamat email). Pastikan akun ini memiliki izin untuk kedua opsi "Pengelolaan Organisasi" dan "Pengelolaan Penerima". - Masukkan nama pengguna dan kata sandi administrator Office 365 di kotak dialog yang muncul.
- Periksa pengaturan sumber daya kalender dengan menjalankan perintah berikut:
Get-CalendarProcessing -Identity CalendarResource | Format-List Identity,DeleteSubject,AddOrganizerToSubject,DeleteComments,RemovePrivateProperty
Catatan: Ganti teks CalendarResource dengan alamat email sumber daya kalender. - Catat data yang dikembalikan untuk nilai-nilai berikut:
"Hapus Subjek", "Tambahkan Penyelenggara ke Subjek", "Hapus Komentar", dan "Hapus Properti Pribadi"
Dalam kebanyakan kasus, nilai-nilai ini disetel ke True.
Identitas : [domain].com/Users/CalendarResource
Hapus Subjek : Benar
Tambahkan Pengatur ke Subjek : Benar
Hapus Komentar : Benar
HapusPropertiPribadi : Benar - Ubah pengaturan untuk ruangan dengan perintah berikut:
Set-CalendarProcessing -Identity <CalendarResource> -AddOrganizerToSubject $false -OrganizerInfo $true -DeleteComments $false -DeleteSubject $false -RemovePrivateProperty $false
Catatan: Ganti teks <CalendarResource> dengan alamat email sumber kalender.
- Jika Anda tidak ingin menampilkan topik Kalender, ubah DeleteSubject $false menjadi DeleteSubject $true.
- Jika Anda melihat pesan kesalahan seperti “Operasi tidak dapat dilakukan karena objek 'Room' tidak ditemukan di '[domain].onmicrosoft.com'.”, Artinya, ruang lingkup grup peran yang memberikan izin kepada Anda untuk menjalankan cmdlet tidak mencakup pengguna/ruang. Pastikan Anda telah masuk dengan akun admin yang memiliki izin yang dijelaskan dalam persyaratan prasyarat.
- Jika Anda melihat kesalahan seperti "Perintah Set-CalendarProcessing tidak ditemukan", pastikan Anda masuk dengan akun admin yang memiliki izin yang dijelaskan dalam persyaratan prasyarat.
- Validasi pengaturan ruangan setelah perubahan dengan menjalankan perintah berikut:
Get-CalendarProcessing -Identity <CalendarResource> | Format-List Identity,DeleteSubject,AddOrganizerToSubject,DeleteComments,RemovePrivateProperty
Catatan: Ganti teks <CalendarResource> dengan alamat email sumber kalender.
Pengaturan berikut akan diterapkan:
Identitas : [domain].com/Users/CalendarResource
Hapus Subjek : Salah
Tambahkan Penyelenggara ke Subjek : False
Hapus Komentar : False
HapusPropertiPribadi : False - Ulangi Langkah 4-7 untuk setiap kalender, dengan hanya mengubah nama sumber kalender "< " menjadi " > "<CalendarResource> dalam setiap perintah.
- Putuskan sesi dengan perintah berikut:
Disconnect-ExchangeOnline - Tetap buka jendela PowerShell untuk perintah selanjutnya.
Cara mempersiapkan integrasi kalender
Memilih antara Izin Aplikasi dan Akses Delegasi Penuh
Secara umum, Zoom merekomendasikan penggunaan MS Graph API dengan izin aplikasi, karena konfigurasi ini memerlukan upaya yang jauh lebih sedikit untuk disiapkan dan dipelihara oleh administrator, serta tidak memerlukan akun layanan khusus. Izin Aplikasi (juga dikenal sebagai Akses Hanya Aplikasi) adalah pendekatan yang direkomendasikan oleh Microsoft untuk aplikasi perusahaan yang berjalan sebagai layanan latar belakang dan data yang diperlukan tidak dapat dibatasi untuk satu pengguna saja. MS Graph API dengan Akses Delegasi Penuh adalah opsi alternatif, tetapi memerlukan akun layanan khusus dan upaya tambahan untuk pengaturan awal dan pemeliharaan. Zoom tidak lagi merekomendasikan penggunaan opsi Exchange Web Services (EWS) untuk implementasi baru, karena Microsoft berencana untuk menghentikan dukungan RBAC Application Impersonation di Exchange Online dan akhirnya menghentikan dukungan untuk Exchange Web Services. Integrasi kalender yang sudah ada yang menggunakan EWS akan tetap berfungsi untuk sementara waktu sesuai dengan yang tercantum di halaman dukungan Microsoft, tetapi Zoom merekomendasikan untuk beralih ke integrasi kalender baru menggunakan MS Graph API dengan izin aplikasi.
Untuk panduan migrasi, silakan merujuk ke Pengumuman awal tentang penghentian dukungan untuk Microsoft Exchange Web Services + Impersonasi Aplikasi.
Persiapan Izin Aplikasi MS Graph API (disarankan)
Untuk menggunakan integrasi Izin Aplikasi MS Graph API, akun Zoom Anda harus memiliki setidaknya satu domain yang terkait dan sesuai dengan domain kustom yang telah Anda verifikasi di akun O365 Anda.
Setelah menambahkan layanan kalender, Anda dapat secara opsional menerapkan Kontrol Akses Berbasis Peran untuk Aplikasi di Exchange Online.
Izin yang diperlukan
Aplikasi integrasi kalender Zoom akan meminta izin berikut sebagai bagian dari proses persetujuan administrator oleh akun Global Administrator O365 (atau akun dengan izin setara):
- Nama API: Microsoft Graph
- Diterbitkan dengan persetujuan admin.
Nilai klaim
|
Izin
|
Jenis
|
Bagaimana Zoom menggunakannya?
|
Kalender.BacaTulis
|
Membaca dan menulis kalender di semua kotak surat
|
Aplikasi
|
Layanan kalender Zoom menggunakan izin ini untuk mengatur langganan pemberitahuan acara kalender dan membaca acara kalender dari sumber kalender ruang di akun O365 Anda.
|
Domain.Baca.Semua
|
Baca domain
|
Aplikasi
|
Layanan kalender Zoom menggunakan Domains API untuk memverifikasi adanya kesesuaian antara domain yang diverifikasi oleh O365 dan domain yang terkait dengan akun Zoom.
|
Tempat.Baca.Semua
|
Baca semua lokasi perusahaan
|
Aplikasi
|
Layanan kalender Zoom menggunakan API Places untuk menemukan sumber daya kalender ruang di akun O365 Anda.
|
Persiapan untuk Akses Penuh Delegasi MS Graph API
Zoom merekomendasikan penggunaan MS Graph API dengan izin aplikasi.
Membuat pengguna khusus untuk izin yang didelegasikan
Sebelum Anda dapat menambahkan layanan kalender menggunakan Akses Delegasi Penuh, seorang administrator Office 365 harus membuat akun pengguna layanan khusus di Office 365 untuk integrasi tersebut.
Mereka akan menggunakan kredensial pengguna khusus tersebut untuk memberikan izin kepada Zoom Rooms di akun Anda agar dapat menggunakan layanan kalender dan semua sumber daya kalender yang tersedia.
- Masuk ke Office 365 sebagai admin.
- Tambahkan pengguna ke akun Office 365 Anda. Lihat dokumentasi Microsoft " Menambahkan pengguna ke Office 365 " untuk petunjuk selengkapnya.
Catatan: Pengguna akun layanan khusus harus merupakan pengguna berlisensi di Office 365 yang memiliki kotak surat. - Catat alamat email dan kata sandi pengguna akun layanan khusus.
Delegasikan ruang rapat ke pengguna akun layanan khusus.
- Buka Windows PowerShell menggunakan opsi "Jalankan sebagai administrator".
Catatan: Opsi ini tersedia saat Anda mengklik kanan aplikasi Windows PowerShell tanpa menjalankannya. - Masukkan perintah berikut:
Connect-ExchangeOnline -UserPrincipalName <UPN>
Catatan: Ganti nilai <UPN> dengan nama pengguna utama administrator Office 365 (biasanya berupa alamat email). - Masukkan nama pengguna/kata sandi administrator Office 365 di kotak dialog.
Pastikan akun ini memiliki izin untuk kedua opsi "Pengelolaan Organisasi" dan "Pengelolaan Penerima". - Jalankan perintah berikut untuk memberikan akses delegasi penuh kepada akun layanan khusus ke kalender sumber kalender:
Add-MailboxPermission -Identity CalendarResource -User DedicatedUser -AccessRights FullAccess
Catatan: Ganti teks CalendarResource dengan alamat email sumber kalender. Ganti teks " DedicatedUser" dengan alamat email dari pengguna akun layanan khusus. - Jalankan perintah berikut untuk memberikan akses delegasi penuh kepada akun layanan khusus ke kalender sumber kalender:
Add-MailboxFolderPermission -Identity CalendarResource:\Calendar -User DedicatedUser -AccessRights Editor
Catatan: Ganti teks CalendarResource dengan alamat email sumber kalender (tetapi biarkan teks “:\Calendar” tetap ada; contoh: conferenceroom@contoso.com:\Calendar). Ganti teks "DedicatedUser" dengan alamat email dari pengguna akun layanan khusus. - Ulangi langkah 4-5 untuk setiap sumber daya kalender di setiap ruangan.
Izin yang diperlukan
Aplikasi integrasi kalender Zoom akan meminta izin berikut sebagai bagian dari proses otorisasi oleh akun layanan khusus:
- Nama API: Microsoft Graph
- Diterbitkan dengan persetujuan admin.
Nilai klaim
|
Izin
|
Jenis
|
Bagaimana Zoom menggunakannya?
|
Kalender.BacaTulis
|
Memiliki akses penuh ke kalender pengguna
|
Delegasi
|
Layanan kalender Zoom menggunakan izin ini untuk mengatur langganan pemberitahuan acara kalender dan membaca acara kalender dari sumber kalender ruang di akun O365 Anda.
|
Kalender.BacaTulis.Berbagi
|
Membaca dan menulis kalender pengguna dan kalender bersama
|
Delegasi
|
Layanan kalender Zoom menggunakan izin ini untuk mengatur langganan pemberitahuan acara kalender dan membaca acara kalender dari sumber kalender ruang di akun O365 Anda.
|
Akses offline
|
Baca semua lokasi perusahaan
|
Aplikasi
|
Layanan kalender Zoom memerlukan akses offline untuk mendapatkan token penyegaran yang memungkinkan akses berkelanjutan ke sumber daya kalender ruang di akun O365 Anda.
|
OpenID
|
Masuk untuk pengguna
|
Aplikasi
|
Layanan kalender Zoom meminta OpenID sebagai bagian dari proses otorisasi akun layanan khusus.
|
Tempat.Baca.Semua
|
Baca semua lokasi perusahaan
|
Aplikasi
|
Layanan kalender Zoom menggunakan API Places untuk menemukan sumber daya kalender ruang di akun O365 Anda.
|
Cara menambahkan Layanan Kalender ke Zoom
Zoom merekomendasikan untuk menggunakan browser web dalam mode penyamaran atau mode penelusuran pribadi saat mengotorisasi integrasi kalender ke Office 365. Hal ini akan membantu mencegah otorisasi yang tidak sengaja terhadap integrasi dengan pengguna Office 365 yang sudah masuk.
- Izin Aplikasi MS Graph API (disarankan)
- Akses Penuh Delegasi untuk MS Graph API
Izin Aplikasi MS Graph API (disarankan)
- Masuk ke portal web Zoom sebagai administrator Zoom Rooms.
- Di menu navigasi, klik Pengelolaan Ruang, lalu Integrasi Kalender.
- Klik Tambah Layanan Kalender.
Kotak dialog " Tambahkan Layanan Kalender " akan muncul. - Klik Office 365.
- Pastikan opsi " Authorize with OAuth 2.0 " telah dicentang.
- Konfigurasikan jenis layanan Office 365.
- Pilih Graph API.
- Di bawah Jenis Izin Akun, pilih Izin Aplikasi.
- Klik Izinkan
- Di portal masuk Microsoft, masuk sebagai Administrator Global Microsoft O365.
- Klik "Setuju " untuk memberikan izin yang diminta oleh aplikasi "Zoom calendar integration using MS Graph API app permissions".
- Setelah Anda menerima, browser Anda akan kembali ke halaman Integrasi Kalender dan layanan kalender yang telah Anda tambahkan.
- Jika Anda menerima pesan kesalahan "Domain yang diverifikasi untuk akun O365 tidak sesuai dengan domain yang terkait dengan akun Zoom," pastikan akun Zoom dan akun O365 Anda memenuhi persyaratan prasyarat. Untuk menggunakan integrasi Izin Aplikasi MS Graph API, akun Zoom Anda harus memiliki setidaknya satu domain yang terkait dan sesuai dengan domain kustom yang telah Anda verifikasi di akun O365 Anda.
Catatan: Lihat Tambahkan Ruang Zoom untuk informasi tentang cara mengonfigurasi sumber daya kalender dengan Ruang Zoom.
Akses Penuh Delegasi untuk MS Graph API
- Masuk ke portal web Zoom sebagai administrator Zoom Rooms.
- Di menu navigasi, klik Pengelolaan Ruang, lalu Integrasi Kalender.
- Klik Tambah Layanan Kalender.
Kotak dialog " Tambahkan Layanan Kalender " akan muncul. - Klik Office 365.
- Pastikan opsi " Authorize with OAuth 2.0 " telah dicentang.
- Konfigurasikan jenis layanan Office 365.
- Pilih Graph API.
- Di bawah Jenis Izin Akun, pilih Delegasi Akses Penuh.
- Klik Izinkan.
Catatan: Jika opsi untuk mengizinkan pengguna Office 365 memberikan izin kepada aplikasi perusahaan untuk mengakses data perusahaan atas nama mereka dinonaktifkan di Pengaturan Akun, opsi ini perlu diaktifkan di pengaturan, atau diaktifkan untuk aplikasi Zoom di Azure. - Di portal masuk Microsoft, masuk sebagai pengguna akun layanan khusus untuk menyelesaikan integrasi kalender. Jangan masuk sebagai diri sendiri atau administrator lain atau pengguna akhir.
- Halaman Integrasi Kalender menampilkan layanan kalender yang telah Anda tambahkan.
Catatan: Lihat Tambahkan Ruang Zoom untuk informasi tentang cara mengonfigurasi sumber daya kalender dengan Ruang Zoom.
Migrasi dari Exchange Web Services (EWS) ke MS Graph API
Zoom tidak lagi merekomendasikan penggunaan opsi Exchange Web Services (EWS) untuk implementasi baru, karena Microsoft berencana untuk menghentikan dukungan RBAC Application Impersonation di Exchange Online dan akhirnya menghentikan dukungan untuk Exchange Web Services. Untuk panduan migrasi, silakan merujuk ke Pengumuman awal tentang penghentian dukungan untuk Microsoft Exchange Web Services + Impersonasi Aplikasi.