Konfigurasi Microsoft Teams

Halaman ini menjelaskan cara menyiapkan autentikasi dan izin sebelum membuat penyimpanan data Microsoft Teams.

Menyiapkan autentikasi dan izin

Anda harus menyiapkan autentikasi dan izin di Microsoft 365. Hal ini sangat penting agar konektor dapat mengakses data. Konektor MS Teams mendukung berbagai metode autentikasi, seperti kredensial klien OAuth atau token API.

Pendaftaran aplikasi Entra untuk konektor Microsoft Teams

Anda harus menyiapkan pendaftaran aplikasi Microsoft Entra untuk mengaktifkan akses aman ke Microsoft Teams sebelum dapat membuat konektor Gemini Enterprise.

Untuk mendaftarkan Gemini Enterprise sebagai aplikasi OAuth 2.0 di Microsoft Entra, lakukan hal berikut:

  1. Buka Microsoft Entra admin center.
  2. Di menu, luaskan bagian Entra ID, lalu pilih Pendaftaran aplikasi.
  3. Di halaman App registrations, pilih add New registration.
  4. Di halaman Register an application, buat pendaftaran aplikasi dengan melakukan hal berikut:
    1. Di bagian Name, masukkan nama tampilan untuk aplikasi.
      Screenshot halaman Register an application di pusat admin Microsoft Entra.
      Halaman pendaftaran aplikasi
    2. Di bagian Supported account types, pilih Accounts in the organizational directory only. Opsi ini membatasi akses ke pengguna dalam tenant Microsoft Entra organisasi Anda, yang sesuai untuk aplikasi perusahaan.
    3. Di bagian URI Pengalihan, pilih Web dan masukkan URL berikut sebagai URL callback web (atau URL pengalihan):
      • https://vertexaisearch.cloud.google.com/oauth-redirect
    4. Klik Daftar. Microsoft Entra akan membuat aplikasi Anda dan menampilkannya di halaman Semua aplikasi.

Membuat konfigurasi OAuth 2.0

Untuk membuat koneksi menggunakan metode autentikasi OAuth 2.0, Anda harus mendapatkan client ID, rahasia klien, dan tenant ID dari halaman pendaftaran aplikasi Microsoft Entra Anda.

Mendapatkan client ID dan rahasia klien

Untuk mendapatkan ID dan rahasia klien aplikasi, lakukan hal berikut:

  1. Buka Microsoft Entra admin center.
  2. Di menu, luaskan bagian Entra ID, lalu pilih Pendaftaran aplikasi.
  3. Di halaman App registrations, pilih All applications.
  4. Buka aplikasi yang Anda buat.
  5. Di halaman aplikasi, pilih Certificates & secrets.
  6. Klik add New client secret.
  7. Dalam dialog Tambahkan rahasia klien:
    1. Masukkan deskripsi untuk rahasia.
      Screenshot dialog Tambahkan rahasia klien di pusat admin Microsoft Entra.
      Dialog Tambahkan rahasia klien
    2. Pilih durasi masa berlaku. Sebaiknya pilih nilai default.
    3. Klik Tambahkan.
  8. Salin rahasia dari kolom Value (Client Secret) dan ID dari kolom Secret ID (Client ID), lalu simpan dengan aman untuk digunakan nanti.

Mendapatkan ID tenant

ID tenant Anda dapat ditemukan di kotak Tenant ID di halaman ringkasan di pusat admin Microsoft Entra.

Screenshot ID Tenant di halaman ringkasan di pusat admin Microsoft Entra.
Dapatkan ID tenant

Izin minimum Microsoft Graph

Untuk mengonfigurasi izin API yang diperlukan untuk aplikasi, lakukan hal berikut:

  1. Buka Microsoft Entra admin center.
  2. Di menu, luaskan bagian Entra ID, lalu pilih Pendaftaran aplikasi.
  3. Di halaman App registrations, pilih All applications.
  4. Buka aplikasi yang Anda buat.
  5. Di halaman aplikasi, pilih API permissions.
  6. Klik Tambahkan izin.
  7. Di halaman Request API permissions, pilih Microsoft Graph, lalu pilih Delegated permissions.

  8. Telusuri dan pilih izin berikut untuk penelusuran gabungan:

    Mode Koneksi Izin Tujuan
    Penelusuran Gabungan Group.Read.All Mengizinkan penyimpanan data membaca properti dan keanggotaan grup, serta membaca percakapan untuk semua grup.
    Sites.Read.All Mengizinkan penyimpanan data membaca semua file dan dokumen yang dibagikan dalam saluran Teams di seluruh organisasi.
    ChatMessage.Read.All Mengizinkan aplikasi membaca semua pesan chat pribadi dan grup.
    User.Read.All Mengizinkan penyimpanan data membaca profil pengguna.
  9. Klik Add Permissions.