Menghubungkan Jira Cloud

Halaman ini menjelaskan cara menghubungkan Jira Cloud ke Gemini Enterprise.

Setelah Anda menyiapkan sumber data dan mengimpor data untuk pertama kalinya, penyimpanan data akan menyinkronkan data dari sumber tersebut dengan frekuensi yang Anda pilih selama penyiapan.

Catatan: Setelah Anda menghubungkan Jira Cloud ke aplikasi, Google sangat menyarankan agar Anda mengaktifkan Knowledge Graph untuk meningkatkan kualitas penelusuran secara signifikan bagi pengguna Anda. Untuk menggunakan fitur ini, aplikasi Anda juga harus mengonfigurasi sumber data Orang. Untuk mengetahui informasi selengkapnya, lihat Pustaka Pengetahuan: Mendukung penelusuran cerdas dan sesuai konteks.

Versi yang didukung

Konektor Jira Cloud mendukung JIRA Cloud REST API versi 2.

Sebelum memulai

Sebelum menyiapkan koneksi, lakukan hal berikut:

• Pastikan akun Atlassian Anda disiapkan untuk menggunakan model pengelolaan pengguna terpusat yang baru.

  Catatan: Untuk menyiapkan konektor Jira Cloud, Anda harus menggunakan model pengelolaan pengguna Atlassian terpusat yang baru. Jika menggunakan model asli, Anda harus memigrasikan pengelolaan pengguna sebelum melanjutkan.

• Pastikan Anda memiliki akses administrator organisasi Jira ke instance dan project Jira. Dengan akses administrator organisasi, Anda dapat menyiapkan izin minimum dan memberikan hak istimewa akses ke grup pengguna. Untuk mengetahui informasi tentang cara memverifikasi akses administrator organisasi Jira, lihat Memverifikasi akses administrator organisasi Jira.

• (Opsional) Untuk mengambil alamat email pengguna dari Jira Cloud, meskipun setelan membatasi visibilitas email, instal aplikasi User Identity Accessor for Jira Cloud. Anda harus menjadi Administrator situs Jira untuk menginstal dan mengonfigurasi aplikasi ini. Setelah menginstal aplikasi, konfigurasi aplikasi untuk mengambil alamat email pengguna secara aman. Anda mungkin tidak perlu menginstal aplikasi ini jika alamat email sudah dapat diakses secara publik.

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

• Untuk mengaktifkan OAuth 2.0 dan mendapatkan client ID serta rahasia, lihat aplikasi OAuth 2.0 (3LO) dalam dokumentasi developer Atlassian.

Catatan: Atlassian sedang memperbarui elemen antarmuka pengguna, dan beberapa elemen yang disebutkan dalam dokumentasi ini sedang diganti namanya (misalnya, Produk diganti namanya menjadi Aplikasi). Untuk mengetahui informasi selengkapnya, lihat Perubahan terminologi Administrasi Atlassian dari "produk" menjadi "aplikasi".

Memverifikasi akses administrator organisasi Jira

1. Login ke Atlassian dengan kredensial pengguna Anda.

2. Pilih aplikasi Jira.

   

   Halaman beranda Atlassian

3. Klik Setelan.

   Jika Anda melihat opsi Sistem di bagian setelan Jira, Anda memiliki akses administrator organisasi Jira. Atau, minta administrator organisasi Jira Anda untuk memberikan akses.

   

   Setelan

Membuat integrasi OAuth 2.0

1. Login ke Atlassian Developer Console.

2. Klik ikon profil, lalu pilih Konsol developer.

   

   Pilih Konsol Play

3. Klik Buat, lalu pilih Integrasi OAuth 2.0.

   

   Pilih Integrasi OAuth 2.0

4. Masukkan nama untuk aplikasi.

5. Centang kotak untuk menyetujui persyaratan developer Atlassian.

6. Klik Buat.

   

   Membuat Integrasi OAuth 2.0 baru

7. Klik Authorization.

8. Di tabel Authorization type, pilih Add untuk OAuth 2.0 (3LO).

   

   Tambahkan jenis otorisasi

9. Di kolom URL Callback, masukkan https://vertexaisearch.cloud.google.com/console/oauth/jira_oauth.html.

10. Klik Simpan perubahan.

    

    Simpan perubahan

Mengonfigurasi izin minimum yang diperlukan untuk aplikasi

1. Di halaman aplikasi, klik Izin.

   

   Pilih Izin

2. Buka Jira API, lalu klik Add.

   Catatan: Setelah menambahkan Jira API, tombol Konfigurasi mungkin memerlukan waktu untuk muncul. Jika tidak muncul dengan segera, coba muat ulang halaman atau tunggu beberapa detik.

3. Klik Configure.

4. Buka tab Cakupan klasik.

5. Klik Edit cakupan, lalu pilih izin berikut:

   • read:jira-user
   • read:jira-work

   

   Edit cakupan Klasik

6. Konfirmasi bahwa kedua cakupan telah dipilih, lalu simpan perubahan Anda.

7. Buka tab Cakupan terperinci.

8. Klik Edit cakupan, lalu pilih izin berikut:

   • read:issue-security-level:jira
   • read:issue-security-scheme:jira
   • read:group:jira
   • read:user:jira
   • read:avatar:jira
   • read:audit-log:jira

   

   Edit Granular scopes

Izin minimum

Tabel berikut mencantumkan izin minimum yang diperlukan untuk membuat konektor Jira Cloud.

Cakupan klasik

Izin	Alasan penggunaan	Deskripsi
read:jira-work	Penyerapan data	Mengizinkan konektor membaca detail entitas (termasuk masalah, lampiran, komentar, dan properti).
read:jira-user	Menerapkan Daftar Kontrol Akses (ACL)	Mengizinkan konektor membaca detail pengguna dan grup.

Cakupan terperinci

Izin	Alasan penggunaan	Deskripsi
read:issue-security-level:jira	Menerapkan ACL	Memungkinkan penegakan ACL untuk masalah berdasarkan tingkat keamanan masalah tertentu.
read:issue-security-scheme:jira	Menerapkan ACL	Memungkinkan penerapan ACL untuk masalah berdasarkan skema keamanan masalah terkait.
read:group:jira	Menerapkan ACL	Mengizinkan konektor membaca informasi grup untuk menerapkan ACL yang terkait dengan keanggotaan grup.
read:user:jira	Menerapkan ACL	Mengizinkan konektor membaca informasi pengguna untuk menerapkan ACL yang terkait dengan izin pengguna perorangan.
read:avatar:jira	Menerapkan ACL	Mengizinkan konektor membaca informasi pengguna dan grup untuk menerapkan ACL. Avatar tidak digunakan, tetapi merupakan bagian dari cakupan terperinci yang dibundel dengan grup dan pengguna.
read:audit-log:jira	Memantau ACL	Mengizinkan konektor membaca log audit Jira untuk verifikasi dan pemantauan ACL.

Mendapatkan client ID dan rahasia klien

1. Klik Distribusi, lalu pilih Edit.
2. Pilih Berbagi untuk mengaktifkan pengeditan kolom lainnya.
3. Isi kolom yang tersisa:
   1. Untuk Vendor, masukkan Google.
   2. Untuk Kebijakan privasi, masukkan https://policies.google.com.
   3. Untuk Apakah aplikasi Anda menyimpan data pribadi?, pilih Ya.
   4. Centang kotak Saya mengonfirmasi bahwa saya telah menerapkan API pelaporan data pribadi. Untuk mengetahui informasi selengkapnya, lihat Personal data reporting API.

      

      Edit Distribusi

4. Klik Simpan perubahan.

5. Klik Setelan untuk menyalin Client ID dan Client secret Anda.

   

   Salin client ID dan rahasia klien Anda

Mendapatkan ID instance dan URL instance

1. Dapatkan ID instance:

   1. Buka tab baru, salin URL instance, dan tambahkan /_edge/tenant_info ke URL instance. Contoh, https://YOUR_INSTANCE.atlassian.net/_edge/tenant_info.

   2. Buka link untuk menemukan nilai cloudId. cloudId adalah ID instance Anda.

      

      Mendapatkan ID instance Anda

2. Dapatkan URL instance:

   1. Buka atlassian.net, lalu login dengan akun administrator Anda.
   2. Pilih aplikasi yang ingin Anda sinkronkan. Misalnya, sinkronkan aplikasi pertama.
   3. Temukan URL instance (subdomain di kolom URL).

Memberikan peran administrator

Untuk memberikan peran Editor Discovery Engine kepada administrator Jira di konsol Google Cloud , lakukan hal berikut:

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

2. Buka IAM.

   Buka IAM

3. Temukan akun pengguna yang memiliki akses administrator di Jira, lalu klik ikon Edit .

4. Berikan peran Editor Discovery Engine kepada administrator.

Untuk memberikan peran administrator kepada pengguna di Atlassian, lakukan hal berikut:

1. Login ke Atlassian menggunakan akun administrator organisasi.

2. Klik ikon menu, lalu pilih organisasi Anda. Atau, Anda dapat membuka admin.atlassian.com.

3. Di halaman Admin, klik produk, lalu pilih tombol Kelola pengguna.

   

   Mengelola pengguna

4. Klik Grup di bagian Pengelolaan pengguna.

5. Di halaman Grup:

   1. Klik Buat grup.
   2. Masukkan nama untuk grup.

   

   Buat grup

Grup ini menerima izin yang diperlukan oleh konektor. Pengguna yang ditambahkan ke grup ini akan mewarisi izin ini.Konektor menggunakan grup ini untuk mengautentikasi dan mengambil dokumen.

1. Di halaman grup, klik Tambahkan produk.

2. Pilih Admin akses pengguna sebagai peran untuk Jira.

3. Pilih Admin produk sebagai peran untuk administrasi Jira.

   

   Administrator akses pengguna Jira

4. Klik Grant Access.

5. Klik Tambahkan anggota grup untuk menambahkan akun pengguna atau anggota grup yang digunakan konektor untuk mengautentikasi dan mengakses resource yang diperlukan.

   

   Menambahkan anggota grup

Mengelola visibilitas pengguna

Untuk membuat email pengguna terlihat oleh siapa saja di akun Atlassian, ikuti langkah-langkah berikut:

1. Login ke Atlassian Developer Console.

2. Klik ikon profil, lalu pilih Konsol developer.

3. Klik ikon profil pengguna, lalu pilih Kelola akun.

   

   Mengelola akun

4. Buka Profil dan visibilitas.

   

   Profil dan visibilitas

5. Buka Kontak dan tetapkan Siapa yang dapat melihat ini sebagai Siapa saja.

   

   Kontak

Untuk membuat email pengguna terlihat oleh siapa saja di Jira, ikuti langkah-langkah berikut:

1. Login ke Atlassian dengan kredensial pengguna Anda.

2. Pilih aplikasi Jira.

3. Klik Setelan > Sistem.

4. Pilih Konfigurasi Umum di panel kiri.

5. Klik Edit Settings.

6. Untuk Visibilitas email pengguna, pilih Publik.

   

   Pilih visibilitas email

7. Klik Perbarui.

Menginstal dan mengonfigurasi User Identity Accessor untuk Jira Cloud

Jika alamat email pengguna tidak dapat diakses secara publik secara default karena setelan privasi di Jira Cloud, Anda harus menginstal aplikasi User Identity Accessor for Jira Cloud untuk mengambil alamat email pengguna secara aman. Jika alamat email pengguna sudah terlihat secara publik, Anda mungkin tidak perlu menginstal aplikasi. Untuk mengetahui informasi selengkapnya tentang visibilitas email yang dibatasi, lihat Mengelola visibilitas pengguna.

Peran dan izin

Untuk menginstal dan mengonfigurasi aplikasi User Identity Accessor for Jira Cloud, Anda harus memiliki peran administratif yang sesuai dan memberikan izin tingkat aplikasi yang diperlukan.

• Peran yang diperlukan: Anda harus menjadi Jira Site administrator untuk menginstal dan mengonfigurasi aplikasi.
• Izin tingkat aplikasi: Anda harus memberikan izin berikut selama penginstalan aplikasi:
  • Read Email Address: Mengizinkan aplikasi mengambil alamat email pengguna secara aman, meskipun visibilitas profil dibatasi.
  • App Storage scope: Mengizinkan aplikasi membaca dan menulis ke perangkat penyimpanan.

Menginstal User Identity Accessor untuk Jira Cloud

Untuk menginstal aplikasi User Identity Accessor for Jira Cloud di situs Jira Cloud Anda, ikuti langkah-langkah berikut:

1. Buka Atlassian Developer Console.

2. Tinjau izin Baca Alamat Email dan cakupan Penyimpanan Aplikasi, lalu klik Dapatkan aplikasi.

   

   Meninjau izin dan mendapatkan aplikasi

3. Dari daftar Pilih situs tempat menginstal aplikasi ini, pilih situs Jira tempat Anda ingin menginstal aplikasi. Daftar ini hanya menampilkan situs yang akses administrator-nya Anda miliki.

   Catatan: Anda harus menjadi administrator setidaknya satu situs Jira untuk menginstal aplikasi.

4. Klik Instal untuk menyelesaikan penginstalan aplikasi.

Mengonfigurasi Pengakses Identitas Pengguna untuk Jira Cloud

Setelah menginstal aplikasi User Identity Accessor for Jira Cloud, konfigurasi kunci API yang digunakan sistem eksternal Anda (misalnya, Jira Cloud Connector) untuk memanggil pemicu web aplikasi secara aman guna mengambil email.

Mengakses halaman konfigurasi

Untuk mengakses halaman konfigurasi aplikasi User Identity Accessor for Jira Cloud, ikuti langkah-langkah berikut:

1. Di instance Jira Cloud, klik ikon ⚙️ Setelan di menu navigasi.
2. Pilih Aplikasi dari menu.
3. Di halaman Administrasi aplikasi, temukan aplikasi Anda, User Identity Accessor for Jira Cloud, dalam daftar Kelola aplikasi.

4. Klik Konfigurasi atau link yang terkait dengan aplikasi Anda. Halaman konfigurasi khusus aplikasi akan terbuka di Jira Cloud.

   

   Mengonfigurasi aplikasi User Identity Accessor untuk Jira Cloud

Menyiapkan kunci API

Untuk menyiapkan kunci API di halaman konfigurasi, ikuti langkah-langkah berikut:

1. Di bagian Konfigurasi Kunci API, tentukan kunci rahasia untuk mengautentikasi permintaan ke webtrigger aplikasi. Anda dapat mengautentikasi permintaan menggunakan salah satu metode berikut:

   • Masukkan kunci Anda sendiri: Ketik atau tempel kunci API yang kuat dan unik ke kolom Kunci API. Gunakan kunci minimal 20–30 karakter dengan kombinasi huruf besar, huruf kecil, angka, dan simbol.

     

     Masukkan kunci Anda sendiri

   • Buat kunci: Klik tombol Buat Kunci Baru. Sistem membuat dan menampilkan kunci acak yang kuat di kolom.

     

     Buat kunci

     Penting: Segera salin kunci API yang ditampilkan di kolom. Karena alasan keamanan, Anda mungkin tidak dapat melihat kunci lengkap lagi setelah menyimpan atau keluar. Jika hilang, Anda harus menyetel atau membuat yang baru.

2. Klik Save API Key. Pesan sukses mengonfirmasi bahwa kunci telah disimpan dengan aman.

Catatan: Kunci API yang dihasilkan atau dibuat di bagian ini berfungsi sebagai nilai untuk kolom Jira Identity Sync Forge Client Secret di bagian Advanced Options selama penyiapan Konektor.

Menguji konfigurasi aplikasi

Verifikasi apakah aplikasi User Identity Accessor for Jira Cloud dikonfigurasi dengan benar dengan mengirim permintaan dari sistem eksternal Anda dan mengonfirmasi bahwa alamat email pengguna berhasil ditampilkan.

Mendapatkan URL webtrigger

1. Di halaman Administrasi aplikasi, temukan bagian URL Webtrigger, yang menampilkan URL unik khusus untuk situs Jira Anda dan penginstalan aplikasi ini:
   • Sistem eksternal Anda harus memanggil URL ini untuk meminta email pengguna.
   • URL biasanya terlihat seperti: http://uuid/domain.net/x1/randomId. Misalnya, https://YOUR_INSTANCE_ID.hello.atlassian-dev.net/x1/WEBTRIGGER_ID, dengan YOUR_INSTANCE_ID adalah ID instance Jira Cloud Anda dan WEBTRIGGER_ID adalah ID unik untuk endpoint webtrigger yang dibuat untuk aplikasi Anda.
2. Klik tombol Salin URL atau salin seluruh URL.

Mengonfigurasi sistem eksternal Anda

• Konfigurasi sistem eksternal Anda yang perlu mengambil email pengguna Jira dengan kunci API dan URL webtrigger yang diperoleh pada langkah sebelumnya.

• Endpoint URL: URL webtrigger yang Anda salin.

• Metode HTTP: POST

• Header Wajib:

  • Content-Type: application/json

  • X-Api-Key: YOUR_API_KEY

    Ganti YOUR_API_KEY dengan kunci API yang Anda tetapkan atau buat di bagian Siapkan kunci API.

Contoh perintah curl

Contoh ini menunjukkan cara memanggil web pemicu User Identity Accessor for Jira Cloud, yang menerima array ID akun dan menampilkan alamat email.

curl --location --request POST 'https://YOUR_INSTANCE_ID.hello.atlassian-dev.net/x1/ENDPOINT_PATH' \
--header 'X-Api-Key: YOUR-API-KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
   "accountIds": [
       "ACCOUNT_ID_1",
       "ACCOUNT_ID_2"
   ]
}'

Ganti:

• YOUR_INSTANCE_ID dengan ID instance Jira Cloud Anda
• ENDPOINT_PATH dengan jalur endpoint API
• YOUR_API_KEY dengan kunci API yang Anda tetapkan atau buat di bagian Siapkan kunci API
• ACCOUNT_ID dengan ID akun Atlassian yang ingin Anda targetkan

Respons yang diharapkan

[{"accountId":"ACCOUNT_ID_1","emailAddress":"EMAIL_ADDRESS_1"},
 {"accountId":"ACCOUNT_ID_2","emailAddress":"EMAIL_ADDRESS_2"}]

Ganti:

• ACCOUNT_ID_X dengan ID akun Atlassian yang sebenarnya
• USER_EMAIL_X dengan alamat email pengguna yang ditampilkan dari panggilan API Anda

Menerapkan praktik terbaik keamanan

Untuk mengonfirmasi keamanan kunci API Anda, ikuti rekomendasi berikut:

• Simpan kunci API dengan aman dalam konfigurasi Jira Cloud Connector Anda.
• Pastikan semua komunikasi dengan URL webhook terjadi melalui HTTPS. Ini adalah setelan default untuk pemicu web User Identity Accessor for Jira Cloud.

Dukungan untuk Pengakses Identitas Pengguna untuk Jira Cloud

Penawaran dukungan tersedia dari Google untuk aplikasi User Identity Accessor for Jira Cloud yang dapat mencakup pemeliharaan dan update rutin agar aplikasi tetap terbaru. Jika Anda mengalami masalah atau memiliki pertanyaan khusus tentang fungsi aplikasi, hubungi Google Cloud Dukungan. Untuk mengetahui informasi selengkapnya, lihat Mendapatkan Cloud Customer Care.

Membuat penyimpanan data Jira Cloud

Konsol

Untuk menggunakan konsol Google Cloud guna menyinkronkan data dari Jira Cloud ke Gemini Enterprise, ikuti langkah-langkah berikut:

1. Login ke situs Atlassian sebagai pengguna dengan kredensial administrator organisasi.

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

   Gemini Enterprise

3. Di menu navigasi, klik Data Stores.

4. Klik Create Data Store.

5. Di halaman Pilih sumber data, scroll atau telusuri Jira Cloud untuk menghubungkan sumber pihak ketiga Anda, lalu klik Pilih.

6. Di bagian Setelan autentikasi, masukkan URI Instance, ID Instance, ID Klien, dan Rahasia klien.

7. Klik Login.

8. Pastikan Anda login sebagai pengguna admin, pilih situs tempat aplikasi akan digunakan, lalu klik Setuju.

   

   Pilih situs tempat aplikasi akan digunakan

9. Klik Lanjutkan.

10. Di bagian Opsi lanjutan:

    • Opsional. Untuk mengizinkan sekumpulan alamat IP statis di sistem Anda, pilih Aktifkan Alamat IP Statis untuk pendaftaran.

    • Di kolom QPS Maksimum, masukkan bilangan bulat untuk menentukan kueri per detik maksimum yang akan dikirim ke instance Jira Cloud Anda. Nilai defaultnya adalah 12 QPS.

    • Di kolom Jira Identity Sync Forge URL, masukkan URL yang dihasilkan oleh aplikasi User Identity Accessor for Jira Cloud.

    • Di kolom Jira Identity Sync Forge Client Secret, masukkan rahasia klien yang dikonfigurasi di User Identity Accessor untuk Jira Cloud, yaitu kunci API yang Anda buat di bagian Menyiapkan kunci API.

    • Klik Lanjutkan.

11. Di bagian Entitas yang akan disinkronkan, lakukan tindakan berikut:

    1. Pilih entitas yang ingin Anda sinkronkan:

       • Masalah

       • Lampiran

       • Komentar

       • Log kerja

    2. Secara opsional, untuk menyinkronkan project tertentu, lakukan hal berikut:

       1. Klik Filter.
       2. Untuk mengecualikan entity dari indeks, pilih Kecualikan dari indeks atau untuk memastikan entity disertakan dalam indeks, pilih Sertakan ke indeks.
       3. Masukkan kunci project. Tekan enter setelah setiap kunci project.
       4. Klik Simpan.

    

    Tentukan filter untuk menyertakan atau mengecualikan entitas.

12. Klik Lanjutkan.

13. Pilih Frekuensi sinkronisasi untuk Sinkronisasi penuh dan Frekuensi sinkronisasi inkremental untuk Sinkronisasi data inkremental. Untuk mengetahui informasi selengkapnya, lihat Jadwal sinkronisasi.

    Jika Anda ingin menjadwalkan sinkronisasi penuh terpisah untuk data entitas dan identitas, luaskan menu di bagian Sinkronisasi penuh, lalu pilih Opsi kustom.

    

    Menetapkan jadwal terpisah untuk sinkronisasi entity penuh dan sinkronisasi identitas penuh.

14. Klik Lanjutkan.

15. Di bagian Konfigurasi konektor data Anda:

    1. Pilih region untuk penyimpanan data Anda. Anda tidak dapat mengubah wilayah nanti. Untuk mengetahui informasi selengkapnya tentang multi-region, lihat Lokasi Gemini Enterprise.

    2. Masukkan nama untuk konektor data Anda. Anda dapat mengubah nama tersebut di lain waktu.

    3. Opsional. Untuk mengubah ID konektor data setelah memasukkan nama, klik Edit dan ubah nilainya. Anda tidak dapat mengubah ID konektor data setelah membuat penyimpanan data.

    4. Klik Buat. Gemini Enterprise membuat penyimpanan data Anda dan menampilkannya di halaman Data Stores.

Untuk memeriksa status penyerapan, buka halaman Data Stores dan klik nama penyimpanan data Anda untuk melihat detailnya di halaman Data. Status konektor berubah dari Membuat menjadi Menjalankan saat mulai menyinkronkan data. Setelah penyerapan selesai, status akan berubah menjadi Aktif untuk menunjukkan bahwa koneksi ke sumber data Anda telah disiapkan dan menunggu sinkronisasi terjadwal berikutnya. Bergantung pada ukuran data Anda, penyerapan dapat memerlukan waktu beberapa menit atau beberapa jam.

Untuk mengetahui informasi mendetail tentang kuota, termasuk batas default dan petunjuk untuk meminta kuota yang lebih tinggi, lihat Kuota dan batas.

Mengaktifkan sinkronisasi real-time

Pratinjau: Anda harus berada dalam daftar yang diizinkan untuk menggunakan fitur ini.

Sinkronisasi real-time hanya menyinkronkan entitas dokumen dan tidak menyinkronkan data yang terkait dengan entitas identitas. Tabel berikut menunjukkan peristiwa dokumen yang didukung dengan sinkronisasi real-time.

Entitas Jira	Buat	Perbarui	Hapus	Perubahan izin
Masalah
Log kerja
Project
Komentar
Lampiran

Untuk mengaktifkan sinkronisasi real-time untuk konektor sumber data Jira Cloud, ikuti langkah-langkah berikut:

Membuat URL webhook

1. Buka halaman Gemini Enterprise, lalu di menu navigasi, klik Data Stores.
2. Pilih penyimpanan data Jira Cloud.

3. Klik Lihat/Edit di baris Sinkronisasi real-time.

   

   Sinkronisasi real-time : Status dinonaktifkan

4. Pada dialog Lihat dan edit parameter sinkronisasi real-time, lakukan hal berikut:

   1. Untuk mengaktifkan sinkronisasi real-time, klik tombol Aktifkan sinkronisasi real-time.
   2. Masukkan nilai di kolom Client secret dan salin. Anda memerlukan nilai ini lagi saat membuat webhook di konsol administrasi Jira.
   3. Klik Simpan.

      

      Mengaktifkan sinkronisasi real-time

5. Setelah status Sinkronisasi real-time berubah menjadi Running, klik Lihat/Edit.

   

   Sinkronisasi real-time : Status berjalan

6. Pada dialog Lihat dan edit parameter sinkronisasi real-time, lakukan hal berikut:

   1. Salin URL Webhook.
   2. Klik Close.

      

      Salin URL webhook

Membuat webhook

1. Login ke konsol administrasi Jira.
2. Klik Setelan, lalu pilih Sistem.
3. Di panel System settings, pilih Webhooks.
4. Klik Buat webhook. Untuk mengetahui informasi tentang webhook, lihat Webhook.
5. Masukkan nama untuk webhook.
6. Pilih Status sebagai Enabled.
7. Di kolom URL, tempelkan URL yang disalin dari Gemini Enterprise dan tambahkan /{issue.id}.

8. Di kolom Secret, masukkan nilai yang sama dengan yang Anda masukkan saat membuat URL webhook di Gemini Enterprise.

   

   Webhook

   Catatan: Untuk memverifikasi konsistensi data dan mencegah error saat mengonfigurasi webhook di Jira, pilih hanya entitas yang diaktifkan untuk sinkronisasi di penyimpanan data Anda.

9. Di bagian Peristiwa terkait masalah, pilih opsi berikut:

   Entity	Dibuat	Diperbarui	Dihapus
   Masalah	Ya	Ya	Ya
   Log kerja	Ya	Ya	Ya
   Komentar	Ya	Ya	Ya
   Lampiran	Ya	Tidak	Ya

   

   Acara terkait masalah

10. Di bagian Project related events, pilih kotak centang created, updated, dan deleted untuk entitas Project.

11. Klik Buat.

Pesan error

Tabel berikut menjelaskan pesan error umum, deskripsinya, dan kemungkinan solusinya saat menghubungkan Jira Cloud dengan Gemini Enterprise.

Kode error	Pesan error	Deskripsi	Pemecahan masalah
JIRA_INVALID_AUTH_1	Penyiapan OAuth gagal.	Panggilan refresh token mengalami masalah, yang mungkin terkait dengan kredensial, Secret Manager, atau konektivitas.	Detail pengecualian diberikan dalam pesan error lengkap. Kemungkinan penyebab dan solusinya meliputi: Masalah konektivitas: Masalah ini umumnya diselesaikan melalui percobaan ulang internal. Kredensial tidak valid: Verifikasi atau perbaiki kredensial.
JIRA_INVALID_AUTH_2	Autentikasi gagal.	Konektor tidak dapat melakukan autentikasi dengan Jira Cloud karena akun pengguna tidak memiliki akses API yang memadai.	Lakukan autentikasi ulang datastore menggunakan kredensial administrator.
JIRA_MISSING_PERMISSION_1	Pengguna non-admin tidak memiliki otorisasi untuk mendapatkan skema keamanan masalah.	Akun pengguna tanpa hak istimewa administrator mencoba mengambil skema keamanan masalah.	Berikan izin administrator yang diperlukan ke akun pengguna.
JIRA_MISSING_PERMISSION_2	Pengguna non-admin tidak dapat memperoleh skema izin.	Akun pengguna tanpa hak istimewa administrator mencoba mengambil skema izin.	Berikan izin administrator yang diperlukan ke akun pengguna.
JIRA_MISSING_PERMISSION_3	Masalah saat mengambil izin project.	Akun pengguna tanpa hak istimewa administrator mencoba mengambil detail project.	Berikan izin administrator yang diperlukan ke akun pengguna.
JIRA_IO_CONNECTION	Masalah saat menghubungkan ke Jira.	Konektor gagal terhubung ke instance Jira Cloud Anda, yang menunjukkan ketidakmampuan umum untuk membuat atau mempertahankan komunikasi dengan server Jira.	Verifikasi URL Jira Anda dan periksa silang kredensial autentikasi Anda. Pastikan instance Jira Anda beroperasi dan token API atau cakupan OAuth Anda memberikan izin yang diperlukan.
JIRA_INVALID_INSTANCE_ID	Gagal mengambil detail yang diperlukan dari instance Jira Anda. Periksa ID Instance Jira Anda. ID Instance Jira harus berupa UUID.	Sistem gagal mengambil detail yang diperlukan dari instance Jira Anda karena ID instance Jira Cloud yang diberikan tidak valid. ID Instance Jira harus berupa UUID.	Pastikan ID instance yang Anda masukkan adalah UUID yang benar.

Batasan umum

• Untuk data tidak terstruktur, setiap jenis media memiliki batasan yang berbeda. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan data untuk sumber data kustom.

• Untuk data terstruktur, setiap dokumen tidak boleh berukuran lebih dari 500 KB.

• Peran aplikasi dengan peran spesifik yang tidak kosong tidak dapat diberi izin Browse project atau tingkat keamanan.

• Izin dokumen yang ditentukan oleh kolom kustom pengguna atau kolom kustom grup tidak didukung.

• Jira Cloud tidak mengizinkan batasan apa pun pada tingkat log aktivitas.

• Jira Cloud tidak mengindeks lampiran PDF yang melebihi 2.000 halaman.

• Lampiran yang ditambahkan ke komentar pribadi tidak mewarisi batasan akses (ACL) pada komentar.

• Hanya 20 komentar sebelumnya untuk masalah di Jira Cloud yang diambil.

• Tabel sprint tidak dapat diproses.

• Model pengelolaan pengguna lama tidak didukung untuk integrasi dengan Jira Cloud. Hanya model pengelolaan pengguna terpusat yang didukung. Untuk mengetahui informasi selengkapnya, lihat Panduan penggabungan Organisasi Atlassian.

Langkah berikutnya

• Untuk melampirkan penyimpanan data ke aplikasi, buat aplikasi dan pilih penyimpanan data Anda dengan mengikuti langkah-langkah di bagian Membuat aplikasi.

• Untuk melihat pratinjau tampilan hasil penelusuran setelah aplikasi dan penyimpanan data Anda disiapkan, lihat Melihat pratinjau hasil penelusuran.

• Untuk mengaktifkan pemberitahuan untuk penyimpanan data, lihat Mengonfigurasi pemberitahuan untuk penyimpanan data pihak ketiga.