Integrasi Atlassian Jira Cloud - Amazon Quick
Sebelum Anda mulaiKonfigurasikan Konsol Pengembang AtlassianSiapkan integrasi di Amazon QuickTindakan yang tersediaKelola dan pecahkan masalah

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Integrasi Atlassian Jira Cloud

Gunakan konektor aksi Atlassian Jira Cloud untuk membuat, memperbarui, mencari, dan mengelola masalah, proyek, sprint, dan pengguna Jira secara langsung di Amazon Quick melalui bahasa alami.

Menyiapkan integrasi ini melibatkan dua langkah. Pertama, Anda membuat aplikasi OAuth 2.0 (3LO) di Atlassian Developer Console dan mengonfigurasi izinnya. Kemudian, Anda membuat integrasi di Amazon Quick dan menghubungkannya ke aplikasi Atlassian Anda. Untuk informasi tentang metode otentikasi yang didukung Amazon Quick, lihatMetode otentikasi.

Sebelum Anda mulai

Pastikan Anda memiliki yang berikut ini sebelum Anda mengatur integrasi.

Konfigurasikan Konsol Pengembang Atlassian

Jika Anda berencana menggunakan autentikasi pengguna (3LO), buat aplikasi OAuth 2.0 di Atlassian Developer Console sebelum mengonfigurasi Amazon Quick. Selesaikan semua langkah berikut sebelum pindah ke konsol Amazon Quick.

Jika Anda berencana untuk menggunakan otentikasi layanan (API Key) saja, Anda dapat melewati bagian ini dan melanjutkan keSiapkan integrasi di Amazon Quick.

Untuk informasi selengkapnya tentang aplikasi OAuth 2.0 (3LO), lihat aplikasi OAuth 2.0 (3LO) dalam dokumentasi pengembang Atlassian.

Buat aplikasi OAuth 2.0 (3LO)

Amazon Quick menggunakan aplikasi Atlassian OAuth 2.0 (3LO) untuk mengautentikasi dengan produk Atlassian Cloud Anda atas nama pengguna Anda. Buat aplikasi ini di Atlassian Developer Console sebelum Anda mengonfigurasi Amazon Quick.

  1. Buka Atlassian Developer Console dan masuk dengan akun Atlassian Anda.

  2. Pilih Buat, lalu pilih integrasi OAuth 2.0.

  3. Untuk Nama, masukkan nama deskriptif untuk integrasi Anda, misalnyayour-app-name connector.

  4. Tinjau dan setujui persyaratan pengembang Atlassian.

  5. Pilih Buat.

Mengatur Konfigurasi Izin

Setelah Anda membuat aplikasi OAuth 2.0, tambahkan izin API yang diperlukan Amazon Quick untuk berinteraksi dengan produk Atlassian Anda.

  1. Dari aplikasi Anda di Atlassian Developer Console, pilih Izin di navigasi kiri.

  2. Temukan API untuk produk Atlassian Anda (misalnya, Jira API atau Confluence API) dan pilih Tambah. Tombol berubah menjadi Configure setelah API ditambahkan.

  3. Pilih Konfigurasikan Halaman cakupan terbuka dengan cakupan Klasik dan tab cakupan Granular.

  4. Pada tab Lingkup klasik, pilih Edit Lingkup. Pilih cakupan klasik yang diperlukan dan pilih Simpan.

  5. Pilih tab Granular scopes, lalu pilih Edit Scopes. Pilih cakupan granular yang diperlukan dan pilih Simpan.

Untuk cakupan spesifik yang diperlukan untuk integrasi Anda, lihat bagian cakupan berikut.

Konfigurasikan izin API

Tambahkan cakupan berikut ke aplikasi OAuth 2.0 Anda untuk integrasi tindakan Jira Cloud.

Lingkup klasik

Pada tab Lingkup klasik, pilih Edit Lingkup dan pilih cakupan berikut.

Integrasi aksi Jira - cakupan klasik
Lingkup Deskripsi
read:jira-work Baca proyek Jira dan data masalah, cari masalah, dan objek yang terkait dengan masalah seperti lampiran dan worklog.
manage:jira-project Buat dan edit pengaturan proyek dan buat objek tingkat proyek baru (misalnya, versi dan komponen).
manage:jira-configuration Ambil tindakan administrasi Jira (misalnya, buat proyek dan bidang khusus, lihat alur kerja, kelola jenis tautan masalah).
read:jira-user Lihat informasi pengguna di Jira yang dapat diakses pengguna, termasuk nama pengguna, alamat email, dan avatar.
write:jira-work Buat dan edit masalah di Jira, posting komentar sebagai pengguna, buat worklog, dan hapus masalah.
manage:jira-webhook Ambil, daftarkan, segarkan, dan hapus webhook Jira yang dideklarasikan secara dinamis.

Lingkup granular

Pilih tab Granular scopes, lalu pilih Edit Scopes. Gunakan bilah pencarian untuk menemukan cakupan di bawah ini. Misalnya, cari sprint:jira-software untuk menemukan cakupan terkait sprint.

Integrasi aksi Jira - cakupan granular
Lingkup Deskripsi
read:board-scope:jira-software Baca konfigurasi papan.
read:sprint:jira-software Baca informasi sprint.
write:sprint:jira-software Membuat dan memodifikasi sprint.
delete:sprint:jira-software Hapus sprint.
write:board-scope:jira-software Kelola konfigurasi papan.
read:project:jira Baca detail proyek.

Konfigurasikan otorisasi

Setel URL panggilan balik sehingga Atlassian dapat mengarahkan pengguna kembali ke Amazon Quick setelah mereka mengotorisasi aplikasi.

  1. Dari aplikasi Anda di Atlassian Developer Console, pilih Otorisasi di navigasi kiri.

  2. Di samping OAuth 2.0 (3LO), pilih Tambah.

  3. Untuk Callback URLs, masukkanhttps://region.quicksight.aws.amazon.com/sn/oauthcallback. Ganti region dengan AWS Wilayah tempat instans Amazon Quick Anda digunakan, misalnyaus-east-1.

  4. Pilih Simpan perubahan.

Rekam kredensional Anda

Sebelum Anda meninggalkan Konsol Pengembang Atlassian, konfirmasikan bahwa Anda memiliki nilai berikut. Anda membutuhkannya untuk konfigurasi Amazon Quick.

  1. Dari aplikasi Anda di Atlassian Developer Console, pilih Pengaturan di navigasi kiri.

  2. Di bawah rincian otentikasi, salin ID Klien dan nilai Rahasia.

Kredensi yang diperlukan dari Atlassian Developer Console
Nilai Di mana menemukannya
ID Klien Halaman pengaturan, di bawah Detail otentikasi
Rahasia Halaman pengaturan, di bawah Detail otentikasi

Siapkan integrasi di Amazon Quick

Setelah Anda menyiapkan kredensi otentikasi, buat integrasi di Amazon Quick.

  1. Di konsol Amazon Quick, pilih Integrasi.

  2. Pilih tab Tindakan.

  3. Di bawah Siapkan integrasi aplikasi baru untuk Tindakan, temukan Atlassian Jira Cloud dan pilih tombol Tambah (plus “+”).

  4. Di wizard Create Integration, isi kolom berikut:

    • Nama - Nama deskriptif untuk integrasi Jira Anda.

    • Deskripsi (Opsional) — Catatan tentang bagaimana koneksi ini akan digunakan.

    • Jenis koneksi - Pilih jaringan Publik.

  5. Di bawah Pengaturan otentikasi, pilih metode otentikasi Anda dan isi kolom yang diperlukan:

    1. Untuk otentikasi Pengguna, konfigurasikan bidang berikut:

      • URL Dasar — URL instans Jira Anda untuk panggilan API. Ini bukan URL yang sama dengan yang digunakan pengguna. Ini menyerupai yang berikut:https://api.atlassian.com/ex/jira/yourInstanceId. Untuk menemukan ID instans Anda, navigasikan kehttps://your-domain.atlassian.net/_edge/tenant_info.

      • ID Klien — ID Klien dari halaman Pengaturan aplikasi Atlassian OAuth Anda.

      • Rahasia klien — Rahasia dari halaman Pengaturan aplikasi Atlassian OAuth Anda.

      • URL Token — https://auth.atlassian.com/oauth/token

      • URL Otorisasi — https://auth.atlassian.com/authorize

      • URL pengalihan - Bidang ini diisi sebelumnya dengan URL panggilan balik Cepat Amazon Anda.

    2. Untuk otentikasi Layanan, konfigurasikan bidang berikut:

      • Kunci API — Token API JIRA.

      • URL Dasar — URL instans Jira Anda untuk panggilan API.

      • Email - Email akun pengguna terkait.

  6. Pilih Buat dan lanjutkan.

  7. (Opsional) Pada halaman Integrasi berbagi, pilih pengguna untuk berbagi integrasi dengan.

penting

Jira Cloud dapat mengembalikan respons keberhasilan HTTP 200 bahkan ketika token API dicabut atau dikonfigurasi dengan tidak benar. Untuk informasi lebih lanjut, lihat JRACLOUD-82932. Jika integrasi Anda tampaknya berhasil terhubung tetapi tindakan gagal secara tak terduga, verifikasi bahwa token API Anda valid dan belum dicabut.

Tindakan yang tersedia

Setelah Anda mengatur integrasi, tindakan berikut tersedia.

Tindakan yang tersedia Jira Cloud
Tindakan Deskripsi
Tambahkan Lampiran Tambahkan lampiran ke masalah.
Tambahkan Komentar Tambahkan komentar baru.
Ubah Status Masalah Ubah status tugas dari suatu masalah.
Buat Masalah Buat masalah atau subtugas baru.
Buat Proyek Buat proyek baru.
Buat Sprint Buat sprint dalam sebuah proyek.
Hapus Komentar Hapus komentar.
Hapus Masalah Hapus masalah dalam proyek.
Hapus Proyek Hapus proyek.
Hapus Sprint Hapus sprint dalam sebuah proyek.
Edit Masalah Ubah masalah.
Temukan Pengguna Cari pengguna Jira.
Dapatkan Semua Label Lihat semua label.
Dapatkan Semua Pengguna Daftar semua pengguna Jira.
Dapatkan Konten Lampiran Lihat isi lampiran.
Dapatkan Komentar Lihat komentar masalah.
Dapatkan Masalah Lihat detail masalah dalam proyek.
Dapatkan Jenis Masalah Untuk Proyek Lihat jenis masalah proyek.
Dapatkan Prioritas Lihat prioritas masalah.
Dapatkan Proyek Lihat detail proyek.
Dapatkan Sprint Lihat detail sprint dalam sebuah proyek.
Pindahkan Masalah ke Backlog Pindahkan masalah ke backlog.
Pindahkan Masalah Ke Sprint Dan Rank Tetapkan masalah ke sprint.
Masalah Pencarian Cari masalah.
Cari Proyek Temukan proyek yang terlihat.
Cari Status Cari status masalah.
Perbarui Komentar Edit komentar.
Perbarui Proyek Memodifikasi proyek.
Perbarui Sprint Perbarui detail sprint.
catatan

Tindakan yang dapat Anda gunakan bergantung pada izin yang dikonfigurasi dalam instans Jira Cloud dan metode otentikasi Anda.

Kelola dan pecahkan masalah

Untuk mengedit, membagikan, atau menghapus integrasi Anda, lihatMengelola integrasi yang ada.

Masalah otentikasi

  • Konfigurasi aplikasi salah — Verifikasi OAuth aplikasi di Atlassian Developer Console menyertakan cakupan yang diperlukan dan URI pengalihan cocok dengan konfigurasi Amazon Quick Anda.

  • Token API yang kedaluwarsa atau dicabut — Jika menggunakan otentikasi layanan, periksa apakah token API belum kedaluwarsa atau dicabut. Karena perilaku Jira Cloud yang diketahui (JRACLOUD-82932), integrasi mungkin tampak berhasil terhubung bahkan dengan token yang tidak valid.

  • URL Dasar Salah — URL Dasar untuk panggilan API tidak sama dengan URL login Jira Cloud. Verifikasi bahwa Anda menggunakan format URL API:https://api.atlassian.com/ex/jira/yourInstanceId. Untuk menemukan ID instans Anda, navigasikan kehttps://your-domain.atlassian.net/_edge/tenant_info.

Pesan kesalahan umum

  • Access denied. You do not have permission to perform this action— Pengguna yang diautentikasi tidak memiliki izin yang diperlukan di Jira Cloud. Hubungi administrator Jira Cloud Anda untuk memverifikasi dan memberikan izin yang sesuai.

  • OAuth 2.0 authorization failed— Verifikasi ID klien, rahasia klien, dan OAuth cakupan dikonfigurasi dengan benar di Konsol Pengembang Atlassian dan Amazon Quick.