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

ServiceNow konektor V1.0

ServiceNow menyediakan sistem manajemen layanan berbasis cloud untuk membuat dan mengelola alur kerja tingkat organisasi, seperti layanan TI, sistem tiket, dan dukungan. Anda dapat menggunakannya Amazon Kendra untuk mengindeks ServiceNow katalog, artikel pengetahuan, dan lampirannya.

catatan

Support untuk ServiceNow konektor V1.0/ ServiceNowConfiguration API dijadwalkan berakhir pada tahun 2023. Kami merekomendasikan untuk bermigrasi ke atau menggunakan ServiceNow konektor V2.0/ TemplateConfiguration API.

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

Fitur yang didukung

Amazon Kendra ServiceNow konektor sumber data mendukung fitur-fitur berikut:

  • ServiceNow versi contoh: London, Others

  • Pola inklusi/pengecualian: Katalog layanan, artikel pengetahuan, dan lampirannya

Prasyarat

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

Di ServiceNow, pastikan Anda memiliki:

  • Membuat akun ServiceNow administrator dan telah membuat sebuah ServiceNow instance.

  • Menyalin host URL ServiceNow instans Anda. Misalnya, jika URL instans adalah https://your-domain.service-now.com, format untuk URL host yang Anda masukkan adalah your-domain.service-now.com.

  • Mencatat kredensyal otentikasi dasar Anda yang berisi nama pengguna dan kata sandi untuk memungkinkan untuk terhubung Amazon Kendra ke instans Anda. ServiceNow

    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: Mengonfigurasi token kredenal OAuth 2.0 yang dapat mengidentifikasi Amazon Kendra dan menghasilkan nama pengguna, kata sandi, ID klien, dan rahasia klien. Nama pengguna dan kata sandi harus menyediakan akses ke basis ServiceNow pengetahuan dan katalog layanan. Lihat ServiceNow dokumentasi tentang otentikasi OAuth 2.0 untuk informasi selengkapnya.

  • Menambahkan izin berikut:

    • kb_category

    • kb_knowledge

    • kb_knowledge_base

    • kb_uc_cannot_read_mtom

    • kb_uc_can_read_mtom

    • sc_catalog

    • sc_category

    • sc_cat_item

    • sys_attachment

    • sys_attachment_doc

    • sys_user_role

  • Memeriksa setiap dokumen unik di dalam ServiceNow 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 ServiceNow otentikasi Anda AWS Secrets Manager secara rahasia dan, jika menggunakan API, catat ARN rahasia tersebut.

    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 ServiceNow data Anda 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 ServiceNow data Anda, Anda harus memberikan rincian yang diperlukan dari sumber ServiceNow data Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi ServiceNow untuk Amazon Kendra lihatPrasyarat.

Console

Untuk terhubung Amazon Kendra ke ServiceNow

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

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

    1. ServiceNow host —Masukkan URL ServiceNow host.

    2. ServiceNow versi —Pilih ServiceNow versi Anda.

    3. Pilih antara otentikasi Dasar dan otentikasi Oauth 2.0 berdasarkan kasus penggunaan Anda.

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

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

      2. Jika menggunakan Otentikasi Dasar—Masukkan nama Rahasia, Nama Pengguna, dan Kata Sandi untuk akun Anda. ServiceNow

        Jika menggunakan Otentikasi OAuth2—Masukkan nama Rahasia, Nama Pengguna, Kata Sandi, ID Klien, dan Rahasia Klien yang Anda buat di akun Anda. ServiceNow

      3. Pilih Simpan dan tambahkan rahasia.

    5. IAM peran —Pilih peran yang 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 atau FAQ, pilih Buat peran baru untuk menghindari kesalahan.

    6. Pilih Selanjutnya.

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

    1. Sertakan artikel pengetahuan —Pilih untuk mengindeks artikel pengetahuan.

    2. Jenis artikel pengetahuan —Pilih antara Sertakan hanya artikel publik dan Sertakan artikel berdasarkan kueri ServiceNow filter berdasarkan kasus penggunaan Anda. Jika Anda memilih Sertakan artikel berdasarkan kueri ServiceNow filter, Anda harus memasukkan kueri Filter yang disalin dari ServiceNow akun Anda.

    3. Sertakan lampiran artikel pengetahuan —Pilih untuk mengindeks lampiran artikel pengetahuan. Anda juga dapat memilih jenis file tertentu untuk diindeks.

    4. Sertakan item katalog —Pilih untuk mengindeks item katalog.

    5. Sertakan lampiran item katalog —Pilih untuk mengindeks lampiran item katalog. Anda juga dapat memilih jenis file tertentu untuk diindeks.

    6. Frekuensi —Seberapa sering Amazon Kendra akan disinkronkan dengan sumber data Anda.

    7. Pilih Selanjutnya.

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

    1. Artikel pengetahuan dan Katalog layanan —Pilih dari bidang sumber data default yang Amazon Kendra dihasilkan dan pemetaan bidang tambahan yang disarankan yang ingin Anda petakan ke indeks Anda.

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

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

Anda harus menentukan yang berikut menggunakan ServiceNowConfiguration API:

  • URL sumber data —Tentukan ServiceNow URL. Titik akhir host akan terlihat seperti berikut: your-domain.service-now.com.

  • Instance host sumber data —Tentukan versi instance ServiceNow host sebagai salah satu LONDON atauOTHERS.

  • Rahasia Nama Sumber Daya Amazon (ARN) —Berikan Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensyal otentikasi yang Anda buat di akun Anda. ServiceNow

    Jika Anda menggunakan otentikasi dasar, rahasia disimpan dalam struktur JSON dengan kunci berikut:

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

    Jika Anda menggunakan otentikasi OAuth2, rahasia disimpan dalam struktur JSON dengan kunci berikut:

    {
    "username": "user name",
    "password": "password",
    "clientId": "client id",
    "clientSecret": "client secret"
}

  • 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 ServiceNow konektor dan. Amazon Kendra Untuk informasi selengkapnya, lihat IAM peran untuk sumber ServiceNow data.

Anda juga dapat menambahkan fitur opsional berikut:

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

  • Filter inklusi dan pengecualian —Tentukan apakah akan menyertakan atau mengecualikan lampiran file tertentu dari katalog dan artikel pengetahuan.

    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.

  • Parameter pengindeksan —Anda juga dapat memilih untuk menentukan apakah akan:

    • Mengindeks artikel pengetahuan dan katalog layanan, atau keduanya. Jika Anda memilih untuk mengindeks artikel pengetahuan dan item katalog layanan, Anda harus memberikan nama ServiceNow bidang yang dipetakan ke kolom isi dokumen indeks dalam Amazon Kendra indeks.

    • Lampiran indeks ke artikel pengetahuan dan item katalog.

    • Gunakan ServiceNow kueri yang memilih dokumen dari satu atau lebih basis pengetahuan. Basis pengetahuan boleh bersifat publik atau privat. Untuk informasi selengkapnya, lihat Menentukan dokumen untuk diindeks dengan kueri.

Pelajari selengkapnya

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