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

Daftar Isi

Cara membuat atau menemukan sumber daya kalender untuk setiap ruangan

  1. Masuk ke Pusat Admin Microsoft Exchange (EAC) sebagai admin.
  2. Di menu navigasi, klik Penerima lalu Sumber Daya.
  3. 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.
  4. 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.

  1. Jalankan Windows PowerShell menggunakan opsi " Jalankan sebagai administrator ".
    Catatan: Opsi ini tersedia saat Anda mengklik kanan aplikasi Windows PowerShell tanpa menjalankannya.
  2. Siapkan untuk menginstal modul EXO dengan menjalankan perintah berikut:
    Set-ExecutionPolicy RemoteSigned
  3. Tekan Y untuk menerima perubahan.
  4. 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.
  5. 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.
  6. 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.

  1. Buka Windows PowerShell menggunakan opsi "Jalankan sebagai administrator".
    Catatan: Opsi ini tersedia saat Anda mengklik kanan aplikasi Windows PowerShell tanpa menjalankannya.
  2. 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".
  3. Masukkan nama pengguna dan kata sandi administrator Office 365 di kotak dialog yang muncul.
  4. 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.
  5. 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
  6. 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.
  7. 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
  8. Ulangi Langkah 4-7 untuk setiap kalender, dengan hanya mengubah nama sumber kalender "< " menjadi " > "<CalendarResource> dalam setiap perintah.
  9. Putuskan sesi dengan perintah berikut:
    Disconnect-ExchangeOnline
  10. 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):

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

ikon peringatan
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.

  1. Masuk ke Office 365 sebagai admin.
  2. 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.
  3. Catat alamat email dan kata sandi pengguna akun layanan khusus.

Delegasikan ruang rapat ke pengguna akun layanan khusus.

  1. Buka Windows PowerShell menggunakan opsi "Jalankan sebagai administrator".
    Catatan: Opsi ini tersedia saat Anda mengklik kanan aplikasi Windows PowerShell tanpa menjalankannya.
  2. Masukkan perintah berikut:
    Connect-ExchangeOnline -UserPrincipalName <UPN>
    Catatan: Ganti nilai <UPN> dengan nama pengguna utama administrator Office 365 (biasanya berupa alamat email).
  3. Masukkan nama pengguna/kata sandi administrator Office 365 di kotak dialog.
    Pastikan akun ini memiliki izin untuk kedua opsi "Pengelolaan Organisasi" dan "Pengelolaan Penerima".
  4. 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.
  5. 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.
  6. 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:

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)

  1. Masuk ke portal web Zoom sebagai administrator Zoom Rooms.
  2. Di menu navigasi, klik Pengelolaan Ruang, lalu Integrasi Kalender.
  3. Klik Tambah Layanan Kalender.
    Kotak dialog " Tambahkan Layanan Kalender " akan muncul.
  4. Klik Office 365.
  5. Pastikan opsi " Authorize with OAuth 2.0 " telah dicentang.
  6. Konfigurasikan jenis layanan Office 365.
  7. Pilih Graph API.
  8. Di bawah Jenis Izin Akun, pilih Izin Aplikasi.
  9. Klik Izinkan
  10. Di portal masuk Microsoft, masuk sebagai Administrator Global Microsoft O365.
  11. Klik "Setuju " untuk memberikan izin yang diminta oleh aplikasi "Zoom calendar integration using MS Graph API app permissions".
  12. Setelah Anda menerima, browser Anda akan kembali ke halaman Integrasi Kalender dan layanan kalender yang telah Anda tambahkan.

Catatan: Lihat Tambahkan Ruang Zoom untuk informasi tentang cara mengonfigurasi sumber daya kalender dengan Ruang Zoom.

Akses Penuh Delegasi untuk MS Graph API

  1. Masuk ke portal web Zoom sebagai administrator Zoom Rooms.
  2. Di menu navigasi, klik Pengelolaan Ruang, lalu Integrasi Kalender.
  3. Klik Tambah Layanan Kalender.
    Kotak dialog " Tambahkan Layanan Kalender " akan muncul.
  4. Klik Office 365.
  5. Pastikan opsi " Authorize with OAuth 2.0 " telah dicentang.
  6. Konfigurasikan jenis layanan Office 365.
  7. Pilih Graph API.
  8. Di bawah Jenis Izin Akun, pilih Delegasi Akses Penuh.
  9. 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.
  10. 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.
  11. 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.