Mengonfigurasi instance Workday untuk replikasi data

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.

Dokumen ini menjelaskan cara mengonfigurasi Datastream untuk melakukan streaming data dari instance Workday ke tujuan yang didukung, seperti BigQuery atau Cloud Storage.

Sebelum memulai

Sebelum mulai mengonfigurasi Workday untuk digunakan dengan Datastream, Anda harus:

• Memiliki akses ke instance Workday yang aktif.
• Memiliki pengetahuan tentang cara menavigasi dan mengubah setelan di Workday.
• Memiliki pengetahuan tentang cara membuat pengguna sistem integrasi dan grup keamanan di Workday.

Mengonfigurasi instance Workday untuk digunakan dengan Datastream

Untuk membuat koneksi antara instance Workday dan Datastream, Anda harus memberikan nama host dan nama tenant instance, serta kredensial klien OAuth 2.0, seperti client ID, rahasia klien, dan token refresh saat Anda membuat profil koneksi Workday.

Mengidentifikasi nama host dan nama tenant

Anda dapat menemukan nama host dan nama tenant instance Workday dengan salah satu cara berikut:

• Menggunakan alamat URL login Anda. Nama host dan nama tenant adalah bagian dari alamat URL instance yang Anda gunakan untuk login ke Workday. Misalnya, jika URL login Anda adalah https://wd5-impl.workday.com/google/d/home.html, maka bagian wd5-impl.workday.com adalah nama host, dan nama pendek atau alias instance Anda yang muncul segera setelah nama host di URL adalah nama tenant (dalam hal ini, google).

• Menggunakan detail klien API terdaftar Anda. Jika telah mendaftarkan klien API, Anda dapat mengambil informasi ini langsung dari alamat URL endpoint REST:

  1. Di Workday, cari dan pilih tugas View API Client.
  2. Di bagian Client Details, temukan kolom Workday REST API Endpoint, misalnya: https://wd2-impl-services1.workday.com/ccx/api/v1/mytenant.

  3. Temukan kredensial Anda:

     • Nama host adalah bagian domain dari URL, misalnya, wd2-impl-services1.workday.com.
     • Nama tenant adalah segmen jalur terakhir URL setelah /v1/ (misalnya, mytenant).

Untuk mengetahui informasi selengkapnya tentang cara menemukan endpoint API, lihat Workday APIs dokumentasi.

Mengonfigurasi pengguna dan grup keamanan

Untuk melakukan streaming data dari Workday, Anda harus mengonfigurasi Pengguna Sistem Integrasi (ISU) khusus, menetapkannya ke grup keamanan yang tidak dibatasi, dan memberikan izin domain yang diperlukan kepada grup tersebut.

Membuat Pengguna Sistem Integrasi (ISU)

1. Di kotak penelusuran Workday, cari dan pilih tugas Create Integration System User.

2. Konfigurasikan akun ISU:

   1. Masukkan nama pengguna, misalnya, datastream_isu.
   2. Buat sandi yang aman.
   3. Masukkan 0 (tanpa batas waktu) di kolom Session Timeout Minutes.
   4. Hapus centang pada kotak Do Not Allow UI Sessions.
   Catatan: Anda harus mengizinkan sesi UI pada awalnya untuk ISU agar dapat mengautentikasi dan mengotorisasi klien OAuth 2.0. Setelah menyelesaikan penyiapan dan membuat token refresh, sebaiknya centang kotak ini untuk keamanan.

3. Klik OK, lalu klik Done.

Membuat Grup Keamanan Sistem Integrasi

1. Cari dan pilih tugas Create Security Group.

2. Konfigurasikan opsi grup keamanan:

   1. Dari menu drop-down Type of Tenanted Security Group, pilih Integration System Security Group (Unconstrained).
   2. Di kolom Name, masukkan nama untuk grup keamanan, misalnya, datastream_sg.

3. Klik OK.

4. Di halaman berikutnya, di kolom Integration System Users, cari dan pilih ISU yang Anda buat pada langkah sebelumnya.

5. Klik OK.

Memberikan izin Kebijakan Keamanan Domain

Untuk memastikan cakupan penuh domain data standar, Anda harus memberikan izin Get Only grup keamanan untuk domain Workday yang diperlukan:

1. Dari halaman detail grup keamanan, klik ikon elipsis Related Actions (...) di samping nama grup keamanan.
2. Buka Security Group > Maintain Domain Permissions for Security Group.

3. Di tabel Domain Security Policy Permissions, tambahkan domain berikut:

   • Worker Data: Public Worker Reports
   • Workday Usage Metrics
   • Manage: Organization Integration
   • Worker Data: All Positions
   • Job Requisition Data
   • Manage: Evergreen Requisitions
   • Special OX Web Services
   • Prospects
   • Candidate Data: Job Application
   • Worker Data: Skills and Experience
   • Payroll Interface
   • Job Information
   • Staffing Organizations: Header
   • Staffing Organizations: Company
   • Staffing Organizations: Region
   • Staffing Organizations: Business Unit
   • Staffing Organizations: Custom Organization

4. Untuk setiap domain yang ditambahkan, centang kotak di kolom akses Get Only.

5. Klik OK, lalu klik Done.

Mengecualikan ISU dari masa berlaku sandi

Untuk mencegah gangguan streaming karena sandi yang masa berlakunya sudah berakhir, kecualikan ISU dari aturan masa berlaku sandi standar tenant Anda:

1. Cari dan pilih tugas Maintain Password Rules.
2. Di kolom System Users exempt from password expiration, tambahkan ISU yang Anda buat.
3. Klik OK, lalu klik Done.

Mengaktifkan perubahan kebijakan keamanan

Pastikan Anda mengaktifkan perubahan izin domain secara eksplisit, jika tidak, perubahan tersebut tidak akan berlaku:

1. Cari dan pilih tugas Activate Pending Security Policy Changes.
2. Di kolom Comment, masukkan deskripsi untuk perubahan tersebut, misalnya, Grant permissions for Datastream Workday integration.
3. Klik OK.
4. Di halaman konfirmasi, centang kotak Confirm.
5. Klik OK untuk mengaktifkan perubahan.

Membuat dan menyiapkan klien API

Gunakan tugas berikut di Workday untuk membuat kredensial yang diperlukan untuk profil koneksi Datastream Anda.

Mendaftarkan klien API

1. Di kotak penelusuran Workday, cari dan pilih tugas Register API Client for Integrations.

2. Konfigurasikan klien API:

   1. Masukkan nama untuk integrasi Datastream Anda.
   2. Di bagian Client Grant Type, pilih Authorization Code Grant.
   3. Di bagian Access Token Type, pilih Bearer.
   4. Centang kotak Enforce Customized Access Token Expiry, lalu tentukan waktu habis masa berlaku pilihan Anda.

   5. Secara opsional, centang kotak Non-expiring refresh tokens untuk mencegah gangguan koneksi.

      Catatan: Jika kebijakan keamanan organisasi Anda mengharuskan token refresh berakhir masa berlakunya, Anda harus memperbarui token refresh secara manual di profil koneksi Datastream sebelum atau segera setelah masa berlakunya berakhir.

   6. Di bagian Scopes, sebaiknya sertakan area fungsional berikut untuk memastikan cakupan penuh domain data standar:

      • Implementation
      • Jobs & Positions
      • Organizations and Roles
      • Payroll Interface
      • Pre-Hire Process
      • Recruiting
      • Staffing
      • System
      • Talent Pipeline

      Cakupan yang diperlukan bergantung pada endpoint tempat Anda ingin melakukan streaming data.

   7. Centang kotak Include Workday owned scope.

3. Klik OK.

4. Salin dan simpan client ID dan rahasia klien yang dibuat. Anda memerlukan kredensial ini untuk membuat profil koneksi Datastream.

Mengelola token refresh untuk integrasi

1. Setelah mendaftarkan klien, klik ikon elipsis (...) di samping nama klien, lalu pilih Manage Refresh Tokens for Integrations.
2. Pilih Pengguna Sistem Integrasi (ISU) yang Anda buat sebelumnya.

3. Klik Generate New Refresh Token.

   Catatan: Sebaiknya buat token refresh yang tidak habis masa berlakunya. Jika kebijakan keamanan organisasi Anda mengharuskan token berakhir masa berlakunya, Anda harus memperbarui token refresh secara manual di profil koneksi Datastream setiap kali masa berlakunya berakhir.
   Penting: Salin dan simpan token refresh segera, karena hanya ditampilkan satu kali.

Mengedit grup keamanan klien API

1. Untuk memastikan klien API dapat digunakan oleh ISU Anda, cari tugas Edit API Client.
2. Pilih klien terdaftar Anda dan buka setelan keamanan.
3. Tambahkan Grup Keamanan Sistem Integrasi yang terkait dengan ISU Anda ke daftar grup keamanan yang diizinkan untuk klien ini.

Melihat klien API

1. Untuk mengambil client ID dan rahasia klien, cari tugas View API Client atau buka halaman detail klien API.
2. Di bagian Client Details, temukan dan salin Client ID.
3. Klik Manage Consumer Details untuk melihat dan menyalin Client Secret.

Langkah berikutnya

• Pelajari lebih lanjut sumber Workday.