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

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

Untuk mendaftarkan aplikasi OAuth, selesaikan langkah-langkah berikut.

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

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

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

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 (kredensyal klien)
<a name="servicenow-oauth-client-credentials"></a>

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](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 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`

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 aplikasi OAuth Anda di **System OAuth > Application Registry**.** Tambahkan bidang **Pengguna Aplikasi OAuth** ke formulir jika tidak terlihat (gunakan **Configure** > **Form Builder** untuk menambahkannya).

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

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

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

1. Pilih tab **Buat untuk tim Anda**.

1. Temukan dan pilih **ServiceNow**.

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 **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`

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

1. Pilih **Buat dan lanjutkan**.

1. Pilih pengguna untuk berbagi integrasi dengan.

1. Pilih **Berikutnya**.

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

## 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 (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
<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. Server-side aturan bisnis, ACL, 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>
+ **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 ke`true`. Konfirmasikan bidang **Pengguna Aplikasi OAuth** diisi pada catatan registri aplikasi.

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