Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Integrasi aksi Atlassian Confluence Cloud
Gunakan konektor aksi Atlassian Confluence Cloud untuk membuat, memperbarui, dan mengelola halaman dan spasi Confluence secara langsung di Amazon Quick melalui bahasa alami.
Untuk menyiapkan integrasi ini, pertama-tama 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 Pertemuan 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 otentikasi](#confluence-action-auth-setup).
Untuk informasi selengkapnya tentang aplikasi OAuth 2.0 (3LO), lihat aplikasi [OAuth 2.0 (3LO) dalam dokumentasi](https://developer.atlassian.com/cloud/confluence/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 terima 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.
### Cakupan yang diperlukan untuk Confluence
Tambahkan cakupan berikut ke aplikasi OAuth 2.0 Anda untuk integrasi aksi Confluence Cloud.
**Lingkup klasik**
Pada tab **Lingkup klasik**, pilih **Edit Lingkup** dan pilih lingkup berikut.
**Integrasi aksi pertemuan — lingkup klasik**
| Lingkup | Deskripsi |
| --- | --- |
| search:confluence | Cari konten Confluence dan ringkasan ruang. |
**Lingkup granular**
Pilih tab **Granular scopes**, lalu pilih **Edit** Scopes. Pilih cakupan berikut.
**Integrasi aksi pertemuan — cakupan granular**
| Lingkup | Deskripsi |
| --- | --- |
| read:page:confluence | Lihat konten halaman. |
| write:page:confluence | Buat dan perbarui halaman. |
| read:space:confluence | Akses informasi ruang. |
### 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 kredensil 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 otentikasi
Konektor aksi Confluence Cloud mendukung dua metode otentikasi. Kumpulkan kredensi yang diperlukan sebelum mengonfigurasi Amazon Quick.
**Otentikasi pengguna (3LO)**
Jika Anda menyelesaikan pengaturan Konsol Pengembang Atlassian di bagian sebelumnya, Anda harus menyiapkan nilai berikut. Masukkan ini saat Anda mengonfigurasi integrasi di Amazon Quick.
+ **URL Dasar — URL** instans Confluence Anda untuk panggilan API. Ini bukan URL yang sama dengan yang digunakan pengguna. Ini menyerupai yang berikut:`https://api.atlassian.com/ex/confluence/yourInstanceId`. Untuk menemukan ID instans Anda, navigasikan ke`https://your-domain.atlassian.net/_edge/tenant_info`.
+ **ID Klien** — Dari halaman Pengaturan aplikasi Atlassian OAuth Anda.
+ **Rahasia klien** — Dari halaman Pengaturan aplikasi Atlassian OAuth Anda.
+ **URL Token** — `https://auth.atlassian.com/oauth/token`
+ **URL Otorisasi** — `https://auth.atlassian.com/authorize`
+ **URL pengalihan** - `https://region.quicksight.aws.amazon.com/sn/oauthcallback`
**Otentikasi layanan (API Key)**
Kumpulkan informasi berikut dari administrator Confluence Cloud Anda:
+ **Kunci API** — Token API pertemuan.
+ **URL Dasar — URL** instans Confluence Anda untuk panggilan API.
+ **Email - Email** akun pengguna terkait.
## Siapkan integrasi di Amazon Quick
Setelah 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 Confluence Cloud** dan pilih tombol Tambah (plus “\$1”).
1. **Pada halaman **Jenis integrasi**, pilih **Lakukan tindakan di Atlassian Confluence Cloud** dan pilih Berikutnya.**
1. Dalam formulir **Buat integrasi**, isi kolom berikut:
+ **Nama — Nama** deskriptif untuk integrasi Confluence 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 Confluence Anda untuk panggilan API, dalam format. `https://api.atlassian.com/ex/confluence/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 pertemuan.
+ **URL Dasar — URL** instans Confluence 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.
## Tindakan yang tersedia
Setelah Anda mengatur integrasi, tindakan berikut tersedia.
**Tindakan yang tersedia Confluence Cloud**
| Tindakan | Deskripsi |
| --- | --- |
| Buat Halaman | Buat halaman baru. |
| Dapatkan Halaman | Lihat semua halaman. |
| Pencarian | Cari konten menggunakan CQL. |
| Perbarui Halaman | Perbarui konten halaman. |
## 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 kedaluwarsa** — Jika menggunakan otentikasi layanan, periksa apakah token API belum kedaluwarsa dan buat yang baru jika diperlukan.
+ **URL Dasar Salah** — URL Dasar untuk panggilan API tidak sama dengan URL login Confluence Cloud. Pastikan Anda menggunakan format URL API:`https://api.atlassian.com/ex/confluence/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 Confluence Cloud. Hubungi administrator Confluence 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.