Konektor pertemuan V1.0 - Amazon Kendra
Fitur yang didukungPrasyaratInstruksi koneksiPelajari selengkapnya

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

Konektor pertemuan V1.0

Confluence adalah alat manajemen kerja kolaboratif yang dirancang untuk berbagi, menyimpan, dan mengerjakan perencanaan proyek, pengembangan perangkat lunak, dan manajemen produk. Anda dapat menggunakan Amazon Kendra untuk mengindeks ruang Confluence Anda, halaman (termasuk halaman bersarang), blog, dan komentar dan lampiran ke halaman dan blog yang diindeks.

catatan

Konektor pertemuan V1.0/ ConfluenceConfiguration APIberakhir pada 2023. Kami merekomendasikan untuk bermigrasi ke atau menggunakan konektor Confluence V2.0/. TemplateConfiguration API

Untuk memecahkan masalah konektor sumber data Amazon Kendra Confluence, lihat. Mengatasi masalah sumber data

Fitur yang didukung

Amazon Kendra Konektor sumber data pertemuan mendukung fitur-fitur berikut:

  • Pemetaan lapangan

  • Kontrol akses pengguna

  • Filter inklusi/pengecualian

  • (Hanya untuk Server Confluence) Virtual private cloud () VPC

Prasyarat

Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber data Confluence Anda, buat perubahan ini di Confluence dan akun Anda. AWS

Di Confluence, pastikan Anda memiliki:

  • Memberikan Amazon Kendra izin untuk melihat semua konten dalam instance Confluence Anda dengan:

    • Amazon Kendra Membuat anggota confluence-administrators kelompok.

    • Memberikan izin situs-admin untuk semua ruang, blog, dan halaman yang ada.

  • Menyalin contoh URL Confluence Anda.

  • Untuk pengguna SSO (Single Sign-On): Mengaktifkan halaman Show on login untuk nama pengguna dan kata sandi saat Anda mengonfigurasi metode Otentikasi Konfluensi di Pusat Data Confluence.

  • Untuk Server Confluence

    • Mencatat kredensyal otentikasi dasar Anda yang berisi nama pengguna dan kata sandi akun administratif Confluence Anda untuk terhubung. Amazon Kendra

      catatan

      Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami tidak menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku).

    • Opsional: Membuat token akses pribadi di akun Confluence Anda untuk terhubung. Amazon Kendra Untuk informasi selengkapnya, lihat Dokumentasi pertemuan tentang pembuatan token akses pribadi.

  • Untuk Confluence Cloud

    • Mencatat kredensyal otentikasi dasar Anda yang berisi nama pengguna dan kata sandi akun administratif Confluence Anda untuk terhubung. Amazon Kendra

  • Memeriksa setiap dokumen unik di Confluence dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks.

Di dalam Anda Akun AWS, pastikan Anda memiliki:

  • Membuat Amazon Kendra indeks dan, jika menggunakanAPI, mencatat ID indeks.

  • Membuat IAM peran untuk sumber data Anda dan, jika menggunakanAPI, catat ARN IAM peran tersebut.

    catatan

    Jika Anda mengubah jenis otentikasi dan kredensyal, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benar AWS Secrets Manager .

  • Menyimpan kredensi otentikasi Confluence Anda secara AWS Secrets Manager rahasia dan, jika menggunakanAPI, catat rahasianya. ARN

    catatan

    Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami tidak menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku).

Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat Anda menghubungkan sumber data Confluence. Amazon Kendra Jika Anda menggunakanAPI, Anda harus memberikan IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks. ARN

Instruksi koneksi

Untuk terhubung Amazon Kendra ke sumber data Confluence Anda, Anda harus memberikan rincian kredenal Confluence Anda sehingga dapat mengakses data Anda. Amazon Kendra Jika Anda belum mengkonfigurasi Confluence untuk Amazon Kendra lihat. Prasyarat

Console

Untuk terhubung Amazon Kendra ke Confluence

  1. Masuk ke Konsol AWS Manajemen dan buka Amazon Kendra konsol.

  2. Dari panel navigasi kiri, pilih Indeks dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks.

    catatan

    Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan kontrol akses Pengguna Anda di bawah Pengaturan indeks.

  3. Pada halaman Memulai, pilih Tambahkan sumber data.

  4. Pada halaman Tambahkan sumber data, pilih Konektor Confluence V1.0, lalu pilih Tambahkan sumber data.

  5. Pada halaman Tentukan detail sumber data, masukkan informasi berikut:

    1. Di Nama dan deskripsi, untuk Nama sumber data —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi.

    2. (Opsional) Deskripsi —Masukkan deskripsi opsional untuk sumber data Anda.

    3. Dalam Bahasa default —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih.

    4. Di Tag, untuk Tambahkan tag baru —Sertakan tag opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda.

    5. Pilih Berikutnya.

  6. Pada halaman Tentukan akses dan keamanan, masukkan informasi berikut:

    1. Pilih antara Confluence Cloud dan Confluence Server.

    2. Jika Anda memilih Confluence Cloud, masukkan informasi berikut:

      1. Pertemuan URL —Pertemuan Anda. URL

      2. AWS Secrets Manager rahasia —Pilih rahasia yang ada atau buat Secrets Manager rahasia baru untuk menyimpan kredensi otentikasi Confluence Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka.

        1. Masukkan informasi berikut di jendela Buat AWS Secrets Manager rahasia:

          1. Nama rahasia —Nama untuk rahasiamu. Awalan 'AmazonKendra-Confluence-' secara otomatis ditambahkan ke nama rahasia Anda.

          2. Untuk Nama Pengguna dan Kata Sandi —Masukkan nama pengguna dan kata sandi Confluence Anda.

          3. Pilih Simpan otentikasi.

    3. Jika Anda memilih Confluence Server, masukkan informasi berikut:

      1. Confluence URL —Nama pengguna dan kata sandi Confluence Anda.

      2. (Opsional) Untuk proxy Web masukkan informasi berikut:

        1. Nama host —Nama host untuk akun Confluence Anda.

        2. Nomor port —Port yang digunakan oleh protokol URL transportasi host.

      3. Untuk Otentikasi, Pilih otentikasi Dasar atau (hanya Server Confluence) Token Akses Pribadi.

      4. AWS Secrets Manager rahasia —Pilih rahasia yang ada atau buat Secrets Manager rahasia baru untuk menyimpan kredensi otentikasi Confluence Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka.

        1. Masukkan informasi berikut di jendela Buat AWS Secrets Manager rahasia:

          1. Nama rahasia —Nama untuk rahasiamu. Awalan 'AmazonKendra-Confluence-' secara otomatis ditambahkan ke nama rahasia Anda.

          2. Untuk Nama Pengguna dan Kata Sandi —Masukkan nilai kredensi otentikasi yang Anda konfigurasikan di Confluence. Jika menggunakan otentikasi dasar, gunakan nama pengguna Confluence Anda (ID email) dan kata sandi (APItoken). Jika menggunakan token akses pribadi, masukkan detail Token Akses Pribadi yang Anda konfigurasikan di akun Confluence.

          3. Simpan dan tambahkan rahasia Anda.

    4. IAM peran —Pilih peran yang sudah ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten Anda.

      catatan

      IAM peran yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atauFAQ, pilih Buat peran baru untuk menghindari kesalahan.

    5. Pilih Berikutnya.

  7. Pada halaman Konfigurasi pengaturan sinkronisasi, masukkan informasi berikut:

    1. Untuk Sertakan ruang pribadi dan Sertakan ruang yang diarsipkan —Pilih jenis ruang opsional untuk disertakan dalam sumber data ini.

    2. Untuk konfigurasi tambahan —Tentukan pola ekspresi reguler untuk menyertakan atau mengecualikan konten tertentu. Anda dapat menambahkan hingga 100 pola.

    3. Anda juga dapat memilih untuk Merayapi lampiran dalam ruang yang dipilih.

    4. Di Jadwal lari Sinkronisasi, untuk Frekuensi —Pilih seberapa sering Amazon Kendra akan disinkronkan dengan sumber data Anda.

    5. Pilih Berikutnya.

  8. Pada halaman Setel pemetaan bidang, masukkan informasi berikut:

    1. Untuk Spasi, Halaman, Blog —Pilih dari bidang sumber data default Amazon Kendra yang dihasilkan atau Pemetaan bidang yang disarankan tambahan untuk menambahkan bidang indeks.

    2. Tambahkan bidang —Untuk menambahkan bidang sumber data kustom untuk membuat nama bidang indeks untuk dipetakan dan tipe data bidang.

    3. Pilih Berikutnya.

  9. Pada halaman Tinjau dan buat, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih Tambahkan sumber data. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman Sumber data setelah sumber data berhasil ditambahkan.

API

Untuk terhubung Amazon Kendra ke Confluence

Anda harus menentukan yang berikut menggunakan ConfluenceConfigurationAPI:

  • Versi Confluence —Tentukan versi instance Confluence yang Anda gunakan sebagai atau. CLOUD SERVER

  • Rahasia Amazon Resource Name (ARN) —Berikan Amazon Resource Name (ARN) Secrets Manager rahasia yang berisi kredensi otentikasi Confluence Anda.

    Jika Anda menggunakan Confluence Server, Anda dapat menggunakan nama pengguna dan kata sandi Confluence Anda, atau token akses pribadi Anda sebagai kredensyal otentikasi.

    Jika Anda menggunakan nama pengguna dan kata sandi Confluence sebagai kredensyal otentikasi, Anda menyimpan kredensyal berikut sebagai struktur dalam rahasia Anda: JSON Secrets Manager 

    {
    "username": "user name",
    "password": "password"
}

    Jika Anda menggunakan token akses pribadi untuk menghubungkan Confluence Server Amazon Kendra, Anda menyimpan kredensyal berikut sebagai JSON struktur dalam rahasia Anda: Secrets Manager 

    {
    "patToken": "personal access token"
}

    Jika Anda menggunakan Confluence Cloud, Anda menggunakan nama pengguna Confluence dan API token, yang dikonfigurasi di Confluence, sebagai kata sandi Anda. Anda menyimpan kredensi berikut sebagai JSON struktur dalam rahasia Anda Secrets Manager :

    {
    "username": "user name",
    "password": "API token"
}

  • IAM peran —Tentukan RoleArn kapan Anda menelepon CreateDataSource untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk konektor Confluence dan. Amazon Kendra Untuk informasi selengkapnya, lihat IAM peran untuk sumber data Confluence.

Anda juga dapat menambahkan fitur opsional berikut:

  • Web proxy —Apakah akan terhubung ke URL instans Confluence Anda melalui proxy web. Anda dapat menggunakan opsi ini untuk Confluence Server.

  • (Hanya untuk Confluence Server) Virtual Private Cloud (VPC) —Tentukan VpcConfiguration sebagai bagian dari konfigurasi sumber data. Lihat Mengkonfigurasi Amazon Kendra untuk menggunakan file. VPC

  • Filter inklusi dan pengecualian —Tentukan pola ekspresi reguler untuk menyertakan atau mengecualikan spasi, posting blog, halaman, spasi, dan lampiran tertentu. Jika Anda memilih untuk mengindeks lampiran, hanya lampiran ke halaman dan blog terindeks yang akan diindeks.

    catatan

    Sebagian besar sumber data menggunakan pola ekspresi reguler, yang merupakan pola inklusi atau pengecualian yang disebut sebagai filter. Jika Anda menentukan filter inklusi, hanya konten yang cocok dengan filter inklusi yang diindeks. Dokumen apa pun yang tidak cocok dengan filter inklusi tidak diindeks. Jika Anda menentukan filter inklusi dan pengecualian, dokumen yang cocok dengan filter pengecualian tidak akan diindeks, meskipun sesuai dengan filter inklusi.

  • Pemetaan bidang —Pilih untuk memetakan bidang sumber data Confluence Anda ke bidang indeks Anda. Amazon Kendra Untuk informasi lebih lanjut, lihat Memetakan bidang sumber data.

    catatan

    Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks_document_body. Semua kolom lain bersifat opsional.

  • Pemfilteran konteks pengguna dan kontrol akses —Amazon Kendra meng-crawl daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL untuk dokumen Anda. ACLInformasi tersebut digunakan untuk memfilter hasil pencarian berdasarkan akses pengguna atau grup mereka ke dokumen. Untuk informasi selengkapnya, lihat Pemfilteran konteks pengguna.

Pelajari selengkapnya

Untuk mempelajari lebih lanjut tentang mengintegrasikan Amazon Kendra dengan sumber data Confluence Anda, lihat: