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 OAuth aplikasi dalam ServiceNow instans Anda. Kemudian, Anda membuat integrasi di Amazon Quick dan menghubungkannya ke ServiceNow aplikasi Anda. Untuk informasi tentang metode otentikasi yang didukung Amazon Quick, lihatMetode otentikasi.

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 OAuth aplikasi (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 OAuth aplikasi di ServiceNow instans Anda. 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 OAuth aplikasi

Untuk mendaftarkan OAuth aplikasi, selesaikan langkah-langkah berikut.

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

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

  3. Lengkapi formulir:

    • Nama — Nama deskriptif untuk OAuth aplikasi.

    • 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 (kredensi klien)

Jika Anda berencana untuk menggunakan otentikasi layanan, selesaikan langkah-langkah tambahan ini setelah mendaftarkan OAuth aplikasi. Jenis hibah kredensial 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 kredensial 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 OAuth aplikasi Anda di System OAuth > Application Registry. Tambahkan bidang Pengguna OAuth Aplikasi ke formulir jika tidak terlihat (gunakan Configure > Form Builder untuk menambahkannya).

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

penting

Dengan otentikasi layanan, semua tindakan dijalankan sebagai pengguna OAuth aplikasi 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 ServiceNow OAuth konfigurasi, buat integrasi di Amazon Quick.

  1. Di konsol Amazon Quick, pilih Integrasi.

  2. Pilih ServiceNowdan pilih tombol Tambah (plus “+”).

  3. Masukkan detail integrasi:

    • Nama — Nama deskriptif untuk ServiceNow integrasi Anda.

    • Deskripsi (Opsional) — Tujuan integrasi.

  4. Pilih jenis koneksi Anda dan isi pengaturan koneksi:

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

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

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

      • Rahasia Klien — Rahasia klien dari ServiceNow OAuth aplikasi 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

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

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

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

  5. Pilih Buat dan lanjutkan.

  6. Pilih pengguna untuk berbagi integrasi dengan.

  7. Pilih Berikutnya.

Untuk otentikasi pengguna, navigasikan ke Integrasi > Tindakan > nama ServiceNow integrasi Anda, dan pilih Masuk untuk menyelesaikan alur OAuth otorisasi.

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 yang disetujui dan didukung (CIs).
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 Basis Pengetahuan Buat artikel basis pengetahuan. Membutuhkan plugin Knowledge API (sn_km_api).
Artikel dasar pengetahuan Perbarui Artikel Basis Pengetahuan Memodifikasi artikel basis pengetahuan.
Artikel dasar pengetahuan Hapus Artikel Basis 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. Aturan bisnis sisi server ACLs, 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

  • OAuth otorisasi gagal — Verifikasi bahwa ID Klien dan Rahasia Klien cocok dengan nilai dalam Registri ServiceNow Aplikasi Anda. 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 OAuth Aplikasi diisi pada catatan registri aplikasi.

Pesan kesalahan umum

  • Tindakan mengembalikan kesalahan izin — Verifikasi bahwa ServiceNow pengguna atau pengguna OAuth aplikasi 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.