Konektor Sistem / API Internal
Konektor Sistem Internal (tipe integrasi database dan internal) memungkinkan platform DagangBot v3 membaca tabel atau view secara langsung dari database MySQL atau PostgreSQL milik perusahaan Anda. Pendekatan ini menghilangkan kebutuhan bagi tim rekayasa perangkat lunak Anda untuk merancang, mendistribusikan, dan memelihara API penengah (middleware). Dengan mengizinkan mesin DagangBot melakukan pengaksesan basis data secara langsung yang terkontrol dan terisolasi, proses sinkronisasi katalog e-commerce, pembaruan inventaris ketersediaan stok, serta pencernaan dokumen basis pengetahuan RAG (Retrieval-Augmented Generation) dapat berjalan seketika.
Platform menjamin bahwa referensi sumber pengetahuan yang digunakan oleh bot kecerdasan artifisial (AI) dan balasan percakapan selalu mutakhir dan berpatokan pada satu basis kebenaran tunggal (single source of truth). Konektor ini dirancang dengan jaminan keamanan arsitektur baca-saja (read-only) dan dilengkapi perlindungan ketat terhadap ancaman Server-Side Request Forgery (SSRF) serta peretasan injeksi SQL.
Stable1. Ikhtisar & Nilai Bisnis
Mengintegrasikan sistem database perusahaan secara langsung dengan arsitektur platform DagangBot v3 memberikan lompatan efisiensi yang substansial. Fitur ini dirancang khusus bagi penyewa platform (tenant) skala menengah hingga besar yang mengandalkan sistem Enterprise Resource Planning (ERP) atau basis data manajemen master terpusat untuk menjalankan bisnis mereka.
- Efisiensi Implementasi: Mengurangi beban tim rekayasa perangkat lunak Anda secara drastis. Lewat model sinkronisasi ini, Anda tidak perlu lagi mengalokasikan waktu pengembangan hanya untuk mendesain spesifikasi OpenAPI dan merawat endpoint REST khusus guna mengekspos katalog atau inventaris gudang. Cukup tunjuk tabel atau objek view mana yang diizinkan untuk diekspos, dan platform komputasi DagangBot akan mengurus proses paginasi, sinkronisasi asinkron, resolusi tabrakan, serta konversi data ke format RAG.
- Keamanan Secara Desain (Secure by Design): Kami secara fundamental menyadari risiko memaparkan pangkalan data operasional ke internet. Oleh karena itu, semua sesi koneksi dipastikan bersifat baca-saja. Pada tingkat Data Source Name (DSN), sesi disetel keras ke mode baca-saja (contohnya menambahkan
default_transaction_read_only=onuntuk koneksi PostgreSQL). Kueri yang tereksekusi murni hanya operasiSELECTdasar, tanpa memperbolehkan penyusunan kueri relasional kompleks (join) berat yang rakus CPU, apalagi instruksi operasi modifikasi (DML). - Integritas Pengetahuan AI & Proteksi Data Sensitif: Mekanisme perlindungan
FilterBusinessTablessecara otomatis berfungsi sebagai penjaga gerbang. Mekanisme ini menyaring dan menghapus nama-nama tabel sistem operasional penyokong kerangka kerja (framework) Anda (seperti tabel otentikasiusers, sesi tokensessions,personal_access_tokens, maupun metadatamigrations). Hal ini dirancang untuk menjamin entitas data rahasia sama sekali tidak masuk ke indeks pemahaman bahasa mesin AI (LLM), menutup penuh bahaya kebocoran informasi krusial kepada audiens publik di luar. - Uji Konektivitas Interaktif Waktu Nyata: Fitur
PingDatabaseinteraktif dan rutinitas penemuan anatomi skema databaseListTablesyang dijalankan di antarmuka dasbor membekali Anda dengan validasi instan seketika. Fitur ini memverifikasi kecocokan format parameter, ketersediaan host, serta resolusi kecukupan wewenang privilese kueri. Tidak ada artefak koneksi yang akan diperkenankan tersimpan ke memori platform jika gagal divalidasi pada tahapan ini.
Mesin perutean integrasi DagangBot beroperasi pada lingkungan infrastruktur cloud dengan alamat Egress IP (Alamat Protokol Internet Keluar) publik yang statis dan permanen. Agar klaster mesin pekerja kami diizinkan membaca pangkalan data di balik dinding pertahanan firewall perusahaan Anda, Anda diwajibkan menambahkan nomor Egress IP statis kami ke dalam daftar putih (whitelist) di tingkat perangkat keras pengelolaan jaringan (contohnya AWS Security Group, GCP VPC Firewall Rules, atau IPTables Linux lokal). Jika pengaturan pendaftaran ini diabaikan, transmisi koneksi akan mutlak ditolak oleh server Anda sendiri dengan status connection timeout atau connection refused.
2. Alur Visual & Antarmuka
Proses penyetelan tata kelola konfigurasi konektor dirancang teliti agar tampil transparan dan mudah dipahami, tanpa menyembunyikan parameter teknikal yang esensial.

Konfigurasi koneksi endpoint REST API internal dilakukan melalui antarmuka modal konfigurasi:

Antarmuka konfigurasi mencakup formulir otentikasi data peka di mana nilai barisan kata sandi peladen (password) akan langsung dienkripsi menggunakan metode kriptografi mutakhir bersertifikasi standar industri (AES-GCM dengan kunci acak terisolasi) tepat sebelum ditulis ke media penyimpanan fisik. Sistem DagangBot tidak akan pernah menampilkannya ulang secara plaintext pada klien web pengguna di kunjungan berikutnya.
Setelah Anda menekan tombol kelayakan uji koneksi, mesin platform spontan mengeksekusi panggilan utilitas pembedahan kerangka referensial ListDatabaseTables untuk membaca metadata bangunan dari peladen target. Hasilnya direpresentasikan sebagai rentetan pilihan di atas menu tarik-turun (dropdown). Anda cukup menyeleksi objek tabel target tanpa keharusan mengetikkan nama tabel secara manual, menghilangkan potensi tinggi kesalahan pengetikan sintaks.
3. Panduan Langkah-demi-Langkah
Untuk memulai integrasi pangkalan basis data relasional lokal perusahaan ke dalam ekosistem layanan otomatisasi DagangBot v3, ikuti petunjuk langkah operasional di bawah ini:
- 1
Langkah 1: Persiapan Akun Database Terbatas (Read-Only Privilege)
Sangat dilarang menggunakan akun superuser (root, administrator, atau postgres superuser). Buat akun pengguna (machine user) khusus dengan hak
SELECTsaja, eksklusif pada tabel yang akan diekspos.sql-- Contoh untuk PostgreSQL CREATE USER dagangbot_ekstraksi_sync WITH PASSWORD 'SandiketatTahun2026WajibSulit!'; GRANT CONNECT ON DATABASE sistem_sentral_erp TO dagangbot_ekstraksi_sync; GRANT USAGE ON SCHEMA public TO dagangbot_ekstraksi_sync; -- Hanya mengekspos tabel esensial GRANT SELECT ON public.daftar_produk_katalog, public.saldo_inventaris_gudang TO dagangbot_ekstraksi_sync;Jika tabel mengandung kolom campuran rahasia dan non-rahasia, buat
VIEWyang hanya memproyeksikan kolom non-rahasia, lalu berikan hakSELECTpadaVIEWtersebut. - 2
Langkah 2: Audit Firewall & Penambahan Egress IP
Pastikan port pangkalan data (contoh: 3306 untuk MySQL, 5432 untuk PostgreSQL) diekspos melalui firewall. Batasi inbound filtering rule khusus untuk Egress IP platform DagangBot. Alamat IP Egress statis ini dapat dilihat pada banner halaman konfigurasi integrasi di dasbor.
- 3
Langkah 3: Pengisian Parameter Identitas Koneksi
Buka Integrasi > Konektor Sistem Internal di dasbor DagangBot. Buat profil integrasi Database Eksternal dan isi konfigurasi:
- Host / IP Publik: IP publik atau domain server database Anda.
- Port: Opsional; default
3306(MySQL) atau5432(PostgreSQL). - Username & Password: Kredensial read-only dari Langkah 1.
- Nama Database: Nama database (
dbname). - Driver: Pilih
mysqlataupostgres. - SSL: Disarankan diaktifkan untuk koneksi terenkripsi (TLS 1.2+).
- 4
Langkah 4: Uji Tes Koneksi (Ping Database)
Klik Test Connection. Platform akan mengeksekusi
PingDatabase. Prosedur ini dilengkapi perlindungan SSRF (Server-Side Request Forgery) yang menolak alamat lokal seperti127.0.0.1. Jika berhasil, koneksi TCP dan privilese telah tervalidasi. - 5
Langkah 5: Penentuan Tabel Target & Pemetaan Kolom
Setelah divalidasi, dropdown Tabel Target Sinkronisasi akan memunculkan daftar tabel yang diizinkan. Mekanisme
FilterBusinessTablessecara otomatis menyembunyikan tabel sistem (misal: awalancache_,job_,users,sessions) demi keamanan.Petakan kolom asal sistem Anda dengan kolom standar DagangBot:
- SKU / ID Produk (Primary Key)
- Nama Produk
- Harga
- Deskripsi
- Stok
- 6
Langkah 6: Simpan dan Sinkronisasi (SyncDatabase)
Simpan konfigurasi. Kata sandi dienkripsi sebelum disimpan. Platform akan memulai proses
SyncDatabasesecara asinkron, membaca data secara terpaginasi, mengubahnya menjadi JSON, dan memasukkannya ke antrean RAG Ingestion Pipeline untuk diproses oleh sistem AI.
4. Parameter & Spesifikasi Teknis Konfigurasi Integrasi
Konfigurasi konektor database yang dijabarkan dalam dokumentasi ini merujuk kepada implementasi arsitektur payload struktur hierarkis JSON yang sungguh luar biasa fleksibelnya. Platform menjunjung tinggi privasi yang mutlak, yang mana secara fisik memisahkan opsi konfigurasi dari parameter berkarakteristik sakral kredensial keamanan (yakni kata kunci password).
Di bawah ini adalah penjelasan matriks ragam variabel properti penyusun integrasi ini:
Payload JSON Konfigurasi Database Eksternal
Bagi tim IT atau lapisan operasi insinyur perangkat lunak Anda yang senantiasa menghindari pengoperasian frontend grafis untuk keperluan orkestrasi, pembuatan instalasi profil konektor bisa ditempuh sempurna melalui HTTP API PUT v1/integrations/{integration_id}:
{
"typ": "database",
"name": "Konektor Utama Pusat ERP PostgreSQL",
"is_active": true,
"config": {
"driver": "postgres",
"host": "db.perusahaan-nusantara.co.id",
"port": 5432,
"database": "erp_production_2026",
"ssl": true,
"tables": [
"katalog_barang_dagang",
"posisi_inventaris_gudang"
],
"column_mapping": {
"id": "uuid_identifikasi_sku",
"name": "nomenklatur_nama_produk",
"price": "harga_retail_terakhir",
"description": "narasi_spesifikasi_marketing"
}
},
"credentials": {
"password": "PasswordEnkripsiTingkatDewaSangatMengerikan!8822"
}
}Representasi Pemanggilan API Sinkronisasi Database (cURL)
Anda tak sekadar disajikan referensi format JSON; utilitas pemanggilan cURL di bawah dapat disisipkan ke alur kerja rutinitas CI/CD terminal DevOps peranti CLI perusahaan:
curl -X PUT "https://dagangbot.web.id/api/v1/integrations/int_db_1x9p2m33" \
-H "Authorization: Bearer dbot_api_kunci_rahasia_anda_disini" \
-H "Content-Type: application/json" \
-d '{
"typ": "database",
"name": "Konektor Penjualan Instan",
"is_active": true,
"config": {
"driver": "postgres",
"host": "198.51.100.42",
"port": 5432,
"database": "sales_db",
"ssl": true,
"tables": ["produk_aktif"],
"column_mapping": {
"id": "sku",
"name": "judul",
"price": "harga_jual"
}
},
"credentials": {
"password": "SuperSecretDatabasePassword123!"
}
}'Penjelasan Arsitektur Sistem Batas Memori & Jaminan Baca-Saja (Read-Only Guarantee)
Perlu diutarakan lebih mendalam mengenai sistem batasan memori teknikal platform DagangBot ketika operasional mesin integrasi dieksekusi. Ekosistem peredam kejut menetapkan seperangkat hukum pengendalian perlambatan komputasi operasi memori:
- Batas Jangka Waktu Pemeriksaan Temporal (Time-bound Timeout Expiration): Prosedur seremonial Ping Database dibatasi oleh toleransi sirkuit temporal maksimum keterlambatan jaringan sesaat yang dikunci statis pada 10 detik. Jika durasinya lewat, kueri dihentikan paksa via interupsi mekanisme API Konteks (Context Cancellation).
- Kapasitas Hambatan RAM Paginasi Eksekusi Kueri: Rentang operasional batas pemuatan ekstrim pengurasan koneksi mesin perantara kueri membatasi area tangkapan parsial ke nilai volume sekitar
5000barisan awal saja pada satuan kueri irisan parsial (defaultMaxRowsPerTable). Hal ini menghambat peluang kemunculan anomali tabel raksasa gigabytes menelan keseluruhan cadangan memori kerja memori (Random Access Memory) gerombolan unit layanan pengolah platform komputasi (worker node). - Penyekatan Validasi Injeksi Kueri (SQL Injection Guard): Sembarang nama identitas relasional tabel atau anotasi kolom yang Anda usulkan senantiasa divalidasi ke presisi kaku konstruksi kerangka ekspresi reguler karakter rujukan abjad dasar
[A-Za-z0-9_](termasuk anomali pencantuman pengecualian tanda pemisah titik pembentukan hirarki perluasanschema.table). Indikasi pendelegasian upaya peretasan injeksi manipulasi kueri SQL akan terpental otomatis dalam seleksi saringan fungsi isolasi keamanan statis statisisSafeIdentifier. - Isolasi Pagar Pintu Penolakan Akses SSRF (Server-Side Request Forgery Guard): Prosedur intelijen fungsi pencegat rutinitas modul
guardDatabaseHostdipersenjatai untuk mendeteksi menggugurkan wujud rentang angka jejak blok IP privat identifikasi lingkungan mesin pangkalan (merujuk ilustrasi fiktif misalnya masukan angka palsu192.168.x.xdan juga resolusi siluman anomali rekayasa alamat pemeta DNS palsu jaringan privat). Eksekusi interupsi jaringan dihentikan proaktif seketika berpuluh milidetik sebelum penjalur rutinitas fungsi rute pembukaan TCP perute protokol bawahan (TCP driver dial routine) bersiap membangkitkan panggilannya. Lapisan garda pagar ekstrim lini depan menahan laju serangan peretas opportunis meraba rentetan infrastruktur jaringan server kerahasiaan platform DagangBot.
Autentikasi Antar-Layanan & Kontrak Versi (Internal API)
Ketika integrasi internal DagangBot (seperti modul Webhook Outbound atau API eksternal pangkalan data) berkomunikasi bolak-balik dengan lapisan arsitektur backend kustom milik penyewa platform, DagangBot memastikan tingkat perlindungan yang ketat menggunakan protokol Autentikasi Antar-Layanan berbasil Token/HMAC (Hash-based Message Authentication Code).
- Validasi Kriptografi HMAC-SHA256: Seluruh panggilan keluar (contohnya perutean
ecommerce:sync_failedmaupun pemberitahuan pesanan) ditandatangani memakai algoritme konstan HMAC-SHA256. Pihak penerima (server Anda) diharuskan melakukan proses dekripsi membandingkan atribut header (sepertiX-Hub-Signature-256) menggunakanwebhook_secretyang dirotasi secara reguler melalui endpoint pengamanan rahasia. - Kontrak Versi (Versioning): URL endpoint API DagangBot mengikat versi struktur mutlak yang stabil, direpresentasikan melalui prefiks
/api/v1/. Struktur tanggapan JSON pada/v1/dilarang pecah mundur (backward incompatible). Fitur atau kolom baru akan dikonfigurasi sebagai ekstensi opsional, tidak menggantikan atau menghapus kolom inti sepertiis_activeatau ID konfigurasiconfig.
Pembatasan Laju API (Rate Limiting) Internal
Dalam menahan gempuran eksekusi ping yang serampangan maupun panggilan uji koneksi yang dapat membebani perutean TCP peladen Anda, komponen layanan API di lingkungan v3 menerapkan Pembatasan Laju (Rate Limit) yang sangat ketat:
- Panggilan Sinkronisasi Manual (
/sync): Dibatasi maksimal 3 pemanggilan berturut-turut dalam durasi satu jam. - Pengujian Koneksi (
/test/{kind}): Dibatasi hingga kuota 10 upaya per menit guna mencegah serangan brute force tebakan kata sandi menuju peladen database Anda melalui antarmuka DagangBot.
5. Relasi & Integrasi Antar-Modul Lintas Fungsional
Arsitektur perangkat lunak Konektor Sistem Internal ini beroperasi menjadi tulang punggung pemasok bahan mentah utama (urat nadi ekosistem) bagi sederetan rangkaian jejaring modul-modul sub-sistem operasional DagangBot:
- [Knowledge Base Vektor Otak (RAG Ingestion Engine)](knowledge-base): Setiap rekaman baris tabel rasionalisasi data log yang disedot oleh layanan sinkronisasi konektor basis disuntikkan secara utuh menjadi abstrak dokumen RAG terkompresi. Dokumen lantas mengalami pemecahan vektor (embedding extraction) menuju representasi pemahaman korelasi numerikal. Mekanisme pencernaan pangkalan yang rapi mumpuni ini membekali otak LLM bot asisten asisten virtual asisten (Customer Service) korelasi wawasan berlimpah rujukan inventaris ketika merespons aneka rentetan prompts pertanyaan pembeli konsumen.
- [Katalog Layanan Jasmani & Booking Pintar](service-catalog): Serapan data tabel dikonversi, diselaraskan, lalu dipajang secara otomatis merepresentasikan representasi fisik wujud etalase inventaris produk ritel nyata bagi transaksi pembayaran dan pembelian melalui modul Conversational Commerce.
- [Aktivitas Log Platform Keamanan Audit Tenan](activity-log): Pemicuan rentetan operasi eksekusi relasional backend di atas didokumentasikan. Rekam jejak logging rincian catatan metrik konektivitas menyertakan bukti latensi rujukan parameter ukuran mili-detik murni (
durationMs) beserta rentang angka hasil persilangan perolehan kapasitas data sinkronisasi operasional integrasi disajikan komplit di layar kendali pelacakan administrasi situs dasbor penyewa harian (tenant).
6. Pemecahan Masalah (Panduan Diagnostik)
Ekosistem persilangan konektivitas jaringan merentas batas awan (cloud) dan pertahanan server pangkalan data tertutup hibrida memunculkan kompleksitas insiden tersendiri. Rujuklah rangkuman rujukan pelurusan insiden di bawah ini bilamana sinkronisasi relasional konektor basis menolak berirama:
7. Kode Error Khusus Jaringan & Penanganan Lanjut
Konektor basis data DagangBot dibangun dengan kapabilitas untuk menerjemahkan keruntuhan pelaporan kesalahan teknis driver relasional lapisan TCP Socket Transport menjadi rincian log pesan keruntuhan kemanusiaan diagnostik yang jelas dan dimengerti akal.
Penelusuran Pelacak Laporan Webhook Log Pemanggilan Diagnostik Eksekusi Jaringan Sinkronisasi
Bagi penyewa platform institusi perusahaan yang secara teknis mengaryakan tipe integrasi operasional spesifik rute internal yang menggunakan kanal pengirim request fetch outbound webhook call API, DagangBot mengerahkan pengerahan agen pelopor utilitas SyncWebhook atau perwakilan sekutu utilitas relawan rintisan siluman panggil log eksekusi arsitektur utilitas log riwayat penelusuran dokumentasi SyncRestAPI mencatat serangkaian rincian parameter kekeliruan eksekusi ke ranah pelaporan riwayat rekaman sejarah:
{
"event_type": "probe_restapi",
"status_code": 401,
"duration_ms": 134,
"error_message": "Unauthorized: invalid API token provided in auth_header",
"response_snippet": "{\"error\":\"token_expired\"}"
}Pastikan semua pengaturan atribut header otorisasi Anda dipoles diremajakan pasca peluncuran pengulangan rotasi keamanan kunci rahasia (credential rotation).
8. Referensi Terkait
Untuk melengkapi pemahaman Anda seputar arsitektur sinkronisasi dan alur pencernaan basis pengetahuan relasional pangkalan, silakan lihat koleksi rujukan dokumen platform penunjang berikut.
Otak AI: Knowledge Base & Vector Search
Pelajari bagaimana data tabel dari konektor relasional pangkalan pangkalan tabel diubah menjadi matriks ruang abstraksi vektor dimensi kecerdasan ekstraksi arsitektur perbandingan ruang vektor RAG.
All-in-One API
Alternatif metode penyuntikan barisan rekaman satuan relasional tunggal satu per satu merangkak manual HTTP integrasi data tanpa membuka celah dinding akses langsung pangkalan TCP.
Keamanan, Enkripsi & Kepatuhan UU PDP
Eksplorasi wawasan rincian pertahanan mengenai kekuatan lapis jaminan pengamanan baja arsitektur perlindungan pangkalan algoritma penyimpanan brankas kriptografi penyandian enkripsi keamanan algoritma penyandian mutakhir data ruang rahasia pangkalan brankas penyandian algoritma operasi pangkalan brankas enkripsi AES-GCM 256 memori rahasia data kredensial akses pangkalan kunci database rahasia penyimpanan rahasia keamanan untuk kelangsungan data rahasia persembunyian rahasia keamanan peladen untuk parameter rahasia rahasia pangkalan kredensial kredensial peladen.
