Instal WSO2 Api Manager di Server Ubuntu

Sebelum memulai ada baiknya kita berkenalan dahulu dengan WSO2 API Manager yang bisa dilihat di blog saya di Manfaat WSO2 API Manager: Pilihan Terbaik untuk Mengelola API, untuk artikel kali ini kita akan mencoba menginstall WSO2 APIM terbaru versi 4.4.0 (saat artikel ini dibuat) di server ubuntu.

Persiapan Awal

Spesifikasi server vps yang digunakan untuk tutorial ini adalah sebagai berikut:

1. 4 GB Ram
2. 2 Core Cpu
3. 40 Gb Disk Space
4. OS Ubuntu 24.04 LTS+
5. Domain

Untuk OS sebenarnya kita bisa menggunakan versi 20.04 tapi untuk contoh kali ini kita menggunakan OS Ubuntu yang terbaru versi 24.04, selain itu server kita perlu juga domain agar memudahkan mengaksesnya tanpa perlu menggunakan ip address server untuk mengaksesnya, apabila tidak punya domain kita bisa mengaksesnya lewat ip address saja sudah cukup.

Sebelum Memulai

Salah satu requirement untuk menjalankan WSO APIM adalah terinstallnya JAVA di system, secara default java belum terinstall di server, oleh karena mari kita coba install java terlebih dahulu.

• Pertama update apt index dengan:

sudo apt update

• Jalankan perintah berikut untuk menginstall default java di ubuntu 24.04:

sudo apt install default-jdk

• Pastikan java telah terinstall dengan perintah berikut:

java -version

di terminal akan tampil versi yang telah terinstall.

openjdk version "21.0.6" 2025-01-21
OpenJDK Runtime Environment (build 21.0.6+7-Ubuntu-124.04.1)
OpenJDK 64-Bit Server VM (build 21.0.6+7-Ubuntu-124.04.1, mixed mode, sharing)

• Setelah sukses install java, saatnya menambahkan environment JAVA_HOME agar wso2 apim mengenalinya.

sudo vim /etc/environment

• Sekarang kita perlu menambahkan JAVA_HOME dengan path java di line akhir /etc/environment :

JAVA_HOME="/usr/lib/jvm/java-21-openjdk-amd64"

• Untuk menerapkan perubahan, jalankan 2 perintah berikut untuk mengeceknya.

source /etc/environment
echo $JAVA_HOME

Setelah berhasil menambahkan java, langkah selanjutnya adalah mengkonfigurasi sertifikat Java Keystore(JKS) agar saat mengakses wso2 api manager tidak keluar tampilan “Cannot establish a secure connection”

Apabila wso2 apim akan menggunakan ip address saat mengaksesnya bisa lewati bagian ini.

Siapkan sertifikat yang didapatkan dari provider sertifikat seperti geotrust, comodo atau yang gratis seperti lets encrypt. Untuk contoh kali ini kita menggunakan sertifikat dari lets encrypt, jangan lupa install terlebih dahulu openssl dan keytool.

• Buat file PKCS12/PFX dari sertifikat lets encrypt yang didapat dengan perintah dibawah ini:

openssl pkcs12 -export -in fullchain.pem -inkey privkey.pem -out certserver.p12 -name wso2api

saat ditanyakan password, masukkan password untuk file PKCS12 ini, misalnya

IniCert2025

• Rubah file PKCS12 menjadi sertifikat Java Keystore(JKS) dengan perintah berikut:

keytool -importkeystore -srckeystore certserver.p12 -srcstoretype pkcs12 -destkeystore wso2api.jks -deststoretype JKS

isi password dengan password sebelumnya, file wso2api.jks akan terbuat, simpan dan catat password yang tadi masukkan.

Instalasi WSO2 Api Manager

Download wso2 api manager di WSO2 API Manager website, atau bisa juga download di WSO2 API Manager github, utamakan download di website wso2 langsung, dikarenakan ada tools update apabila nanti kita berlangganan/ subscribe.

• Ekstrak file hasil download, folder wso2am-4.*.0 kita tandai sebagai home/parent folder atau
• Kopi file sertifikat wso2api.jks ke folder dibawah ini, abaikan apabila akses wso2 menggunakan ip address.

<APIM_HOME>/repository/resources/security/

Selanjutnya kita akan mengkonfigurasi wso2 api manager, apabila kita tidak mengkonfigurasinya, secara default url-nya menjadi localhost sehingga tidak bisa diakses dari luar.

• Buka file konfigurasi wso2 api manager dengan perintah:

vim <APIM_HOME>/repository/conf/deployment.toml

• Rubah bagian hostname dengan domain atau ip address server.

[server]
hostname = "agusmerdeko.com"

• Ganti username dan password default admin.

[super_admin]
username = "wsadmin"
password = "wsadmin123"

• Sesuaikan data sertifikat, dengan setifikat JKS yang sebelumnya dibuat.

[keystore.tls]
file_name = "wso2api.jks"
type = "JKS"
password = "IniCert2025"
alias = "wso2api"
key_password = "IniCert2025"

• Dibagian gateway sesuaikan http_endpoint dengan domain atau ip address server.

[[apim.gateway.environment]]
http_endpoint = "http://agusmerdeko.com:${http.nio.port}"
https_endpoint = "https://agusmerdeko.com:${https.nio.port}"

• Simpan file konfigurasi.

Konfigurasi sudah selesai, saatnya untuk menjalankan wso2 api manager, ikuti langkah dibawah ini untuk memulai.

• Masuk ke folder bin dengan perintah berikut:

cd <APIM_HOME>/bin

• Selanjutnya jalankan perintah dibawah ini untuk menjalankan server.

sh api-manager.sh

• Ketika menjalankan wso2 apim, kita bisa melihat url domain atau ip address tampil di log, apabila sampai bagian ini tidak ada error, maka wso2 apim siap untuk diakses dan digunakan.

• Saatnya untuk mengakses halaman wso2 apim, untuk kali ini kita coba akses publisher dengan default port 9443.

https://agusmerdeko.com:9443/publisher

apabila menggunakan ip address keluar error masalah sertifikat, abaikan saja karena kita sebelumnya tidak memasang sertifikat untuk ip address.

• Login menggunakan username password yang sebelumnya kita ubah di konfigurasi deployment.toml, setelah berhasil login, akan tampil halaman publisher dan kita telah berhasil install di server.

Dengan mengikuti panduan instalasi ini, kita telah berhasil menginstal WSO2 APIM 4.4.0 dan siap untuk mengelola API dengan WSO2 API Manager. Apabila ada pertanyaan atau ada yang kurang dimengerti, silahkan komentar di kolom komentar. Sampai jumpa di artikel selanjutnya.