Belajar Secret Management - Pre-Requisites Skill & Setup Environment

#Pendahuluan

Selamat datang di series Belajar Secret Management dengan OpenBao! Series ini akan membawa kalian menguasai OpenBao — fork open-source dari HashiCorp Vault yang dikelola komunitas di bawah Linux Foundation — mulai dari konsep secret management dasar hingga arsitektur production-grade. Total ada 21 episode yang membangun pemahaman kalian lapis demi lapis: setup environment, arsitektur dan unsealing, KV secrets engine, dynamic database credentials, transit encryption, PKI, policies, authentication, hingga integrasi Kubernetes, CI/CD, dan high availability.

Tapi sebelum menulis secret pertama, ada beberapa skill dasar dan tools yang wajib kalian siapkan. Mengapa prasyarat ini penting? Karena OpenBao bukan sekadar perintah yang diketik — dia adalah service kriptografi yang berjalan di server, berbicara melalui REST API, dan bergantung pada pemahaman yang benar tentang kunci, enkripsi, dan token. Kalau fondasinya belum siap, error seperti permission denied atau token expired akan terasa seperti teka-teki tanpa ujung.

Episode 0 ini adalah peta jalannya: kita menyiapkan skill dasar, melengkapi tools, lalu menjalankan server OpenBao pertama yang akan kalian pakai sepanjang series.

#Apa itu Secret Management

Secret management adalah disiplin mengelola informasi sensitif — password, API keys, token, dan sertifikat — secara terpusat, aman, dan dengan kontrol akses yang ketat. Tanpa secret management, kredensial biasanya menumpuk di file konfigurasi, environment variables yang di-hardcode, atau chat grup tim — tiga tempat yang paling sering bocor.

OpenBao menjawab masalah ini dengan menyediakan satu titik pusat tempat secrets disimpan terenkripsi, diakses melalui API, dan dikontrol dengan policy. Sepanjang series ini kalian akan melihat bagaimana OpenBao mengelola secrets statis di KV engine, membuat dynamic credentials untuk database, mengenkripsi data dengan transit engine, hingga menerbitkan sertifikat TLS dengan PKI engine.

#Skill Dasar yang Wajib Dimiliki

#Kriptografi: Simetris, Asimetris, dan Hashing

OpenBao dibangun di atas kriptografi, jadi minimal tiga konsep ini harus kalian pahami:

Poin yang paling penting: data secret di OpenBao tidak pernah disimpan dalam bentuk plaintext. Sebelum ditulis ke storage, data selalu dibungkus oleh lapisan enkripsi dari barrier. Konsep inilah yang akan kalian dalami di episode 2.

#REST API dan JSON

Seluruh interaksi dengan OpenBao, termasuk perintah CLI bao, sebenarnya adalah panggilan HTTP ke REST API. Setiap perintah dipetakan ke endpoint seperti /v1/secret/data/app, dan data dikirim serta diterima dalam format JSON. Kalian tidak perlu menjadi master API untuk mengikuti series ini, tapi memahami bahwa:

• Metode HTTP (GET, PUT, POST, DELETE, LIST) menentukan operasi.
• Response JSON berisi data yang diminta, metadata, dan lease.
• Token dikirim lewat header X-Vault-Token untuk otorisasi.

#Kecakapan CLI Linux

Hampir semua interaksi dengan OpenBao terjadi lewat terminal. Minimal kalian harus nyaman dengan navigasi direktori (pwd, ls, cd), membaca manual (man), dan menjalankan perintah dengan sudo. CLI bao adalah alat kerja utama series ini — tidak ada tombol klik untuk sebagian besar operasi.

#Software & Tools yang Disiapkan

Berikut daftar perangkat lunak yang akan kalian pakai sepanjang series:

#Instalasi OpenBao CLI (bao)

#Instalasi di Linux dengan apt/dnf

Distribusi berbasis Debian/Ubuntu dapat memakai package manager apt, dan distribusi berbasis Fedora/RHEL memakai dnf:

sudo apt update && sudo apt install openbao -y
sudo dnf install openbao -y
bao version

Setelah terinstall, jalankan bao version untuk memastikan binary sudah tersedia. Series ini memakai OpenBao 2.x, dan seluruh perintah yang dipakai kompatibel dengan versi tersebut.

#Standalone Binary

Jika distribusi kalian belum memiliki package, unduh standalone binary dari halaman release resmi, lalu ekstrak dan pindahkan ke PATH:

wget https://github.com/openbao/openbao/releases/latest/download/openbao_2.x_linux_amd64.zip
unzip openbao_2.x_linux_amd64.zip
sudo mv bao /usr/local/bin/
bao version

#Instalasi di macOS

Untuk pengguna macOS, Homebrew menyediakan formula resmi:

brew install openbao
bao version

Apapun jalur instalasinya, tujuan akhirnya sama: perintah bao tersedia di terminal kalian.

#Menjalankan OpenBao Server

Setelah CLI terinstall, kalian perlu server. Ada dua mode yang akan dipakai sepanjang series.

#Dev Mode

Dev mode adalah cara tercepat untuk memulai praktik. Server langsung berjalan dengan storage in-memory, sudah unsealed, dan langsung mengembalikan root token di output-nya:

bao server -dev

Perhatikan output terminal: kalian akan melihat Unseal Key dan Root Token yang dicetak ke layar. Token inilah yang akan dipakai sebagai BAO_TOKEN. Dev mode nyaman untuk belajar, tapi jangan pernah dipakai di produksi — semua data hilang saat proses berhenti.

#Production Server dengan Docker

Untuk mensimulasikan environment produksi, gunakan image resmi openbao/openbao:latest:

services:
  openbao:
    image: openbao/openbao:latest
    command: ["server", "-dev"]
    container_name: openbao
    environment:
      - BAO_DEV_ROOT_TOKEN_ID=root
      - BAO_ADDR=http://127.0.0.1:8200
    ports:
      - "8200:8200"
    cap_add:
      - IPC_LOCK

#Konfigurasi Environment CLI

CLI bao membutuhkan dua variabel lingkungan utama agar bisa berbicara dengan server: alamat server dan token. Sediakan di setiap terminal sesi praktik:

export BAO_ADDR="http://127.0.0.1:8200"
export BAO_TOKEN="s.your-root-token-here"
bao status

BAO_ADDR memberi tahu CLI ke mana harus mengirim request; BAO_TOKEN adalah identitas kalian untuk otorisasi. Jika ingin lebih nyaman, tulis kedua variabel ini di file ~/.bashrc atau ~/.zshrc agar otomatis terisi setiap kali membuka terminal baru.

#Mengakses OpenBao Web UI

OpenBao menyediakan antarmuka web untuk melihat dan mengelola secrets secara visual. Setelah server berjalan, buka browser dan arahkan ke http://127.0.0.1:8200/ui:

• Masukkan root token yang tadi disimpan sebagai BAO_TOKEN.
• Jelajahi daftar secrets engines, policies, dan audit devices.
• Lihat cara kerja KV store, dynamic credentials, dan token secara visual.

Web UI bukan pengganti CLI — banyak operasi lanjutan tetap lebih mudah via terminal — tapi UI sangat membantu untuk memverifikasi hasil praktik dengan cepat.

#Verifikasi Lingkungan

Sebelum melanjutkan ke episode berikutnya, pastikan seluruh lingkungan sehat:

bao version
bao status
bao secrets list
echo $BAO_ADDR

bao status akan menampilkan detail seperti Sealed, HA Enabled, dan versi server. Jika semua perintah di atas berjalan tanpa error, lingkungan kalian sudah siap untuk seluruh series.

#Penutup

Di episode 0 ini kalian sudah menyiapkan pijakan untuk seluruh series: memahami skill dasar kriptografi, REST API, JSON, dan CLI Linux yang menjadi fondasi OpenBao; melengkapi tools yang dibutuhkan seperti bao CLI dan server; serta mengkonfigurasi environment BAO_ADDR dan BAO_TOKEN dengan dev mode dan Docker.

Inti yang harus dibawa pulang:

• Secret management adalah keharusan, bukan pilihan — kredensial tersebar di file konfigurasi adalah risiko terbesar.
• Kuasai tiga konsep kriptografi — simetris, asimetris, dan hashing — karena OpenBao dibangun di atasnya.
• CLI bao adalah alat utama kalian — pastikan sudah terinstall dan bao status berjalan tanpa error.
• Setiap sesi praktik butuh BAO_ADDR dan BAO_TOKEN — siapkan selalu sebelum memulai.

Di episode 1 selanjutnya kita akan membahas sejarah fork OpenBao dari HashiCorp Vault dan manifesto Linux Foundation — mulai dari perubahan lisensi yang memicu perpecahan pada Desember 2023, komitmen 100 persen open source dengan lisensi MPL-2.0, hingga mengapa tim DevOps dunia berbondong-bondong memilih OpenBao sebagai secret management modern. Pastikan bao status sudah hijau, karena petualangan Secret Management baru saja dimulai!