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

# ServiceNow integrasi
<a name="servicenow-integration"></a>

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](https://docs.servicenow.com/bundle/xanadu-api-reference/page/build/applications/concept/api-rest.html) 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, lihat[Metode otentikasi](quick-action-auth.md).

## Sebelum Anda mulai
<a name="servicenow-integration-prerequisites"></a>

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, lihat[Siapkan integrasi di konsol](integration-console-setup-process.md).

## Konfigurasikan ServiceNow OAuth
<a name="servicenow-oauth-setup"></a>

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](https://www.servicenow.com/docs/bundle/xanadu-platform-security/page/administer/security/task/t_CreateEndpointforExternalClients.html) dalam ServiceNow dokumentasi.

### Daftarkan OAuth aplikasi
<a name="servicenow-oauth-app-registration"></a>

Untuk mendaftarkan OAuth aplikasi, selesaikan langkah-langkah berikut.

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

1. Pilih **Buat titik akhir OAuth API untuk klien eksternal**.

1. Lengkapi formulir:
   + **Nama — Nama** deskriptif untuk OAuth aplikasi.
   + **URL pengalihan** - `https://{region}.quicksight.aws.amazon.com/sn/oauthcallback`

     Ganti *\$1region\$1* dengan AWS Wilayah Anda (misalnya,`us-east-1`).

1. Pilih **Kirim**.

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

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

### Langkah-langkah tambahan untuk otentikasi layanan (kredensi klien)
<a name="servicenow-oauth-client-credentials"></a>

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](https://www.servicenow.com/community/developer-blog/up-your-oauth2-0-game-inbound-client-credentials-with-washington/ba-p/2816891). 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`

1. 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`

1. 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).

1. 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
<a name="servicenow-action-integration-setup"></a>

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

1. Di konsol Amazon Quick, pilih **Integrasi.**

1. Pilih **ServiceNow**dan pilih tombol Tambah (plus “\$1”).

1. Masukkan detail integrasi:
   + **Nama — Nama** deskriptif untuk ServiceNow integrasi Anda.
   + **Deskripsi** (Opsional) — Tujuan integrasi.

1. 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`

   1. 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`

1. Pilih **Buat dan lanjutkan**.

1. Pilih pengguna untuk berbagi integrasi dengan.

1. Pilih **Berikutnya**.

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

## Tindakan yang tersedia
<a name="servicenow-integration-actions"></a>

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\$1km\$1api). | 
| 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\$1choice. | 

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

## Batasan
<a name="servicenow-integration-limitations"></a>

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](https://docs.servicenow.com/bundle/xanadu-api-reference/page/integrate/inbound-rest/concept/c_RESTAPI.html) dalam ServiceNow dokumentasi.

## Kelola dan pecahkan masalah
<a name="servicenow-integration-troubleshooting"></a>

Untuk mengedit, membagikan, atau menghapus integrasi Anda, lihat[Mengelola integrasi yang ada](integration-workflows.md#managing-existing-integrations).

### Masalah otentikasi
<a name="servicenow-troubleshooting-auth"></a>
+ **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 ke`true`. Konfirmasikan bidang **Pengguna OAuth Aplikasi** diisi pada catatan registri aplikasi.

### Pesan kesalahan umum
<a name="servicenow-troubleshooting-errors"></a>
+ **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.