Mengonfigurasi instance ServiceNow untuk CDC

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Anda dapat menggunakan Datastream untuk mereplikasi data dari instance ServiceNow ke tujuan yang didukung, seperti BigQuery atau Cloud Storage. Sebelum membuat profil koneksi, Anda menyiapkan pengguna integrasi khusus, mengonfigurasi autentikasi dasar atau OAuth 2.0, dan mengizinkan alamat IP Datastream jika diperlukan.

Sebelum memulai

Sebelum mulai mengonfigurasi ServiceNow untuk digunakan dengan Datastream, pastikan Anda memiliki:

• Instance ServiceNow yang aktif, misalnya, company.service-now.com.
• Hak istimewa administrator pada instance ServiceNow untuk membuat pengguna, menetapkan peran, dan mengelola OAuth Application Registry.
• Pengetahuan tentang versi instance ServiceNow Anda.

Mengonfigurasi pengguna integrasi

Di ServiceNow, Anda dapat membuat pengguna baru atau menyesuaikan setelan untuk akun yang ada guna mengizinkan akses Datastream. Untuk tujuan keamanan dan audit, sebaiknya buat pengguna integrasi khusus.

1. Di ServiceNow, buka User Administration > Users.
2. Untuk membuat pengguna baru, klik Baru. Untuk mengedit pengguna yang ada, telusuri ID Pengguna di daftar pengguna, lalu klik untuk membuka data.

3. Konfigurasikan detail pengguna:

   • Masukkan nama unik di kolom User ID, misalnya, datastream_integration. Anda menetapkan ID pengguna hanya untuk pengguna baru.
   • Jika Anda memilih autentikasi OAuth untuk konektor, sebaiknya masukkan nilai di kolom Nama depan dan Nama belakang untuk mengidentifikasi data pengguna dengan lebih baik.

   • Konfigurasi identitas: berdasarkan versi platform ServiceNow Anda:

     • Xanadu dan yang lebih baru: pilih Machine di drop-down Identity type. Tindakan ini akan otomatis mengaktifkan Akses layanan web saja.
     • Pra-Xanadu: centang kotak Web service access only.

4. Simpan data:

   • Untuk pengguna baru, klik Kirim.
   • Untuk pengguna lama, klik Perbarui.

5. Jika Anda membuat pengguna baru, buka kembali data tersebut. Temukan pengguna dalam daftar, lalu klik ID Pengguna-nya untuk mengakses opsi data.

6. Setel sandi:

   1. Klik Set Password di header formulir.
   2. Masukkan sandi yang kuat, lalu klik Save Password.
   3. Jika Anda menggunakan autentikasi dasar untuk konektor, catat sandinya karena sandi tersebut diperlukan saat mengonfigurasi profil koneksi.

7. Menetapkan izin. Anda harus memberi pengguna integrasi akses baca ke semua tabel yang ingin Anda replikasi. Selain itu, konektor memerlukan izin baca eksplisit untuk tabel metadata sistem sys_db_object, sys_table_rotation, dan sys_dictionary.

Karena sifat peran ServiceNow dan sistem Daftar Kontrol Akses (ACL) yang terperinci, konfigurasi spesifik yang diperlukan untuk memberikan izin ini bersifat spesifik per pelanggan.

• Sebaiknya tetapkan peran snc_read_only kepada pengguna Anda, karena peran ini memastikan sesi pengguna dibatasi secara ketat pada akses hanya baca di seluruh platform.
• Peran admin memberikan akses komprehensif ke semua tabel dalam instance. Jika kebijakan keamanan Anda mengizinkan, menetapkan peran admin adalah metode paling sederhana untuk memastikan akses konektor penuh.

Opsional: Mengonfigurasi kredensial klien OAuth 2.0

OAuth 2.0 adalah metode autentikasi yang paling aman dan direkomendasikan untuk menggunakan konektor ServiceNow dengan Datastream. Mekanisme ini menggunakan Client ID dan Rahasia klien, bukan sandi permanen.

1. Aktifkan plugin OAuth 2.0 untuk instance Anda. Untuk mengetahui informasi selengkapnya, lihat dokumentasi ServiceNow.
2. Pastikan properti sistem com.snc.platform.security.oauth.is.active disetel ke true. Untuk mengetahui informasi selengkapnya, lihat dokumentasi ServiceNow.
3. Pastikan properti sistem glide.oauth.inbound.client.credential.grant_type.enabled disetel ke true. Untuk mengetahui informasi selengkapnya, lihat dokumentasi ServiceNow.

4. Menyiapkan konfigurasi OAuth masuk. Bergantung pada persyaratan keamanan instance, Anda dapat memilih salah satu cakupan konfigurasi OAuth berikut:

   • Cakupan luas: saat menggunakan OAuth dengan cakupan luas, pembawa token mewarisi peran pengguna dan daftar kontrol akses (ACL) terkait.
   • Cakupan autentikasi REST API terperinci: jenis konfigurasi OAuth ini membatasi REST API dan metode tertentu yang diizinkan oleh cakupan, selain peran pengguna dan ACL terkait.

5. Buat data integrasi OAuth. Untuk mengetahui informasi selengkapnya, lihat dokumentasi ServiceNow:

   • Untuk platform versi Zurich dan yang lebih baru
   • Untuk versi platform sebelum Zurich

6. Setelah Anda membuat data integrasi OAuth, konfigurasinya bergantung pada versi platform dan cakupan OAuth:

   • Konfigurasi dengan cakupan luas:

     • Zurich dan yang lebih baru: di bagian Auth scope untuk data integrasi Anda, pastikan tidak ada entri di kolom Auth scope atau Limit authorization to the following APIs, dan kotak centang Allow access only to APIs in selected scope tidak dicentang.
     • Pra-Zurich: di menu drop-down Scope restriction, pilih Broadly scoped dan biarkan daftar Auth scopes kosong.

   • Konfigurasi cakupan Auth REST API terperinci: secara opsional, gunakan cakupan autentikasi untuk lebih membatasi pembawa token ke REST API dan metode tertentu yang diizinkan oleh cakupan. Konektor Datastream hanya memerlukan akses GET ke Table API. Bergantung pada versi platform, lakukan langkah-langkah berikut:

     • Zurich dan yang lebih baru: di bagian Auth scope untuk data integrasi Anda, pilih cakupan otorisasi dan batasi aksesnya ke Table API.

       Catatan: Jika Anda membuat cakupan otorisasi saat mengedit data integrasi, cakupan tersebut memiliki akses ke semua metode API dari Table API secara default. Untuk membatasi akses lebih lanjut hanya ke metode GET, Anda harus mengedit data yang baru dibuat secara manual dengan membuka System Web Services > API Auth Scopes > REST API Auth Scope.

     • Pra-Zurich:

       1. Membatasi akses ke Table API untuk cakupan otorisasi yang dipilih. Untuk mengetahui informasi selengkapnya, lihat dokumentasi ServiceNow.
       2. Tambahkan cakupan di bagian Auth Scopes.
       3. Pilih Securely scoped di kotak Scope Restriction.

Opsional: Mengonfigurasi kontrol akses alamat IP

Jika instance ServiceNow Anda menggunakan Kontrol Akses Alamat IP, Anda harus secara eksplisit mengizinkan alamat IP Datastream.

Langkah-langkah berikut hanya diperlukan jika Anda memiliki aturan kontrol akses alamat IP DENY yang mencakup alamat IP Datastream. Secara default, tidak ada batasan IP untuk akses ke instance.

1. Di ServiceNow, buka System Security > Kontrol Akses Alamat IP.
2. Klik New.
3. Di formulir pembuatan data, terapkan setelan berikut:
   1. Di drop-down Type, pilih Allow.
   2. Di drop-down Direction, pilih Inbound.
   3. Di kolom Range start dan Range end, masukkan alamat IP atau rentang alamat tertentu dari daftar alamat IP Datastream.
   4. Pastikan kotak centang Active dipilih.
4. Klik Kirim.
5. Ulangi langkah-langkah sebelumnya untuk setiap alamat IP dalam daftar alamat Datastream.

Langkah berikutnya

• Pelajari lebih lanjut sumber ServiceNow.