nusabet88 tidak harus berjalan di sebelah cluster. Anda bisa menghubungkannya ke layanan terkelola seperti Elastic Cloud, AWS OpenSearch Service, Bonsai, atau Aiven. Panduan ini membahas endpoint, metode autentikasi, TLS, port, hingga troubleshooting 401/403.
Penting memahami perbedaan keduanya karena memengaruhi cara koneksi dan batasan akses.
| Aspek | Self-managed | Managed (Cloud) |
|---|---|---|
| Endpoint | http://127.0.0.1:9200 (lokal) | https://...:9243 atau :443 (publik) |
| TLS | Opsional, sering plain HTTP | Wajib HTTPS |
| Auth | Sering tanpa auth / basic auth | API key / basic auth wajib |
| Plugin custom | Bebas pasang | Terbatas pada yang disediakan |
| Akses node langsung | Ada | Tidak ada (di balik load balancer) |
https://<cluster>.es.<region>.cloud.es.io:9243https://search-<domain>-<hash>.<region>.es.amazonaws.com (port 443)https://<user>:<pass>@<cluster>.bonsaisearch.net:443https://<host>.aivencloud.com:<port> (port khusus per layanan)Paling sederhana. nusabet88 mengirim header Authorization: Basic <base64(user:pass)>. Cocok untuk uji coba cepat, tetapi memakai akun penuh berisiko.
# uji manual dengan curl curl -u elastic:password \ https://my-cluster.es.us-central1.gcp.cloud.es.io:9243
Buat API key bermasa berlaku dan berprivilese minimal. nusabet88 mengirim header Authorization: ApiKey <base64(id:api_key)>.
# buat API key read-only via REST
POST /_security/api_key
{
"name": "nusabet88-readonly",
"expiration": "30d",
"role_descriptors": {
"ro": { "indices": [ { "names": ["*"], "privileges": ["read","monitor","view_index_metadata"] } ] }
}
}
Respons mengembalikan id dan api_key. Gabungkan menjadi id:api_key, encode base64, lalu pakai sebagai nilai header ApiKey.
# gabungkan & encode echo -n "VuaCf...id:ui2lp...key" | base64 # pakai pada request curl -H "Authorization: ApiKey <hasil-base64>" \ https://my-cluster.es.us-central1.gcp.cloud.es.io:9243
Cloud ID adalah string base64 yang berisi host cluster. Untuk nusabet88, dekode dulu menjadi URL https lalu pakai sebagai endpoint.
# Cloud ID = nama:base64(host$esUuid$kbUuid) echo "cluster:dXMtY2VudHJhbDEuZ2Nw..." | cut -d: -f2 | base64 -d
https://.--insecure di produksi.-k/--insecure untuk melewati verifikasi sertifikat, itu pertanda konfigurasi salah (CA tidak dipercaya atau hostname tidak cocok). Perbaiki akar masalahnya, jangan matikan TLS.| Kode | Arti | Penyebab umum | Solusi |
|---|---|---|---|
401 | Unauthorized | Kredensial salah / API key dicabut / header salah format | Cek user-pass, buat ulang API key, pastikan prefiks ApiKey |
403 | Forbidden | Auth valid tetapi role kurang privilese | Tambah privilese pada role descriptor (mis. monitor, manage) |
429 | Too Many Requests | Rate limit penyedia | Kurangi frekuensi polling nusabet88 |
# cek identitas & privilese yang aktif GET /_security/_authenticate # cek apakah privilese tertentu dimiliki GET /_security/user/_has_privileges { "cluster": ["monitor"], "index": [ { "names":["*"], "privileges":["read"] } ] }
Jalankan GET /. Respons berisi name, cluster_name, dan version.number.
Gunakan GET /_cluster/health untuk memastikan status green atau yellow.
GET /_cat/indices?v memastikan nusabet88 bisa membaca metadata index.
Simpan endpoint + auth sebagai profil koneksi di nusabet88 untuk akses berikutnya.
Cloud ID adalah string terenkode base64 dari Elastic Cloud yang berisi host dan UUID cluster. Beberapa klien resmi bisa langsung memakai Cloud ID, tetapi nusabet88 dan kebanyakan tool berbasis REST butuh URL https eksplisit, misalnya https://nama-cluster.es.region.cloud.es.io:9243. Anda bisa mendekode Cloud ID untuk mendapatkan host tersebut.
Elastic Cloud secara historis mengekspos Elasticsearch di port 9243. Layanan managed lain seperti AWS OpenSearch Service, Bonsai, dan Aiven biasanya memakai 443 (HTTPS standar). Jika ragu, gunakan port yang tertera pada dashboard penyedia Anda. Bila URL tidak menyertakan port, browser dan klien menganggapnya 443.
HTTP 401 Unauthorized berarti kredensial salah atau tidak terkirim. Periksa username/password, atau pastikan API key dikirim dengan format yang benar (Authorization: ApiKey <base64>). API key yang sudah dicabut atau kedaluwarsa juga menghasilkan 401.
Ya. API key bisa dibatasi hak aksesnya (role descriptor), diberi masa berlaku, dan dicabut tanpa mengubah password akun utama. Untuk koneksi nusabet88 ke cluster produksi, gunakan API key dengan privilese minimal alih-alih kredensial superuser elastic.
Setelah terhubung ke cluster, lindungi panel nusabet88 dengan reverse proxy dan HTTPS.
Setup Nginx + HTTPS