View a markdown version of this page

Integrasi aksi Atlassian Confluence Cloud - Amazon Quick
Sebelum Anda mulaiKonfigurasikan Konsol Pengembang AtlassianSiapkan otentikasiSiapkan 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 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, 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 otentikasi.

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 terima 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.

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.

  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 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.

  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 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 kehttps://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.

  2. Pilih tab Tindakan.

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

  4. Pada halaman Jenis integrasi, pilih Lakukan tindakan di Atlassian Confluence Cloud dan pilih Berikutnya.

  5. 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.

  6. 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 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 pertemuan.

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

      • Email - Email akun pengguna terkait.

  7. Pilih Buat dan lanjutkan.

  8. (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, 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 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 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 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.