View a markdown version of this page

ServiceNow integrasi - Amazon Quick
Sebelum Anda mulaiKonfigurasikan ServiceNow OAuthSiapkan integrasi di Amazon QuickTindakan yang tersediaBatasanKelola dan pecahkan masalah

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

ServiceNow integrasi

Gunakan ServiceNow integrasi untuk melakukan tindakan dalam ServiceNow instans Anda, termasuk mengelola insiden, masalah, permintaan perubahan, artikel basis pengetahuan, dan lampiran. Integrasi ini menggunakan ServiceNow REST API. Untuk informasi selengkapnya, lihat REST API dalam ServiceNow dokumentasi.

Menyiapkan integrasi ini melibatkan dua langkah. Pertama, Anda mengonfigurasi aplikasi OAuth dalam instans Anda ServiceNow . Kemudian, Anda membuat integrasi di Amazon Quick dan menghubungkannya ke ServiceNow aplikasi Anda. Untuk informasi tentang metode otentikasi yang didukung Amazon Quick, lihatMetode autentikasi.

Sebelum Anda mulai

Sebelum Anda mengatur integrasi, verifikasi bahwa Anda memiliki yang berikut ini.

  • Sebuah ServiceNow contoh. Integrasi ini divalidasi terhadap rilis Xanadu.

  • Akun ServiceNow pengguna dengan izin untuk membuat aplikasi OAuth (diperlukan admin peran).

  • Untuk otentikasi layanan (kredensi klien), instans Anda harus menjalankan rilis Washington DC atau yang lebih baru.

  • Untuk persyaratan berlangganan, lihatSiapkan integrasi di konsol.

Konfigurasikan ServiceNow OAuth

Sebelum mengonfigurasi Amazon Quick, buat endpoint aplikasi OAuth di instans Anda. ServiceNow Selesaikan semua langkah berikut ServiceNow sebelum pindah ke konsol Amazon Quick.

Untuk informasi selengkapnya, lihat Membuat titik akhir bagi klien untuk mengakses instance dalam ServiceNow dokumentasi.

Daftarkan aplikasi OAuth

Untuk mendaftarkan aplikasi OAuth, selesaikan langkah-langkah berikut.

  1. Dalam ServiceNow contoh Anda, navigasikan ke All > System OAuth > Application Registry dan pilih New.

  2. Pilih Buat titik akhir API OAuth untuk klien eksternal.

  3. Lengkapi formulir:

    • Nama — Nama deskriptif untuk aplikasi OAuth.

    • URL pengalihan - https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

      Ganti {region} dengan AWS Wilayah Anda (misalnya,us-east-1).

  4. Pilih Kirim.

  5. Buka kembali entri registri aplikasi dan pilih ikon kunci di sebelah Rahasia Klien untuk mengungkapkan nilainya.

  6. Salin nilai Client ID dan Client Secret. Anda memerlukan ini saat mengonfigurasi integrasi di Amazon Quick.

Langkah-langkah tambahan untuk otentikasi layanan (kredensyal klien)

Jika Anda berencana untuk menggunakan otentikasi layanan, selesaikan langkah-langkah tambahan ini setelah mendaftarkan aplikasi OAuth. Jenis hibah kredensyal klien diperkenalkan dalam rilis ServiceNow Washington DC. Untuk informasi lebih lanjut, lihat Up Your OAuth2.0 Game: Inbound Client Client Client Client dengan Washington DC di Komunitas. ServiceNow

  1. Aktifkan jenis hibah kredensyal klien. Arahkan ke sys_properties.list menggunakan navigator filter dan buat properti sistem baru dengan nilai-nilai berikut:

    • Nama – glide.oauth.inbound.client.credential.grant_type.enabled

    • Jenis - true | false

    • Nilai – true

  2. Verifikasi bahwa plugin berikut telah diinstal (navigasikan ke Admin > Manajer Aplikasi):

    • OAuth 2.0 () com.snc.platform.security.oauth

    • Penyedia API REST (com.glide.rest)

    • Lingkup otentikasi () com.glide.auth.scope

    • Plugin Lingkup Auth API REST () com.glide.rest.auth.scope

  3. Kembali ke aplikasi OAuth Anda di System OAuth > Application Registry. Tambahkan bidang Pengguna Aplikasi OAuth ke formulir jika tidak terlihat (gunakan Configure > Form Builder untuk menambahkannya).

  4. Setel Pengguna Aplikasi OAuth ke pengguna yang diizinkan dengan izin yang tepat, seperti pengguna dengan peran Administrator Sistem.

penting

Dengan otentikasi layanan, semua tindakan dijalankan sebagai pengguna aplikasi OAuth yang dikonfigurasi. Setiap pengguna Amazon Quick dengan akses ke integrasi ini dapat melakukan tindakan menggunakan izin akun tersebut. Konfigurasikan izin akun agar sesuai dengan persyaratan keamanan organisasi Anda.

Siapkan integrasi di Amazon Quick

Setelah Anda menyelesaikan konfigurasi ServiceNow OAuth, buat integrasi di Amazon Quick.

  1. Di konsol Amazon Quick, pilih Konektor.

  2. Pilih tab Buat untuk tim Anda.

  3. Temukan dan pilih ServiceNow.

  4. Masukkan detail integrasi:

    • Nama — Nama deskriptif untuk ServiceNow integrasi Anda.

    • Deskripsi (Opsional) — Tujuan integrasi.

  5. Pilih jenis koneksi Anda dan isi pengaturan koneksi:

    1. Untuk otentikasi Pengguna (OAuth), konfigurasikan bidang berikut:

      • URL dasar — https://{your-instance}.service-now.com

      • ID Klien — ID Klien dari aplikasi ServiceNow OAuth Anda.

      • Rahasia Klien — Rahasia klien dari aplikasi ServiceNow OAuth Anda.

      • URL Token — https://{your-instance}.service-now.com/oauth_token.do

      • URL Auth — https://{your-instance}.service-now.com/oauth_auth.do

      • URL pengalihan - https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

    2. Untuk otentikasi Layanan (kredensi klien), konfigurasikan bidang berikut:

      • Jenis otentikasi — Service-to-service OAuth

      • URL dasar — https://{your-instance}.service-now.com

      • ID Klien — ID Klien dari aplikasi ServiceNow OAuth Anda.

      • Rahasia Klien — Rahasia klien dari aplikasi ServiceNow OAuth Anda.

      • URL Token — https://{your-instance}.service-now.com/oauth_token.do

  6. Pilih Buat dan lanjutkan.

  7. Pilih pengguna untuk berbagi integrasi dengan.

  8. Pilih Berikutnya.

Untuk otentikasi pengguna, navigasikan ke Konektor > nama ServiceNow konektor Anda, dan pilih Masuk untuk menyelesaikan alur otorisasi OAuth.

Tindakan yang tersedia

Setelah Anda mengatur integrasi, tindakan berikut tersedia.

ServiceNow tindakan yang tersedia
Kategori Tindakan Deskripsi
Insiden Daftar Insiden Ambil kembali insiden yang ada.
Insiden Buat Insiden Buat catatan insiden untuk mendokumentasikan penyimpangan dari standar operasi yang diharapkan.
Insiden Lihat Insiden Ambil detail insiden tertentu.
Insiden Perbarui Insiden Perbarui catatan insiden.
Insiden Hapus Insiden Hapus insiden.
Masalah Daftar Masalah Ambil kembali masalah yang ada.
Masalah Buat Masalah Buat catatan masalah baru.
Masalah Lihat Masalah Ambil detail catatan masalah tertentu.
Masalah Perbarui Masalah Perbarui catatan masalah.
Masalah Hapus Masalah Hapus masalah.
Perubahan permintaan Daftar Permintaan Perubahan Ambil semua permintaan perubahan.
Perubahan permintaan Buat Permintaan Perubahan Buat permintaan perubahan untuk mengimplementasikan proses terkontrol untuk memodifikasi item konfigurasi (CI) yang disetujui dan didukung.
Perubahan permintaan Lihat Permintaan Perubahan Ambil informasi rinci tentang permintaan perubahan tertentu.
Perubahan permintaan Perbarui Permintaan Perubahan Ubah permintaan perubahan.
Perubahan permintaan Hapus Permintaan Perubahan Hapus permintaan perubahan.
Artikel dasar pengetahuan Buat Artikel Dasar Pengetahuan Buat artikel basis pengetahuan. Membutuhkan plugin Knowledge API (sn_km_api).
Artikel dasar pengetahuan Perbarui Artikel Dasar Pengetahuan Memodifikasi artikel basis pengetahuan.
Artikel dasar pengetahuan Hapus Artikel Dasar Pengetahuan Hapus artikel basis pengetahuan.
Lampiran Ambil Lampiran Metadata Ambil metadata untuk file lampiran.
Lampiran Ambil Metadata Lampiran Ambil metadata untuk file lampiran tertentu.
Lampiran Ambil Konten Lampiran Ambil konten lampiran file biner.
Lampiran Unggah Lampiran Biner Unggah file biner sebagai lampiran ke catatan tertentu.
Lampiran Unggah Lampiran Formulir Multipart Unggah lampiran file multipart.
Lampiran Hapus Lampiran Hapus lampiran.
Pengguna Daftar Pengguna Daftar semua catatan pengguna.
Sistem Daftar Pilihan Ambil nilai daftar pilihan dari tabel sys_choice.
catatan

Tindakan spesifik yang tersedia bergantung pada izin yang dikonfigurasi dalam ServiceNow instans Anda dan metode otentikasi yang digunakan.

Batasan

Integrasi ini berinteraksi dengan ServiceNow melalui REST API, yang tidak menerapkan kebijakan UI, tindakan UI, atau skrip klien. Aturan ini hanya berlaku di antarmuka ServiceNow browser. Server-side aturan bisnis, ACL, dan kebijakan data diberlakukan. Untuk informasi selengkapnya, lihat REST API dalam ServiceNow dokumentasi.

Kelola dan pecahkan masalah

Untuk mengedit, membagikan, atau menghapus integrasi Anda, lihatMengelola integrasi yang ada.

Masalah otentikasi

  • Otorisasi OAuth gagal — Verifikasi bahwa ID Klien dan Rahasia Klien cocok dengan nilai dalam Registri Aplikasi Anda ServiceNow . Konfirmasikan URL Pengalihan ServiceNow sesuai dengan URL di konfigurasi Cepat Amazon Anda dengan tepat.

  • Otentikasi layanan gagal — Verifikasi bahwa properti glide.oauth.inbound.client.credential.grant_type.enabled sistem disetel ketrue. Konfirmasikan bidang Pengguna Aplikasi OAuth diisi pada catatan registri aplikasi.

Pesan kesalahan umum

  • Tindakan mengembalikan kesalahan izin — Verifikasi bahwa ServiceNow pengguna atau pengguna aplikasi OAuth memiliki peran yang diperlukan untuk mengakses tabel target (misalnya, itil peran untuk manajemen insiden).

  • Batas waktu koneksi atau instance yang tidak dapat dijangkau — Verifikasi URL Dasar menggunakan nama instance yang benar. ServiceNow Konfirmasikan bahwa ServiceNow instance dapat diakses dan tidak dalam mode pemeliharaan.