Adobe Experience Manager - Amazon Kendra
Fitur yang didukungPrasyaratInstruksi koneksi

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

Adobe Experience Manager

Adobe Experience Manageradalah sistem manajemen konten yang digunakan untuk membuat konten situs web atau aplikasi seluler. Anda dapat menggunakan Amazon Kendra untuk menghubungkan Adobe Experience Manager dan mengindeks halaman dan aset konten Anda.

Amazon Kendra mendukung Adobe Experience Manager (AEM) sebagai instance penulis Layanan Cloud dan penulis Adobe Experience Manager On-Premise dan menerbitkan instance.

Anda dapat terhubung Amazon Kendra ke sumber Adobe Experience Manager data menggunakan Amazon Kendra konsol atau TemplateConfigurationAPI.

Untuk memecahkan masalah konektor sumber data Amazon Kendra Adobe Experience Manager, lihat. Mengatasi masalah sumber data

Fitur yang didukung

Adobe Experience Managerkonektor sumber data mendukung fitur-fitur berikut:

  • Pemetaan lapangan

  • Kontrol akses pengguna

  • Filter inklusi/pengecualian

  • Sinkronisasi konten penuh dan inkremental

  • OAuth 2.0 dan otentikasi dasar

  • Cloud privat virtual (VPC)

Prasyarat

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

DiAdobe Experience Manager, pastikan Anda memiliki:

  • Akses ke akun dengan hak administratif, atau pengguna admin.

  • Menyalin URL Adobe Experience Manager host Anda.

    catatan

    (On-premise/server) Amazon Kendra memeriksa apakah informasi titik akhir yang disertakan sama dengan informasi titik akhir yang AWS Secrets Manager ditentukan dalam detail konfigurasi sumber data Anda. Ini membantu melindungi dari masalah wakil yang membingungkan, yang merupakan masalah keamanan di mana pengguna tidak memiliki izin untuk melakukan tindakan tetapi menggunakan Amazon Kendra sebagai proxy untuk mengakses rahasia yang dikonfigurasi dan melakukan tindakan. Jika nanti Anda mengubah informasi titik akhir Anda, Anda harus membuat rahasia baru untuk menyinkronkan informasi ini.

  • Mencatat kredensi otentikasi dasar Anda dari nama pengguna dan kata sandi admin.

    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 kredensil dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku).

  • Opsional: Kredensi OAuth 2.0 yang dikonfigurasi di Adobe Experience Manager (AEM) sebagai Layanan Cloud atau AEM On-Premise. Jika Anda menggunakan AEM On-Premise, kredensialnya mencakup ID klien, rahasia klien, dan kunci pribadi. Jika Anda menggunakan AEM sebagai Layanan Cloud, kredensialnya mencakup ID klien, rahasia klien, kunci pribadi, ID organisasi, ID akun teknis, dan host Adobe Identity Management System (IMS). Untuk informasi selengkapnya tentang cara membuat kredensil ini untuk AEM sebagai Layanan Cloud, lihat dokumentasi. Adobe Experience Manager Untuk AEM On-Premise, implementasi server Adobe Granite OAuth 2.0 (com.adobe.granite.oauth.server) menyediakan dukungan untuk fungsi server OAuth 2.0 di AEM.

  • Memeriksa setiap dokumen unik di Adobe Experience Manager 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. ID dokumen bersifat global untuk indeks dan harus unik per indeks.

Di dalam Anda Akun AWS, pastikan Anda memiliki:

  • Membuat Amazon Kendra indeks dan, jika menggunakan API, mencatat ID indeks.

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

    catatan

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

  • Menyimpan kredensi otentikasi Adobe Experience Manager Anda AWS Secrets Manager secara rahasia dan, jika menggunakan API, catat ARN rahasianya.

    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 kredensil 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 menghubungkan sumber data Adobe Experience Manager Amazon Kendra. Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks.

Instruksi koneksi

Untuk terhubung Amazon Kendra ke sumber Adobe Experience Manager data Anda, Anda harus memberikan rincian yang diperlukan dari sumber Adobe Experience Manager data Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi Adobe Experience Manager untuk Amazon Kendra, lihatPrasyarat.

Console

Untuk terhubung Amazon Kendra ke Adobe Experience Manager

  1. Masuk ke AWS Management Console 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 Tambah sumber data, pilih konektor Adobe Experience Manager, lalu pilih Tambah konektor. Jika menggunakan versi 2 (jika ada), pilih konektor Adobe Experience Manager dengan tag “V2.0".

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

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

    1. Sumber —Pilih AEM On-Premise atau AEM sebagai Layanan Cloud.

      Masukkan URL Adobe Experience Manager host Anda. Misalnya, jika Anda menggunakan AEM On-Premise, Anda menyertakan nama host dan port:. https://hostname:port Atau, jika Anda menggunakan AEM sebagai Layanan Cloud, Anda dapat menggunakan URL penulis: https://author-xxxxxx-xxxxxxx.adobeaemcloud.com.

    2. Lokasi sertifikat SSL —Masukkan jalur ke sertifikat SSL yang disimpan dalam bucket. Amazon S3 Anda menggunakan ini untuk terhubung ke AEM On-Premise dengan koneksi SSL yang aman.

    3. Otorisasi — Aktifkan atau nonaktifkan informasi daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat Pemfilteran konteks pengguna.

    4. Otentikasi —Pilih otentikasi dasar atau otentikasi OAuth 2.0. Kemudian pilih AWS Secrets Manager rahasia yang ada atau buat rahasia baru untuk menyimpan Adobe Experience Manager kredensil Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka.

      Jika Anda memilih otentikasi dasar, masukkan nama untuk rahasia, nama pengguna Adobe Experience Manager situs dan kata sandi. Pengguna harus memiliki izin admin atau menjadi pengguna admin.

      Jika Anda memilih otentikasi OAuth 2.0 dan Anda menggunakan AEM On-Premise, masukkan nama untuk rahasia, ID klien, rahasia klien, dan kunci pribadi. Jika Anda menggunakan AEM sebagai Layanan Cloud, masukkan nama untuk rahasia, ID klien, rahasia klien, kunci pribadi, ID organisasi, ID akun teknis, dan host Adobe Identity Management System (IMS).

      Simpan menambahkan rahasia Anda.

    5. Virtual Private Cloud (VPC) —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan Subnet dan grup keamanan VPC.

    6. Perayap identitas —Tentukan apakah akan mengaktifkan crawler Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi pemfilteran konteks pengguna dari hasil pencarian. Jika tidak, jika crawler identitas dimatikan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan PutPrincipalMappingAPI untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna.

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

      catatan

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

    8. Pilih Selanjutnya.

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

    1. Sinkronisasi cakupan —Tetapkan batas untuk merayapi jenis konten tertentu, komponen halaman, dan jalur akar, dan filter konten menggunakan pola ekspresi regex.

      1. Jenis konten —Pilih apakah hanya akan merayapi halaman atau aset, atau keduanya.

      2. (Opsional) Konfigurasi tambahan —Konfigurasikan pengaturan berikut:

        • Komponen halaman —Nama spesifik komponen halaman. Komponen Halaman adalah komponen halaman yang dapat diperluas yang dirancang untuk bekerja dengan editor Adobe Experience Manager template dan memungkinkan header halaman/footer dan komponen struktur dirakit dengan editor template.

        • Variasi fragmen konten —Nama spesifik variasi fragmen konten. Fragmen Konten memungkinkan Anda mendesain, membuat, mengkurasi, dan mempublikasikan konten yang tidak bergantung pada halaman. Adobe Experience Manager Mereka memungkinkan Anda menyiapkan konten yang siap digunakan di beberapa lokasi/melalui beberapa saluran.

        • Jalur root —Jalur root ke konten tertentu.

        • Pola Regex —Pola ekspresi reguler untuk menyertakan atau mengecualikan halaman dan aset tertentu.

    2. Mode sinkronisasi —Pilih cara Anda ingin memperbarui indeks saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda.

      • Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda.

      • Sinkronisasi baru yang dimodifikasi: Indeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendra dapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir.

      • Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendra dapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir.

    3. ID zona waktu —Jika Anda menggunakan AEM On-Premise dan zona waktu server Anda berbeda dari zona waktu konektor atau indeks Amazon Kendra AEM, Anda dapat menentukan zona waktu server agar sejajar dengan konektor atau indeks AEM. Zona waktu default untuk AEM On-Premise adalah zona waktu konektor atau indeks Amazon Kendra AEM. Zona waktu default untuk AEM sebagai Layanan Cloud adalah Greenwich Mean Time.

    4. Sinkronkan jadwal berjalan, untuk Frekuensi —Pilih seberapa sering menyinkronkan konten sumber data Anda dan memperbarui indeks Anda.

    5. Pilih Selanjutnya.

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

    1. Pilih dari bidang sumber data default yang Amazon Kendra dihasilkan yang ingin Anda petakan ke indeks Anda. Untuk menambahkan bidang sumber data kustom, buat nama bidang indeks untuk dipetakan dan tipe data bidang.

    2. Pilih Selanjutnya.

  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 Adobe Experience Manager

Anda harus menentukan JSON dari skema sumber data menggunakan API. TemplateConfiguration Anda harus memberikan informasi berikut ini:

  • Sumber data —Tentukan tipe sumber data seperti AEM saat Anda menggunakan skema TemplateConfigurationJSON. Tentukan juga sumber data seperti TEMPLATE saat Anda memanggil CreateDataSourceAPI.

  • URL host AEM —Tentukan URL Adobe Experience Manager host. Misalnya, jika Anda menggunakan AEM On-Premise, Anda menyertakan nama host dan port:. https://hostname:port Atau, jika Anda menggunakan AEM sebagai Layanan Cloud, Anda dapat menggunakan URL penulis: https://author-xxxxxx-xxxxxxx.adobeaemcloud.com.

  • Mode sinkronisasi —Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. Anda dapat memilih antara:

    • FORCED_FULL_CRAWLuntuk mengindeks semua konten baru, mengganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda.

    • FULL_CRAWLuntuk mengindeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendra dapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir.

    • CHANGE_LOGuntuk mengindeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendra dapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir.

  • Jenis otentikasi —Tentukan jenis otentikasi yang ingin Anda gunakan, salah satu atau. Basic OAuth2

  • Jenis AEM —Tentukan jenis yang Adobe Experience Manager Anda gunakan, salah satu atauCLOUD. ON_PREMISE

  • Rahasia Nama Sumber Daya Amazon (ARN) —Jika Anda ingin menggunakan otentikasi dasar untuk AEM On-Premise atau Cloud, Anda memberikan rahasia yang menyimpan kredensi otentikasi nama pengguna dan kata sandi Anda. Anda memberikan Nama Sumber Daya Amazon (ARN) dari sebuah AWS Secrets Manager rahasia. Rahasianya disimpan dalam struktur JSON dengan kunci berikut:

    {
    "aemUrl": "Adobe Experience Manager On-Premise host URL",
    "username": "user name with admin permissions",
    "password": "password with admin permissions"
}

    Jika Anda ingin menggunakan otentikasi OAuth 2.0 untuk AEM On-Premise, rahasianya disimpan dalam struktur JSON dengan kunci berikut:

    {
    "aemUrl": "Adobe Experience Manager host URL",
    "clientId": "client ID",
    "clientSecret": "client secret",
    "privateKey": "private key"
}

    Jika Anda ingin menggunakan otentikasi OAuth 2.0 untuk AEM sebagai Layanan Cloud, rahasia disimpan dalam struktur JSON dengan kunci berikut:

    {
    "clientId": "client ID",
    "clientSecret": "client secret",
    "privateKey": "private key",
    "orgId": "organization ID",
    "technicalAccountId": "technical account ID",
    "imsHost": "Adobe Identity Management System (IMS) host"
}

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

Anda juga dapat menambahkan fitur opsional berikut:

  • Virtual Private Cloud (VPC) VpcConfiguration —Tentukan kapan Anda menelepon. CreateDataSource Untuk informasi selengkapnya, lihat Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC.

  • ID zona waktu —Jika Anda menggunakan AEM On-Premise dan zona waktu server Anda berbeda dari zona waktu konektor atau indeks Amazon Kendra AEM, Anda dapat menentukan zona waktu server agar sejajar dengan konektor atau indeks AEM.

    Zona waktu default untuk AEM On-Premise adalah zona waktu konektor atau indeks Amazon Kendra AEM. Zona waktu default untuk AEM sebagai Layanan Cloud adalah Greenwich Mean Time.

    Untuk informasi tentang ID zona waktu yang didukung, lihat skema Adobe Experience Manager JSON.

  • Filter inklusi dan pengecualian —Tentukan apakah akan menyertakan atau mengecualikan halaman dan aset tertentu.

    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.

  • Perayap identitas —Tentukan apakah akan mengaktifkan crawler Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi pemfilteran konteks pengguna dari hasil pencarian. Jika tidak, jika crawler identitas dimatikan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan PutPrincipalMappingAPI untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna.

  • Pemetaan bidang —Pilih untuk memetakan bidang sumber data Adobe Experience Manager 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.

Untuk daftar kunci JSON penting lainnya untuk dikonfigurasi, lihat skema Adobe Experience Manager template.