Menyiapkan penyimpanan data Confluence Data Center

Halaman ini menjelaskan cara membuat penyimpanan data dan menghubungkan Confluence Data Center ke Gemini Enterprise.

Sebelum memulai

Catatan: Untuk menerapkan kontrol akses sumber data dan mengamankan data di Google Gemini Enterprise, pastikan Anda telah mengonfigurasi penyedia identitas.

Sebelum menyiapkan koneksi, lakukan hal berikut:

1. Berikan peran Discovery Engine Editor (roles/discoveryengine.editor). Peran ini diperlukan agar pengguna dapat membuat penyimpanan data. Untuk memberikan peran ini, lakukan hal berikut:

   1. Di konsol Google Cloud , buka halaman IAM.

      Buka IAM

   2. Temukan akun pengguna, lalu klik edit Edit.
   3. Berikan peran Discovery Engine Editor kepada pengguna. Untuk mengetahui informasi selengkapnya, lihat Peran dan izin IAM.

2. Selesaikan langkah-langkah di Menyiapkan autentikasi dan mendapatkan kredensial klien untuk mendapatkan client ID dan rahasia klien, serta menyiapkan cakupan OAuth.

3. Jika instance Confluence Data Center Anda menggunakan IP pribadi, publikasikan layanan produsen Private Service Connect. Untuk mengetahui informasi selengkapnya tentang penggunaan Private Service Connect untuk menghubungkan Gemini Enterprise ke sumber data yang dihosting sendiri, lihat Pengantar sumber data yang dihosting sendiri.

Jika menggunakan mode koneksi penyerapan data, Anda harus memenuhi persyaratan tambahan berikut:

1. Pastikan Anda memiliki izin Administrator Confluence untuk mengambil informasi Daftar Kontrol Akses (ACL).

2. Instal plugin Permission Accessor for Confluence Data Center. Plugin ini menyediakan endpoint REST ke Gemini Enterprise. Endpoint ini memungkinkan Gemini Enterprise mengambil detail izin ruang, batasan konten, dan alamat email pengguna berlisensi. Informasi ini kemudian digunakan untuk memastikan bahwa izin yang benar diterapkan dalam pengalaman penelusuran Gemini Enterprise.

Membuat penyimpanan data Confluence Data Center

Untuk membuat penyimpanan data Confluence Data Center, lakukan langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman Gemini Enterprise.

   Gemini Enterprise

2. Pilih atau buat project Google Cloud .

3. Di menu navigasi, klik Penyimpanan data.

4. Klik Buat penyimpanan data.

5. Di bagian Source, telusuri Confluence Data Center, lalu klik Select.

6. Di bagian Data:

   1. Di bagian Connector mode, pilih Data ingestion atau Federated search.

      Catatan: Penyerapan data tersedia dalam Pratinjau Pribadi. Anda harus masuk dalam daftar yang diizinkan untuk menggunakan penyimpanan data penyerapan data. Untuk ditambahkan ke daftar yang diizinkan, hubungi tim akun atau tim penjualan.

   2. Klik Lanjutkan.

   3. Di bagian Authentication settings, konfigurasikan autentikasi berdasarkan mode koneksi yang Anda pilih.

      1. Berikan detail autentikasi:

         • Untuk Federated search, berikan detail berikut:

           • URI Instance: URL dasar instance Confluence Data Center Anda, misalnya, https://your-confluence-instance.com.
           • Client ID: ID unik untuk aplikasi OAuth yang terdaftar di Confluence Data Center.
           • Rahasia klien: Rahasia Secret Manager yang berisi rahasia klien untuk mengautentikasi permintaan.

           Untuk mempelajari cara mendapatkan kredensial ini, lihat Menyiapkan autentikasi dan mendapatkan kredensial klien.

         • Untuk Penyerapan data, pilih antara kredensial Nama pengguna dan Sandi, Token akses pribadi, atau Token API, lalu masukkan detail autentikasi yang sesuai.

      2. Klik Lanjutkan.

   4. Dari daftar Destination type, pilih Public atau Private.

      • Jika Anda memilih jenis tujuan Publik, untuk URL Domain, masukkan URL publik Anda.

      • Jika Anda memilih jenis tujuan Private, masukkan informasi berikut:

        1. Service attachment: Masukkan lampiran layanan Private Service Connect Anda. Untuk mendapatkannya, Anda harus memublikasikan layanan produsen Private Service Connect untuk instance Confluence Data Center Anda.
        2. Jika region lampiran layanan Private Service Connect Anda berbeda dengan region penyimpanan data Anda, centang kotak Enable PSC Global Access.
        3. Untuk instance dengan URL Domain:
           • Opsional: Nama domain dasar: Masukkan domain dasar Anda. Tentukan nama domain dasar yang unik dan terperinci (misalnya, confluence.example.com), bukan domain root bersama (misalnya, example.com). Jika Anda memiliki beberapa konektor data dalam project yang sama, seperti Jira Data Center dan Confluence Data Center, pastikan masing-masing menggunakan domain instance lengkapnya sendiri sebagai domain dasar untuk menghindari tabrakan jaringan. Dua konektor data yang menggunakan Konektivitas Pribadi dengan nama domain dasar yang sama tidak dapat dibuat dalam project yang sama.
           • URL domain: Masukkan URL domain Anda. URI ini harus cocok dengan URI instance.
           • Opsional: Destination port: Masukkan port tujuan Anda.
        4. Untuk instance tanpa URL Domain:
           • Destination port: Masukkan port tujuan Anda.
        Catatan: Konektivitas pribadi diperlukan saat terhubung ke endpoint autentikasi lokal pribadi.

   5. Klik Lanjutkan.

   6. Opsional: Klik Advanced options.

      • Jika Anda memilih Federated search, lakukan tindakan berikut:

        • Jika Anda mengaktifkan kotak centang SSL settings, pilih Trust Model dari Private, Public, atau Insecure, lalu konfigurasikan kolom yang diperlukan. Untuk mengetahui informasi selengkapnya tentang model kepercayaan, lihat Model kepercayaan.

          • Publik: Gunakan opsi ini jika instance Confluence pusat data Anda menggunakan sertifikat yang dikeluarkan oleh CA yang dipercaya publik.
          • Private: Gunakan opsi ini jika instance Confluence Data Center Anda menggunakan sertifikat yang ditandatangani oleh CA pribadi atau internal.
          • Tidak aman: Opsi ini mengabaikan validasi sertifikat. Hal ini tidak direkomendasikan untuk lingkungan produksi karena dapat mengekspos koneksi Anda ke risiko keamanan.

          Kolom berikut umum untuk semua Model Kepercayaan:

          • Keystore Client Certificate: Sertifikat klien dalam format PEM. Contoh, -----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----.
          • Kunci Pribadi Klien Keystore: Kunci pribadi untuk sertifikat klien dalam format PEM.
          • Keystore Client Private Key Passphrase: Frasa sandi untuk kunci pribadi klien, jika ada.

          Informasi tambahan berikut diperlukan untuk Model Kepercayaan Pribadi:

          • Private Certificate: Sertifikat publik dari CA pribadi dalam format PEM.

      • Jika Anda memilih Penyerapan data, lakukan tindakan berikut:

        1. Centang kotak Enable Static IP Addresses. Setelah membuat konektor, Anda harus mengizinkan IP statis terdaftar agar operasi sinkronisasi berhasil. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi egress IP statis.
        2. Di kolom Max QPS, tentukan jumlah maksimum kueri yang dikirim ke penyimpanan data Confluence Data Center per detik.
        3. Centang kotak Enable Custom Fields. Jika diaktifkan, konektor akan mengambil kolom kustom dari Confluence Data Center.
        4. Jika diperlukan, centang kotak Setelan proxy dan Setelan SSL untuk mengaktifkannya.

   7. Klik Lanjutkan.

   8. Di bagian Entities to search (jika Anda memilih Federated search) atau Entities to sync (jika Anda memilih penyerapan data):

      1. Pilih semua entity yang diperlukan.
      2. Jika Anda memilih Federated search, lanjutkan ke langkah berikutnya.
      3. Jika Anda memilih Penyerapan data, lanjutkan dengan langkah-langkah berikut:
         1. Opsional: Untuk menyinkronkan project tertentu, lakukan hal berikut:
            1. Klik Filter.
            2. Untuk memfilter entity dari indeks, centang kotak Exclude from the index, atau untuk memastikan entity disertakan dalam indeks, centang kotak Include in the index.
            3. Masukkan kunci. Tekan Enter setelah setiap kunci.
            4. Klik Simpan.
         2. Untuk mengonfigurasi jadwal sinkronisasi, lakukan hal berikut:
            1. Dalam daftar Sync frequency, pilih frekuensi sinkronisasi.
               • Untuk menjadwalkan sinkronisasi penuh data entitas dan identitas secara terpisah, luaskan menu di bagian Sinkronisasi penuh, lalu pilih Opsi kustom.
            2. Dalam daftar Incremental sync frequency, pilih frekuensi sinkronisasi inkremental. Untuk mengetahui informasi selengkapnya, lihat Jadwal sinkronisasi.

7. Klik Lanjutkan.

8. Jika Anda memilih Federated search, di bagian Actions, untuk Select Confluence Data Center actions to enable, pilih tindakan dari kategori yang akan diaktifkan untuk penyimpanan data.

   Catatan: Jika Anda melewati penambahan tindakan pada langkah ini, Anda dapat menambahkannya nanti. Untuk mengetahui informasi selengkapnya, lihat Menambahkan tindakan.

   Untuk mengelola daftar tindakan, lihat Mengelola tindakan.

9. Klik Lanjutkan.

10. Di bagian Configuration:

    1. Dari daftar Multi-region, pilih lokasi untuk konektor data Anda.
    2. Di kolom Nama konektor data Anda, masukkan nama untuk konektor Anda.
    3. Jika Anda memilih us atau eu sebagai lokasi, konfigurasikan Setelan enkripsi:
       • Opsional: Jika Anda belum mengonfigurasi kunci satu region, klik Buka halaman setelan untuk melakukannya. Untuk mengetahui informasi selengkapnya, lihat Mendaftarkan kunci satu region untuk konektor pihak ketiga.
       • Pilih Google-managed encryption key atau Cloud KMS key.
       • Jika Anda memilih Cloud KMS key:
         • Dalam daftar Key management type, pilih jenis yang sesuai.
         • Di daftar Cloud KMS key, pilih kunci.
       Untuk mengetahui informasi selengkapnya, lihat Kunci enkripsi yang dikelola pelanggan.

11. Klik Lanjutkan.

12. Di bagian Penagihan, pilih Harga umum atau Harga yang dapat dikonfigurasi. Untuk informasi selengkapnya, lihat Memverifikasi status penagihan project dan Lisensi.

13. Klik Lanjutkan.

14. Klik Create. Gemini Enterprise akan membuat penyimpanan data Anda dan menampilkan penyimpanan data Anda di halaman Data stores.

15. Jika Anda memilih jenis tujuan Private dan mengonfigurasi layanan produsen Private Service Connect untuk Accept connections for selected projects (persetujuan eksplisit), lakukan hal berikut:

    1. Di konsol Google Cloud , telusuri Private Service Connect dan buka halaman Private Service Connect.

    2. Klik tab Published services.

    3. Klik nama layanan Private Service Connect yang sesuai dengan penyimpanan data Confluence Data Center Anda.

    4. Di bagian Connected projects, centang kotak di samping project tenant Gemini Enterprise untuk penyimpanan data, lalu klik Accept project.

    Catatan: Project ID tenant Gemini Enterprise diakhiri dengan -tp.

    Status penyimpanan data tetap Creating di halaman Data Stores hingga Anda mengklik Accept project di halaman detail layanan dalam Private Service Connect. Setelah Anda mengklik Accept project, status penyimpanan data akan berubah menjadi Active.

Untuk memverifikasi status penyimpanan data, lakukan hal berikut di halaman Data stores:

1. Buka penyimpanan data yang baru dibuat di daftar penyimpanan data dan pantau statusnya hingga berubah menjadi Active.
2. Saat status penyimpanan data berubah dari Creating menjadi Active, konektor Confluence Data Center siap digunakan.

Setelah membuat penyimpanan data:

• Buat aplikasi.
• Hubungkan ke penyimpanan data pusat data Confluence.
• Izinkan Gemini Enterprise ke Confluence Data Center sebelum menjalankan kueri apa pun.

Untuk mengetahui informasi tentang izin yang diperlukan untuk melakukan penelusuran, lihat Cakupan yang diperlukan.

Penanganan data dan eksekusi kueri

Bagian ini menjelaskan cara Gemini Enterprise mengelola kueri Anda dan implikasi privasi dari penggunaan penyimpanan data gabungan.

Eksekusi kueri

Setelah Anda mengizinkan Confluence Data Center dan mengirim kueri penelusuran ke Gemini Enterprise:

• Gemini Enterprise mengirimkan kueri penelusuran Anda langsung ke API Confluence Pusat Data.
• Gemini Enterprise menggabungkan hasil tersebut dengan hasil dari sumber data lain yang terhubung dan menampilkan hasil penelusuran yang komprehensif.

Penanganan data

Saat menggunakan penelusuran gabungan pihak ketiga, aturan penanganan data berikut berlaku:

• String kueri Anda dikirim ke backend penelusuran pihak ketiga (Confluence Data Center API).
• Pihak ketiga ini dapat mengaitkan kueri dengan identitas Anda.
• Jika beberapa sumber data penelusuran gabungan diaktifkan, kueri mungkin akan dikirim ke semua sumber data tersebut.
• Setelah data mencapai sistem pihak ketiga, data tersebut akan diatur oleh persyaratan layanan dan kebijakan privasi sistem tersebut.

Catatan: Untuk meningkatkan akurasi, LLM dapat menulis ulang kueri Anda sebelum dikirim ke pusat data Confluence. Kueri yang ditulis ulang ini dapat menggabungkan informasi dari histori kueri sesi Anda. Akibatnya, bagian dari histori kueri Anda mungkin juga disertakan dalam kueri yang dikirim ke Confluence Data Center API.

Langkah berikutnya

• Untuk menyediakan antarmuka pengguna untuk mengkueri data Confluence Data Center, buat aplikasi dan hubungkan ke penyimpanan data Confluence Data Center.
• Untuk melihat pratinjau tampilan hasil penelusuran setelah aplikasi disiapkan, lihat Mendapatkan hasil penelusuran.
• Untuk mengaktifkan pemberitahuan bagi penyimpanan data, lihat Mengonfigurasi pemberitahuan untuk penyimpanan data pihak ketiga.