Quickstart

Panduan ringkas untuk mengonfigurasi Monago sebagai governance gateway dan mengirim permintaan pertama.

Prasyarat: peran admin di tenant Monago dan akun aktif di penyedia AI yang ingin diintegrasikan.

Tip

Untuk konfigurasi end-to-end termasuk acquisition kredensial, rotasi, troubleshooting, dan FAQ, lihat BYOK guide.

Langkah 1 — Memperoleh kunci API dari penyedia

Pilih satu atau lebih penyedia AI.

OpenAI

Login

Buat secret key

Akses Settings → API keys → Create new secret key.

Tentukan scope minimum

Pilih scope yang dibutuhkan oleh integrasi Anda, misalnya model.read dan chat.completions:write. Prinsip least-privilege berlaku.

Salin plaintext kunci

Format sk-… atau sk-proj-….

Anthropic

Login

Buat kunci

Akses Settings → API keys → Create Key.

Salin plaintext kunci

Format sk-ant-….

Kredensial AWS Bedrock dapat didaftarkan di Monago saat ini. Pemrosesan permintaan inference melalui Bedrock akan tersedia di rilis berikutnya. Hubungi tim Monago untuk diskusi timeline bila Bedrock menjadi penyedia utama Anda.

Akses IAM

AWS Console → IAM → Users → Create access key.

Tetapkan permission

Berikan permission minimum: bedrock:InvokeModel dan bedrock:InvokeModelWithResponseStream.

Catat kredensial dan region

Simpan Access Key ID, Secret Access Key, dan region (misalnya Singapore ap-southeast-1).

Simpan plaintext kunci pada password manager Anda untuk digunakan pada Langkah 2.

Langkah 2 — Mendaftarkan kredensial di Monago

Login sebagai admin

Buka menu Penyedia AI

Pilih Penyedia AI dari sidebar.

Tambahkan penyedia

Klik Tambah penyedia di kanan atas.

Isi formulir

Penyedia: OpenAI, Anthropic, atau AWS Bedrock.
Nama kredensial: label internal, misalnya production-openai.
Kunci API: plaintext dari Langkah 1.
Base URL (opsional): bila Anda menggunakan endpoint penyedia di belakang gateway internal.

Submit

Klik Tambah kredensial.

Monago memvalidasi kunci terhadap endpoint metadata penyedia dengan batas waktu singkat. Indikator "Memvalidasi kunci…" ditampilkan selama proses berlangsung.

Dialog tampil-sekali (penting)

Setelah validasi berhasil, dialog tampil-sekali (show-once) menampilkan plaintext kunci.

Plaintext ditampilkan sekali

Banner peringatan menjelaskan bahwa kunci hanya ditampilkan pada saat ini.

Salin

Klik Salin; indikator Tersalin muncul sesaat.

Simpan ke password manager

Tempelkan plaintext pada password manager atau secret vault internal Anda.

Konfirmasi

Centang konfirmasi "Saya sudah menyalin kunci API."

Tutup

Klik Sudah disimpan, tutup.

Warning

Setelah dialog ditutup, plaintext tidak lagi dapat dilihat melalui product workflow. Pemulihan akses dilakukan dengan melakukan rotasi kredensial. Tabel hanya menampilkan empat karakter terakhir kunci (sk-…-XXXX).

Langkah 3 — Mengirim permintaan melalui Monago

curl -X POST https://gateway.monago.io/v1/chat/completions \
  -H "Authorization: Bearer $MONAGO_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "Halo!"}]
  }'

Monago akan:

Mengidentifikasi kredensial aktif untuk tenant + penyedia yang relevan.
Mendekripsi kunci hanya untuk durasi pemrosesan permintaan.
Meneruskan permintaan ke penyedia menggunakan kunci pelanggan.
Mencatat audit log dengan integritas terjamin secara kriptografis.
Menerapkan policy enforcement, deteksi PII, dan risk scoring.
Mengembalikan respons ke aplikasi pelanggan.

Konfigurasi selesai. Monago sekarang aktif sebagai governance gateway dengan model BYOK.

Langkah berikutnya

Topik	Dokumen
Rotasi kunci, troubleshooting, FAQ	BYOK guide
Policy enforcement DSL	Dashboard → Policies
Audit trail + observability	Dashboard → Observability
Compliance posture	Dashboard → Compliance

Troubleshooting ringkas

"Kunci API tidak valid"

Periksa whitespace pada saat copy-paste (spasi atau newline di awal atau akhir).
Verifikasi kunci masih aktif di dashboard penyedia.
Periksa status billing akun penyedia.

"Nama kredensial sudah digunakan"

Setiap kombinasi tenant + penyedia membutuhkan nama unik. Konvensi yang direkomendasikan: production-openai-v2, staging-openai.

Permintaan gateway gagal setelah kredensial dinonaktifkan

Perilaku yang diharapkan. Saat kredensial dinonaktifkan, deployment cloud akan menggunakan kunci default platform bila administrator deployment telah mengonfigurasinya. Pada deployment on-premise, permintaan dikembalikan dengan error konfigurasi karena tidak ada fallback. Solusi: aktifkan kembali kredensial melalui UI.

Detail lebih lanjut: BYOK guide — Troubleshooting.