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, lihat[Metode otentikasi](quick-action-auth.md).
## Sebelum Anda mulai
Pastikan Anda memiliki yang berikut ini sebelum Anda mengatur integrasi.
+ Awan Jira Atlassian.
+ Akses ke [Konsol Pengembang Atlassian](https://developer.atlassian.com/console/myapps/) untuk membuat atau mengelola aplikasi OAuth .
+ Untuk persyaratan berlangganan, lihat[Siapkan integrasi di konsol](integration-console-setup-process.md).
## 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 ke[Siapkan integrasi di Amazon Quick](#jira-integration-setup).
Untuk informasi selengkapnya tentang aplikasi OAuth 2.0 (3LO), lihat aplikasi [OAuth 2.0 (3LO) dalam dokumentasi](https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/) 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](https://developer.atlassian.com/console/myapps/) dan masuk dengan akun Atlassian Anda.
1. Pilih **Buat**, lalu pilih **integrasi OAuth 2.0**.
1. Untuk **Nama**, masukkan nama deskriptif untuk integrasi Anda, misalnya`your-app-name connector`.
1. Tinjau dan setujui persyaratan pengembang Atlassian.
1. 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.
1. **Temukan API untuk produk Atlassian Anda (misalnya, **Jira API atau **Confluence API****) dan pilih Tambah.** Tombol berubah menjadi **Configure** setelah API ditambahkan.
1. Pilih **Konfigurasikan** Halaman cakupan terbuka dengan cakupan **Klasik dan tab cakupan** **Granular**.
1. Pada tab **Lingkup klasik**, pilih **Edit Lingkup**. Pilih cakupan klasik yang diperlukan dan pilih **Simpan**.
1. 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.
1. Di samping **OAuth 2.0 (3LO)**, pilih **Tambah**.
1. Untuk **Callback URLs**, masukkan`https://region.quicksight.aws.amazon.com/sn/oauthcallback`. Ganti *region* dengan AWS Wilayah tempat instans Amazon Quick Anda digunakan, misalnya`us-east-1`.
1. 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.
1. 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.**
1. Pilih tab **Tindakan**.
1. Di bawah **Siapkan integrasi aplikasi baru untuk Tindakan**, temukan **Atlassian Jira Cloud** dan pilih tombol Tambah (plus “\$1”).
1. 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**.
1. 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 ke`https://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.
1. 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.
1. Pilih **Buat dan lanjutkan**.
1. (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](https://jira.atlassian.com/browse/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, lihat[Mengelola integrasi yang ada](integration-workflows.md#managing-existing-integrations).
### 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](https://jira.atlassian.com/browse/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 ke`https://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.