External Service

---

AlurKerja menyediakan jalur akses terpusat ke layanan eksternal yang digunakan bersama oleh Studio, App, dan Front End lainnya. Seluruh integrasi dijalankan melalui External Service sebagai proxy, sehingga Front End tidak perlu menangani detail teknis seperti endpoint, header, atau credential. AlurKerja mengelola autentikasi, penyimpanan credential, serta penerusan request ke layanan tujuan secara terpusat, sekaligus memastikan akses yang konsisten melalui aksi yang telah ditentukan. Dengan pendekatan ini, integrasi menjadi lebih aman, mudah dikelola dan tetap fleksibel untuk dikembangkan seiring bertambahnya kebutuhan Front End.

---

Mengakses Keamanan Multi Front End

1. Login ke AlurKerja On Premise, lalu buka halaman Studio.

2. Akses menu External Services untuk melihat daftar layanan eksternal yang sudah ada.

   

3. Pastikan service yang dibutuhkan sudah tersedia dan berstatus Active agar bisa digunakan oleh Studio, App atau Front End lainnya.

Membuat Keamanan Multi Front End

1. Klik Add New pada halaman External Service.

   

2. Isi Basic Information.

   
   • Service Name : Nama layanan.
   • Slug : Kode unik sebagai identitas layanan yang akan dipakai sistem saat layanan dipanggil.
   • Description : Ringkasan fungsi service dan konteks penggunaanya.
   • Target URL : Alamat API Eksternal yang menjadi tujuan integrasi.
   • Base Path : Jalur dasar yang akan digunakan sebagai prefix endpoint saat dipanggil melalui proxy.
   • Proxy Type : Menentukan pola akses proxy, apakah bebas (Non-Set Action) atau terkontrol berbasis aksi (Set Action).
   • Status : Mengaktifkan atau menonaktifkan service, hanya service berstatus aktif yang dapat digunakan oleh Front End.

3. Masuk ke tab Aunthentication, lalu pilih metode autentikasi yang sesuai kebutuhan layanan eksternal. Setelah dipilih, sistem akan menampilkan Aunthentication Configuration yang perlu diisi.

   • None : Digunakan jika layanan eksternal tidak memerlukan autentikasi.

     

   • Basic Auth : Menggunakan username dan password untuk autentikasi dasar.

     

   • Bearer Token : Menggunakan token akses yang dikirim melalui header Authorization.

     

   • API Key : Menggunakan API Key yang dikirim melalui header atau query parameter.

     

   • Custom Headers : Digunakan jika layanan eksternal membutuhkan header autentikasi khusus.

     

   • OAuth Refresh Token : Digunakan untuk layanan berbasis OAuth 2.0, di mana AlurKerja akan mengelola refresh token secara otomatis.

     

4. Klik Create Service untuk menyimpan External Service.

Mengelola Keamanan Multi Front End

1. Pada daftar External Service, klik ikon View untuk membuka konfigurasi service.

   

2. Pada halaman detail, salin Output URL yang disediakan. Endpoint ini adalah jalur yang harus dipakai oleh Studio, App dan Front End lainnya untuk mengakses layanan eksternal melalui AlurKerja.

   

3. Jika Anda perlu mengubah konfigurasi service, klik ikon Edit untuk memperbarui Basic Information dan tab Aunthentication.

   

4. Untuk menghentikan akses layanan eksternal, ubah Status service menjadi Inactive.